Console

Settings

Sign out

Notifications

Alexa

亚马逊应用商店

Ring

AWS

文档

Support

My Cases

Console

Vega开发者文档

主页

新手入门

设计和开发

应用发布

参考

支持

安装Vega SDK

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

Vega开发者工具 (VDT) 是一套完整的开发工具包，包含工具、SDK、库和组件，用于开发适用于Vega OS设备的应用。该套件包括Vega Studio，这是Visual Studio Code (VS Code) 中的一个扩展，用于应用开发、调试、性能分析和优化。然后，安装程序会自动安装Vega Studio。您也可以稍后按照设置和使用Vega Studio中的说明安装Vega Studio。

先决条件

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

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

支持的操作系统：macOS 10.15+或Ubuntu 20.4+

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

建议做法： 下载并安装用于集成Vega Studio的Visual Studio (VS Code)

所需依赖项

安装操作系统所需的依赖项：

macOS依赖项
Ubuntu依赖项

程序包管理器：

Homebrew：按照brew中的安装说明进行操作

开发工具：

Node.js（版本16.x或更高版本）：从Node.js下载并安装
如果您已经安装了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

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

安装原生curl：

已复制到剪贴板。

sudo apt remove curl
sudo apt install curl

系统要求：

原生调试和崩溃报告符号化：python3.8、lz4
KVM虚拟化支持：请参阅KVM管理程序（仅提供英文版）
Node.js（版本16.x或更高版本）：从Node.js下载并安装
如果您已经安装了node.js，请检查其版本：
已复制到剪贴板。
```
 node --version
```
用于文件监控的Watchman：按照Ubuntu安装指南进行操作（仅提供英文版）。

安装Python和压缩工具：

此命令会安装安装所需的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 SDK

在安装SDK之前，请关闭VS Code。如果您在安装期间或之后看到“Electron quit unexpectedly”消息，可能是由于安装时VS Code正在运行所致，或是在现有Kepler版本上覆盖安装所致。虽然此消息不会影响安装，您可以忽略它，但之后必须重新启动VS Code。

正在加载SDK安装界面......

要安装Vega SDK，您必须拥有开发者账户并登录开发者门户，才能访问SDK安装程序。

如需支持，请访问社区论坛。

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

按照屏幕上的指示进行操作。
出现提示时，输入Vega SDK的安装路径：
- 按回车键使用默认位置：<HOME>/kepler/sdk/。
等待安装结束。

安装程序显示一些导出命令，这些命令让您能够使用kepler命令，并启用Vega Studio扩展。

export命令示例：
```
 export KEPLER_SDK_PATH=/Users/<用户>/kepler/sdk/<版本号>
 export PATH=$KEPLER_SDK_PATH/bin:$PATH
```
将导出命令添加到您的shell配置文件中：
- Bash用户：~/.bashrc或~/.bash_profile
- Zsh用户：~/.zshrc或~/.zprofile
应用配置更改：
- Bash用户：source ~/.bashrc或source ~/.bash_profile
- Zsh用户：source ~/.zshrc或source ~/.zprofile
或者，重启终端。
通过检查Vega SDK版本来验证安装是否成功：
已复制到剪贴板。
```
 kepler --version
```

安装Vega SDK后，请重启VS Code

如果在Vega SDK安装期间VS Code正在运行，请重新加载应用以识别Vega Studio扩展：

打开VS Code命令面板：
- MacOS：按Cmd+Shift+P
- Linux：按Ctrl+Shift+P
输入Reload Window（重新加载窗口），然后按回车键。

VS Code重新加载并识别Vega Studio扩展。

后续步骤

安装Vega开发者工具后，选择您的开发方法：

对于初学者：

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

对于经验丰富的开发者：

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

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

需要帮助？

请参阅修复Vega SDK安装问题。
在开发者论坛中发布问题。

Last updated: 2025年10月6日