Vega Studioでのビルドに関する問題の修正
このページでは、VS CodeでVega Studioを使用してアプリをビルドおよび実行する際に発生する一般的な問題の解決方法を説明します。解決策がここで見つからない場合、開発者フォーラムに問題を投稿すれば追加のサポートを受けることができます。
ポートフォワーディングが「operation unsuccessful」エラーで失敗する
原因： このエラーは、シミュレーターが実行されていないときに発生します。
解決策：
- [Vega Studio] > [Devices] に移動します。
- 「VirtualDevice:Tv (Not running)」と表示されている場合は、[プロジェクト] セクションに移動し、プロジェクト名の横にある [再生] ボタンをクリックします。
VS CodeでWebViewをロードする際にエラーが発生する
VS Codeの使用中に、画面に次のメッセージが表示される場合があります。
Error loading webview
原因： このエラーは、VS Codeの複数のインスタンスが開いている場合に発生します。
解決策： コマンドプロンプトでforce quit allを実行してすべてのインスタンスを終了し、VS Codeを再起動します。
新しいプロジェクトを作成するときにReact Native Tools拡張機能を有効化できない
新しいプロジェクトを作成するときに、次のエラーメッセージが表示されることがあります。
[Error] Failed to activate the React Native Tools extension (error code 702)
原因： VS Codeワークスペースの設定の問題により、React Native Tools拡張機能が正しく読み込まれません。
解決策： VS Codeのツールバーからプロジェクトをワークスペースとして開き（[ファイル] > [ファイルでワークスペースを開く]）、新しいワークスペースとして保存します。
アプリを起動しようとしたときにReact Nativeパッケージャーが既に実行されている
アプリを起動しようとすると、次のエラーが表示されます。
Failed to execute command.React Native Packager is already running
原因： この問題は、ワークスペースに複数のプロジェクトがあり、いずれかのアプリが現在実行されている場合に発生します。
解決策： 別のアプリを起動する前にパッケージャーを停止してください。VS Codeのコマンドパレットで、「React Native: Stop Packager」を実行します。
間違ったプロジェクトを選択するとReact Native Toolsパッケージャーが応答しなくなる
複数のプロジェクトを実行していて、RNパッケージャーで誤って間違ったプロジェクト名を選択した場合、React Native: Stop Packagerコマンドが無効になります。
原因： 間違ったプロジェクトを選択すると、React Native Tools拡張機能はアクティブなパッケージャープロセスを追跡できなくなります。
解決策： VS Codeウィンドウを再読み込みします。コマンドパレット： 開発者： Reload Windowを使用します。
- Ctrl+Shift+P（Linux）またはCmd+Shift+P（Mac）を押して、コマンドパレットを開きます。
- 「Developer: Reload Window」と入力します。
- VS Codeを再読み込みするコマンドを選択します。
- プロジェクトのパッケージャーを再起動します。
テンプレートを選択してもプロジェクトテンプレートが表示されない
原因： 現在のVS Codeセッションが、Vega SDKの環境変数を正しく読み込んでいません。
解決策： Vega SDKのインストールディレクトリから環境ファイルを取得します。コマンドプロンプトで、codeを実行してVS Codeを開きます。
ポートの競合によりビルドまたは起動が失敗する
原因： 必要なポートを別のプロセスが使用しています。
解決策： ポートの競合を解消するには、別のポートを選択します。
コードを変更しても、高速リフレッシュ機能でアプリが更新されない
原因： ポートフォワーディング接続の問題により、高速リフレッシュがデバイスと通信できません。
解決策： 逆方向のポート転送の接続をリセットし、アプリを再起動します。
-
現在のリストを確認します。
vega exec vda reverse --list -
すべてのリストを削除します。
vega exec vda reverse --remove-all -
アプリを再起動します。
行単位のデバッグが機能しない
原因： 開発者モードの構成が正しくないか、デバッグホスト構成が欠落している可能性があります。
解決策： この問題を解決するには、開発者モードの構成とshared_preferences.jsonを確認します。Fire TV Stickでの開発者モードの構成を参照してください。
カスタムポートで行単位のデバッグを有効にするには、shared_preferences.jsonファイルに次の構成を追加します。
{
"debug_http_host": "localhost:<ポート>"
}
<ポート>は、使用するポートの実際のポート番号に置き換えてください。
ビルドが「Missing [os.version]」というエラーで失敗する
アプリのビルド時に次のエラーが表示されます。
Missing [os.version].target.A Vega application must declare its OS version.
Missing [os.version].min. Declare both min and target in [os.version].
Vega operation FAILED due to an irrecoverable error: vega build refused: 2 OS-version compliance error(s) in manifest.toml.
原因： Vega SDK 0.24以降では、manifest.tomlに[os.version]セクションが必要です。この要件の追加前に作成された既存のプロジェクトには、このセクションが含まれていません。
解決策： プロジェクトルートから次のコマンドを実行した後、再ビルドします。
vega project update-manifest --os-min 1.2 --os-version 1.2
手動でmanifest.tomlにセクションを追加することもできます。
[[needs.module]]
id = "/com.amazon.vega.os@IVega_1_2"
[os.version]
target = "1.2"
min = "1.2"
詳細については、リリースノートのアプリのマニフェストに必要なOSバージョンを参照してください。
関連トピック
Last updated: 2026年8月6日
