SDKバージョンの管理

Vega SDK Managerには、Vega CLI（vegaというコマンドラインバイナリ）からアクセスできます。このツールを使用すると、開発プロジェクトのSDKバージョンを簡単に管理できます。インストール、バージョン間の切り替え、CI/CDパイプラインとの統合をシームレスに行うことができます。Node.jsのnvmやPythonのpyenvのように機能します。

前提条件

次に進む前に、Vega CLIがインストールされていることを確認します。

最新のVega SDK（バージョン0.22以降）がインストールされている場合： Vega CLIは既に利用可能です。開始の手順または一般的なワークフローに進んでください。

Vega SDKのバージョンが古い場合： Vega SDKのインストール手順に従って最新バージョンにアップグレードします。

開始の手順

次の手順に従ってインストールを確認し、最初のプロジェクト構成を作成します。

1. SDK Managerがインストールされているか確認します。

   コードをコピー クリップボードにコピーしました。

   vega --version
   

   「command not found」というエラーが表示された場合は、前提条件に従ってVega SDKをインストールまたはアップグレードします。

2. Vega SDKをインストールします（必要な場合）。

   最新のSDKバージョンをインストールするには

   コードをコピー クリップボードにコピーしました。

   vega sdk install
   

   Vega Virtual Device installation:

   Vega SDKはデフォルトでVega仮想デバイス（VVD）をインストールします。VVDは、Vegaアプリをテストして実行するための仮想環境を提供します。たとえば、CI/CD環境では、仮想デバイスは必要ありません。

   仮想デバイスのインストールをスキップする場合は、インストールコマンドを実行する前に、環境変数SKIP_VVD_INSTALL=trueを使用します。

   コードをコピー クリップボードにコピーしました。

   export SKIP_VVD_INSTALL=true
   vega sdk install
   

   特定のバージョンをインストールするには

   コードをコピー クリップボードにコピーしました。

   vega sdk install 1.2.3
   

   使用可能なバージョンを確認するには

   コードをコピー クリップボードにコピーしました。

   vega sdk list-remote
   

3. インストールを確認します。

   コードをコピー クリップボードにコピーしました。

   vega sdk list-installed
   

4. プロジェクトのルートにvega-sdk-requirements.jsonファイルを作成します。

   コードをコピー クリップボードにコピーしました。

   {
      "vegaSdkVersion": "1.2.3"
   }
   

一般的なワークフロー

これらの例は、開発ワークフローでSDK Managerを使用する方法を示しています。

新しいプロジェクトのセットアップ

このワークフローに従って、新しいVegaプロジェクトの開発環境を構成します。

1. Vega CLIがインストールされていることを確認します。

   コードをコピー クリップボードにコピーしました。

   vega --version
   

2. SDKをインストールします。

   コードをコピー クリップボードにコピーしました。

   vega sdk install
   

3. インストールを検証します。

   コードをコピー クリップボードにコピーしました。

   vega sdk list-installed
   

4. ヘルスチェックを実行します。

   コードをコピー クリップボードにコピーしました。

   vega sdk config doctor
   

   これにより、SDKのインストールが検証され、環境の構成がチェックされ、潜在的な問題が特定されます。

5. プロジェクト要件ファイルを作成します（推奨）。

   コードをコピー クリップボードにコピーしました。

   echo '{"vegaSdkVersion": "1.2.3"}' > vega-sdk-requirements.json
   

要件ファイルの仕組み

vega-sdk-requirements.jsonを含むディレクトリで任意のVegaコマンドを実行すると、Vegaは以下のように動作します。

1. ファイル内のvegaSdkVersionフィールドを検索します。
2. そのプロジェクトのすべてのSDK操作にvegaSdkVersionを使用します。
3. すべてのグローバルデフォルトバージョン設定をオーバーライドします。

プロジェクト構造の例

バージョン要件のある一般的なプロジェクトは次のようになります。

my-project/
├── vega-sdk-requirements.json
├── src/
└── README.md

vega-sdk-requirements.jsonファイルには以下が含まれます。

{
  "vegaSdkVersion": "1.2.3"
}

複数のプロジェクトの管理

vega-sdk-requirements.jsonを使用すると、各プロジェクトで独自のSDKバージョンを使用できます。

# プロジェクトAはSDK 1.2.3を使用する
cd project-a
cat vega-sdk-requirements.json  # {"Vega SDKバージョン"： "1.2.3"}
vega sdk list-installed  # 1.2.3がアクティブと表示される
vega build

# プロジェクトBはSDK 2.0.0を使用する
cd ../project-b
cat vega-sdk-requirements.json  # {"Vega SDKバージョン"： "2.0.0"}
vega sdk list-installed  # 2.0.0がアクティブと表示される
vega build

SDKバージョンの更新

最新のSDK機能とバグ修正により、プロジェクトを常に最新の状態に保ちましょう。

クイックアップデート

1. 利用可能なバージョンを確認します。

   コードをコピー クリップボードにコピーしました。

   vega sdk list-remote
   

2. 新しいバージョンをインストールします。

   コードをコピー クリップボードにコピーしました。

   vega sdk install 2.0.0
   

3. デフォルトとして設定します（オプション）。

   コードをコピー クリップボードにコピーしました。

   vega sdk use 2.0.0
   

4. （オプション）古いバージョンをクリーンアップします。

   コードをコピー クリップボードにコピーしました。

   vega sdk uninstall 1.2.3
   

安全な更新（コミット前のテスト）

マージする前に、新しいSDKバージョンを別のブランチでテストします。

# 既存のバージョンと一緒に新しいバージョンをインストールする
vega sdk install 2.0.0

# 別のブランチでテストする
git checkout -b test-sdk-2.0.0
echo '{"vegaSdkVersion": "2.0.0"}' > vega-sdk-requirements.json
vega build

# 成功したら、チームを統合して更新する
git checkout main
git merge test-sdk-2.0.0

既存のSDKインストールのリンク

SDK Managerの外部に既にVega SDKがインストールされている場合は、再インストールする代わりにリンクできます。

# KEPLER_SDK_PATHから自動検出する
vega sdk link --discover

# または特定のパスからリンクする
vega sdk link --path /path/to/existing/sdk

# リンクを確認する
vega sdk list-installed

CI/CDの統合

CI/CDパイプラインのような自動化環境向けに、Vegaは非インタラクティブモードを有効にする2つの方法を提供しています。これにより、自動化を妨げるようなプロンプトやインタラクティブな動作を防ぐことができます。

自動化のための非インタラクティブモード

方法1： CLIフラグ（個別のコマンドに推奨）

サポートしているコマンドには--non-interactiveフラグを使用します。

# プロンプトなしでSDKをインストールする
vega sdk install --non-interactive

# 非インタラクティブに構成をセットアップする
vega sdk config setup --non-interactive --sdk-path /opt/vega-sdk

# プロンプトなしでSDKをリンクする
vega sdk link --discover --non-interactive

方法2： 環境変数（パイプライン全体に推奨）

NONINTERACTIVE環境変数をtrueに設定します。

# セッション全体の環境変数を設定する
export NONINTERACTIVE=true

# これですべてのコマンドが非インタラクティブに実行されるようになる
vega sdk install
vega sdk config setup
vega sdk link --discover

優先ルール

両方の方法を使用する場合、CLIフラグが優先されます。

1. CLIフラグ（--non-interactive）- 優先度が最も高い。
2. 環境変数（NONINTERACTIVE=true）- 優先度が低い。

これにより、環境変数でデフォルトの動作を設定しながら、必要に応じてCLIフラグでオーバーライドできます。

高度な機能

これらの高度な構成オプションにより、特殊な開発環境やワークフローの柔軟性が高まります。

カスタム構成ファイルの場所

デフォルトでは、Vegaは構成を~/vega/config.jsonに保存します。VEGA_CONFIG_FILE環境変数を使用してこの場所をカスタマイズできます。これは次のような場合に便利です。

• 同じマシンで複数のVega構成を実行する
• チーム全体で共有する構成ファイルを使用する
• デフォルトパスが適切でないCI/CD環境
• メインセットアップに影響を与えずにさまざまな構成をテストする

カスタム構成パスの設定

# カスタム構成ファイルの場所を設定する
export VEGA_CONFIG_FILE="/path/to/custom/config.json"
  		  
# 次に、セットアップまたはその他のコマンドを実行する
vega sdk config setup
  		  
# または1つのコマンドで結合する
export VEGA_CONFIG_FILE="/path/to/custom/config.json" && vega sdk config setup

カスタム構成パスの永続化

カスタム構成の場所を永続的に使用するには、シェルプロファイルにエクスポートを追加します。

# bashの場合（~/.bashrcまたは~/.bash_profile）
echo 'export VEGA_CONFIG_FILE="/path/to/custom/config.json"' >> ~/.bashrc
  		  
# zshの場合（~/.zshrc）
echo 'export VEGA_CONFIG_FILE="/path/to/custom/config.json"' >> ~/.zshrc

CI/CDの例

# CI/CDパイプラインのカスタム構成を設定する
export VEGA_CONFIG_FILE="/opt/ci/config.json"
export NONINTERACTIVE=true
  		  
# セットアップおよびインストールする
vega sdk config setup --sdk-path /opt/vega-sdk
vega sdk install

ベストプラクティス

これらのプラクティスは、よくある問題を回避し、SDK Managerを使用して安定した開発環境を維持するのに役立ちます。

1. 必ず要件ファイルを使用してください。

   vega-sdk-requirements.jsonをバージョン管理にコミットすることで、チーム全体で一貫したSDKバージョンを作成できます。

2. 特定のバージョンを固定します。

   正確なバージョン番号を使用することで、破壊的変更を回避し、再現性のあるビルドを確保します。

   // 特定の バージョン
   {"vegaSdkVersion": "1.2.3"}
   

3. SDK Managerを最新の状態に保ちます。

   SDK Managerの新しいバージョンには、改善、バグ修正、新しいSDKバージョンのサポートが含まれています。

   コードをコピー クリップボードにコピーしました。

   vega update
   

4. CI/CDでは非インタラクティブモードを使用します。

   CI/CDパイプラインはプロンプトや確認に応答できません。非インタラクティブモードを使用しないと、ビルドがユーザー入力を待ち続けて無期限に停止する可能性があります。

   # パイプライン全体の環境変数を設定する
   export NONINTERACTIVE=true
   export SKIP_VVD_INSTALL=true
   
   # 特定のコマンドにフラグを使用する
   vega sdk install --non-interactive 
   

コマンドリファレンス

このセクションでは、SDK Managerのすべてのコマンドとその説明を一覧表示します。特定のコマンド構文が必要な場合は、これを簡単な検索方法として使用してください。

基本コマンド

CI/CDコマンド

ヘルプ

グローバルオプション

トラブルシューティング

問題が発生した場合は、SDK Managerの問題についてのトラブルシューティングを参照してください。

関連トピック

• Vega SDKのインストール
• Vega SDKのインストールに関する問題

Last updated: 2025年12月22日