前提条件
Vega SDKをCIパイプラインに統合する前に、ビルド環境が以下の要件を満たしていることを確認してください。適切なビルドホスト構成を選択するよう特に注意してください。間違ったものを選択すると、インストールエラーやランタイムエラーが発生する可能性があります。システム要件
次のセクションでは、CIでVegaアプリをビルドするためにサポートされているホスト構成を一覧表示します。ホスト構成
- オペレーティングシステム
- Ubuntu 20.04、22.04、24.04、または26.04
- x86_64
- macOS X
- arm64(Mシリーズ)- 推奨
- x86_64(Intel)
- Ubuntu 20.04、22.04、24.04、または26.04
インストールプロセス
Vega SDKをCI環境にインストールするには、完全に自動化されたアプローチが必要です。開発者ワークステーションではインタラクティブなインストールが一般的ですが、CI環境ではプロンプトに頼ることができません。以下のセクションでは、これらの手順について説明します。基本インストール
-
インストールコマンドを編集して、自動インストールを中断する可能性のあるインストーラープロンプトを無効にします。
echo $NONINTERACTIVEを実行して、true出力されることを確認します。 -
必要なインストールフラグを構成します。
成功すると、インストーラーは確認メッセージを出力し、コード
0で終了します。vega -vを実行して、SDKがインストールされていて、想定されたバージョンであることを確認してから続行します。
環境変数の構成
次の環境変数を使用してインストーラースクリプトを制御します。Dockerの統合
Dockerは、Vega SDKを使用してアプリケーションを構築するための一貫性のある分離環境を提供します。次の例は、必要なすべての依存関係と構成を含むビルド環境を作成する方法を示しています。このアプローチは、コンテナベースのビルドをサポートするさまざまなCIソリューションに適用できます。Dockerfileの例
パイプラインでのOSバージョン互換性を検証する
互換性のないアプリがビルドされる前にパイプラインを停止するには、ビルドステップとしてvega project doctorを実行します。これは、vega project install --fixとパッケージマネージャーの後、およびビルドの前に実行してください。
vega project doctorは、チェックが失敗すると0以外の終了コードを返すため、パイプラインステップは失敗し、ビルドは実行されません。プロジェクトで使用しているパッケージマネージャーとビルドスクリプトに合わせて、npm installとビルドコマンドを置き換えてください。doctorを実行するチェックについては、vega project doctor(英語のみ)を参照してください。
ベストプラクティス
バージョン管理
- CI設定では、必ず
VEGA_SDK_VERSIONを使用して正確なSDKバージョンを指定します。 - 安定性と再現性のあるビルドのために、バージョン固定を使用します。
- リポジトリの変更ログにバージョン更新を記録します。
パフォーマンスの最適化
- デバイスエミュレーションが不要な場合は、
SKIP_VVD_INSTALL=trueを設定して、インストールサイズを小さくします。 - ダウンロードしたアーティファクトにはキャッシュ戦略を使用します。
- 最終的なイメージサイズを小さく抑えるために、マルチステージのDockerビルドを検討してください。
セキュリティ
- 常にHTTPSダウンロードURLを使用してください。
- プライベートnpmレジストリに適切なアクセス制御を実装します。
- CI/CDパイプラインの設定を定期的に監査してください。
トラブルシューティング
インストール失敗
- SDKリポジトリへのネットワーク接続を確認します。
- SDKのインストールに十分なディスク容量を確保してください。
- 環境変数が正しく設定されていることを確認します。
- インストールページで、ビルドホストに対して適切なビルドホスト構成を選択したことを確認します。
ビルドエラー
- アプリとのSDKバージョンの互換性を確認してください。
- ビルド環境に不足している依存関係がないか確認してください。
- 特定のエラーメッセージについては、ビルドログを確認してください。
- インストール中に、ビルドホストに対して適切なビルドホスト構成を選択したことを確認します。
manifest.tomlに[os.version]セクションが含まれていることを確認します。これがない場合、ビルドは失敗します。ビルド前にプロジェクトでvega project update-manifest --os-min 2.0 --os-version 2.0を実行するか、コミットされたmanifest.tomlにセクションを追加してください。

