Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases

Console

as

新手入门
设计和开发
应用发布
参考
支持
跳转到主要内容
Vega SDK具有命令行界面 (CLI)，让您可以在终端中构建应用和运行虚拟设备。运行命令时，将所有占位符替换为实际值，以免报错。例如，将、和替换为您的应用名称、公司名称和项目目录路径。请勿使用amazon作为您的公司名称或程序包ID。 本页介绍Vega CLI命令和示例。

​
帮助选项

要浏览所有Vega命令的选项，可运行以下命令：
要获取有关特定命令的帮助，可运行以下命令：
例如，要查看kepler build命令的所有选项，可运行以下命令：

​
常用命令

​
npx react-native build-kepler

使用npx react-native build-kepler命令来编译您的应用并生成vpkg。 要构建应用，可运行以下命令：

​
kepler clean

要移除<项目根目录>/build文件夹中生成的工件，可运行以下命令：

​
kepler project list-templates

要查看可用于创建示例应用的可用JavaScript和Turbo模块模板，可运行以下命令：
输出示例：

​
kepler project generate

要创建Vega项目，可使用带所需参数的kepler project generate命令。 要创建新应用，可运行以下命令：
以下是命令中不同组件的明细：
  • kepler project generate - 使用此命令来生成Vega应用。
  • --template - Vega应用或Turbo模块模板的名称，您可以用kepler project list-templates命令找到该模板。在示例中，它使用了hello-world模板。
  • --name - 您的新应用或Turbo模块的名称。名称不能包含空格或特殊字符。将替换为所需的新应用名称。
  • —packageId - 适用于Vega的React Native应用中（而非Turbo模块中）所需manifest.toml的程序包ID。将替换为您的公司的名称，将替换为您的应用的名称。这将为新应用设置程序包ID。
  • —outputDir（可选）- 指定新应用文件的输出目录。将替换为您的应用的实际名称。
当您遵循此格式时，该命令会显示新项目的路径。

​
kepler run-kepler

要安装和运行您的应用，可运行以下命令：
以下命令结合了kepler device install-app和kepler device launch-app。 对于VVD：
对于Fire TV：
例如，要在Mac M系列计算机上运行名为keplersampleapp的应用，可运行以下命令：

​
设备命令

Vega CLI设备命令接口为您提供了一种与物理设备和Vega虚拟设备进行交互的方式。必须在路径上安装VDA并使其可用，设备命令才能起作用。 一般命令格式为：
要查看所有可用的设备命令，可运行以下命令：

​
kepler device copy-from

要将设备文件复制到主机计算机，可运行以下命令：

​
kepler device copy-logs

要从设备检索工件文件，可运行以下命令：

​
kepler device copy-to

要将主机文件复制到设备，可运行以下命令：

​
kepler device get-log-info

要从设备检索日志信息，可运行以下命令：

​
kepler device install

要在设备和模拟器上安装应用，可在应用程序包中添加路径参数 (-p)。The path follows this syntax: build/<架构>-<构建类型>/<应用名称>_<架构>.vpkg. 例如，如果keplersampleapp在Mac x86计算机上运行，可运行以下命令：
要自动在目录中找到正确的.vpkg并安装它，可运行以下命令：
要指定debug构建类型，可运行以下命令：
要指定release构建类型，可运行以下命令：

​
kepler device installed-apps

要列出设备上安装的应用，可运行以下命令：
例如，要查看虚拟设备上安装的所有应用的列表，可运行以下命令：

​
kepler device installed-packages

要列出设备上安装的所有程序包，可运行以下命令：
例如，要查看虚拟设备上安装的所有程序包的列表，可运行以下命令：

​
kepler device is-app-installed

要使用应用名称检查应用是否已安装，可运行以下命令：
要使用项目目录检查应用是否已安装，可运行以下命令：

​
kepler device is-app-running

要使用应用名称检查应用是否在设备上运行，可运行以下命令：
要使用项目目录检查应用是否在设备上运行，可运行以下命令：

​
kepler device is-connected

要检查特定设备的连接状态，可运行以下命令：
示例：
连接时的输出：
未连接时的输出：

​
kepler device launch-app

要使用应用名称在设备上启动应用，可运行以下命令：
要使用项目目录在设备上启动应用，可运行以下命令：

​
kepler device list

要列出连接的设备（Fire TV Stick和Vega虚拟设备），可运行以下命令：
Vega虚拟设备显示为：VirtualDevice : tv - architecture - OS type - hostname 连接Fire TV Stick (GXX2A1234567890A) 并运行虚拟设备时的输出示例：

​
kepler device reboot

要重启给定设备，可运行以下命令：

​
kepler device run-cmd

要在特定设备上运行命令，可运行以下命令：

​
kepler device running-apps

要列出正在设备上运行的所有应用，可运行以下命令：
例如，要查看在虚拟设备上运行的所有应用的列表，可运行以下命令：

​
kepler device shell

要在设备上启动shell会话，可运行以下命令：

​
kepler device start-log-stream

要开始从设备流式传输日志，可运行以下命令：

​
kepler device stop-log-stream

要停止从设备流式传输日志，可运行以下命令：

​
kepler device start-port-forwarding

要启动设备的正向或反向端口转发，可运行以下命令：

​
kepler device stop-port-forwarding

要停止设备的正向或反向端口转发，可运行以下命令：

​
kepler device terminate-app

要使用应用名称终止设备上的应用，可运行以下命令：
要使用项目目录终止设备上的应用，可运行以下命令：
示例：

​
kepler device uninstall-app

要使用应用名称从设备上卸载应用，可运行以下命令：
要使用项目目录在设备上卸载应用，可运行以下命令：
示例：

​
Vega虚拟设备命令

​
kepler virtual-device status

要查找虚拟设备的状态，可运行以下命令：

​
kepler virtual-device start

要启动模拟器，可运行以下命令：
终端显示以下消息：

​
kepler virtual-device stop

要停止模拟器，可运行以下命令：

​
相关主题

最后修改于 2026年10月26日