步骤1：
依赖项更新
依赖项更新
将应用升级到React Native 0.83
将应用升级到React Native 0.83
开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅最新的发布说明。
本指南涵盖了将Vega React Native应用从0.72.0版本迁移到0.83.0版本的相关内容。您可以在以下两种方式中任选其一：
- AI辅助迁移 — 使用Amazon Devices Builder Tools MCP服务器中的AI辅助升级助手。该助手会自动检测当前版本，生成一份必改项核对清单，并逐步引导您完成每一项操作。
- 手动迁移 — 按照本指南中的步骤说明，手动完成每一项更改。
这两种方式涵盖的更改项完全一致。对于大多数应用而言，AI辅助方式更为高效。手动方式让您拥有完全控制权，适合希望充分理解每一项更改，或应用包含大量自定义逻辑的场景。
如果遇到任何迁移问题，请参阅React Native 0.83迁移问题排查。
先决条件
开始迁移前，请先确认您已满足下列要求：
- 已安装Vega SDK 0.24
- Node.js版本为22.14.0或更高
- npm（随附于Node 22）
- git（工作树干净，有备份分支）
- 已启用开发者模式的测试用Vega Fire TV设备。
开始前先提交当前变更项，必要时可回滚。
cd /path/to/your/vega-app
git add .
git commit -m "Pre-upgrade checkpoint"
AI辅助迁移
Amazon Devices Builder Tools模型上下文协议 (MCP) 服务器内建有AI辅助升级助手，用于在Vega平台上进行React Native版本迁移。该助手提供：
- Vega专属上下文 — 了解Vega的要求和限制
- 自动生成待办事项清单 — 创建升级任务核对清单
- 版本专属知识库 — 加载React Native 0.83专属配置详情
- 交互式分步指南 — 通过说明引导您完成每项更改
- 断点续传功能 — 保存进度，并在稍后恢复升级
安装MCP服务器
安装Amazon Devices Builder Tools MCP服务器：
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context
提示您选择AI编码助手，并为其配置MCP服务器。
要手动配置MCP服务器，请将以下内容添加到AI代理的MCP设置JSON中：
"amazon-devices-buildertools-mcp": {
"command": "npx",
"args": ["-y", "@amazon-devices/amazon-devices-buildertools-mcp@latest"],
"type": "stdio"
}
验证设置：
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status
代理的上下文文档和MCP配置均显示为已配置。
验证MCP版本是否为0.1.31或更高：
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest --version
注意： 如果默认情况下未启用MCP，请确保在AI代理中予以启用。
启动升级助手
使用AI编码助手并运行以下提示命令。
对于Kiro、Claude Code或Cline：
/prompt react_native_for_vega_ai_assisted_rn_upgrade
或者，直接询问：
Use the React Native Upgrade workflow from @amazon-devices/amazon-devices-buildertools-mcp to upgrade my application to RN83.
升级助手会执行以下操作：
- 询问您的工作目录，如果您已在项目中，则会自动检测。
- 通过
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。
确认项目目录中已创建该文件。此操作旨在确认升级助手已正确初始化。
待办事项文件包括：
- 带有复选框的进度跟踪
- 优先级标识（从紧急到低优先级）
- 每项更改的详细实施步骤
- 代码示例和文件引用
注意： 在待办事项中，有一项将引导您执行
npm install命令，以更新依赖项。升级助手会协助完成此步骤，并帮助排查任何安装错误。交互处理更改项
升级助手使用基于命令的界面进入交互模式。您将看到一个菜单，其中按优先级列出了所有待处理更改项。
交互式命令
- [1-N] — 按数字选择更改项以查看其实施指南。如为简单更改，AI会自动实施。
- 完成 — 手动实施后，将当前更改项标记为已完成。
- 构建 — 报告构建错误，以获取基于知识库的故障排除支持。
- 状态 — 查看详细的进度报告。
- 帮助 — 显示命令参考。
- 退出 — 保存进度并退出。这会创建
.rn-upgrade-checkpoint.json，以便稍后恢复。
要实施更改：
- 查看助手显示的待处理更改项（按优先级分组）。
- 要选择更改项，请输入其编号。
- 查看包含详细步骤的实施指南。
- 接受AI自动更改或手动更改，然后输入
完成。 - 重复上述步骤，处理剩余更改项。
进度会自动保存。您可以随时暂停，稍后通过再次运行升级命令来继续进行更改。
构建和测试
完成升级更改后，要求AI助手在已连接的Vega设备上，构建并运行该应用。AI负责构建、部署和启动。
如果遇到构建错误，升级助手能指引您发现问题并提供解决方案。您还可以就具体更改进行提问，例如RN83升级需要对哪一项package.json依赖项进行更改。
有关手动构建和验证命令，请参阅步骤7： 构建并验证。
手动迁移
要自行迁移应用，请按以下步骤依次操作。所有应用均须执行步骤1–4和步骤6–7。仅在应用使用轮播组件的情况下执行步骤5。
相关主题
外部资源
Last updated: 2026年7月29日
