as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
开发者模式(也称为“开发模式”)使您能够在Fire TV设备上侧载应用并调试组件。**您可以通过开发者shell和Vega设备适配器 (VDA) 经由网络或USB接口访问设备。您可以测试应用、访问安全shell、管理程序包、调试组件和访问文件系统。通过亚马逊开发者账户进行身份验证后,方可激活开发者模式,随即会重新启动设备。所有Vega Fire TV设备都使用相同的开发者模式启用流程。本页面还介绍如何禁用开发者模式以及如何从您的亚马逊账户注销设备。 **预计完成时间:**5–10分钟

先决条件

在开始之前,请确保您已具备:
  • 亚马逊开发者账户(身份验证必需): 如果没有,请注册一个。
  • 装有Vega CLI的开发计算机: 通过vega --version进行验证。如未安装,请参阅安装Vega SDK。
  • 最新版本的SDK管理器: 运行vega update以获取最新版本。请参阅Vega SDK管理器。
  • 运行Vega OS的Fire TV设备,且与您的计算机连接至同一网络。有关受支持设备的完整列表,请参阅Fire TV设备规格。

对Fire TV的开发者模式进行身份验证

开发者模式要求您使用Vega CLI,通过亚马逊开发者账户进行身份验证。此流程包括从Fire TV设备获取验证码,然后通过浏览器完成身份验证,最后在终端中完成设备启用。启用后,设备会自动重启。
  1. 访问Fire TV设置菜单: 选项1: 使用“主页”按钮 a. 按下遥控器上的主页按钮进入主页屏幕。 b. 导航到顶部菜单栏。 c. 向右滚动查找并选择设置图标(齿轮符号)。 选项2: 使用“主页”按钮快捷方式(速度更快) a. 长按遥控器上的主页按钮3秒钟。 b. 从出现的快捷菜单中选择设置(设置)。
  2. 转到设置 > My Fire TV(我的Fire TV)> 关于。 屏幕截图显示了“My Fire TV”设置菜单中的“关于”选项。
  3. 选择您的设备名称(例如Fire TV Stick HD、Fire TV Stick 4K Select或Fire TV流媒体播放器)。 屏幕截图显示了“关于”屏幕中的“Fire TV Stick 4K Select”选项。
  4. 连按遥控器上的中心按钮七次。 按完七次后,屏幕上显示简短通知,内容为“You are now a developer”(您已成为开发者)。
  5. 按返回按钮,返回My Fire TV。 开发者选项出现在列表中。 屏幕截图显示了My Fire TV设置菜单中的“开发者选项”条目。
  6. 选择开发者选项。 Developer Mode(开发者模式)(默认禁用)出现在菜单列表中。 屏幕截图显示“开发者选项”中Developer Mode的状态为Disabled(已禁用)。
  7. 选择Developer Mode,继续操作。 屏幕截图显示了Enable Developer Mode(启用开发者模式)确认对话框,其中包含Continue(继续)和Cancel(取消)两个选项。
  8. 选择Continue,继续操作(或选择Cancel,中止操作)。 如果选择Cancel,则对话框关闭,您将返回开发者选项屏幕,不作任何更改。 选择Continue后,Fire TV屏幕上会显示一个6位验证码。第11步会用到此验证码。 屏幕截图显示了Fire TV屏幕上的6位验证码。
  9. 要通过亚马逊开发者账户进行身份验证,请运行登录命令:
    按照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会显示:
  11. 输入Fire TV屏幕上显示的6位验证码以启用设备:
    如果亚马逊开发者账户只有一个供应商,CLI会显示:
    如果账户有多个供应商,CLI会提示您从中选择一个:
    输入供应商对应编号。然后CLI会显示✓ Device enabled successfully。
  12. 等待设备重启。 Fire TV会显示一条通知,提示设备将在3秒后重启。
  13. 设备重启后,导航至设置 > My Fire TV > 开发者选项 > Developer Mode。 Developer Mode的状态显示为Enabled(已启用)。 在“开发者选项”设置中,Developer Mode的状态显示为Enabled。
  14. 检查设备识别。
    连接一台设备时的输出示例:
    连接多台设备时的输出示例:
  15. 连接到设备。
    • 如果您连接了一台设备:
    • 如果您连接了多台设备,请指定设备序列号:
      输出示例:

禁用开发者模式

使用与启用时相同的Developer Mode设置关闭开发者模式。设备在此过程中会重新启动。
  1. 转到设置 > My Fire TV > 开发者选项。
  2. 选择Developer Mode。 将出现Disable Developer Mode(禁用开发者模式)对话框。 屏幕截图显示了Enable Developer Mode确认对话框,其中包含Continue和Cancel两个选项。
  3. 选择Continue,继续操作(或选择Cancel,中止操作)。 如果选择Cancel,对话框会关闭,Developer Mode保持启用状态。
  4. 等待设备重启。 重新启动后,Developer Mode状态会显示Disabled。
禁用Developer Mode后,开发者选项菜单仍保留在设置中。要重新开启开发者模式,请重复对Fire TV的开发者模式进行身份验证中的步骤。

注销Fire TV设备

要将Fire TV设备从您的亚马逊账户中移除,请执行恢复出厂设置。恢复出厂设置会将设备从您的亚马逊账户中退出登录、注销该设备,并禁用Developer Mode。
  1. 转到设置 > My Fire TV > Reset to Factory Defaults(恢复出厂设置)。
  2. 选择Reset(重置)并确认。 系统会显示一条警告,提示重置会将设备从您的亚马逊账户中退出登录。
  3. 等待设备重新启动。 设备会重新启动到初始设置屏幕,并且不再注册到您的亚马逊账户。

开发者模式状态

开发者模式可在启用、身份验证和禁用状态下运行。 启用状态 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,无法定位到组件。 删除文件时,请记住执行以下操作:
  1. 仅删除从默认开发shell推送到/tmp的文件。
  2. 使用以下方法,删除特定组件shell的中的文件:
    • 使用以下方法进入组件shell:vega exec vda shell -t component-id com.myorg.myapp.main
    • 导航到/scratch目录,该目录是组件shell内的绑定挂载:
    默认shell推送
    组件shell推送
    例如:
    查找组件清单
    输出示例:
    查找设备上安装的程序包清单
    输出示例:
    启动组件shell
    查看推送的文件
    输出示例:
    从设备中拉取

最佳实践

使用开发者模式时,在常规开发工作流程中采取以下做法,以防发生意外的系统修改:
  • 仅侧载具有非亚马逊程序包ID的应用(确认您的程序包ID不是以com.amazon开头)。
  • 使用任务所需的最低访问级别。
  • 遵循最小权限原则。
  • 请注意,您的操作可能会影响设备的稳定性和安全性。

故障排除和支持

开发过程中出现问题时,首先确定受影响的方面(身份验证、shell访问、程序包管理、组件启动或文件操作)。常见问题的原因包括权限不正确或设备状态限制。 如果以下各节中描述的解决方案无法解决您的问题,请在寻求支持之前使用loggingctl log收集相关日志。

身份验证问题

常见开发问题

调试工具

使用loggingctl log收集系统日志并监控组件状态。根据您的设备状态,每个调试工具都有特定的访问级别。

相关主题


最后修改于 2026年10月13日