在Vega虚拟设备或Fire TV Stick上运行您的应用

Learn how to use Vega Virtual Device or a Fire TV device to run your Vega apps. Each tool serves different development needs: Vega Virtual Device for rapid iterations and Fire TV设备 for production-ready execution.

Vega Virtual Device
Fire TV设备

在Vega虚拟设备上运行您的应用

Vega开发者工具 (VDT) 采用Vega虚拟设备，让您可在没有物理设备的情况下测试和运行Vega应用，为您提供以下控制选项：

直接在虚拟设备上进行鼠标交互
虚拟遥控器界面
键盘快捷键和命令

先决条件

安装Vega SDK。
一款准备好进行测试的Vega应用。您可以使用通过Vega SDK项目模板创建的应用，或使用从示例应用下载的应用，也可以使用自己构建的应用。
（可选）注册您的Vega虚拟设备以使用亚马逊服务进行测试。

步骤1：启动Vega虚拟设备

在命令提示符下，运行：

kepler virtual-device start

该命令将一直等到Vega虚拟设备启动。

Launching default instance.
Waiting for virtual device to boot.
Launch process complete.
Virtual device shell available.
Virtual device ready.

Vega虚拟设备可能：

在首次启动时请求麦克风访问权限。
启动期间超时。如果需要，使用--timeout标记来延长等待时间。

启动Vega虚拟设备后，Vega虚拟设备用户界面将在新窗口中打开。

步骤2：加载并运行您的应用

要在Vega虚拟设备上加载和运行您的应用，请运行以下命令：

kepler run-kepler <vpkg-path> <app-id> -d VirtualDevice

-d标记指定您在Vega虚拟设备上运行应用。要在Fire TV Stick上加载和运行您的应用，请运行以下命令：

kepler run-kepler <vpkg-path> <app-id> -d <Device Serial Number>

请务必：

将替换为您应用的vpkg文件路径
将替换为您的应用ID
将替换为您的Fire TV Stick序列号

在Vega虚拟设备上停止应用的选项

虚拟程序包 (vpkg) 的架构必须与开发计算机的架构相匹配才能正常执行。例如：您可以使用Vega Studio的用户界面或命令行停止您的Vega应用。

kepler run-kepler build/aarch64-release/keplersampleapp_aarch64.vpkg com.amazondeveloper.keplersampleapp.main -d VirtualDevice

x86_64设备：

kepler run-kepler build/x86_64-release/keplersampleapp_x86_64.vpkg com.amazondeveloper.keplersampleapp.main -d VirtualDevice

步骤3：停止虚拟设备

要停止Vega虚拟设备，请关闭虚拟设备窗口，或运行：

kepler virtual-device stop

可选配置

注册Vega虚拟设备（仅当您使用亚马逊服务进行测试时）

要使用亚马逊服务进行测试，请注册您的Vega虚拟设备。当您看到Vega虚拟设备已启动时，请按照以下步骤操作：

点击右上角的“Register this device”（注册此设备）。
记下屏幕上显示的注册码。
前往www.amazon.com/code并输入验证码。查找此消息以确认注册：

Your device has successfully been registered

启动时自定义Vega虚拟设备

Vega虚拟设备在启动时提供自定义选项。运行启动命令时：

禁止图形用户界面 (GUI)：
kepler virtual-device start --no-gui

关闭OpenGL加速（仅限Ubuntu x86）：

kepler virtual-device start --no-gl-accel

修改默认显示分辨率：

kepler virtual-device start --display-res=1920,1080

启用开发者模式以获得完整的inputd-cli功能

默认情况下，Vega虚拟设备提供有限的inputd-cli命令。启用开发者模式以访问用于自动化和测试的完整命令集：

打开虚拟设备的shell：
kepler device shell -d VirtualDevice
启用开发者模式：
vsm developer-mode enable
执行此命令后，VVD将重新启动。重复步骤1以重新连接到虚拟设备的shell。

验证完整功能：

inputd-cli --help

键盘快捷键

使用以下键盘快捷键控制Vega虚拟设备，而不是用鼠标单击：

Fire TV Stick遥控器按钮	Vega虚拟设备键盘按键
Select（选择）	ENTER（回车键）
Up, Down, Right, Left（向上、向下、向右、向左）	Arrow keys（箭头键）
Back（后退）	ESC（退出键）
Homepage（主页）	F1
Menu（菜单）	F2
快退	F3
Play/Pause（播放/暂停）	F4
Fast Forward（快进）	F5

设置快速刷新

要自动检测代码更改并在Vega虚拟设备上实时显示更新，您可以设置快速刷新。

故障排除

如果您遇到Vega虚拟设备问题，请参阅解决Vega虚拟设备问题。

在Fire TV Stick上运行您的应用

警告：如果不能通过计算机USB接口获得充足电力，Fire TV Stick可能会重新启动。如果您遇到此问题，请参阅解决Fire TV Stick问题。

先决条件

安装Vega SDK。
确保您已安装最新的SDK管理器（运行vega update以获取最新版本）。
运行Vega OS的Fire TV设备（例如Fire TV Stick HD、Fire TV Stick 4K Select或Fire TV流媒体播放器）。有关受支持设备的完整列表，请参阅Fire TV设备规格。

步骤1：设置并注册您的Fire TV设备。

继续操作前，请确保您使用的是Fire TV设备随附的遥控器。在开发和测试过程中，使用其他Fire TV设备随附的遥控器会导致配对问题。

连接Fire TV设备： a. 使用USB数据线连接到您的开发计算机。 b. 使用HDMI适配器连接到显示器。显示遥控器配对屏幕。
完成遥控器配对： a. 出现提示时，按Home（主页）按钮。 b. 按照屏幕上的指示进行操作。 c.等待Fire TV标志出现。如果数分钟内未出现Fire TV标志，请参阅解决Fire TV Stick问题，了解故障排除步骤。
配置设置： a. 按遥控器上的播放/暂停按钮。 b. 选择您的首选语言。 c. 连接到您的网络。 d. 输入您的网络凭证。
完成设备注册： a. 在线或通过二维码登录您的亚马逊账户。 b. 按照屏幕上的指示进行操作。 c. 等待“Successfully registered”（成功注册）消息出现。
当您看到“Your Fire TV remote is now successfully set up”（您的Fire TV遥控器现已成功设置）时按OK（确定）。

步骤2：配置开发者模式

开发者模式要求您使用Vega CLI，通过亚马逊开发者账户进行身份验证。此流程包括从Fire TV设备获取验证码，然后通过浏览器完成身份验证，最后在终端中完成设备启用。启用后，设备会自动重启。

访问Fire TV Settings（设置）菜单： 选项1：使用Home按钮 a. 按下遥控器上的Home按钮进入Home屏幕。 b. 导航到顶部菜单栏。 c. 向右滚动查找并选择Settings图标（齿轮符号）。 选项2：使用Home按钮快捷方式（速度更快） a. 长按遥控器上的Home按钮3秒钟。 b. 从出现的快捷菜单中选择Settings（设置）。
前往Settings（设置）> My Fire TV（我的Fire TV）> About（关于）。
选择您的设备名称（例如Fire TV Stick HD、Fire TV Stick 4K Select或Fire TV流媒体播放器）。
连按遥控器上的中心按钮七次。按完七次后，屏幕上显示简短通知，内容为“You are now a developer”（您已成为开发者）。
按返回按钮，返回My Fire TV（我的Fire TV）。 Developer Options（开发者选项）出现在列表中。
选择Developer Options（开发者选项）。 Developer Mode（开发者模式）（默认禁用）出现在菜单列表中。
选择Developer Mode（开发者模式），继续操作。
选择Continue（继续），继续操作（或选择Cancel（取消），中止操作）。如果选择Cancel（取消），则对话框关闭，您将返回Developer Options（开发者选项）屏幕，不作任何更改。选择Continue（继续）后，Fire TV屏幕上会显示一个6位验证码。第11步会用到此验证码。
要通过亚马逊开发者账户进行身份验证，请运行登录命令：
vega devmode login
按照CLI操作说明完成身份验证。CLI会自动打开默认的网页浏览器，并导航至亚马逊身份验证页面。如果浏览器未自动打开，则手动导航至终端所提供的URL。
在浏览器中授权Vega CLI访问。亚马逊OAuth同意屏幕上显示“Vega Authentication Test would like access to:”（Vega身份验证测试想要访问以下内容：），同时列出您的基本个人资料信息和姓名。 a.查看请求的权限。 b. 选择Allow（允许），授权Vega身份验证测试（或选择Cancel（取消），拒绝授权）。如果选择Cancel（取消），CLI会拒绝授权并提示身份验证错误。请重新运行vega devmode login命令，再试一次。选择Allow（允许）后，屏幕上会显示带有勾号图标的确认页面，以及内容为“Device connected to your account”（设备已连接至您的账户）的消息。您可以关闭此页面。返回终端。CLI会显示：
Login successful! You are now authenticated with Amazon Developer Services.
输入Fire TV屏幕上显示的6位验证码以启用设备：
vega devmode enable-device --code <6位验证码>
如果亚马逊开发者账户只有一个供应商，CLI会显示：
Using vendor: Amazon ✓ Device enabled successfully
如果账户有多个供应商，CLI会提示您从中选择一个：
Select a vendor: 1. Amazon (XXXXXXXXXX) 2. Amazon (XXXXXXXXXX)
输入供应商对应编号。随后，CLI会显示✓ Device enabled successfully（✓设备已成功启用）。
等待设备重启。
设备重启后，导航至Settings（设置）> My Fire TV（我的Fire TV）> Developer Options（开发者选项）> Developer Mode（开发者模式）。 Developer Mode（开发者模式）的状态显示为Enabled（已启用）。

检查设备识别。

vega device list

连接一台设备时的输出示例：

Found the following device：
[序列号] : [设备号]

连接多台设备时的输出示例：

Found the following devices:
[序列号] : [设备号]
[序列号] : [设备号]

连接到设备。

如果您连接了一台设备：
vega device shell

如果您连接了多台设备，请指定设备序列号：

vega device -d <设备序列号> shell

输出示例：

 (hostmachine)% vega device -d <设备序列号> shell

 ##################################################

 ##### Welcome to Developer Mode Shell #####

 ##################################################

 sh(com.amazon.dev.shell):/$

步骤4：在Fire TV Stick上加载您的应用

在Fire TV Stick上配置开发者模式后，要加载应用，请打开新终端并使用以下命令：找到你的.vpkg文件当您使用vega build应用程序时，.vpkg文件将在项目的build/目录中生成。路径遵循以下模式：

build/<ARCH>-<BUILD_TYPE>/<APP_NAME>_<ARCH>.vpkg

对于Fire TV Stick，使用armv7架构。例如，如果您的应用程序名为sampleapp，并且您构建了发布变体版本：

build/armv7-release/sampleapp_armv7.vpkg

一台设备已连接到您的计算机将<my-package.vpkg>替换为您.vpkg文件的路径。

vega device install-app --packagePath build/armv7-release/sampleapp_armv7.vpkg

多台设备已连接到您的计算机使用以下命令指定目标设备。将替换为您设备的序列号并将替换为您.vpkg文件的路径。

vega device -d <Device Serial Number> install-app --packagePath build/armv7-release/sampleapp_armv7.vpkg

输出示例：

Installing/Updating '/tmp/sampleapp_armv7.vpkg' .. success

步骤4：在Fire TV上运行应用

在Fire TV设备上加载应用后，使用以下命令运行应用。一台设备已连接到您的计算机

vega device launch-app --appName <组件ID>

多台设备已连接到您的计算机使用以下命令指定目标设备。将替换为您设备的序列号并将替换为您应用的组件ID。

vega device -d <设备序列号> launch-app --appName <组件ID>

输出示例：

(hostmachine)% vega device -d <设备序列号> launch-app --appName com.amazondeveloper.sampleapp
Launching app 'com.amazondeveloper.sampleapp' .. success

如果您在使用Fire TV Stick时遇到问题，请参阅解决Fire TV Stick问题。

开发 Vega 应用

在Vega虚拟设备或Fire TV Stick上运行您的应用

在Vega虚拟设备上运行您的应用

先决条件

步骤1：启动Vega虚拟设备

步骤2：加载并运行您的应用

在Vega虚拟设备上停止应用的选项

步骤3：停止虚拟设备

可选配置

注册Vega虚拟设备（仅当您使用亚马逊服务进行测试时）

启动时自定义Vega虚拟设备

启用开发者模式以获得完整的inputd-cli功能

键盘快捷键

设置快速刷新

故障排除

在Fire TV Stick上运行您的应用

先决条件

步骤1：设置并注册您的Fire TV设备。

步骤2：配置开发者模式

步骤4：在Fire TV Stick上加载您的应用

步骤4：在Fire TV上运行应用

相关主题

​在Vega虚拟设备上运行您的应用

​先决条件

​步骤1： 启动Vega虚拟设备

​步骤2： 加载并运行您的应用

​在Vega虚拟设备上停止应用的选项

​步骤3：停止虚拟设备

​可选配置

​注册Vega虚拟设备（仅当您使用亚马逊服务进行测试时）

​启动时自定义Vega虚拟设备

​启用开发者模式以获得完整的inputd-cli功能

​键盘快捷键

​设置快速刷新

​故障排除

​在Fire TV Stick上运行您的应用

​先决条件

​步骤1：设置并注册您的Fire TV设备。

​步骤2：配置开发者模式

​步骤4：在Fire TV Stick上加载您的应用

​步骤4：在Fire TV上运行应用

​相关主题

在Vega虚拟设备上运行您的应用

先决条件

步骤1：启动Vega虚拟设备

步骤2：加载并运行您的应用

在Vega虚拟设备上停止应用的选项

步骤3：停止虚拟设备

可选配置

注册Vega虚拟设备（仅当您使用亚马逊服务进行测试时）

启动时自定义Vega虚拟设备

启用开发者模式以获得完整的inputd-cli功能

键盘快捷键

设置快速刷新

故障排除

在Fire TV Stick上运行您的应用

先决条件

步骤1：设置并注册您的Fire TV设备。

步骤2：配置开发者模式

步骤4：在Fire TV Stick上加载您的应用

步骤4：在Fire TV上运行应用

相关主题