upgrade-react-navigation

升级 React Navigation

目标

将 React Navigation 升级到下一个主版本，并处理所有必需的破坏性变更，同时保留现有导航行为。

何时使用

你正在升级 React Navigation 主版本（6.x -> 7.x 或 7.x -> 8.x）。

适配策略

将此技能中的模式视为规范的起点，而非详尽列表。没有完全匹配的示例并不是阻碍。

• 将本地代码映射到此处最接近的模式并进行适配；当结构不同时，推断出等效方案。
• 优先选择保留行为的最简单升级。
• 保持改动最小，仅升级受影响的代码。

何时请求澄清

先检查本地代码。

如果在阅读相关 navigator 和升级参考后，你仍无法高度确信某个 API 是否发生了变化或如何更新它，请暂停并在编辑代码前询问用户。

在以下情况请求澄清：

• navigator 使用了官方文档或升级参考中未涵盖的 API。
• 升级需要假设哪些行为变更可以接受。

参考

先检查 package.json 中的 @react-navigation/native。

• 如果是 6.x，阅读 references/upgrade-6-to-7.md
• 如果是 7.x，阅读 references/upgrade-7-to-8.md
• 对于任何其他版本，请遵循升级指南先迁移到 7.x 或 8.x。

除非明确比较版本，否则只加载一个参考文件。

验证

升级后：

• 从 package.json 或锁文件确定包管理器。
• 当脚本可用时，运行现有的类型检查器、linter 和相关测试。
• 完成已加载参考中的“自动化检查”和“手动检查”。如果某一步无法运行，请报告原因。