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

在Fire TV上运行应用

在提交到亚马逊应用商店之前，在Fire TV设备上运行Vega应用对于测试真实设备性能和确保兼容性至关重要。本部分将引导您设置用于开发的Fire TV设备、启用开发者模式以及侧载Vega应用进行测试。

开发者模式让您可以在设备上侧载应用和测试开发版本。所有Vega Fire TV设备都使用相同的开发者模式启用流程。

先决条件

1. 安装Vega SDK。
2. 确保安装了最新的SDK管理器（运行vega update以获取最新版本）。

3. 运行Vega OS的Fire TV设备（例如Fire TV Stick HD、Fire TV Stick 4K Select或Fire TV流媒体播放器）。

   有关受支持设备的完整列表，请参阅Fire TV设备规格。

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

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

1. 连接Fire TV设备：

   a.使用USB数据线连接到您的开发计算机。

   b. 使用HDMI适配器连接到显示器。

   显示遥控器配对屏幕。

2. 完成遥控器配对：

   a. 出现提示时，按Home（主页）按钮。

   b. 按照屏幕上的指示进行操作。

   c. 等待Fire TV标志出现。

   如果数分钟内未出现Fire TV标志，请参阅解决Fire TV Stick问题，了解故障排除步骤。

3. 配置设置：

   a. 按遥控器上的播放/暂停按钮。

   b. 选择您的首选语言。

   c. 连接到您的网络。

   d. 输入您的网络凭证。

   警告： 设备检查无线 (OTA) 更新。在更新完成之前，请勿关闭设备电源或重新启动设备。中断更新可能会导致无法发现网络。

4. 完成设备注册：

   a. 在线或通过二维码登录您的亚马逊账户。

   b. 按照屏幕上的指示进行操作。

   c. 等待“Successfully registered”（成功注册）消息出现。

5. 当您看到“Your Fire TV remote is now successfully set up”（您的Fire TV遥控器现已成功设置）时按OK（确定）。

步骤2： 配置开发者模式

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

1. 访问Fire TV Settings（设置）菜单：

   选项1： 使用Home按钮

   a. 按下遥控器上的Home按钮进入Home屏幕。

   b. 导航到顶部菜单栏。

   c. 向右滚动查找并选择Settings图标（齿轮符号）。

   选项2： 使用Home按钮快捷方式（速度更快）

   a. 长按遥控器上的Home按钮3秒钟。

   b. 从出现的快捷菜单中选择Settings（设置）。

2. 前往Settings（设置）> My Fire TV（我的Fire TV）> About（关于）。

   

3. 选择您的设备名称（例如Fire TV Stick HD、Fire TV Stick 4K Select或Fire TV流媒体播放器）。

   

4. 连按遥控器上的中心按钮七次。

   按完七次后，屏幕上显示简短通知，内容为“You are now a developer”（您已成为开发者）。

5. 按返回按钮，返回My Fire TV（我的Fire TV）。

   Developer Options（开发者选项）出现在列表中。

   

6. 选择Developer Options（开发者选项）。

   Developer Mode（开发者模式）（默认禁用）出现在菜单列表中。

   

7. 选择Developer Mode（开发者模式），继续操作。

   

8. 选择Continue（继续），继续操作（或选择Cancel（取消），中止操作）。

   如果选择Cancel（取消），则对话框关闭，您将返回Developer Options（开发者选项）屏幕，不作任何更改。

   选择Continue（继续）后，Fire TV屏幕上会显示一个6位验证码。第11步会用到此验证码。

   

   注意： 验证码有效期为5分钟。如未在指定时间内输入代码，请在同一屏幕上选择Request a New Code（申请新验证码），或返回Developer Options（开发者选项），重新执行该流程。

9. 要通过亚马逊开发者账户进行身份验证，请运行登录命令：

   复制代码 已复制到剪贴板。

    vega devmode login
   

   按照CLI操作说明完成身份验证。CLI会自动打开默认的网页浏览器，并导航至亚马逊身份验证页面。如果浏览器未自动打开，则手动导航至终端所提供的URL。

10. 在浏览器中授权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.
    

11. 输入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（✓设备已成功启用）。

    注意： 供应商即开发者账户，通过亚马逊开发者服务进行内容管理与发布。该身份验证流程可能需要数秒时间，才能同步到设备端。

12. 等待设备重启。

    

13. 设备重启后，导航至Settings（设置）> My Fire TV（我的Fire TV）> Developer Options（开发者选项）> Developer Mode（开发者模式）。

    Developer Mode（开发者模式）的状态显示为Enabled（已启用）。

    

14. 检查设备识别。

    复制代码 已复制到剪贴板。

    vega device list
    

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

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

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

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

15. 连接到设备。

    • 如果您连接了一台设备：

      复制代码 已复制到剪贴板。

      vega device shell
      

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

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

      输出示例：

       (hostmachine)% vega device -d <设备序列号> shell
      
       ##################################################
      
       ##### Welcome to Developer Mode Shell #####
      
       ##################################################
      
       sh(com.amazon.dev.shell):/$
      

步骤3： 在Fire TV设备上加载应用

在Fire TV设备上配置开发者模式后，要加载应用，请打开新终端并使用以下命令：

找到您的.vpkg文件

在使用vega build构建应用的过程中，项目的build/目录中会生成.vpkg文件。路径遵循以下模式：

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

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

build/armv7-release/sampleapp_armv7.vpkg

一台设备已连接到您的计算机

将<my-package.vpkg>替换为您.vpkg文件的路径。

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

多台设备已连接到您的计算机

使用以下命令指定目标设备。将<设备序列号>替换为您设备的序列号并将<my-package.vpkg>替换为您.vpkg文件的路径。

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

输出示例：

安装/更新  “/tmp/sampleapp_armv7.vpkg”... 成功

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

在Fire TV设备上加载应用后，使用以下命令运行应用。

一台设备已连接到您的计算机

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

多台设备已连接到您的计算机

使用以下命令指定目标设备。将<设备序列号>替换为您设备的序列号并将<组件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屏幕上。