先决条件
在将Vega SDK集成到CI管道中之前,请确保您的构建环境满足以下要求。请特别注意为构建主机选择正确的平台,因为选择错误的平台可能会导致安装或运行时错误。系统要求
主机配置
- 操作系统
- Ubuntu 20.04、22.04或24.04
- x86_64
- macOS X
- arm64(M系列)—推荐
- x86_64 (Intel)
- Ubuntu 20.04、22.04或24.04
安装过程
在CI环境中安装Vega SDK时,需要特别注意。与经常进行交互式安装的开发者工作站不同,CI环境需要使用全自动的方法。以下部分将指导您完成此过程。基本安装
-
编辑安装命令以禁用可能中断自动安装的安装程序提示。
-
配置所需的安装标记。
环境变量配置
使用以下环境变量控制安装程序脚本。Docker集成
Docker为使用Vega SDK构建应用提供了统一且隔离的环境。以下示例演示如何创建包含所有必要依赖项和配置的构建环境。这种方法适用于各种支持基于容器进行构建的CI解决方案。示例Dockerfile
最佳实践
版本控制
- 务必使用
VEGA_SDK_VERSION在CI配置中指定确切的SDK版本。 - 使用版本固定来提高稳定性和可重现的构建。
- 存储库变更日志中的文档版本更新。
性能优化
- 在不需要设备仿真时设置
SKIP_VVD_INSTALL=true,这样可以显著减小安装规模。 - 对已下载工件使用缓存策略。
- 考虑使用多阶段Docker构建,以确保较小的最终镜像。
安全性
- 请务必使用HTTPS下载网址。
- 对私有npm注册表实施适当的访问控制。
- 定期审核您的CI/CD管道配置。
故障排除
安装失败
- 验证与SDK存储库的网络连接。
- 确保有足够的磁盘空间来安装SDK。
- 检查环境变量是否设置正确。
- 确认您已在安装页面为构建主机选择了正确的平台。
编译错误
- 验证SDK版本与您的应用程序的兼容性。
- 检查您的构建环境中是否缺少依赖关系。
- 查看编译日志中是否有特定的错误消息。
- 确认在安装过程中选择了正确的平台。
- 确认您的
manifest.toml中包含[os.version]部分。自SDK 0.24版本起,缺失此部分会导致构建失败。构建前,现在项目中运行vega project update-manifest --os-min 1.2 --os-version 1.2,或将此部分添加到已提交的manifest.toml中。

