Console

Settings

Sign out

Notifications

Alexa

亚马逊应用商店

Ring

AWS

文档

Support

My Cases

Console

Vega开发者文档

主页

新手入门

设计和开发

应用发布

参考

支持

安装Vega开发者工具

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅最新的发布说明。

Vega开发者工具 (VDT) 是一个套件，包含了开发Vega OS应用所需的所有工具：

Vega SDK: 用于构建Vega OS应用的核心框架和API
Vega SDK管理器：用于管理开发项目的SDK版本的工具。它的工作原理类似于Node.js的nvm或Python的pyenv。有关详细信息，请参阅管理SDK版本。
Vega Studio：一个集成开发环境 (IDE)，用于应用开发、调试、性能分析和应用优化
Vega虚拟设备 (VVD)： 用于运行和测试应用的虚拟设备
库和组件：用于应用开发的其他工具

选择您的安装场景

根据您是首次安装VDT还是更新现有安装，选择相应的选项卡。

首次安装
更新现有安装

本节介绍如何在您的系统上首次安装VDT。

先决条件

在安装VDT之前，请确认您的系统满足以下要求：

系统要求

磁盘空间： 有20GB可用空间于安装VDT和开发环境

检查可用磁盘空间：df -h ~
操作系统：macOS 10.15或更高版本，或是Ubuntu 20.04或更高版本

警告： 不支持Windows和适用于Linux的Windows子系统 (WSL)，也未针对这些系统进行测试。Vega SDK只能在原生macOS或Ubuntu上安装。

所需依赖项

请为您的操作系统安装以下依赖项，然后再继续操作：

macOS依赖项

程序包管理器： 安装Homebrew

开发工具： 下载并安装Node.js（版本18.x或更高版本）

如果已安装Node.js，请检查其版本：

已复制到剪贴板。

   node --version

开发工具： 运行以下命令，以安装Vega开发所需的工具（包括适用于Apple Silicon Mac的Rosetta 2）：

已复制到剪贴板。

   [[ $(arch) == "arm64" ]] && softwareupdate --install-rosetta --agree-to-license; brew update && brew install binutils coreutils gawk findutils grep jq lz4 gnu-sed watchman

Ubuntu依赖项

警告： 请勿使用Snap版本的curl。Snap版本存在沙盒限制，会导致安装脚本无法正常运行。如果您在安装过程中看到有关“Snap version of curl”（Snap版本的curl）的消息，请停止安装进程。使用原生curl命令切换到原生版本。

安装原生curl：

已复制到剪贴板。

   sudo apt remove curl
   sudo apt install curl

开发工具：

原生调试：python3.8、lz4，用于崩溃报告符号化
KVM虚拟化：请参阅KVM管理程序安装指南
文件监控：按照适用于Ubuntu的Watchman安装指南操作
Node.js：下载并安装Node.js（版本18.x或更高版本）

如果已安装Node.js，请检查其版本：

已复制到剪贴板。

   node --version

开发工具： 运行以下命令，以安装lz4压缩工具和Python 3.8开发库：

已复制到剪贴板。

   (dpkg -l | grep -q lz4 || sudo apt install -y lz4) && \
   sudo add-apt-repository -y ppa:deadsnakes/ppa && \
   sudo apt update && \
   (dpkg -l | grep -q libpython3.8-dev || sudo apt install -y libpython3.8-dev)

安装Vega CLI

如果正在运行Visual Studio (VS) Code，请先将其关闭，然后再运行安装脚本。如果未安装VS Code，则安装程序会跳过Vega Studio扩展程序的安装。您可以稍后安装VS Code和Vega Studio扩展程序。

注意： 安装过程用时10到15分钟，具体取决于互联网连接和系统性能。

运行安装脚本：

已复制到剪贴板。

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

安装程序会验证您的Node.js版本和VS Code版本是否兼容，并在需要升级时提示您。

安装程序还会提示您：

选择安装目录：按Enter键使用默认路径 (~/vega/sdk)，或者指定自定义路径。
安装Vega SDK：按Enter。
安装Vega Studio扩展程序：按Enter键（如果未安装VS Code则跳过）。

重要须知： 默认情况下，Vega SDK及其附带的工具会收集遥测数据。有关收集的遥测类型的详细信息或如何选择退出的说明，请访问遥测。

安装的内容：

Vega CLI → ~/vega/bin
最新SDK版本，包括Vega虚拟设备
VS Code中的Vega Studio扩展程序
Shell配置更新（.bashrc、.zshrc、.bash_profile、.zprofile和.profile）

验证安装

检查安装是否成功完成：

已复制到剪贴板。

vega --version

输出示例（注意：界面显示内容均为英文，此处中文译文仅供参考）：

Active SDK Version: <版本号> 
Vega CLI Version: <版本号>

Active SDK Version（活跃的SDK版本）表明了您正在使用哪个SDK进行开发。Vega CLI Version显示了用于管理SDK安装的命令行工具的版本。

重要须知： 如果该命令失败，请重新启动终端或运行source ~/vega/env，以重新加载您的shell配置。

后续步骤

安装VDT后，选择您的开发方法：

对于初学者：

从构建Hello World应用开始，学习Vega开发基础知识。

对于经验丰富的开发者：

Vega Studio：如果已安装Vega Studio，请从使用Vega Studio构建应用开始。

如果未安装Vega Studio，请按照设置Vega Studio中的说明设置开发环境。
Vega CLI：有关命令行开发，请参阅使用Vega CLI构建应用。

本节介绍如何更新SDK版本、执行清理构建和验证更新。

先决条件

将Vega CLI更新到最新版本：vega update
查看发布说明，了解是否有重大更改。
将所有更改提交到版本控制
移除现有构建构件（用时增加约5到10分钟）
在部署之前，验证新SDK能否让应用正常运行

更新SDK版本

请按照以下步骤更新SDK：

步骤1：查看可用版本

已复制到剪贴板。

vega sdk list-remote

输出示例（注意：界面显示内容均为英文，此处中文译文仅供参考）：

步骤2：安装新的SDK版本

安装最新版本：

已复制到剪贴板。

vega sdk install

安装某个特定版本：

vega sdk install <版本号>

示例：

vega sdk install 0.22.5850

重要须知： 如果在安装期间运行VS Code，可能会出现“Electron quit unexpectedly”（Electron意外退出）消息。在现有Vega版本之上安装时，也可能出现这种情况。此消息不会影响安装，您可以忽略它，但之后必须重新启动VS Code。

步骤３：激活新的SDK 版本

将新安装的版本设置为活跃版本：

vega sdk use <版本号>

示例：

vega sdk use 0.22.5850

步骤４：重新加载您的环境

为了让SDK版本更改完全生效，请重新加载您的shell环境。

请选择以下任一选项：

选项A：获取您的shell配置文件

# 对于bash用户
source ~/.bash_profile
# 或
source ~/.bashrc

# 对于zsh用户
source ~/.zshrc

选项B：打开新终端

关闭当前终端，然后打开一个新的终端窗口。

步骤５：验证活跃的版本

检查SDK版本是否处于活跃状态。如果版本或路径不正确，请重复步骤3到4。

已复制到剪贴板。

vega --version

输出示例（注意：界面显示内容均为英文，此处中文译文仅供参考）：

Active SDK Version: 0.22.5850
Vega CLI Version: 1.2.0

步骤6（可选）：移除旧版SDK

警告： 在卸载SDK版本之前，请确保它不是活跃的版本。先使用vega sdk use <版本>切换到其他版本。

为了释放磁盘空间，可以卸载不再需要的SDK版本：

vega sdk uninstall <版本号>

示例：

vega sdk uninstall 0.21.4890

在已安装的SDK版本之间切换

如果安装了多个SDK版本，则无需重新安装即可在它们之间切换：

步骤1：检查已安装的版本

已复制到剪贴板。

vega sdk list-installed

输出示例（注意：界面显示内容均为英文，此处中文译文仅供参考）：

22.5850 (active)
22.5720
21.4890

步骤2：切换到其他版本

vega sdk use <版本号>

示例：

vega sdk use 0.21.4890

步骤３：重新加载您的环境

请选择以下任一选项：

选项A：获取您的shell配置文件

# 对于bash用户
source ~/.bash_profile
# 或
source ~/.bashrc

# 对于zsh用户
source ~/.zshrc

选项B：打开新终端

关闭当前终端，然后打开一个新的终端窗口。

步骤４：验证切换

已复制到剪贴板。

vega --version

更新后的清理构建

警告： 之前的构建构件可能不兼容更新后的SDK。切换SDK版本后，务必执行清理构建。

步骤1：移除现有构建和依赖项

已复制到剪贴板。

rm -rf ./build && rm -rf ./node_modules

步骤2：更新并重新安装依赖项

定期维护项目的依赖项对于确保安全性、性能和兼容性非常重要。选择适用于程序包管理器的说明（仅按照下面一个章节操作）：

NPM（如果项目使用的是package-lock.json）：

提取应用依赖项的最新版本：
已复制到剪贴板。
```
npm update
```
清除全局程序包缓存：
已复制到剪贴板。
```
npm cache clean --force
```
使用start命令运行应用时，清除Metro缓存：
已复制到剪贴板。
```
npm start -- --reset-cache
```
提示： npm start -- --reset-cache命令会在清除缓存后启动Metro bundler。要退出此进程，请按Ctrl+C。对于常规开发，使用npm start（不带--reset-cache标记）。

Yarn（如果项目使用的是yarn.lock）：

提取应用依赖项的最新版本：
已复制到剪贴板。
```
yarn upgrade
```
清除全局程序包缓存：
已复制到剪贴板。
```
yarn cache clean --all
```
使用start命令运行应用时，清除Metro缓存：
已复制到剪贴板。
```
yarn start -- --reset-cache
```

PNPM（如果项目使用的是pnpm-lock.yaml）：

提取应用依赖项的最新版本：
已复制到剪贴板。
```
pnpm update
```
清除全局程序包缓存：
已复制到剪贴板。
```
pnpm cache delete
```
使用start命令运行应用时，清除Metro缓存：
已复制到剪贴板。
```
pnpm start --reset-cache
```

步骤３：重新构建您的应用

更新依赖项后，重新构建您的应用，以使用新的SDK版本编译所有组件：

已复制到剪贴板。

   npm run build:app

验证更新

确认您正在运行预期的SDK版本：
已复制到剪贴板。
```
vega --version
```
输出示例（注意：界面显示内容均为英文，此处中文译文仅供参考）：
```
Active SDK Version: 0.22.5850
Vega CLI Version: 1.2.0
```
Active SDK Version（活跃的SDK版本）表明了您正在使用哪个SDK进行开发。Vega CLI Version显示了用于管理SDK安装的命令行工具的版本。
在Vega虚拟设备上运行您的应用，以验证功能能否正常运行：
```
vega run-app <vpkg路径> <应用ID> -d VirtualDevice
```
输出示例（注意：界面显示内容均为英文，此处中文译文仅供参考）：
```
vega run-app sampleapp.vpkg com.amazon.sampleapp.main -d VirtualDevice
```

重新加载VS Code

更新完成后，重新加载VS Code，以确保所有Vega Studio组件都已初始化。

要打开VS Code命令面板，请按Cmd+Shift+P (Mac) 或 Ctrl+Shift+P (Linux)。
在命令面板中键入Reload Window（重新加载窗口）。
重新加载VS Code，请按Enter键。

Last updated: 2026年2月17日

安装Vega开发者工具

选择您的安装场景

先决条件

系统要求

所需依赖项

macOS依赖项

Ubuntu依赖项

安装Vega CLI

验证安装

后续步骤

先决条件

更新SDK版本

在已安装的SDK版本之间切换

更新后的清理构建

验证更新

重新加载VS Code

相关主题