设置快速刷新以使用Vega CLI构建应用
快速刷新是一项React Native功能，让您无需重新构建应用即可立即查看代码更改。快速刷新适用于Vega Studio和Vega命令行界面 (CLI) 环境。如果在“调试”模式下构建，Vega Studio会自动启用快速刷新；如果使用Vega CLI构建应用，您必须手动配置快速刷新。按照此页面上的说明操作。
先决条件
- 安装Vega SDK。
-
完成以下任一项的设置：
将您的Vega虚拟设备连接到Metro服务器
准备好应用的目录路径：
- 打开两个终端窗口（A和B）。
-
在终端A中启动Vega虚拟设备：
kepler virtual-device start -
在终端B中导航到应用的目录：
cd <您应用的目录> // 输出示例 cd keplersampleapp -
安装依赖项：
npm install -
构建应用：
npm run build:debug -
在终端B中启动Metro服务器：
npm startMetro服务器加载依赖项并显示其标志。
Metro服务器 -
返回终端A并启动端口转发：
kepler device start-port-forwarding --device <设备名称> -p <端口> --forward false // 输出示例 kepler device start-port-forwarding --device VirtualDevice -p 8081 --forward false -
使用调试构建版本运行您的应用：
kepler run-kepler <VPKG的路径> <com.amazondeveloper.应用名称.main> -d VirtualDevice # 要在x86 Vega虚拟设备上运行 `keplersampleapp`，请输入以下命令： kepler run-kepler build/x86_64-release/keplersampleapp_x86_64.vpkg com.amazondeveloper.keplersampleapp.main -d VirtualDevice提示： 您可以在项目根目录下的manifest.toml文件中找到您的ID，并将完全限定域名 (FQDN) 自定义为您偏好的域名。
使用自定义Metro Bundler端口
Metro Bundler支持更改默认端口。
-
在自定义端口上启动Metro：
npm start -- --port=<新端口>提示： 将<新端口>替换为您的首选端口号（例如8082）。 -
反向端口转发主机上的自定义端口：
vda reverse tcp:8081 tcp:<新端口>
结束快速刷新会话
使用“快速刷新”完成应用开发后，您可以：
-
关闭应用。
kepler device terminate-app --device <设备名称> --appName <com.amazondeveloper.应用名称.main> # 在Vega虚拟设备上关闭“keplersampleapp”的命令是： kepler device terminate-app --device VirtualDevice --appName com.amazondeveloper.keplersampleapp.main -
按Ctrl+C停止Metro服务器。
-
停止端口转发：
kepler device stop-port-forwarding --device <设备名称> -p <端口> --forward false # 在Vega虚拟设备上停止 `keplersampleapp` 端口转发的命令如下： kepler device stop-port-forwarding --device VirtualDevice -p 8081 --forward false -
停止Vega虚拟设备：
kepler virtual-device stop
将您的Fire TV Stick连接到Metro服务器
-
将您的Fire TV Stick连接到计算机。
如果您是macOS用户，则在将Fire TV Stick连接到电脑时会看到安全提示。单击允许。
允许连接配件 要避免将来出现提示，请如下操作：
a. 转到配置 > 隐私和安全。
b. 将允许连接配件设置为始终。
允许连接配件 - 打开两个终端窗口（A和B）。
-
在终端A中导航到应用的目录：
cd <您应用的目录> // 输出示例 cd keplersampleapp -
在终端A中启动Metro服务器：
npm startMetro服务器加载依赖项并显示其标志。
Metro服务器 - 在Metro服务器窗口中按r。
-
在终端B中开始端口转发：
kepler device start-port-forwarding --device <设备名称> -p <端口> --forward false # 例如，如果您的设备序列号为“GXX2A1234567890A”，完整的命令可如下所示： kepler device start-port-forwarding --device GXX2A1234567890A -p 8081 --forward false重要须知： 运行命令后，将出现弃用警告。继续执行下一步。要核实设备的序列号，请运行以下命令：
kepler device list -
安装依赖项：
npm install -
构建您的应用：
npm run build:app -
运行您的应用：
kepler run-kepler <VPKG的路径> <com.amazondeveloper.应用名称.main> --deviceId <设备名称> # 运行设备序列号为“GXX2A1234567890A”的“keplersampleapp”应用的命令将是： kepler run-kepler build/armv7-release/keplersampleapp_armv7.vpkg --deviceId GXX2A1234567890A
使用自定义Metro Bundler端口
Metro Bundler支持更改默认端口。
-
在自定义端口上启动Metro：
npm start -- --port=<新端口>提示： 将<新端口>替换为您的首选端口号（例如8081）。 -
反向端口转发主机上的自定义端口：
vda reverse tcp:8081 tcp:<新端口>
结束快速刷新会话
使用快速刷新完成应用开发后，断开设备的连接。
故障排除
如果您在设置快速刷新时遇到问题，请访问解决快速刷新问题。
相关主题
Last updated: 2025年9月30日
