开发与工程

Jetpack Navigation 3 指南与实战配方

学习安装和迁移到 Navigation 3,并掌握深度链接、多返回栈、自适应场景、条件导航等模式的实战技能。

59/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
ChatGPT · Codex · Claude Code
Star 数
★ 7.7k
最近更新
16 天前
License
Apache-2.0
androidjetpack-navigationcomposenavigation-3
+4deep-linksscenesmigrationhilt

这个 Skill 能做什么,适合哪些场景?

此技能为 Android 开发者提供 Jetpack Navigation 3 的全面指南和代码示例。它包含从 Navigation 2 升级到 Navigation 3 的分步迁移指南、类型安全导航的文档、以及覆盖从基础 API 到高级模式(如深层链接、多返回栈、对话框/底部工作表场景、自适应双面板布局、条件导航、结果返回、模块化导航和 ViewModel 集成)的丰富配方。所有内容面向使用 Jetpack Compose 和 Kotlin 的现代 Android 应用。由 Google LLC 维护,遵循 Apache-2.0 许可证。

通过指向 SKILL.md 中引用的 Markdown 文件,提供导航相关教程、开发文档和代码示例。具体操作包括:指导从 Navigation 2 到 Navigation 3 的迁移步骤、展示如何实现基本 API 用法、使用可保存的返回栈、通过 DSL 定义入口、构建带多个返回栈的底部导航栏、解析和处理深层链接、创建自定义场景(如对话框、底部工作表、列表详情、双面板)、应用 Material 自适应布局、自定义动画、处理条件导航(如登录状态)、使用 Hilt/Koin 解耦导航代码、将参数传递给 ViewModel,以及将结果作为事件或状态返回。

适合
  • 正在使用 Navigation 2 并计划升级到 Navigation 3 的 Android 开发者,需要迁移指南
  • 希望在 Compose 应用中实现底部导航栏,并保留每个标签页独立导航历史的开发者
  • 需要处理从外部 Intent 传入的深度链接,并确保正确的返回栈行为的开发者
  • 需要实现自适应列表-详情或双面板布局,以适配手机和平板等不同屏幕尺寸的开发者
  • 希望使用 Hilt 或 Koin 将导航代码模块化,以便于大型项目维护的开发者
  • 需要将导航结果返回给上一个目的地,以状态或事件方式传递的开发者

如何安装这个 Skill?

使用前请注意
  • 依赖海外服务(如developer.android.com),在中国大陆可能无法直接访问,建议代理或镜像。
  • 迁移指南假设项目满足特定条件,使用前需由用户确认,否则可能导致不完整迁移。
  • 静态审查无法验证代码实际可运行性,请在实际项目中验证。

本技能来自 android/skills 仓库,该仓库包含多个技能。要安装此特定技能,可以使用 Android CLI 工具,在项目根目录执行:android skills add --skill=navigation-3 --project=. 或者,手动将 SKILL.md 文件及其引用的 references 目录放入您的 agent 技能目录(例如 ~/.gemini/antigravity/skills/navigation-3/)。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/android/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/navigation/navigation-3" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 使用 navigation-3 技能,帮我编写从 Navigation 2 迁移到 Navigation 3 的步骤
  • 参考 navigation-3 技能中的配方,实现一个带多个返回栈的底部导航栏

安装后,您可以在对话中引用该技能,例如:"使用 navigation-3 技能,帮我编写从 Navigation 2 迁移到 Navigation 3 的步骤",或"参考 navigation-3 技能中的配方,实现一个带多个返回栈的底部导航栏"。技能将引导您阅读相关的 Markdown 指南和代码示例。

这个 Skill 有哪些优点和局限?

优点
  • 由 Google 提供并维护,内容权威且与官方文档一致
  • 覆盖从基础到高级的广泛场景,包括迁移、深层链接、自适应布局和架构模式
  • 提供代码示例,可直接用于实战
  • 持续更新,最后更新于 2026 年
  • 遵循开放的 Agent Skills 标准,易于集成
局限
  • 内容仅包含指向 Markdown 文件的链接,本身不包含实际代码,需要手动复制或查看
  • 未包含测试或验证步骤,用户需自行验证示例的正确性
  • 大部分内容适用于 Compose 和 Kotlin,对传统 View 系统的支持有限(仅提及互操作性)
  • 安装需要 Android CLI 工具,对于不熟悉该工具的用户可能增加学习成本

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Jetpack Navigation 3 指南与实战配方 本页 59 · 推荐 ★ 7.7k 16 天前 Apache-2.0
Android 自适应界面技能 71 · 高度推荐 ★ 7.7k 16 天前 Apache-2.0
Jetpack Compose 样式集成技能 44 · 不推荐 ★ 7.7k 16 天前 Apache-2.0
CameraX 相机开发技能 60 · 推荐 ★ 7.7k 16 天前 Apache-2.0
Expo 原生 UI 构建助手 59 · 推荐 ★ 2.7k 6 天前 MIT

该技能是 Android 官方提供的,与 Jetpack Navigation 的其他版本(如 Navigation 2)形成对比,其内容专门针对 Navigation 3,包含迁移指南。没有提及与其他第三方导航库(如 Voyager、Decompose)的直接比较。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
59/ 100 五分制 3.0 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全15 / 25 · 3.0/5

技能仅提供导航实现的操作指南,无高风险权限操作,依赖均在官方文档中声明,无隐藏数据流或敏感信息处理。但缺少对用户确认或回滚步骤的明确要求,且来源未经验证,故扣分。

2可靠稳定10 / 20 · 2.5/5

核心迁移步骤和代码示例自洽,但依赖外部库和API,静态审查无法验证可运行性,错误处理仅提示用户检查假设,缺少详细失败反馈。

3适用触发10 / 15 · 3.3/5

适用场景明确,面向使用Compose和Navigation 2迁移到Navigation 3的开发者,但边界条件需用户自查,且未涉及中国大陆网络可达性,依赖海外服务,故扣分。

4规范维护12 / 15 · 4.0/5

文档结构清晰,有迁移指南、食谱和参考,但缺少版本历史和变更日志,维护责任仅由文档作者体现,未明确更新路径。

5有效结果7 / 15 · 2.3/5

核心任务(迁移)的步骤和代码示例应能指导完成,但静态审查无法验证其直接可用性,用户需自行验证。

6证据核验5 / 10 · 2.5/5

食谱引用官方GitHub仓库和开发者文档,但缺乏独立验证证据,静态审查无法确认其真实性。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年8月7日 审查版本 28822b2306f3 评估证据[1][2][3][4][5][6][7][8][9][10][11][12][13]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

此技能是否免费?
是的,该技能遵循 Apache-2.0 许可证,可免费使用和修改。
我需要使用特定的 IDE 吗?
不需要,但推荐使用 Android Studio,因为它内置了对 Android 开发的支持。该技能本身仅提供文档和示例,适用于任何支持 Markdown 的 agent。
技能中的示例代码是否完整可用?
示例代码以配方形式提供,可能需要根据您的项目结构进行调整。建议结合官方文档进行验证。
是否支持非 Compose 项目?
该技能主要面向 Compose 项目,但提及了 View 互操作性,因此可能对混合项目有帮助。

同仓库的其他 Skills

均来自 android/skills

相关 Skills