as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
设备
构建
测试
应用发布
相关资源
文档

Share:

Edit the Blog Post Header component above this, then place your content here, then fill out the Related Articles section below, if possible. You should have at least one related article and ideally, all three.

Feel free to add supplementary content to the sidebar at right, but please retain the Twitter component (it can live at the bottom of your added content). 

This text component can be edited or deleted as necessary.

Related Articles

Related article title here

Related articles only have an image (the squarer version of the banner) and a title. This text can be deleted. Place 1-3 related articles.

Subscribe

Vega OS开发入门

Amazon Developer Jul 13, 2026
Share:
Vega Fire TV How to
Blog_Header_Post_Img

Fire TV有一个新的操作系统Vega OS。您可能听说过亚马逊基于Linux的Fire TV设备平台,并考虑过针对它进行构建。无论您是已经开发过应用,还是对亚马逊应用商店一无所知,本指南都会引导您入门。

Vega OS在底层使用React Native,所以如果您以前使用过这个框架,您会有非常熟悉的感觉。如果您未曾使用过,那也没关系:Vega开发者工具能够处理项目设置、构建、打包和调试,这样您就可以专注于自己的应用,而不是设置。

在本指南末尾,您将设置开发环境,连接Fire TV设备,并从中构建一个可用的Hello World应用。

先决条件

以下是安装Vega开发者工具的先决条件以及您需要遵循的内容:

(如果您手上没有Fire TV Stick 4K Select,可以使用随SDK安装的Vega虚拟设备 (VVD)。本指南中的所有内容都适用于VVD,但我们建议您在开始构建生产应用时使用实际硬件。)

如果您是React Native的新手,那么React Native文档(仅提供英文版)将帮助您上手,便于您遵照说明进行操作。

安装Vega开发者工具

Vega开发者工具 (VDT) 的单个安装脚本已设置好您需要的一切。遵照开发者技术文档,或者直接运行脚本:

Copied to clipboard
$ curl -fsSL https://sdk-installer.vega.labcollab.net/get_vvm.sh \
  | bash && source ~/vega/env

安装程序将引导您选择安装目录并确认要安装的内容。

Copied to clipboard
✨ 来自Vega的问候!✨
此脚本会下载并安装Vega CLI。
…
➡️ 安装Vega SDK版本0.23.8128?[是/否](按Enter键表示是):
…
正在安装SDK...
正在安装VVD...
安装完成。版本0.23.8128已安装。
➡️ 将Vega Studio安装到Visual Studio Code中?[是/否]?(按Enter键表示是):
…
✔ 已通过市场安装Vega Studio VSCode扩展

安装程序完成后,您将获得:

  • Vega CLI工具,用于构建、部署和管理设备
  • 最新的SDK,包括Vega虚拟设备 (VVD),一个用于在没有物理设备的情况下对Vega应用进行本地测试的模拟器
  • Vega Studio,一个VS Code扩展,将Vega命令添加到命令面板中(项目创建、构建、安装、启动)
  • Shell配置更新,因此vega命令在新的终端会话中可用

安装完成后,验证其是否能正常工作:

Copied to clipboard
$ vega --version
有效的SDK版本: 0.23.8128
Vega CLI版本: 1.3.2

您将看到有效SDK版本和Vega CLI版本都输出到您的终端上。如果找不到该命令,请运行source ~/vega/env以重新加载shell配置,或打开一个新的终端。

Vega CLI为您提供了管理项目和终端中连接的Fire TV设备所需的所有命令。但是,如果您通常在IDE中工作,那么Vega Studio扩展会将这些命令方便地包装在VS Code接口中。在本文的其余部分,我们将重点介绍Vega Studio方法,我们推荐这种方法以获得更轻松的开发体验。

要确认Vega Studio在VS Code中处于活动状态,请打开命令面板并键入“Vega”。 您应该会看到Vega命令出现。

如果您需要重新安装或手动安装Vega Studio,可以使用VS Code市场(仅提供英文版)或按照指南进行操作。

启动Vega虚拟设备

要启动VVD,请在VS Code的Vega Studio扩展的Devices(设备)部分找到它。单击图标以启动VVD。

Vega Studio将在您的计算机上启动一个新窗口。

连接您的Fire TV Stick 4K Select
 

如果您已经设置并连接了Fire TV Stick 4K Select,那么您还将在Vega Studio扩展的Devices部分看到它。

构建您的首个Vega OS应用: Hello World

您的环境已设置,设备已连接。现在,是时候进行构建工作了。您在这里有两个途径,一切都取决于您喜欢的工作方式: 带有Vega Studio的VS Code或者AI辅助的工作流程。

带有Vega Studio的VS Code

打开VS Code命令面板并选择Vega Create New Project(Vega:创建新项目)。

选择Hello World模板。

为项目选择一个本地文件夹,然后为项目指定应用名称和程序包名称。脚手架将创建此项目的所有文件。

在Vega Studio扩展窗格中,在项目名称旁边,您将看到三个图标。

这三个图标代表用于以下几项的快捷操作:

  • 构建此Vega项目: 运行npmnpx命令来构建React Native项目,最终在项目build文件夹的子文件夹中生成一个VPKG文件。
  • 将它安装在您的目标设备上: 运行vega device install-app,将VPKG文件安装到您的目标设备(即Vega Studio扩展的Devices部分中选择的设备)。
  • 通过构建和安装运行项目: 如果需要,构建项目,然后将其安装到目标设备。最后,运行vega device launch-app,以在设备上运行该应用。

单击以在目标设备上构建、安装和运行项目。

构建项目时,您可以从“Debug”(调试)或“发布”(Release)构建模式中进行选择。调试模式包括调试工件,并允许实时代码更新。发布模式创建了优化的、可用于生产的代码,删除了开发和调试功能,从而减小了文件大小。

请注意Output(输出)窗格,因为它显示了除VS Code之外的等效Vega CLI命令,如果您在命令行手动构建项目,您将使用这些命令。

您将在设备上看到安装的应用,无论是您连接的Fire TV Stick 4K还是VVD

替代路径: AI辅助的工作流程

从第一行代码开始,就可以在编辑器中使用Amazon Devices Builder Tools for AI-Powered Development (ADBT) 置入的Vega智能工具。它了解SDK并遵循经过验证的模式,同时适应您正在构建的内容。您可以在线提问,并获得基于实际Vega模式的答案,而不是每隔几分钟切换到文档的上下文。

您仍然需要安装Vega SDK,因为MCP服务器将您的AI助手连接到您计算机上的SDK和CLI工具。

首先在您的计算机上安装Amazon Devices Builder Tools MCP。

Copied to clipboard
$ npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest \
  --init-context

您将看到各种AI工具的选项,包括Claude Code、GitHub Copilot和Kiro。选择要安装代理的位置。

Copied to clipboard
此工具安装Vega App开发上下文文档,并在项目中为您的AI代理设置MCP配置。
…

选择AI代理 (1-8):

对于本指南中的示例,我们将选择Claude Code。

Copied to clipboard
…
🎉 已成功初始化Claude Code上下文!

 摘要:
   代理: Claude Code
   文件:/home/devuser/project/CLAUDE.md

📚 后续步骤:
   1.审核生成的文件:/home/devuser/project/CLAUDE.md
   2.根据需要为项目自定义内容
   3.开始在特定于Vega的上下文中使用Claude Code

当您打开Claude Code时,它将检测到新的MCP服务器。

Copied to clipboard
~/project$ claude

  在.mcp.json: amazon-devices-buildertools中未找到新的MCP服务器

  MCP服务器可以执行代码或访问系统资源。所有工具调用都需要批准。在MCP文档中了解更多信息。

现在,代理已安装在Claude Code中,要使用Vega SDK是非常简单的。MCP服务器将您的提示转换为相应的Vega CLI命令,并在您的项目中执行它们。                                                                              

Copied to clipboard

❯ 帮我建立一个Vega hello world应用项目。

● 已找到manifest.toml文件 — 平台为Vega。加载Vega 
  已调用amazon-devices-buildertools-mcp(使用ctrl+o进行扩展)

…

以下是使用当前目录中的helloWorld模板生成新项目的建议命令:

  vega project generate \
    --template helloWorld \
    --name HelloWorldViaClaude \
    --packageId com.example.helloworldviaclaude \
    --outputDir .

…

您是否想调整这些值中的任何一个,或者我应该运行此命令?

❯ 运行此命令。然后在VVD上构建、安装和运行此应用。

…
● 您的Vega项目已准备就绪。我将启动VVD并且并行安装依赖项,然后构建和部署。

…
● 应用正在VVD上运行。 以下是完成的操作:

  1.启动VVD -- 成功启动
  2. npm安装 -- 安装依赖项
  3.构建 -- 为aarch64、armv7和x86_64完成了调试构建
  4.安装 -- helloworldviaclaude_x86_64.vpkg已在VVD上安装
  5.启动 -- com.example.helloworldviaclaude.main正在运行

在AI工具中使用MCP服务器还可以帮助您熟悉在没有AI辅助的情况下手动开发时使用的Vega CLI命令。

Copied to clipboard
❯ 我的机器当前连接了哪些Fire TV设备?                               

…

● 连接了两个设备:

  1.实体Fire TV -- 序列号: GT533M01234567K8,设备ID: A1TGF7GBNNZ9EE
  2.Vega虚拟设备 -- x86_64,序列号:amazon-d82a77d000723901

❯ 在我的物理设备上安装并运行应用。

…

● 应用已安装并在您的实体Fire TV (GT533M01234567K8) 上运行。

后续步骤

无论您是使用VS Code还是AI编码助手,现在都可以在Vega上构建更大、更复杂的应用。以下是一些建议的开始方式:

  • 浏览其他示例应用。 我们保留了几个Vega示例应用,展示了各种功能和开发模式。用这些示例进行尝试,以了解不同的模式、焦点管理方法、媒体控制集成和内容类型。
  • 浏览Vega文档。从焦点管理和视频播放到性能优化,以及将应用发布到亚马逊应用商店,Vega开发者文档都可为您提供参考。
  • 通过AI辅助进行构建。当您超出Hello World范畴时,用于AI辅助式开发的Amazon Devices Builder Tools (ADBT) 提供了性能调试、崩溃调试和媒体播放器开发的工作流程。它可用于Claude Code、Cursor、GitHub Copilot、Kiro和其他AI编码代理。
  • 加入开发者社区。Vega Open Beta社区空间(仅提供英文版)是我们发布SDK发布说明、路线图更新和文档提示以及开发者问答、错误报告和功能请求的地方。这是获得平台特定问题答案的最佳去处。

相关文章

最新文章

 

查看有关亚马逊应用商店、应用开发与盈利、亚马逊服务以及更多主题的最新消息。