Vega仮想デバイスに関する問題のトラブルシューティング
このページでは、Vega仮想デバイス（VVD）に関するよくある問題の解決策を示します。解決策がここで見つからない場合、開発者フォーラムに問題を投稿すれば追加のサポートを受けることができます。
WebviewベースのVegaアプリがUbuntuで失敗する
Module dependency not found: /com.amazon.vega.webview_3@IWebview_3
原因：
VVDは、UbuntuまたはIntelベースのMacプラットフォームでのWebviewをサポートしていません。
解決策：
Webviewアプリのテストには、Apple Silicon Mac（M1、M2、M3、M4）またはFire TV 4K Selectを使用します。
代替手段： すべてのプラットフォームで仮想デバイスを完全にサポートするには、Vega SDKの使用を検討してください。
起動後にVVDがクラッシュする
原因：
次のような原因でVVDの起動が妨げられる可能性があります。
• 特定のUSBハブまたはドッキングステーション
• オーディオインターフェイス（Focusrite 2i2など）を入力と出力の両方に同時に使用する場合
解決策：
USBまたはドッキングステーションの干渉の場合：
- ホストマシンからすべてのUSBハブを取り外します。
- ホストマシンからすべてのドッキングステーションを取り外します。
- VVDを再起動します。
オーディオインターフェイスのクラッシュ（起動後10〜20秒で発生）の場合：
- オーディオインターフェイスは入力と出力のいずれかに使用します。両方を同時に使用することはできません。
- または、VVDを実行している間、一時的に入力と出力に別のデバイスを使用してください。
VVDをAmazonサービスに登録できない
原因：
Amazonのサービスをテストに使用するには、VVDを登録する必要があります。登録プロセスを完了しないと、アプリは仮想デバイス上のAmazonサービスにアクセスできません。
解決策：
- 右上の [Register this device] をクリックします。
- 画面に表示されている登録コードを記録します。
- www.amazon.com/codeにアクセスして、コードを入力します。
次のメッセージが表示されたら登録は完了です。
Your device has successfully been registered
メモリ不足が原因でVVDがクラッシュする
原因： リソースを大量に使用する複数のプロセス（画面、オーディオ、ビデオの録画など）を同時に実行すると、VVDがクラッシュすることがあります。メモリ使用量が多いと、メモリが圧迫され、VVDのクラッシュが発生します。
解決策： VVDの実行中にメモリ使用量を確認します。
Macの場合：
- アクティビティモニタを開きます（[アプリケーション] > [ユーティリティ] > [アクティビティモニタ]）。
- [メモリ] タブをクリックします。
Linuxの場合：
- ターミナルを開きます。
-
次のいずれかのコマンドを使用します。
top（基本的なシステムモニター）htop（インストールされている場合、より使いやすい）free -h（メモリをバイト数ではなくGB/MBで表示）
free -h total used free Mem: 16G 8.2G 4.3G-hを指定しない場合、バイト数が出力されます。
free total used free Mem: 16777216 8388608 4304892
使用可能なメモリが2GB未満の場合：
- リソース使用量の多いプロセスを終了します。
- 不要なアプリを閉じます。
-
VVDを再起動します。
vega virtual-device start
VVDが起動しない
原因：
Ubuntuシステムで仮想テクノロジー（KVM）が無効になっているため、/dev/kvmの読み取りまたは書き込みパーミッションに関するエラーが表示されます。
解決策：
UbuntuイメージでKVM仮想化テクノロジーが有効になっていることを確認してください。Ubuntuを仮想マシンとして実行している場合は、[設定] > [プロセッサとメモリ] > [詳細オプション] に移動し、ハイパーバイザーアプリのサポートを有効にします。
デバイスサービスのクラッシュ後にアプリがフリーズする
原因：
VVDサービスがクラッシュし、アプリがフリーズして応答しなくなります。VVDが接続を切断するため、サービスを再起動してもアプリがフリーズしたままになります。
解決策：
-
VVDを停止します。
vega virtual-device stop -
VVDを再起動します。
vega virtual-device start -
アプリを再起動します。
vega device launch-app [アプリ名] // 例 vega device launch-app com.example.sampleapp
VVDでインターネットに接続できない
原因：
ネットワーク構成に問題がある可能性があるため、VVDからインターネットに接続できません。
解決策：
VVDでシェルを開き、接続をテストします。
vega virtual-device start
vega device shell
ping www.amazon.com
想定される出力：
送信済みパケット3、受信済みパケット3、パケットロス0%
kepler-ui-componentsのモジュール依存関係が見つからない
原因：
アプリは@amazon-devices/kepler-ui-componentsを使用していますが、テストで使用しているのは必要なネイティブモジュールが含まれていない古いVVDバージョンです。SDKの各バージョンには、特定のネイティブOSコンポーネントを含むVVDイメージが含まれています。SDK 0.21以前のVVDバージョンには、最近の更新で追加されたネイティブモジュールは含まれていません。
症状：
アプリのインストール中に次のエラーが表示されます。
error (Module dependency not found): error: Unable to install '/tmp/myapp.vpkg'
as the required dependencies are not found on the device.
The Kepler Virtual Device is missing modules that are available on a physical
device.Test your app using a Fire TV Stick instead.
The following module dependencies declared in the application manifest are
not found:
/com.amazon.kepler.native_ui_components_2@INativeUiComponents_13
解決策：
最新のSDK（0.22以降）にアップグレードします。
vega sdk install
最新のSDKには、必要なすべてのネイティブモジュールを含む更新されたVVDが含まれています。
アップグレードできない場合は、次のいずれかの代替手段を試してください。
- 実際のFire TV Stick 4K Selectでテストします。物理デバイスは定期的に更新され、必要なすべてのモジュールが含まれています。
@amazon-devices/kepler-ui-components依存関係をアプリから削除するか、VVDテストの対象をUIコンポーネントを使用しない機能に限定します。
package-lock.jsonまたはyarn.lockを必ずソース管理にチェックインしてください。関連トピック
Last updated: 2026年2月27日
