在何处访问Vega SDK管理器
可通过以下方式安装Vega SDK管理器:-
Vega Studio扩展程序:
在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
-
运行以下命令,检查您是否有Vega CLI:
-
安装Vega SDK(如果需要):
安装最新的SDK版本
安装某个特定版本如需查看可用版本
-
确认哪个 SDK 版本处于活动状态:
vega sdk ls是的简短别名vega sdk list-installed。输出会列出您已安装的版本,并用箭头标记活动版本,并且Active SDK Version:安装新的 SDK 版本并不总是使其成为活动版本。如果其他 SDK 版本仍处于活动状态,请继续执行下一步。 -
要使新版本成为活跃的 SDK,请运行:
然后
vega sdk ls再次运行以确认新版本已标记为活动版本。
创建项目
- 从CLI安装SDK(如果尚未安装)。
-
在你的项目根目录下创建一个
vega-sdk-requirements.json文件: -
执行运行状况检查以验证环境:
这将验证SDK安装是否正确、检查环境配置并发现潜在问题。
需求文件的工作原理
当你运行 Vega 命令时,Vega 会在当前目录中查找vega-sdk-requirements.json文件,然后在每个父目录中查找文件。如果找到一个,Vega:
- 读取文件中的
vegaSdkVersion字段。 - 将
vegaSdkVersion用于该项目中的所有 SDK 操作。 - 覆盖任何全局默认版本,包括您设置的版本。
Vega 如何选择活跃的 SDK 版本
Vega 按以下顺序选择当前的 SDK 版本:vegaSdkVersion在当前目录或父目录的vega-sdk-requirements.json文件中。- 您设置的全局默认版本。
- 最近安装的 SDK 版本。
vega sdk ls显示哪个版本处于活动状态,但不显示哪个来源设置了该版本。如果活动版本不是你预期的版本,请参阅在运行 vega sdk use 之后编译版本使用不同的 SDK 版本。
示例项目结构
以下是一个具有版本要求的典型项目示例:
管理多个项目
通过使用以下方法,每个项目都可以拥有自己的 SDK 版本vega-sdk-requirements.json:
更新SDK版本
更新SDK以获取最新功能和错误修复。快速更新
-
查看可用版本:
-
安装新版本:
-
(可选)将新版本设置为默认版本:
安装新版本并不总是使其成为活动版本,因此请运行
vega sdk use以使其成为活跃的 SDK。 -
验证活跃的版本
新版本标有
Active SDK Version。如果早期版本仍被标记为活动版本,请参阅安装新的 SDK 版本后未激活。 -
(可选)清理旧版本:
安全更新(提交前请进行测试)
合并之前,在一个单独的分支中对新的SDK版本进行测试:链接现有的SDK安装
如果已经使用CLI安装程序或Vega Studio扩展程序安装了Vega SDK,则可以链接它而不必重新安装。这会重复使用现有安装,从而节省时间和磁盘空间。CI/CD集成
对于CI/CD管道等自动化环境,Vega提供了两种启用非交互模式的方法。这可防止阻碍自动化流程的提示或交互行为。适用于自动化流程的非交互模式
方法1: CLI标记(推荐用于单个命令) 使用该--non-interactive标志可防止提示特定命令。
NONINTERACTIVENONINTERACTIVE环境变量。这是CI/CD环境的首选方法。
优先规则
当同时使用这两种方法时,系统会优先使用CLI标记:- CLI 标志 (
--non-interactive)-最高优先级。 - 环境变量 (
NONINTERACTIVE=true)-较低的优先级。 - 默认行为(交互模式)- 上述两项均未设置时应用。
高级功能
这些高级配置选项为特定的开发环境和工作流程提供了更高的灵活性。自定义配置文件位置
默认情况下,Vega 将其配置存储在。~/vega/config.json您可以使用VEGA_CONFIG_FILE环境变量自定义此位置。这在以下情形中很有用:
- 在同一台计算机上运行多个Vega配置
- 在团队中共享一个配置文件
- 不能使用默认路径的CI/CD环境
- 在不修改主设置的情况下,测试不同的配置

