- AI辅助迁移 — 使用Amazon Devices Builder Tools MCP服务器中的AI辅助升级助手。该助手会自动检测当前版本，生成一份必改项核对清单，并逐步引导您完成每一项操作。
- 手动迁移—按照本指南中的步骤说明，手动完成每一项更改。
先决条件
开始迁移前，请先确认您已满足下列要求：- 已安装Vega SDK 0.24
- Node.js版本为22.14.0或更高
- npm（随附于Node 22）
- git（工作树干净，有备份分支）
- 已启用开发者模式的测试用Vega Fire TV设备。
AI辅助迁移
Amazon Devices Builder Tools模型上下文协议 (MCP) 服务器内建有AI辅助升级助手，用于在Vega平台上进行React Native版本迁移。该助手提供：- Vega专属上下文—了解Vega的要求和限制
- 自动生成待办事项清单—创建升级任务核对清单
- 版本专属知识库—加载React Native 0.83专属配置详情
- 交互式分步指南—通过说明引导您完成每项更改
- 断点续传功能—保存进度，并在稍后恢复升级
安装MCP服务器
安装Amazon Devices Builder Tools MCP服务器：0.1.31或更高：
启动升级助手
使用AI编码助手并运行以下提示命令。 对于Kiro、Claude Code或Cline：- 询问您的工作目录，如果您已在项目中，则会自动检测。
- 通过
package.json检测当前使用的React Native版本。 - 验证项目结构和环境。
- 加载React Native 0.83的Vega专属知识库。
- 生成包含所有必要更改项的待办事项清单。
- 进入交互模式，逐步进行更改。
查看生成的待办事项清单
升级助手会在您的项目目录中生成一份名为RN_UPGRADE_TODO_[current_version]_to_0.83.md的待办事项文件。例如，RN_UPGRADE_TODO_0.72_to_0.83.md。
确认项目目录中已创建该文件。此操作旨在确认升级助手已正确初始化。
待办事项文件包括：
- 带有复选框的进度跟踪
- 优先级标识（从紧急到低优先级）
- 每项更改的详细实施步骤
- 代码示例和文件引用
交互处理更改项
升级助手使用基于命令的界面进入交互模式。您将看到一个菜单，其中按优先级列出了所有待处理更改项。 交互式命令- [1-N]—按数字选择更改项以查看其实施指南。如为简单更改，AI会自动实施。
- 完成—手动实施后，将当前更改项标记为已完成。
- 构建—报告构建错误，以获取基于知识库的故障排除支持。
- 状态—查看详细的进度报告。
- 帮助—显示命令参考。
- 退出—保存进度并退出。这会创建
.rn-upgrade-checkpoint.json，以便稍后恢复。
- 查看助手显示的待处理更改项（按优先级分组）。
- 要选择更改项，请输入其编号。
- 查看包含详细步骤的实施指南。
- 接受AI自动更改或手动更改，然后输入
complete。 - 重复上述步骤，处理剩余更改项。
构建和测试
完成升级更改后，要求AI助手在已连接的Vega设备上，构建并运行该应用。AI负责构建、部署和启动。 如果遇到构建错误，升级助手能指引您发现问题并提供解决方案。您还可以就具体更改进行提问，例如RN83升级需要对哪一项package.json依赖项进行更改。
有关手动构建和验证命令，请参阅步骤7：构建并验证。
