as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
跳转到主要内容
“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是旧版本: 请按照Vega SDK安装说明进行操作,升级到最新版本。

从CLI安装SDK

  1. 运行以下命令,检查您是否有Vega CLI:
  2. 安装Vega SDK(如果需要): 安装最新的SDK版本
    安装某个特定版本
    如需查看可用版本
  3. 验证安装是否成功:

创建项目

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

需求文件的工作原理

在包含vega-sdk-requirements.json的目录中运行任何Vega命令时,Vega会执行以下操作:
  1. 读取此文件中的vegaSdkVersion字段。
  2. 在执行该项目中的所有SDK操作时,都会使用vegaSdkVersion。
  3. 覆盖所有全局默认版本设置。
示例项目结构 以下是一个具有版本要求的典型项目示例:

管理多个项目

借助vega-sdk-requirements.json,每个项目都可以有自己的SDK版本:

更新SDK版本

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

快速更新

  1. 查看可用版本:
  2. 安装新版本:
  3. (可选)将新版本设置为默认版本:
  4. (可选)清理旧版本:

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

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

链接现有的SDK安装

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

CI/CD集成

对于CI/CD管道等自动化环境,Vega提供了两种启用非交互模式的方法。这可防止输出提示或出现等待用户输入的情况,从而打断自动化流程运行。

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

方法1:CLI标记(推荐用于单个命令) 如果不想让命令输出提示,请使用--non-interactive标记。
方法2:环境变量(推荐用于整个管道) 如果整个管道应在没有任何用户交互的情况下运行,请设置NONINTERACTIVE环境变量。这是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月26日