Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
このページでは、VS CodeでVega Studioを使用してアプリをビルドおよび実行する際に発生する一般的な問題の解決方法を説明します。解決策がここで見つからない場合は、開発者フォーラムに問題を投稿すると追加のサポートを受けることができます。

ポートフォワーディングが「operation unsuccessful」エラーで失敗する

原因: このエラーは、Vega仮想デバイスが実行されていないときに発生します。 解決策:
  1. [Vega Studio] > [Devices] に移動します。
  2. ステータスが「VirtualDevice:Tv (Not running)」と表示されている場合は、[Projects] に移動し、プロジェクト名の横にある [Play] ボタンをクリックします。

VS CodeでWebViewをロードする際にエラーが発生する

VS Codeの使用中に、画面に次のメッセージが表示される場合があります。
原因: このエラーは、VS Codeの複数のインスタンスが開いている場合に発生します。 解決策: 開いているVS Codeのインスタンスをすべて終了し、再起動します。

新しいプロジェクトを作成するときにReact Native Tools拡張機能を有効化できない

新しいプロジェクトを作成するときに、次のエラーメッセージが表示されることがあります。
原因: VS Codeワークスペースの設定の問題により、React Native Tools拡張機能が正しく読み込まれません。 解決策: VS Codeのツールバーからプロジェクトをワークスペースとして開き([ファイル] > [ファイルでワークスペースを開く])、新しいワークスペースとして保存します。

アプリを起動しようとしたときにReact Nativeパッケージャーが既に実行されている

アプリを起動しようとすると、次のエラーが表示されます。
原因: この問題は、ワークスペースに複数のプロジェクトがあり、いずれかのアプリが現在実行されている場合に発生します。 解決策: 別のアプリを起動する前にパッケージャーを停止してください。VS Codeのコマンドパレットで、「React Native: Stop Packagerと入力します。

間違ったプロジェクトを選択するとReact Native Toolsパッケージャーが応答しなくなる

複数のプロジェクトを実行していて、React Nativeパッケージャーで誤って間違ったプロジェクト名を選択した場合、React Native: Stop Packagerコマンドが無効になります。 原因: 間違ったプロジェクトを選択すると、React Native Tools拡張機能はアクティブなパッケージャープロセスを追跡できなくなります。 解決策: コマンドパレットからVS Codeウィンドウを再読み込みします。
  1. Ctrl+Shift+P(Linux)またはCmd+Shift+P(Mac)を押して、Command Paletteを開きます。
  2. Developer: Reload Window と入力します。
  3. VS Codeを再読み込みするコマンドを選択します。
  4. プロジェクトのパッケージャーを再起動します。

テンプレートを選択してもプロジェクトテンプレートが表示されない

原因: 現在のVS Codeセッションが、Vega SDKの環境変数を正しく読み込んでいません。 解決策: Vega SDKの環境変数を読み込むには、次のコマンドを実行し、同じターミナルからcodeを使用してVS Codeを開きます:

ポートの競合によりビルドまたは起動が失敗する

原因: 必要なポートを別のプロセスが使用しています。 解決策: ポートの競合を解決するには、VS Codeで別のReact Nativeポートを設定してください。手順については、「手順3: (任意)カスタムポートの構成」を「Vega Studioを使用したアプリのビルド」で参照してください。

コードを変更しても、高速リフレッシュ機能でアプリが更新されない

原因: ポートフォワーディング接続の問題により、高速リフレッシュがデバイスと通信できません。 解決策: 逆方向のポート転送の接続をリセットし、アプリを再起動します。
  1. 現在の逆方向のポート転送ルールを一覧表示します。
  2. すべての逆方向のポート転送ルールを削除します。
  3. アプリを再起動します。

行単位のデバッグが機能しない

原因: 開発者モードが設定されていないか、デバッグホスト設定がshared_preferences.jsonにありません。 解決策: 問題を解決するには、開発者モードを確認し、shared_preferences.jsonを確認してください。詳細については、Fire TV Stickでの開発者モードの構成を参照してください。 カスタムポートで行単位のデバッグを有効にするには、デバイスの/data/shared_preferences.jsonファイルに次の構成を追加します。
を、使用しているポート番号に置き換えます。

ビルドが「Missing [os.version]」というエラーで失敗する

アプリのビルド時に次のエラーが表示されます。
原因: Vega SDK 0.24以降では、manifest.tomlに[os.version]セクションが必要です。この要件の追加前に作成された既存のプロジェクトには、このセクションが含まれていません。 解決策: プロジェクトルートから次のコマンドを実行した後、再ビルドします。
手動でmanifest.tomlにセクションを追加することもできます。
SDK 2.0の場合は、min = "2.0"が推奨設定です。どのような場合に1.2を代わりに使用するかについては、minを選ぶを参照してください。 ソースmanifest.tomlに、OSバージョンのモジュールエントリ(/com.amazon.vega.os@IVega_*)を追加しないでください。それらのエントリは、ビルドが[os.version]から生成します。詳細については、マニフェストの [os.version] セクションを参照してください。 OS 1.2を引き続きサポートしながら、既存のアプリをターゲットOS 2.0 にアップグレードするには、アプリのOSバージョン互換性のアップグレード方法を参照してください。お使いのアプリがSDK 0.23以前でビルドされている場合は、「SDK 0.23以前からの移行」を参照してください。

関連トピック


最終更新日 2026年10月23日