Delen via


Hardwareversnelling inschakelen met Android-emulators (Hyper-V & AEHD)

Met Visual Studio kunt u uw .NET MAUI-app voor Android eenvoudig testen en fouten opsporen in emulators voor situaties waarin een Android-apparaat niet beschikbaar is. Als hardwareversnelling echter niet beschikbaar of ingeschakeld is, wordt de emulator zeer langzaam uitgevoerd. U kunt de prestaties van de emulator aanzienlijk verbeteren door hardwareversnelling in te schakelen en installatiekopieën van virtuele apparaten te gebruiken die geschikt zijn voor uw processorarchitectuur. Zie Hardwareversnelling configureren voor de Android Emulator op developer.android.com voor meer informatie.

De emulator biedt veelzijdige netwerkmogelijkheden die kunnen worden gebruikt voor verschillende doeleinden, waaronder het maken van verbinding met een emulator die wordt uitgevoerd op een Mac vanuit een virtuele Windows-machine (VM). Zie Verbinding maken met een Android-emulator op een Mac vanuit een virtuele Windows-machine voor meer informatie.

In macOS maakt de Android-emulator gebruik van het ingebouwde Hypervisor.Framework. Zie Hypervisor op developer.apple.com voor meer informatie.

Android-emulators versnellen in Windows

De volgende virtualisatietechnologieën zijn beschikbaar voor het versnellen van de Android-emulator in Windows:

  • Het Windows Hypervisor-platform (WHPX). Hyper-V is een virtualisatiefunctie van Windows waarmee gevirtualiseerde computersystemen op een fysieke hostcomputer kunnen worden uitgevoerd.
  • Het hypervisorstuurprogramma van de Android Emulator (AEHD).

Opmerking

De Intel Hardware Accelerated Execution Manager (HAXM) is afgeschaft van emulator 33.x.x.x en is vervangen door AEHD op Intel-processors. Zie VM-versnelling configureren met Intel HAXM in Windows op developer.android.com voor informatie over het gebruik van HAXM op emulator 32.x.x.x en lager.

Voor de beste ervaring in Windows is het raadzaam OM WHPX te gebruiken om de Android-emulator te versnellen. Als WHPX niet beschikbaar is op uw computer, kan AEHD worden gebruikt. De Android-emulator gebruikt automatisch hardwareversnelling als aan de volgende criteria wordt voldaan:

  • Hardwareversnelling is beschikbaar en ingeschakeld op uw ontwikkelcomputer.
  • De emulator voert een systeemimage uit die is gemaakt voor een virtueel apparaat op basis van x86-64 of x86.

Belangrijk

Een versnelde emulator van een virtuele machine (VM) kan worden uitgevoerd binnen een andere VIRTUELE machine, inclusief Microsoft Dev Box, mits geneste virtualisatie is ingeschakeld in de VIRTUELE machine.

Beperkingen voor Windows ARM-apparaten

De Android-emulator vereist momenteel x64-processorarchitectuur en wordt niet ondersteund op Windows ARM-apparaten. Deze beperking is van invloed op apparaten zoals:

  • Surface Pro X
  • Surface Pro 9 (5G/ARM-variant)
  • Andere Windows-apparaten met ARM64-processors (Snapdragon, enzovoort)

Als u een Windows ARM-apparaat gebruikt, kunt u de volgende alternatieven overwegen:

  • Gebruik een fysiek Android-apparaat voor het testen via USB-foutopsporing. Zie Android-apparaat instellen voor foutopsporing voor meer informatie.
  • Gebruik cloudgebaseerde testservices of externe ontwikkelomgevingen met x64-architectuur.
  • Overweeg het gebruik van het Windows-subsysteem voor Android (WSA) indien beschikbaar, hoewel dit verschillende beperkingen en mogelijkheden heeft vergeleken met de Android-emulator.

Ga naar de Android Emulator requirements op developer.android.com voor de meest recente informatie over de vereisten voor de Android-emulator.

Zie Foutopsporing in de Android-emulator voor meer informatie over het starten en opsporen van fouten met de Android-emulator.

Versnellen met Hyper-V

Lees de volgende sectie voordat u Hyper-V inschakelt om te controleren of uw computer Hyper-V ondersteunt.

Ondersteuning voor Hyper-V controleren

Hyper-V wordt uitgevoerd op het Windows Hypervisor-platform. Als u de Android-emulator wilt gebruiken met Hyper-V, moet uw computer voldoen aan de volgende criteria om het Windows Hypervisor-platform te ondersteunen:

  • Uw computerhardware moet voldoen aan de volgende vereisten:

    • Intel-processors met ondersteuning voor virtualisatietechnologie (VT-x), uitgebreide paginatabellen (EPT) en onbeperkte gastfuncties (UG). VT-x moet zijn ingeschakeld in het BIOS van uw computer.
    • AMD-processors: AMD Ryzen-processor aanbevolen. Virtualisatie of SVM moet zijn ingeschakeld in het BIOS van uw computer.
  • Op uw computer moet de Enterprise-, Pro- of Education-versies van Windows 11 of Windows 10 versie 1909 of hoger worden uitgevoerd.

Als u wilt controleren of uw computerhardware en -software compatibel zijn met Hyper-V, opent u een opdrachtprompt en typt u de volgende opdracht:

systeminfo

Als alle vermelde Hyper-V vereisten de waarde Ja hebben, kan uw computer Hyper-V ondersteunen. Voorbeeld:

Voorbeeld van systeminfo-uitvoer bij het controleren van Hyper-V ondersteuning voor .NET MAUI.

Als het Hyper-V resultaat aangeeft dat er momenteel een hypervisor wordt uitgevoerd, is Hyper-V al ingeschakeld.

Belangrijk

Als Windows wordt uitgevoerd binnen een virtuele machine, moet geneste virtualisatie zijn ingeschakeld in de host-hypervisor.

Schakel Hyper-V versnelling in Windows in

Als uw computer voldoet aan de bovenstaande criteria, gebruikt u de volgende stappen om de Android-emulator te versnellen met Hyper-V:

  1. Voer Windows-functies in het zoekvak van Windows in en selecteer Windows-functies in- of uitschakelen in de zoekresultaten. Schakel in het dialoogvenster Windows-onderdelen zowel Hyper-V als Windows Hypervisor Platform in:

    Hyper-V en Windows Hypervisor Platform inschakelen voor .NET MAUI.

    Nadat u deze wijzigingen hebt aangebracht, start u de computer opnieuw op.

    Belangrijk

    Op de Windows 10 oktober 2018 update (RS5) en hoger hoeft u alleen Hyper-V in te schakelen, omdat Windows Hypervisor Platform (WHPX) automatisch wordt gebruikt.

  2. Zorg ervoor dat het virtuele apparaat dat u in Android Device Manager hebt gemaakt , een x86-64 - of x86-systeeminstallatiekopieën is. Als u een op Arm gebaseerde systeeminstallatiekopieën gebruikt, wordt het virtuele apparaat niet versneld en wordt het langzaam uitgevoerd.

Nadat Hyper-V is ingeschakeld, kunt u de versnelde Android-emulator uitvoeren.

Versnellen met AEHD

Als uw computer Hyper-V niet ondersteunt, moet u AEHD gebruiken om de Android-emulator te versnellen. Lees de volgende sectie voordat u AEHD kunt installeren en gebruiken om te controleren of uw computer AEHD ondersteunt.

Ondersteuning voor AEHD controleren

Uw computer moet voldoen aan de volgende criteria om AEHD te ondersteunen:

  • Een Intel- of AMD-processor met virtualisatie-extensie, die moet worden ingeschakeld in uw BIOS.
  • 64-bits Windows 11 of Windows 10.
  • Hyper-V moet worden uitgeschakeld.

Opmerking

Verschillende functies in Windows schakelen Hyper-V impliciet in. Zie Dubbel controleren bij het uitschakelen van Hyper-V op developer.android.com voor meer informatie.

AEHD-versnelling inschakelen in Windows

Als uw computer voldoet aan de bovenstaande criteria, gebruikt u de volgende stappen om de Android-emulator te versnellen met AEHD:

  1. Selecteer in Visual Studio het menu-item Extra Android >> SDK Manager.

  2. Selecteer in het venster Android SDK's en hulpprogramma's het tabblad Tools.

  3. Vouw het tabblad Tools uit, kies Extra's, vink het selectievakje aan voor het item Hypervisorstuurprogramma van de Android Emulator (installatieprogramma) en selecteer vervolgens op de knop Wijzigingen toepassen.

    AEHD installeren via Android SDK Manager in Visual Studio.

    Opmerking

    U kunt ook AEHD downloaden en installeren vanuit GitHub. Nadat u het stuurprogrammapakket hebt uitgepakt, voert u silent_install.bat uit op een opdrachtregel met beheerdersbevoegdheden.

  4. Zorg ervoor dat het virtuele apparaat dat u in Android Device Manager hebt gemaakt , een x86-64 - of x86-systeeminstallatiekopieën is. Als u een op Arm gebaseerde systeemimage gebruikt, zal het virtuele apparaat niet worden versneld en zal het langzaam draaien.

AEHD 2.1 en hoger

Controleer na de installatie of het stuurprogramma correct werkt met behulp van de volgende opdracht:

sc query aehd

Als het stuurprogramma correct werkt, bevat het statusbericht de volgende informatie:

SERVICE_NAME: aehd
       ...
       STATE              : 4  RUNNING
       ...

Het volgende foutbericht betekent dat de virtualisatie-extensie niet is ingeschakeld in uw BIOS of dat Hyper-V niet is uitgeschakeld:

SERVICE_NAME: aehd
       ...
       STATE              : 1  STOPPED
       WIN32_EXIT_CODE    : 4294967201 (0xffffffa1)
       ...

Nadat AEHD is geïnstalleerd en wordt uitgevoerd, kunt u de versnelde Android-emulator uitvoeren.

AEHD 2.0 en lager

Controleer na de installatie of het stuurprogramma correct werkt met behulp van de volgende opdracht:

sc query gvm

Als het stuurprogramma correct werkt, bevat het statusbericht de volgende informatie:

SERVICE_NAME: gvm
       ...
       STATE              : 4  RUNNING
       ...

Het volgende foutbericht betekent dat de virtualisatie-extensie niet is ingeschakeld in uw BIOS of dat Hyper-V niet is uitgeschakeld:

SERVICE_NAME: gvm
       ...
       STATE              : 1  STOPPED
       WIN32_EXIT_CODE    : 4294967201 (0xffffffa1)
       ...

Nadat AEHD is geïnstalleerd en wordt uitgevoerd, kunt u de versnelde Android-emulator uitvoeren.

AEHD verwijderen

Als u AEHD wilt verwijderen, gebruikt u de volgende opdrachten in een opdrachtprompt met administratieve bevoegdheden.

  • AEHD 2.1 en hoger

    sc stop aehd
    sc delete aehd
    
  • AEHD 2.0 en lager versies

    sc stop gvm
    sc delete gvm
    

Belangrijk

Sluit eventuele x86-emulators af voordat u AEHD voor AMD verwijdert.

Troubleshoot

Zie de Android-emulator Probleemoplossingsgids voor hulp bij hardwareversnellingsproblemen.