安装Vega开发者工具

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

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

要安装VDT，有以下两种选择：

Vega Studio扩展程序： 使用VS Code中的Vega Studio扩展程序安装VDT。请参阅安装Vega Studio。
Vega命令行界面 (CLI)： 使用vega CLI实现高级工作流程和自动化。

本页介绍CLI安装方法。

选择安装场景

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

首次安装
更新现有安装

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

先决条件

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

所需依赖项

仅安装操作系统所需的依赖项。如果您使用macOS，请按照macOS依赖项部分操作。如果您使用Ubuntu，则跳到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依赖项

安装原生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

在运行安装脚本之前：

安装VS Code： 下载并安装Visual Studio Code（如果尚未安装）。安装程序会自动安装VS Code中的Vega Studio扩展程序。如果未安装VS Code，安装程序则会跳过扩展程序的安装，您可以稍后安装。
如果VS Code正在运行，请将其关闭。

运行安装脚本：

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

验证安装

检查安装是否成功完成：

vega --version

输出示例：

Active SDK Version: <version number>
Vega CLI Version: <version number>

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

后续步骤

安装VDT后，选择您的开发方法：对于初学者：从构建Hello World应用开始，学习Vega开发基础知识。对于经验丰富的开发者：

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

对于AI辅助式开发：设置用于AI驱动式开发的Amazon Devices Builder Tools，以在构建、调试和优化Vega应用方面获得AI编码帮助。这是一个单独的可选工具，可与您的SDK安装一起使用。

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

先决条件

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

更新SDK版本

请按照以下步骤更新SDK：步骤1：列出可用的SDK版本列出可用的SDK版本：

vega sdk list-remote

输出结果按降序列出可用的SDK版本（最新版在前）。步骤2：安装新的SDK版本安装新的SDK版本：

vega sdk install

安装某个特定版本：

vega sdk install <version number>

示例：

vega sdk install 0.22.5850

步骤３：使用新的SDK版本使用新的SDK版本：

vega sdk use <version number>

示例：

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 uninstall <version number>

示例：

vega sdk uninstall 0.21.4890

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

如果安装了多个SDK版本，则无需重新安装即可在它们之间切换：步骤1：检查已安装的版本

vega sdk list-installed

输出示例：

22.5850 (active)
22.5720
21.4890

步骤2：切换到其他版本

vega sdk use <version number>

示例：

vega sdk use 0.21.4890

步骤３：重新加载您的环境请选择以下任一选项：选项A：获取您的shell配置文件

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

# 对于zsh用户
source ~/.zshrc

选项B：打开新终端关闭当前终端，然后打开一个新的终端窗口。步骤４：验证切换

vega --version

更新后的清理构建

步骤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

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-path> <app-id> -d VirtualDevice
输出示例：
vega run-app sampleapp.vpkg com.amazondeveloper.sampleapp.main -d VirtualDevice
重新加载VS Code。
更新完成后，重新加载VS Code，以确保所有Vega Studio组件都已初始化。
1. 要打开VS Code命令面板，请按Cmd+Shift+P (Mac) 或 Ctrl+Shift+P (Linux)。
2. 在命令面板中键入Reload Window（重新加载窗口）。
3. 重新加载VS Code，请按Enter键。

Vega 入门

选择安装场景

先决条件

所需依赖项

macOS依赖项

Ubuntu依赖项

安装Vega CLI

验证安装

后续步骤

先决条件

更新SDK版本

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

更新后的清理构建

验证更新

重新加载VS Code。

相关主题

​选择安装场景

​先决条件

​所需依赖项

macOS依赖项

Ubuntu依赖项

​安装Vega CLI

​验证安装

​后续步骤

​先决条件

​更新SDK版本

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

​更新后的清理构建

​验证更新

​重新加载VS Code。

​相关主题

选择安装场景

先决条件

所需依赖项

安装Vega CLI

验证安装

后续步骤

先决条件

更新SDK版本

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

更新后的清理构建

验证更新

重新加载VS Code。

相关主题