as

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

帮助选项

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

退出代码和错误输出

Vega CLI命令成功时返回退出代码0,失败时返回非零退出代码。错误消息会写入stderr。

常用命令

npx react-native build-vega

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

vega clean

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

vega project list-templates

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

vega project generate

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

vega run-app

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

设备命令

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

vega device copy-from

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

vega device copy-logs

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

vega device copy-to

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

vega device get-log-info

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

vega设备信息

要检索JSON格式的设备元数据,包括设备类型、操作系统版本、主机名、架构、配置文件、产品名称、内部版本描述、设备是模拟设备还是物理设备以及开发者模式状态,可运行以下命令:
输出示例:

vega device install

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

vega device installed-apps

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

vega device installed-packages

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

vega device is-app-installed

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

vega device is-app-running

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

vega device is-connected

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

vega device launch-app

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

vega device list

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

vega device reboot

要重启给定设备,可运行以下命令:

vega device run-cmd

要在特定设备上运行命令,可运行以下命令:

vega device running-apps

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

vega device shell

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

vega device start-log-stream

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

vega device stop-log-stream

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

vega device start-port-forwarding

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

vega device stop-port-forwarding

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

vega device terminate-app

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

vega device uninstall-app

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

Vega虚拟设备命令

vega virtual-device status

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

vega virtual-device start

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

vega virtual-device stop

要停止模拟器,可运行以下命令:

相关主题


最后修改于 2026年10月26日