Console

Settings

Sign out

Notifications

Alexa

亚马逊应用商店

Ring

AWS

文档

Support

My Cases

Console

Vega开发者文档

主页

新手入门

设计和开发

应用发布

参考

支持

将Vega SDK集成到CI管道中

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅最新的发布说明。

重要须知： 目前，持续集成仅面向部分合作伙伴开放。

重要须知： Docker容器不支持Vega虚拟设备 (VVD)。Docker的无头环境和有限的GPU访问权限阻碍了VVD的正常运行。如要进行设备测试，请使用支持显示屏和GPU的专用测试基础架构。

本页面介绍如何将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环境需要使用全自动的方法。以下部分将指导您完成此过程。

基本安装

编辑安装命令以禁用可能中断自动安装的安装程序提示。
```
export NONINTERACTIVE=true
```

配置所需的安装标记。

# 跳过VVD安装。
export SKIP_VVD_INSTALL=true

# 安装特定的SDK版本。
export VEGA_SDK_VERSION=0.21.5245

# 下载并运行安装程序脚本。
curl -fsSL https://sdk-installer.vega.labcollab.net/get_vvm.sh | bash

有关其他配置选项，请参阅以下部分。

环境变量配置

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

变量	默认值	描述
`NONINTERACTIVE`	FALSE	跳过所有提示并自动运行。CI/CD是必需的。
`VEGA_SDK_VERSION`	（最新）	安装特定的SDK版本（例如 0.21.5245）
`SKIP_SDK_INSTALL`	FALSE	完全跳过SDK安装。
`SKIP_VVD_INSTALL`	FALSE	在SDK设置期间跳过VVD安装。

注意： VS Code插件安装警告预计会在CI环境中出现，不会影响SDK功能。您可以放心地忽略这些警告。

Docker集成

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

示例Dockerfile

已复制到剪贴板。

FROM --platform=linux/amd64 ubuntu:22.04

SHELL ["/bin/bash", "-c"]

ENV DEBIAN_FRONTEND=noninteractive

# 安装cURL和实用程序来获取安装程序。
RUN apt-get update && \
    apt-get install -y curl tar jq ca-certificates --no-install-recommends && \
    rm -rf /var/lib/apt/lists/*

# 安装 Vega SDK。
ENV NONINTERACTIVE=true

ARG VEGA_SDK_VERSION=0.21.5245
ARG SKIP_VVD_INSTALL=true

ENV VEGA_SDK_VERSION=${VEGA_SDK_VERSION}
ENV SKIP_VVD_INSTALL=${SKIP_VVD_INSTALL}

RUN curl -fsSL https://sdk-installer.vega.labcollab.net/get_vvm.sh | bash

ENV PATH="/root/vega/bin:${PATH}"

# 验证vega命令是否可用。
RUN vega -v

# React Native应用程序需要Node.js和npm。
运行 apt-get update && apt-get install -y nodejs npm --no-install-recommends && rm -rf /var/lib/apt/lists/*

# 设置全局npm配置路径并将您的npmrc配置绑定到这个位置。
ENV NPM_CONFIG_GLOBALCONFIG="/etc/npmrc"

# 验证节点和npm命令是否可用。
RUN node -v && npm -v

ENTRYPOINT [ "/bin/bash", "-c" ]

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

已复制到剪贴板。

docker build . --tag vega-sdk \
  --build-arg VEGA_SDK_VERSION=0.21.5245 \
  --build-arg SKIP_VVD_INSTALL=true

最佳实践

版本控制

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

性能优化

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

安全性

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

故障排除

安装失败

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

编译错误

验证SDK版本与您的应用程序的兼容性。
检查您的构建环境中是否缺少依赖关系。
查看编译日志中是否有特定的错误消息。
确认在安装过程中选择了正确的平台。

有关更多信息，请参阅管理您的SDK版本。

Last updated: 2026年3月16日