用途:为 Android 项目提供基于 Jetpack Navigation Component 的旧式(XML 导航图)导航实现规范,优先级为 P1(HIGH)。适用于使用 XML 导航图或 SafeArgs 的 Fragment 导航场景。
主要能力与要求: 一、单 Activity 架构。使用一个宿主 Activity 承载 NavHostFragment;必须启用 SafeArgs 插件,用于在 Fragment 之间传递数据。 二、导航图管理。采用嵌套图,将 navigation 资源模块化(如 nav_auth.xml、nav_main.xml)以保持图的可读性;深度链接应在导航图中显式定义 <deepLink>,而不是使用 AndroidManifest 的 intent filter。 三、类型安全导航。通过 SafeArgs 生成的类型安全类进行导航与传参。
反模式(应避免): 不得使用原始字符串 Bundle 键,应改用 SafeArgs 生成的类型安全类;不得手动调用 Fragment 的 commit(),所有导航应通过 NavController 完成。
限制:资料未提供具体版本要求、安装命令、完整 XML 图与 SafeArgs 代码示例、性能数据及收费信息,相关内容暂未提供。