ポートフォワーディングが「operation unsuccessful」エラーで失敗する
原因: このエラーは、Vega仮想デバイスが実行されていないときに発生します。 解決策:- [Vega Studio] > [Devices] に移動します。
- ステータスが「VirtualDevice:Tv (Not running)」と表示されている場合は、[Projects] に移動し、プロジェクト名の横にある [Play] ボタンをクリックします。
VS CodeでWebViewをロードする際にエラーが発生する
VS Codeの使用中に、画面に次のメッセージが表示される場合があります。新しいプロジェクトを作成するときにReact Native Tools拡張機能を有効化できない
新しいプロジェクトを作成するときに、次のエラーメッセージが表示されることがあります。アプリを起動しようとしたときにReact Nativeパッケージャーが既に実行されている
アプリを起動しようとすると、次のエラーが表示されます。間違ったプロジェクトを選択するとReact Native Toolsパッケージャーが応答しなくなる
複数のプロジェクトを実行していて、React Nativeパッケージャーで誤って間違ったプロジェクト名を選択した場合、React Native: Stop Packagerコマンドが無効になります。 原因: 間違ったプロジェクトを選択すると、React Native Tools拡張機能はアクティブなパッケージャープロセスを追跡できなくなります。 解決策: コマンドパレットからVS Codeウィンドウを再読み込みします。- Ctrl+Shift+P(Linux)またはCmd+Shift+P(Mac)を押して、Command Paletteを開きます。
- Developer: Reload Window と入力します。
- VS Codeを再読み込みするコマンドを選択します。
- プロジェクトのパッケージャーを再起動します。
テンプレートを選択してもプロジェクトテンプレートが表示されない
原因: 現在のVS Codeセッションが、Vega SDKの環境変数を正しく読み込んでいません。 解決策: Vega SDKの環境変数を読み込むには、次のコマンドを実行し、同じターミナルからcodeを使用してVS Codeを開きます:
ポートの競合によりビルドまたは起動が失敗する
原因: 必要なポートを別のプロセスが使用しています。 解決策: ポートの競合を解決するには、VS Codeで別のReact Nativeポートを設定してください。手順については、「手順3: (任意)カスタムポートの構成」を「Vega Studioを使用したアプリのビルド」で参照してください。コードを変更しても、高速リフレッシュ機能でアプリが更新されない
原因: ポートフォワーディング接続の問題により、高速リフレッシュがデバイスと通信できません。 解決策: 逆方向のポート転送の接続をリセットし、アプリを再起動します。-
現在の逆方向のポート転送ルールを一覧表示します。
-
すべての逆方向のポート転送ルールを削除します。
- アプリを再起動します。
行単位のデバッグが機能しない
原因: 開発者モードが設定されていないか、デバッグホスト設定がshared_preferences.jsonにありません。
解決策: 問題を解決するには、開発者モードを確認し、shared_preferences.jsonを確認してください。詳細については、Fire TV Stickでの開発者モードの構成を参照してください。
カスタムポートで行単位のデバッグを有効にするには、デバイスの/data/shared_preferences.jsonファイルに次の構成を追加します。
ビルドが「Missing [os.version]」というエラーで失敗する
アプリのビルド時に次のエラーが表示されます。manifest.tomlに[os.version]セクションが必要です。この要件の追加前に作成された既存のプロジェクトには、このセクションが含まれていません。
解決策: プロジェクトルートから次のコマンドを実行した後、再ビルドします。
manifest.tomlにセクションを追加することもできます。
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以前からの移行」を参照してください。
関連トピック
- Vega Studioを使用したアプリのビルド
- Vega Studioのセットアップ
- Vega仮想デバイスまたはFire TVでのアプリの実行
- Vega Studioを使用して1行ずつデバッグを実行する方法
- 高速リフレッシュに関する問題の解決

