Console

Settings

Sign out

Notifications

Alexa

亚马逊应用商店

Ring

AWS

文档

Support

My Cases

Console

Vega开发者文档

主页

新手入门

设计和开发

应用发布

参考

支持

设置快速刷新以使用Vega CLI构建应用

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅最新的发布说明。

快速刷新是一项React Native功能，让您无需重新构建应用即可立即查看代码更改。快速刷新适用于Vega Studio和Vega命令行界面 (CLI) 环境。在Vega Studio（调试模式）中，快速刷新是自动的，但需要使用Vega CLI进行手动设置。按照此页面上的说明操作。

先决条件

安装Vega SDK。
完成以下任一项的设置：
- Vega虚拟设备
- Fire TV Stick

警告： Vega虚拟设备和Fire TV Stick仅支持端口8081。同时在多个应用上运行快速刷新会导致Metro Bundler中发生冲突，从而导致错误并阻止您的其他Vega应用正常运行。

Vega虚拟设备
Fire TV Stick

将您的Vega虚拟设备连接到Metro服务器

准备好应用的目录路径：

打开两个shell窗口（A和B）。
在shell A中启动Vega虚拟设备：
已复制到剪贴板。
```
kepler virtual-device start
```

在shell B中导航到应用的目录：

cd <您应用的目录>

// 输出示例
cd keplersampleapp

安装依赖项：
已复制到剪贴板。
```
npm install
```
构建应用：
已复制到剪贴板。
```
npm run build:debug
```
在shell B中启动Metro服务器：
已复制到剪贴板。
```
npm start
```
Metro服务器加载依赖项并显示其标志。

返回shell 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。

为Vega虚拟设备使用自定义Metro Bundler端口

Metro Bundler支持更改默认端口。

在自定义端口上启动Metro：
```
npm start -- --port=<新端口>
```
提示： 将<新端口>替换为您的首选端口号（例如8082）。
反向端口转发主机上的自定义端口：
```
vda reverse tcp:8081 tcp:<新端口>
```

结束Vega虚拟设备的快速刷新会话

使用“快速刷新”完成应用开发后，您可以：

关闭应用。

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连接到电脑时会看到安全提示。单击Allow（允许）。

要避免将来出现提示，请如下操作：

a. 转到Configuration（配置）> Privacy & Security（隐私和安全）。

b. 将Allow accessories to connect（允许连接配件）设置为Always（始终）。
打开两个shell窗口（A和B）。

在shell A中导航到应用的目录：

cd <您应用的目录>
cd keplersampleapp

在shell A中启动Metro服务器：
已复制到剪贴板。
```
npm start
```
Metro服务器加载依赖项并显示其标志。
在Metro服务器窗口中按r。

在shell 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

为Fire TV Stick使用自定义Metro Bundler端口

Metro Bundler支持更改默认端口。

在自定义端口上启动Metro：
```
npm start -- --port=<新端口>
```
提示： 将<新端口>替换为您的首选端口号（例如8081）。
反向端口转发主机上的自定义端口：
```
vda reverse tcp:8081 tcp:<新端口>
```

结束Fire TV Stick的快速刷新会话

使用快速刷新完成应用开发后，断开设备的连接。

故障排除

有关设置问题，请参阅解决快速刷新问题。

使用Vega CLI构建应用

Last updated: 2025年11月13日