Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
このページでは、Vega SDKを継続的インテグレーション(CI)パイプラインに統合する方法について、自動インストールプロセスや構成要件などを含めて説明します。 ビルドホストは、CIパイプラインの一部としてVegaアプリをビルドする仮想マシンや物理マシンです。Vega SDKでは、ビルドホスト上での自動SDKインストールを容易にするために、ユーザー入力を必要としない非インタラクティブで実行できるインストールコマンドが、インストール手順ページに用意されています。

前提条件

Vega SDKをCIパイプラインに統合する前に、ビルド環境が以下の要件を満たしていることを確認してください。適切なビルドホスト構成を選択するよう特に注意してください。間違ったものを選択すると、インストールエラーやランタイムエラーが発生する可能性があります。

システム要件

次のセクションでは、CIでVegaアプリをビルドするためにサポートされているホスト構成を一覧表示します。

ホスト構成

  • オペレーティングシステム
    • Ubuntu 20.04、22.04、24.04、または26.04
      • x86_64
    • macOS X
      • arm64(Mシリーズ)- 推奨
      • x86_64(Intel)

インストールプロセス

Vega SDKをCI環境にインストールするには、完全に自動化されたアプローチが必要です。開発者ワークステーションではインタラクティブなインストールが一般的ですが、CI環境ではプロンプトに頼ることができません。以下のセクションでは、これらの手順について説明します。

基本インストール

  1. インストールコマンドを編集して、自動インストールを中断する可能性のあるインストーラープロンプトを無効にします。
    echo $NONINTERACTIVEを実行して、true出力されることを確認します。
  2. 必要なインストールフラグを構成します。
    成功すると、インストーラーは確認メッセージを出力し、コード0で終了します。vega -vを実行して、SDKがインストールされていて、想定されたバージョンであることを確認してから続行します。
その他の構成オプションについては、以下のセクションを参照してください。

環境変数の構成

次の環境変数を使用してインストーラースクリプトを制御します。

Dockerの統合

Dockerは、Vega SDKを使用してアプリケーションを構築するための一貫性のある分離環境を提供します。次の例は、必要なすべての依存関係と構成を含むビルド環境を作成する方法を示しています。このアプローチは、コンテナベースのビルドをサポートするさまざまなCIソリューションに適用できます。

Dockerfileの例

Dockerイメージをビルドするには、次のコマンドを実行します。SDKのインストールページで必要なSDKバージョンを見つけ、開発マシンではなく、お使いのCIビルドホストに一致するビルドホスト構成を必ず選択します。

パイプラインでの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にセクションを追加してください。

関連トピック


最終更新日 2026年10月29日