as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
跳转到主要内容
本页面介绍如何将Vega SDK集成到持续集成 (CI) 管道中,包括自动安装过程和配置要求。 构建主机是指CI管道中用于构建Vega应用的计算机(虚拟机或物理机)。Vega SDK可在安装说明页面上提供安装命令,该命令能以非交互式的方式运行,无需用户输入,便于在构建主机上自动安装SDK。

先决条件

在将Vega SDK集成到CI管道中之前,请确保您的构建环境满足以下要求。请特别注意为构建主机选择正确的平台,因为选择错误的平台可能会导致安装或运行时错误。

系统要求

主机配置

  • 操作系统
    • Ubuntu 20.04、22.04或24.04
      • x86_64
    • Mac OS X
      • arm64(M系列)或x86_64 (Intel)

安装过程

在CI环境中安装Vega SDK时,需要特别注意。与经常进行交互式安装的开发者工作站不同,CI环境需要使用全自动的方法。以下部分将指导您完成此过程。

基本安装

  1. 编辑安装命令以禁用可能中断自动安装的安装程序提示。
  2. 配置所需的安装标记。
有关其他配置选项,请参阅以下部分。

环境变量配置

使用以下环境变量控制安装程序脚本。

Docker集成

Docker为使用Vega SDK构建应用提供了统一且隔离的环境。以下示例演示如何创建包含所有必要依赖项和配置的构建环境。这种方法适用于各种支持基于容器进行构建的CI解决方案。

示例Dockerfile

要构建Docker镜像,请运行以下命令。在SDK安装页面上找到所需的SDK版本,并确保为CI构建主机而不是开发机选择平台。

最佳实践

版本控制

  • 务必使用VEGA_SDK_VERSION在CI配置中指定确切的SDK版本。
  • 使用版本固定来提高稳定性和可重现的构建。
  • 存储库变更日志中的文档版本更新。

性能优化

  • 在不需要设备仿真时设置SKIP_VVD_INSTALL=true,这样可以显著减小安装规模。
  • 对已下载工件使用缓存策略。
  • 考虑使用多阶段Docker构建,以确保较小的最终镜像。

安全性

  • 请务必使用HTTPS下载网址。
  • 对私有npm注册表实施适当的访问控制。
  • 定期审核您的CI/CD管道配置。

故障排除

安装失败

  • 验证与SDK存储库的网络连接。
  • 确保有足够的磁盘空间来安装SDK。
  • 检查环境变量是否设置正确。
  • 确认您已在安装页面为构建主机选择了正确的平台。

编译错误

  • 验证SDK版本与您的应用程序的兼容性。
  • 检查您的构建环境中是否缺少依赖关系。
  • 查看编译日志中是否有特定的错误消息。
  • 确认在安装过程中选择了正确的平台。
有关更多信息,请参阅管理您的SDK版本。
最后修改于 2026年10月26日