Android Emulator のトラブルシューティング
この記事では、Android Emulator の構成および実行中に発生する、最も一般的な警告メッセージと問題について説明します。 さらに、これらのエラーを解決するための解決策と、エミュレーターの問題の診断に役立つさまざまなトラブルシューティングのヒントについて説明します。
Windows での展開に関する問題
アプリを展開するときに、エミュレーターによっていくつかのエラー メッセージが表示される場合があります。 ここでは、最も一般的なエラーと解決策について説明します。
配置エラー
エミュレーターでの APK のインストールの失敗、または Android Debug Bridge (adb) の実行の失敗に関するエラーが表示された場合は、Android SDK がエミュレーターに接続できることを確認してください。 エミュレーターの接続を確認するには、次の手順を実行します。
Android Device Manager からエミュレーターを起動します (仮想デバイスを選択し、[開始] をクリックします)。
コマンド プロンプトを開き、adb がインストールされているフォルダーに移動します。 既定の場所に Android SDK がインストールされている場合、adb は C:\Program Files (x86)\Android\android-sdk\platform-tools\adb.exe にあります。この場所にインストールされていない場合は、このパスをお使いのコンピューター上にある Android SDK の場所に変更します。
次のコマンドを入力します。
adb devicesAndroid SDK からエミュレーターにアクセスできる場合は、接続されているデバイスの一覧にエミュレーターが表示されます。 次に例を示します。
List of devices attached emulator-5554 deviceこの一覧にエミュレーターが表示されない場合は、Android SDK マネージャーを起動し、すべての更新プログラムを適用し、エミュレーターをもう一度起動してみてください。
MMIO アクセス エラー
「MMIO アクセス エラーが発生しました」というメッセージが表示されたら、エミュレーターを再起動します。
Google Play 開発者サービスが見つからない
この状態は、エミュレーターで実行している仮想デバイスに Google Play 開発者サービス、または Google Play ストアがインストールされていない場合に、これらのパッケージを含めずに仮想デバイスを作成することでしばしば発生します。 仮想デバイスを作成する (「Android Device Manager による仮想デバイスの管理」を参照) ときに、次のオプションのいずれかまたは両方を必ず選択してください。
- Google API – 仮想デバイスに Google Play 開発者サービスを含めます。
- Google Play ストア – 仮想デバイスに Google Play ストアを含めます。
たとえば、この仮想デバイスには、Google Play 開発者サービスと Google Play ストアが含まれます。
Note
Google Play ストアのイメージは、Pixel、Pixel 2、Nexus 5、Nexus 5 X などの一部の基本デバイスの種類でのみ使用できます。
パフォーマンスの問題
パフォーマンスの問題は、通常、次の問題のいずれかが原因で発生します。
ハードウェア アクセラレーションなしでエミュレーターを実行している。
エミュレーターで実行されている仮想デバイスが、x86 ベースのシステム イメージを使用していない。
以降のセクションでは、これらのシナリオについて詳しく説明します。
ハードウェア アクセラレーションが有効化されていない
ハードウェア アクセラレーションが有効化されていない場合、デバイス マネージャーから仮想デバイスを起動すると、Windows ハイパーバイザー プラットフォーム (WHPX) が正しく構成されていないことを示すエラー メッセージが表示されたダイアログが生成されます。
このエラー メッセージが表示された場合は、ハードウェア アクセラレーションを確認して有効化する手順について、後述の「ハードウェア アクセラレーションの問題」を参照してください。
アクセラレーションは有効化されているが、エミュレーターの実行が遅すぎる
この問題の一般的な原因は、仮想デバイス (AVD) で x86 ベースのイメージが使用されていないことです。 仮想デバイスを作成する (「Android Device Manager による仮想デバイスの管理」を参照) ときに、必ず x86 ベースのイメージを選択してください。
ハードウェア アクセラレーションの問題
ハードウェア アクセラレーションに Hyper-V または HAXM を使用しているかどうかに関わらず、構成の問題やコンピューター上の他のソフトウェアとの競合が発生する場合があります。 ハードウェア アクセラレーションが有効になっていること (およびどのアクセラレーション メソッドをエミュレーターが使用しているか) を確認するには、コマンド プロンプトを開き、次のコマンドを入力します。
"C:\Program Files (x86)\Android\android-sdk\emulator\emulator-check.exe" accel
このコマンドでは、Android SDK が既定の場所 (C:\Program Files (x86)\Android\android-sdk) にインストールされていることを前提としています。そうでない場合は、上記のパスをご使用のコンピューター上にある Android SDK の場所に変更します。
ハードウェア アクセラレーションが使用できない
Hyper-V が使用可能な場合、emulator-check.exe accel コマンドから次の例のようなメッセージが返されます。
HAXM is not installed, but Windows Hypervisor Platform is available.
HAXM が使用可能な場合は、次の例のようなメッセージが返されます。
HAXM version 6.2.1 (4) is installed and usable.
ハードウェア アクセラレーションが使用できない場合は、次の例のようなメッセージが表示されます (Hyper-V が見つからない場合、エミュレーターは HAXM を検索します)。
HAXM is not installed on this machine
ハードウェア アクセラレーションが使用できない場合は、「Accelerating with Hyper-V」 (Hyper-V による高速化) で、ご使用のコンピューターでハードウェア アクセラレーションを有効化する方法を確認してください。
不適切な BIOS 設定
BIOS がハードウェア アクセラレーションをサポートするように適切に構成されていないと、emulator-check.exe accel コマンドを実行したときに、次の例のようなメッセージが表示されます。
VT feature disabled in BIOS/UEFI
この問題を修正するには、コンピューターを再起動して BIOS に入り、次のオプションを有効にします。
- 仮想化テクノロジ (マザーボードの製造元によって、ラベルが異なる場合があります)。
- ハードウェアによるデータ実行防止。
ハードウェア アクセラレーションが有効になっていて、BIOS が正しく構成されている場合は、エミュレーターはハードウェア アクセラレーションを使用して正常に実行されるはずです。 ただし、次で説明するように、Hyper-V と HAXM に固有の問題により、問題が発生する可能性はまだあります。
Hyper-V の問題
場合によっては、[Windows の機能の有効化または無効化] ダイアログで [Hyper-V] と [Windows Hypervisor Platform] の両方を有効化すると、Hyper-V が正しく有効化されない場合があります。 Hyper-V が有効になっていることを確認するには、次の手順を実行します。
Windows の検索ボックスに「powershell」と入力します。
検索結果で [Windows PowerShell] を右クリックし、[管理者として実行] を選択します。
PowerShell コンソールで、次のコマンドを入力します。
Get-WindowsOptionalFeature -FeatureName Microsoft-Hyper-V-All -OnlineHyper-V が有効になっていない場合は、Hyper-V の状態が Disabled (無効) であることを示す次の例のようなメッセージが表示されます。
FeatureName : Microsoft-Hyper-V-All DisplayName : Hyper-V Description : Provides services and management tools for creating and running virtual machines and their resources. RestartRequired : Possible State : Disabled CustomProperties :PowerShell コンソールで、次のコマンドを入力します。
Get-WindowsOptionalFeature -FeatureName HypervisorPlatform -Onlineハイパーバイザーが有効になっていない場合は、HypervisorPlatform の状態が Disabled (無効) であることを示す次の例のようなメッセージが表示されます。
FeatureName : HypervisorPlatform DisplayName : Windows Hypervisor Platform Description : Enables virtualization software to run on the Windows hypervisor RestartRequired : Possible State : Disabled CustomProperties :
Hyper-V および HypervisorPlatform のいずれかまたは両方が有効になっていない場合は、次の PowerShell コマンドを使用して有効にします。
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform -All
これらのコマンドが完了したら、再起動します。
Hyper-V を有効化する (Deployment Image Servicing and Management ツールを使用して Hyper-V を有効化する手法を含む) 詳細については、Hyper-V のインストールに関するページを参照してください。
HAXM の問題
HAXM の問題は、その他の仮想化テクノロジとの競合、間違った設定、または HAXM ドライバーの期限切れが原因で発生することがよくあります。
HAXM プロセスが実行されていません
HAXM がインストールされている場合は、コマンド プロンプトを開き、次のコマンドを入力することで、HAXM プロセスが実行されていることを確認できます。
sc query intelhaxm
HAXM プロセスが実行されている場合は、次の結果と同じような出力が表示されます。
SERVICE_NAME: intelhaxm
TYPE : 1 KERNEL_DRIVER
STATE : 4 RUNNING
(STOPPABLE, NOT_PAUSABLE, IGNORES_SHUTDOWN)
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x0
STATE が RUNNING に設定されていない場合は、「How to Use the Intel Hardware Accelerated Execution Manager」(Intel Hardware Accelerated Execution Manager の使用方法) を参照して問題を解決してください。
HAXM 仮想化の競合
HAXM が、仮想化を使用する他のテクノロジ (Hyper-V、Windows Device Guard、ウイルス対策ソフトウェア) と競合している可能性があります。
Hyper-V – Windows 10 April 2018 Update (ビルド 1803) より前のバージョンの Windows を使用しており、Hyper-V が有効になっている場合は、HAXM を有効化できるように、「Hyper-V を無効にする」の手順に従ってください。
Device Guard – Device Guard と Credential Guard により、Windows マシン上で Hyper-V を無効にできない可能性があります。 Device Guard と Credential Guard を無効にするには、「Disabling Device Guard」 (Device Guard を無効にする) を参照してください。
ウイルス対策ソフトウェア – (Avast など) ハードウェア補助による仮想化を使用するウイルス対策ソフトウェアを実行している場合は、そのソフトウェアを無効にするかアンインストールしてから、Android Emulator を再起動してみてください。
不適切な BIOS 設定
Windows PC 上で HAXM を使用する場合、BIOS 内で仮想化テクノロジ (Intel VT-x 対応) が有効になっていない限り、HAXM は機能しません。 VT-x が無効になっている場合に、Android Emulator の起動を試みると、次のようなエラーが表示されます。
このコンピューターは HAXM の要件を満たしていますが、Intel 仮想化テクノロジ (VT-x) がオンになっていません。
このエラーを修正するには、コンピューターを再起動して BIOS に入り、VT-x と SLAT (第 2 レベルのアドレス変換) の両方を有効にしてから、コンピューターを再起動して再度 Windows に入ります。
Hyper-V を無効にする
Windows 10 April 2018 Update (ビルド 1803) より前のバージョンの Windows を使用しており、Hyper-V が有効になっている場合、HAXM をインストールして使用するには Hyper-V を無効にしてコンピューターを再起動する必要があります。 Windows 10 April 2018 Update (ビルド 1803) 以降を使用している場合は、Android Emulator のバージョン 27.2.7 以降で (HAXM ではなく) Hyper-V を使用してハードウェアを高速化できるため、Hyper-V を無効にする必要はありません。
次の手順に従って、コントロール パネルから HYPER-V を無効にできます。
Windows 検索ボックスに「Windows の機能」を入力し、検索結果で [Windows の機能の有効化または無効化] を選択します。
[Hyper-V] をオフにします。
コンピューターを再起動します。
または、次の PowerShell コマンドを使用して Hyper-V ハイパーバイザーを無効にすることもできます。
Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-Hypervisor
Intel HAXM および Microsoft HYPER-V の両方を同時にアクティブ化することはできません。 残念ながら、コンピューターを再起動せずに Hyper-V と HAXM を切り替える方法はありません。
Device Guard と Credential Guard が有効になっていると、上記の手順で HYPER-V を無効にできない場合があります。 HYPER-V を無効にできない場合 (または無効になっているように見えるが、HAXM のインストールがまだ失敗する場合) は、次のセクションの手順に従って、Device Guard と Credential Guard を無効にします。
Device Guard の無効化
Device Guard と Credential Guard により、Windows コンピューター上で Hyper-V を無効にできない場合があります。 この状況は多くの場合、所有している組織によって構成され、制御されている、ドメインに参加しているマシンの問題です。 Windows 10 で、次の手順を使用して、Device Guard が実行されているかどうかを確認します。
Windows 検索ボックスに「システム情報」と入力し、検索結果で [システム情報] を選択します。
[システムの概要] で、[Device Guard 仮想化ベースのセキュリティ] があり、実行状態になっているかどうかを確認します。
Device Guard が有効になっている場合は、次の手順に従って無効にします。
前のセクションで説明したように、([Windows の機能の有効化または無効化] の下で) HYPER-V が無効になっていることを確認します。
Windows 検索ボックスで、「gpedit.msc」を入力し、検索結果で [グループ ポリシーの編集] を選択します。 この手順によりローカル グループ ポリシー エディターが起動します。
ローカル グループ ポリシー エディターで、[コンピューターの構成]、[管理用テンプレート]、[システム]、[Device Guard] の順に移動します。
(上記のように) [仮想化ベースのセキュリティを有効にする] を [無効] に変更し、ローカル グループ ポリシー エディターを終了します。
Windows 検索ボックスに「cmd」を入力します。 検索結果に [コマンド プロンプト] が表示されたら、[コマンド プロンプト] を右クリックして [管理者として実行] を選択します。
次のコマンドをコピーしてコマンド プロンプト ウィンドウに貼り付けます (ドライブ Z: が使用中の場合は、代わりに使用する未使用のドライブ文字を選択してください)。
mountvol Z: /s copy %WINDIR%\System32\SecConfig.efi Z:\EFI\Microsoft\Boot\SecConfig.efi /Y bcdedit /create {0cb3b571-2f2e-4343-a879-d86a476d7215} /d "DebugTool" /application osloader bcdedit /set {0cb3b571-2f2e-4343-a879-d86a476d7215} path "\EFI\Microsoft\Boot\SecConfig.efi" bcdedit /set {bootmgr} bootsequence {0cb3b571-2f2e-4343-a879-d86a476d7215} bcdedit /set {0cb3b571-2f2e-4343-a879-d86a476d7215} loadoptions DISABLE-LSA-ISO,DISABLE-VBS bcdedit /set {0cb3b571-2f2e-4343-a879-d86a476d7215} device partition=Z: mountvol Z: /dコンピューターを再起動します。 起動画面に、次のようなメッセージのプロンプトが表示されます。
Do you want to disable Credential Guard? (Credential Guard を無効にしますか)
指示に従って指定されたキーを押して Credential Guard を無効にします。
コンピューターが再起動したら、(前の手順で説明したように) HYPER-V が無効になっていることを確認します。
HYPER-V がまだ無効になっていない場合は、ドメインに参加しているコンピューターのポリシーによって Device Guard または Credential Guard を無効にできないようになっている可能性があります。 この場合、Credential Guard を無効化できるように適用除外をドメイン管理者に依頼することができます。 または、HAXM を使用する必要がある場合は、ドメインに参加していないコンピューターを使用することができます。
その他のトラブルシューティングのヒント
次の推奨事項は多くの場合、Android Emulator の問題の診断に役立ちます。
コマンド ラインから Android Emulator を起動する
エミュレーターがまだ実行されていない場合は、コマンド ラインから (Visual Studio 内からではなく) 起動してその出力を表示できます。 通常、Android Emulator AVD イメージは、次の場所に格納されます (ユーザー名をご自分の Windows ユーザー名に置き換えます)。
C:\Users\username\.android\avd
AVD のフォルダー名を渡すことで、この場所から AVD イメージを使用してエミュレーターを起動できます。 たとえば、次のコマンドは Pixel_API_27 という名前の AVD を起動します。
"C:\Program Files (x86)\Android\android-sdk\emulator\emulator.exe" -partition-size 512 -no-boot-anim -verbose -feature WindowsHypervisorPlatform -avd Pixel_API_27 -prop monodroid.avdname=Pixel_API_27
この例では、Android SDK が既定の場所 (C:\Program Files (x86)\Android\android-sdk) にインストールされていることを前提としています。そうでない場合は、上記のパスをご使用のコンピューター上にある Android SDK の場所に変更します。
このコマンドを実行すると、エミュレーターの起動中に多くの行の出力が生成されます。 具体的には、ハードウェア アクセラレーションが有効になっていて正常に機能している場合 (この例では、ハードウェア アクセラレーションに HAXM が使用されています) は、次の例のような行が出力されます。
emulator: CPU Acceleration: working
emulator: CPU Acceleration status: HAXM version 6.2.1 (4) is installed and usable.
デバイス マネージャー ログを表示する
多くの場合、デバイス マネージャー ログを表示して、エミュレーターの問題を診断できます。 これらのログは、次の場所に書き込まれます。
C:\Users\username\AppData\Local\Xamarin\Logs\16.0
各 DeviceManager.log ファイルは、メモ帳などのテキスト エディターを使用して表示できます。 次のログ エントリの例は、コンピューターで HAXM が見つからなかったことを示しています。
Component Intel x86 Emulator Accelerator (HAXM installer) r6.2.1 [Extra: (Intel Corporation)] not present on the system
macOS での展開に関する問題
アプリを展開するときに、エミュレーターによっていくつかのエラー メッセージが表示される場合があります。 以下で、最も一般的なエラーと解決策について説明します。
配置エラー
エミュレーターでの APK のインストールの失敗、または Android Debug Bridge (adb) の実行の失敗に関するエラーが表示された場合は、Android SDK がエミュレーターに接続できることを確認してください。 接続を確認するには、次の手順を実行します。
Android Device Manager からエミュレーターを起動します (仮想デバイスを選択し、[開始] をクリックします)。
コマンド プロンプトを開き、adb がインストールされているフォルダーに移動します。 既定の場所に Android SDK がインストールされている場合、adb は ~/Library/Developer/Xamarin/android-sdk-macosx/platform-tools/adb にあります。そうでない場合は、このパスをご使用のコンピューター上にある Android SDK の場所に変更します。
次のコマンドを入力します。
adb devicesAndroid SDK からエミュレーターにアクセスできる場合は、接続されているデバイスの一覧にエミュレーターが表示されます。 次に例を示します。
List of devices attached emulator-5554 deviceこの一覧にエミュレーターが表示されない場合は、Android SDK マネージャーを起動し、すべての更新プログラムを適用し、エミュレーターをもう一度起動してみてください。
MMIO アクセス エラー
「MMIO アクセス エラーが発生しました」が表示されたら、エミュレーターを再起動します。
Google Play 開発者サービスが見つからない
この状態は通常、エミュレーターで実行している仮想デバイスに Google Play 開発者サービス、または Google Play ストアがインストールされていない場合に、これらのパッケージを含めずに仮想デバイスを作成することで発生します。 仮想デバイスを作成する (「Android Device Manager による仮想デバイスの管理」を参照) ときに、次のいずれかまたは両方を必ず選択してください。
- Google API – 仮想デバイスに Google Play 開発者サービスを含めます。
- Google Play ストア – 仮想デバイスに Google Play ストアを含めます。
たとえば、この仮想デバイスには、Google Play 開発者サービスと Google Play ストアが含まれます。
Note
Google Play ストアのイメージは、Pixel、Pixel 2、Nexus 5、Nexus 5 X などの一部の基本デバイスの種類でのみ使用できます。
パフォーマンスの問題
パフォーマンスの問題は、通常、次の問題のいずれかが原因で発生します。
ハードウェア アクセラレーションなしでエミュレーターを実行している。
エミュレーターで実行されている仮想デバイスが、x86 ベースのシステム イメージを使用していない。
以降のセクションでは、これらのシナリオについて詳しく説明します。
ハードウェア アクセラレーションが有効化されていない
ハードウェア アクセラレーションが有効化されていない場合、アプリを Android Emulator に展開するときに、「デバイスはアクセラレータなしで実行されます」といったメッセージがポップアップ表示されることがあります。 ご使用のコンピューターでハードウェア アクセラレーションが有効化されているかどうかわからない場合 (またはどのテクノロジがアクセラレーションを提供しているかを確認したい場合) は、ハードウェア アクセラレーションを確認して有効化する手順について、後述の「ハードウェア アクセラレーションの問題」を参照してください。
アクセラレーションは有効化されているが、エミュレーターの実行が遅すぎる
この問題の一般的な原因は、仮想デバイスで x86 ベースのイメージを使用していないことです。 仮想デバイスを作成する (「Android Device Manager による仮想デバイスの管理」を参照) ときに、必ず x86 ベースのイメージを選択してください。
ハードウェア アクセラレーションの問題
エミュレーターのハードウェア アクセラレーションに Hypervisor Framework または HAXM を使用しているかどうかに関わらず、インストールの問題または macOS の古いバージョンが原因の問題が発生する場合があります。 以降のセクションが、この問題を解決するのに役立ちます。
Hypervisor Framework の問題
新しい Mac で macOS 10.10 以降を使用している場合、Android Emulator は自動的にハードウェア アクセラレーションに Hypervisor Framework を使用します。 ただし、一部の従来の Mac または macOS 10.10 より前のバージョンを実行している Mac では、Hypervisor Framework を提供していない場合があります。
ご使用の Mac が Hypervisor Framework をサポートしているかどうかを確認するには、ターミナルを開き、次のコマンドを入力します。
sysctl kern.hv_support
ご使用の Mac で Hypervisor Framework がサポートされている場合は、上記のコマンドで次の結果が返されます。
kern.hv_support: 1
ご使用の Mac で Hypervisor Framework が使用できない場合は、HAXM を使用したアクセラレーションに関するセクションの手順に従って、代わりに HAXM をアクセラレーションに使用することができます。
HAXM の問題
Android Emulator が正常に起動しない場合、その原因の多くは HAXM の問題です。 HAXM の問題は、その他の仮想化テクノロジとの競合、間違った設定、または HAXM ドライバーの期限切れが原因で発生することがよくあります。 「Installing HAXM」 (HAXM をインストールする) に詳述された手順に従って、HAXM ドライバーを再インストールしてみてください。
その他のトラブルシューティングのヒント
次の推奨事項は多くの場合、Android Emulator の問題の診断に役立ちます。
コマンド ラインから Android Emulator を起動する
エミュレーターがまだ実行されていない場合は、コマンドラインから (Visual Studio for Mac 内からではなく) 起動してその出力を表示できます。 通常、Android Emulator AVD イメージは、次の場所に格納されます。
~/.android/avd
AVD のフォルダー名を渡すことで、この場所から AVD イメージを使用してエミュレーターを起動できます。 たとえば、次のコマンドは Pixel_2_API_28 という名前の AVD を起動します。
~/Library/Developer/Xamarin/android-sdk-macosx/emulator/emulator -partition-size 512 -no-boot-anim -verbose -feature WindowsHypervisorPlatform -avd Pixel_2_API_28 -prop monodroid.avdname=Pixel_2_API_28
既定の場所に Android SDK がインストールされている場合、エミュレーターは ~/Library/Developer/Xamarin/android-sdk-macosx/emulator にあります。そうでない場合は、このパスをご使用の Mac 上にある Android SDK の場所に変更します。
このコマンドを実行すると、エミュレーターの起動中に多くの行の出力が生成されます。 具体的には、ハードウェア アクセラレーションが有効になっていて正常に機能している場合 (この例では、ハードウェア アクセラレーションに Hypervisor Framework が使用されています) は、次の例のような行が出力されます。
emulator: CPU Acceleration: working
emulator: CPU Acceleration status: Hypervisor.Framework OS X Version 10.13
インテント エキストラの名前付けに関する問題
Android 実行構成でインテント エキストラを設定するとき、A-Z、a-z、‘_’、'-' と数字のみを使用できます。 また、すべてのキー値を一意にする必要があります。
デバイス マネージャー ログを表示する
多くの場合、デバイス マネージャー ログを表示して、エミュレーターの問題を診断できます。 これらのログは、次の場所に書き込まれます。
~/Library/Logs/XamarinDeviceManager
各 Android Devices.log ファイルを表示するには、コンソール アプリでダブルクリックして開きます。 次のログ エントリの例は、HAXM が見つからなかったことを示しています。
Component Intel x86 Emulator Accelerator (HAXM installer) r6.2.1 [Extra: (Intel Corporation)] not present on the system