as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
“Vega SDK管理器”可帮助您管理开发项目的SDK版本。**您可以安装SDK版本、切换版本,并与CI/CD管道集成。与其他平台的版本管理器(Node.js的nvm,Python的pyenv)类似,您可以保留多个SDK版本,并针对每个项目在各版本之间切换。

在何处访问Vega SDK管理器

可通过以下方式安装Vega SDK管理器:
  • Vega Studio扩展程序: 从Vega Studio扩展程序安装SDK管理器 在Vega Studio面板的SDK Manager(SDK管理器)部分中,选择Install SDK Manager(安装SDK管理器)。 或者 在命令面板中,输入Vega: Install SDK Manager 有关更多信息,请参阅设置Vega Studio。
  • Vega命令行界面 (CLI): 按照此页面上的说明操作。

先决条件

在继续操作之前,请确认您已经安装了Vega CLI。 如果你有 Vega SDK 版本 0.22+: 您已经有Vega CLI。继续从CLI安装SDK。 如果您有最新的Vega SDK(版本0.22+): 按照 Vega SDK 安装说明进行操作。

从CLI安装SDK

  1. 运行以下命令,检查您是否有Vega CLI:
  2. 安装Vega SDK(如果需要): 安装最新的SDK版本
    安装某个特定版本
    如需查看可用版本
  3. 确认哪个 SDK 版本处于活动状态:
    vega sdk ls是的简短别名vega sdk list-installed。输出会列出您已安装的版本,并用箭头标记活动版本,并且Active SDK Version:
    安装新的 SDK 版本并不总是使其成为活动版本。如果其他 SDK 版本仍处于活动状态,请继续执行下一步。
  4. 要使新版本成为活跃的 SDK,请运行:
    然后vega sdk ls再次运行以确认新版本已标记为活动版本。

创建项目

  1. 从CLI安装SDK(如果尚未安装)。
  2. 在你的项目根目录下创建一个vega-sdk-requirements.json文件:
  3. 执行运行状况检查以验证环境:
    这将验证SDK安装是否正确、检查环境配置并发现潜在问题。

需求文件的工作原理

当你运行 Vega 命令时,Vega 会在当前目录中查找vega-sdk-requirements.json文件,然后在每个父目录中查找文件。如果找到一个,Vega:
  1. 读取文件中的vegaSdkVersion字段。
  2. 将vegaSdkVersion用于该项目中的所有 SDK 操作。
  3. 覆盖任何全局默认版本,包括您设置的版本。

Vega 如何选择活跃的 SDK 版本

Vega 按以下顺序选择当前的 SDK 版本:
  1. vegaSdkVersion在当前目录或父目录的vega-sdk-requirements.json文件中。
  2. 您设置的全局默认版本。
  3. 最近安装的 SDK 版本。
vega sdk ls显示哪个版本处于活动状态,但不显示哪个来源设置了该版本。如果活动版本不是你预期的版本,请参阅在运行 vega sdk use 之后编译版本使用不同的 SDK 版本。 示例项目结构 以下是一个具有版本要求的典型项目示例:

管理多个项目

通过使用以下方法,每个项目都可以拥有自己的 SDK 版本vega-sdk-requirements.json:

更新SDK版本

更新SDK以获取最新功能和错误修复。

快速更新

  1. 查看可用版本:
  2. 安装新版本:
  3. (可选)将新版本设置为默认版本:
    安装新版本并不总是使其成为活动版本,因此请运行vega sdk use以使其成为活跃的 SDK。
  4. 验证活跃的版本
    新版本标有Active SDK Version。如果早期版本仍被标记为活动版本,请参阅安装新的 SDK 版本后未激活。
  5. (可选)清理旧版本:

安全更新(提交前请进行测试)

合并之前,在一个单独的分支中对新的SDK版本进行测试:

链接现有的SDK安装

如果已经使用CLI安装程序或Vega Studio扩展程序安装了Vega SDK,则可以链接它而不必重新安装。这会重复使用现有安装,从而节省时间和磁盘空间。

CI/CD集成

对于CI/CD管道等自动化环境,Vega提供了两种启用非交互模式的方法。这可防止阻碍自动化流程的提示或交互行为。

适用于自动化流程的非交互模式

方法1: CLI标记(推荐用于单个命令) 使用该--non-interactive标志可防止提示特定命令。
方法2: 环境变量(推荐用于整个管道) 如果整个管道应在没有任何用户交互的情况下运行,请设置NONINTERACTIVENONINTERACTIVE环境变量。这是CI/CD环境的首选方法。

优先规则

当同时使用这两种方法时,系统会优先使用CLI标记:
  1. CLI 标志 (--non-interactive)-最高优先级。
  2. 环境变量 (NONINTERACTIVE=true)-较低的优先级。
  3. 默认行为(交互模式)- 上述两项均未设置时应用。
您可以使用环境变量设置默认行为,然后在需要时使用CLI标记覆盖默认行为。

高级功能

这些高级配置选项为特定的开发环境和工作流程提供了更高的灵活性。

自定义配置文件位置

默认情况下,Vega 将其配置存储在。~/vega/config.json您可以使用VEGA_CONFIG_FILE环境变量自定义此位置。这在以下情形中很有用:
  • 在同一台计算机上运行多个Vega配置
  • 在团队中共享一个配置文件
  • 不能使用默认路径的CI/CD环境
  • 在不修改主设置的情况下,测试不同的配置

设置自定义配置路径

将自定义配置路径设为永久路径

要永久使用自定义配置位置,请将导出内容添加到shell配置文件中:

CI/CD示例

命令参考

本节列出了所有SDK管理器命令及其描述。当您需要查看特定命令语法时,可以快速参考此内容。

基本命令

CI/CD命令

帮助命令

全局选项

故障排除

如果您遇到任何问题,请参阅SDK管理器问题故障排除。

相关主题


最后修改于 2026年10月29日