先决条件
在开始之前,请确保您已具备:- 亚马逊开发者账户(身份验证必需): 如果没有,请注册一个。
- 装有Vega CLI的开发计算机: 通过
vega --version进行验证。如未安装,请参阅安装Vega SDK。 - 最新版本的SDK管理器: 运行
vega update以获取最新版本。请参阅Vega SDK管理器。 - 运行Vega OS的Fire TV设备,且与您的计算机连接至同一网络。有关受支持设备的完整列表,请参阅Fire TV设备规格。
对Fire TV的开发者模式进行身份验证
开发者模式要求您使用Vega CLI,通过亚马逊开发者账户进行身份验证。此流程包括从Fire TV设备获取验证码,然后通过浏览器完成身份验证,最后在终端中完成设备启用。启用后,设备会自动重启。- 访问Fire TV设置菜单: 选项1: 使用“主页”按钮 a. 按下遥控器上的主页按钮进入主页屏幕。 b. 导航到顶部菜单栏。 c. 向右滚动查找并选择设置图标(齿轮符号)。 选项2: 使用“主页”按钮快捷方式(速度更快) a. 长按遥控器上的主页按钮3秒钟。 b. 从出现的快捷菜单中选择设置(设置)。
-
转到设置 > My Fire TV(我的Fire TV)> 关于。
-
选择您的设备名称(例如Fire TV Stick HD、Fire TV Stick 4K Select或Fire TV流媒体播放器)。
- 连按遥控器上的中心按钮七次。 按完七次后,屏幕上显示简短通知,内容为“You are now a developer”(您已成为开发者)。
-
按返回按钮,返回My Fire TV。
开发者选项出现在列表中。
-
选择开发者选项。
Developer Mode(开发者模式)(默认禁用)出现在菜单列表中。
-
选择Developer Mode,继续操作。
-
选择Continue,继续操作(或选择Cancel,中止操作)。
如果选择Cancel,则对话框关闭,您将返回开发者选项屏幕,不作任何更改。
选择Continue后,Fire TV屏幕上会显示一个6位验证码。第11步会用到此验证码。
-
要通过亚马逊开发者账户进行身份验证,请运行登录命令:
按照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会显示: -
输入Fire TV屏幕上显示的6位验证码以启用设备:
如果亚马逊开发者账户只有一个供应商,CLI会显示:如果账户有多个供应商,CLI会提示您从中选择一个:输入供应商对应编号。然后CLI会显示
✓ Device enabled successfully。 -
等待设备重启。
-
设备重启后,导航至设置 > My Fire TV > 开发者选项 > Developer Mode。
Developer Mode的状态显示为Enabled(已启用)。
-
检查设备识别。
连接一台设备时的输出示例:连接多台设备时的输出示例:
-
连接到设备。
-
如果您连接了一台设备:
-
如果您连接了多台设备,请指定设备序列号:
输出示例:
-
如果您连接了一台设备:
禁用开发者模式
使用与启用时相同的Developer Mode设置关闭开发者模式。设备在此过程中会重新启动。- 转到设置 > My Fire TV > 开发者选项。
-
选择Developer Mode。
将出现Disable Developer Mode(禁用开发者模式)对话框。
- 选择Continue,继续操作(或选择Cancel,中止操作)。 如果选择Cancel,对话框会关闭,Developer Mode保持启用状态。
- 等待设备重启。 重新启动后,Developer Mode状态会显示Disabled。
注销Fire TV设备
要将Fire TV设备从您的亚马逊账户中移除,请执行恢复出厂设置。恢复出厂设置会将设备从您的亚马逊账户中退出登录、注销该设备,并禁用Developer Mode。- 转到设置 > My Fire TV > Reset to Factory Defaults(恢复出厂设置)。
- 选择Reset(重置)并确认。 系统会显示一条警告,提示重置会将设备从您的亚马逊账户中退出登录。
- 等待设备重新启动。 设备会重新启动到初始设置屏幕,并且不再注册到您的亚马逊账户。
开发者模式状态
开发者模式可在启用、身份验证和禁用状态下运行。 启用状态enable状态表示全部开发者功能都已激活,包括vsh shell访问、通过vpm进行程序包管理以及组件调试功能。
身份验证状态
authenticating状态表示系统正在验证是否拥有启用开发者模式的权限。
禁用状态
disable状态下,系统会限制对标准用户功能的访问权限。
开发工具
开发者模式提供对用于程序包部署、组件管理和文件操作等核心工具的访问权限。请在正确的上下文中使用,并确保具备相应权限。Vega CLI
在您的设备上,使用Vega命令行界面 (CLI) 命令来安装、卸载和管理程序包。支持以下程序包操作:com.amazon前缀的程序包)。
组件管理
要启动、列出和终止您的应用组件,请使用vega device组件管理命令。键盘命令如下:
文件操作
使用文件操作在开发计算机和设备之间传输文件。默认shell仅允许访问/tmp目录,而组件shell可以访问其特定的目录。始终在传输后验证您的文件权限,并移除不再需要使用的临时文件,以维护设备存储空间。请记住,文件路径需要区分大小写。组件shell使用vega exec vda shell,因为vega device shell仅连接到默认shell,无法定位到组件。
删除文件时,请记住执行以下操作:
-
仅删除从默认开发shell推送到
/tmp的文件。 -
使用以下方法,删除特定组件shell的中的文件:
- 使用以下方法进入组件shell:
vega exec vda shell -t component-id com.myorg.myapp.main - 导航到
/scratch目录,该目录是组件shell内的绑定挂载:
默认shell推送组件shell推送例如:查找组件清单输出示例:查找设备上安装的程序包清单输出示例:启动组件shell查看推送的文件输出示例:从设备中拉取 - 使用以下方法进入组件shell:
最佳实践
使用开发者模式时,在常规开发工作流程中采取以下做法,以防发生意外的系统修改:- 仅侧载具有非亚马逊程序包ID的应用(确认您的程序包ID不是以
com.amazon开头)。 - 使用任务所需的最低访问级别。
- 遵循最小权限原则。
- 请注意,您的操作可能会影响设备的稳定性和安全性。
故障排除和支持
开发过程中出现问题时,首先确定受影响的方面(身份验证、shell访问、程序包管理、组件启动或文件操作)。常见问题的原因包括权限不正确或设备状态限制。 如果以下各节中描述的解决方案无法解决您的问题,请在寻求支持之前使用loggingctl log收集相关日志。
身份验证问题
常见开发问题
调试工具
使用loggingctl log收集系统日志并监控组件状态。根据您的设备状态,每个调试工具都有特定的访问级别。

