Aktivieren der Hardwarebeschleunigung mit Android-Emulatoren (Hyper-V & AEHD)

Mit Visual Studio können Sie Ihre .NET MAUI-App für Android ganz einfach in Emulatoren für Situationen testen und debuggen, in denen ein Android-Gerät nicht verfügbar ist. Wenn die Hardwarebeschleunigung jedoch nicht verfügbar oder aktiviert ist, wird der Emulator sehr langsam ausgeführt. Sie können die Leistung des Emulators erheblich verbessern, indem Sie hardwarebeschleunigung aktivieren und virtuelle Geräteimages verwenden, die für Ihre Prozessorarchitektur geeignet sind. Weitere Informationen finden Sie unter Konfigurieren der Hardwarebeschleunigung für den Android-Emulator auf developer.android.com.

Der Emulator bietet vielseitige Netzwerkfunktionen, die für verschiedene Zwecke verwendet werden können, einschließlich der Verbindung mit einem Emulator, der auf einem Mac von einem virtuellen Windows-Computer (VM) ausgeführt wird. Weitere Informationen finden Sie unter Verbinden zu einem Android-Emulator auf einem Mac von einem virtuellen Windows-Computer aus.

Beschleunigen von Android-Emulatoren unter Windows

Ihnen stehen die folgenden Virtualisierungstechnologien zum Beschleunigen des Android-Emulators zur Verfügung:

  • Die Windows Hypervisor-Plattform (WHPX). Hyper-V ist ein Virtualisierungsfeature von Windows, mit dem virtualisierte Computersysteme auf einem physischen Hostcomputer ausgeführt werden können.
  • Der Android-Emulator-Hypervisortreiber (AEHD).

Hinweis

Der Intel Hardware Accelerated Execution Manager (HAXM) ist vom Emulator 33.x.x.x.x veraltet und wurde durch AEHD auf Intel-Prozessoren ersetzt. Informationen zur Verwendung von HAXM im Emulator 32.x.x.x und niedriger finden Sie unter Konfigurieren der VM-Beschleunigung mit Intel HAXM unter Windows unter developer.android.com.

Um die beste Erfahrung unter Windows zu erzielen, empfiehlt es sich, WHPX zu verwenden, um den Android-Emulator zu beschleunigen. Wenn WHPX auf Ihrem Computer nicht verfügbar ist, kann AEHD verwendet werden. Der Android-Emulator verwendet automatisch Hardwarebeschleunigung, wenn die folgenden Kriterien erfüllt sind:

  • Die Hardwarebeschleunigung ist verfügbar und auf Ihrem Entwicklungscomputer aktiviert.
  • Der Emulator führt ein Systemimage aus, das für ein x86-64 - oder x86-basiertes virtuelles Gerät erstellt wurde.

Wichtig

Ein beschleunigter Emulator für virtuelle Computer (VM) kann innerhalb einer anderen VM ausgeführt werden, einschließlich Microsoft Dev Box, sofern die geschachtelte Virtualisierung auf dem virtuellen Computer aktiviert ist.

Weitere Informationen zum Starten und Debuggen von Apps mit dem Android-Emulator finden Sie unter Debuggen auf dem Android-Emulator.

Beschleunigen mit Hyper-V

Lesen Sie den folgenden Abschnitt, um sicherzustellen, dass Ihr Computer Hyper-V unterstützt, bevor Sie Hyper-V aktivieren.

Überprüfen der Unterstützung für Hyper-V

Hyper-V wird auf der Windows Hypervisor-Plattform ausgeführt. Ihr Computer muss die folgenden Kriterien zur Unterstützung der Windows Hypervisor-Plattform erfüllen, um den Android-Emulator mit Hyper-V verwenden zu können:

  • Ihre Computerhardware muss die folgenden Anforderungen erfüllen:

    • Eine 64-Bit-CPU von Intel oder eine AMD Ryzen-CPU mit SLAT (Second Level Address Translation).
    • CPU-Unterstützung für VM Monitor Mode Extension (VT-c bei Intel-CPUs).
    • Mindestens 4 GB Arbeitsspeicher.
  • Im BIOS Ihres Computers müssen die folgenden Optionen aktiviert sein:

    • Virtualisierungstechnologie (Bezeichnung kann je nach Hauptplatinenhersteller variieren)
    • Von Hardware erzwungene Datenausführungsverhinderung
  • Auf Ihrem Computer müssen die Enterprise-, Pro- oder Education-Versionen von Windows 11 oder Windows 10, Version 1909 oder höher ausgeführt werden.

Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein, um zu überprüfen, ob Ihre Computerhardware und -software mit Hyper-V kompatibel ist:

systeminfo

Wenn alle Hyper-V-Anforderungen den Wert Yes (Ja) aufweisen, wird Hyper-V von Ihrem Computer unterstützt. Beispiel:

Example of systeminfo output when checking Hyper-V support for .NET MAUI.

Wenn das Hyper-V-Ergebnis angibt, dass derzeit ein Hypervisor ausgeführt wird, ist Hyper-V bereits aktiviert.

Wichtig

Wenn Windows auf einem virtuellen Computer ausgeführt wird, muss die geschachtelte Virtualisierung im Host-Hypervisor aktiviert sein.

Aktivieren der Hyper-V-Beschleunigung in Windows

Wenn Ihr Computer die obigen Kriterien erfüllt, führen Sie die folgenden Schritte aus, um den Android-Emulator mit Hyper-V zu beschleunigen:

  1. Geben Sie windows features in das Windows-Suchfeld ein, und klicken Sie in den Suchergebnissen auf Windows-Features aktivieren oder deaktivieren. Aktivieren Sie im Dialogfeld Windows-Features die Optionen Hyper-V und Windows Hypervisor-Plattform:

    Enabling Hyper-V and Windows Hypervisor Platform for .NET MAUI.

    Nachdem Sie die Änderungen vorgenommen haben, starten Sie den Computer neu.

    Wichtig

    Für das Windows-Update vom 10. Oktober 2018 (RS5) und höhere Versionen müssen Sie nur Hyper-V aktivieren, da hier die Windows-Hypervisor-Plattform (WHPX) automatisch verwendet wird.

  2. Stellen Sie sicher, dass das virtuelle Gerät, das Sie im Android-Geräte-Manager erstellt haben, ein x86-64- oder x86-basiertes Systemimage ist. Wenn Sie ein armbasiertes Systemimage verwenden, wird das virtuelle Gerät nicht beschleunigt und wird langsam ausgeführt.

Nachdem Hyper-V aktiviert wurde, können Sie Ihren beschleunigten Android-Emulator ausführen.

Beschleunigen mit AEHD

Wenn Ihr Computer Hyper-V nicht unterstützt, sollten Sie AEHD verwenden, um den Android-Emulator zu beschleunigen. Bevor Sie AEHD installieren und verwenden können, lesen Sie den folgenden Abschnitt, um zu überprüfen, ob Ihr Computer AEHD unterstützt.

Überprüfen der Unterstützung für AEHD

Ihr Computer muss die folgenden Kriterien erfüllen, um AEHD zu unterstützen:

  • Ein Intel- oder AMD-Prozessor mit Virtualisierungserweiterung, der in Ihrem BIOS aktiviert sein muss.
  • 64-Bit-Windows 11, Windows 10, Windows 8 oder Windows 7.
  • Hyper-V muss deaktiviert sein.

Hinweis

Mehrere Features in Windows aktivieren Hyper-V implizit. Weitere Informationen finden Sie unter "Double-Check" beim Deaktivieren von Hyper-V auf developer.android.com.

Aktivieren der AEHD-Beschleunigung in Windows

Wenn Ihr Computer die oben genannten Kriterien erfüllt, führen Sie die folgenden Schritte aus, um den Android-Emulator mit AEHD zu beschleunigen:

  1. Wählen Sie in Visual Studio das Menüelement "Tools > Android > SDK Manager" aus .

  2. Wählen Sie im Fenster "Android-SDKs und -Tools " die Registerkarte "Extras " aus.

  3. Erweitern Sie auf der Registerkarte "Extras" das Kontrollkästchen für das Android Emulator Hypervisor Driver (Installer)-Element, und wählen Sie dann die Schaltfläche "Änderungen übernehmen" aus:

    Installing AEHD through the Android SDK manager in Visual Studio.

    Hinweis

    Alternativ kann AEHD von GitHub heruntergeladen und installiert werden. Führen Sie silent_install.bat nach dem Entpacken des Treiberpakets an einer Befehlszeile mit Administratorrechten aus.

  4. Stellen Sie sicher, dass das virtuelle Gerät, das Sie im Android-Geräte-Manager erstellt haben, ein x86-64- oder x86-basiertes Systemimage ist. Wenn Sie ein armbasiertes Systemimage verwenden, wird das virtuelle Gerät nicht beschleunigt und wird langsam ausgeführt.

Vergewissern Sie sich nach der Installation, dass der Treiber ordnungsgemäß mit dem folgenden Befehl ausgeführt wird:

sc query aehd

Nachdem AEHD installiert und ausgeführt wurde, können Sie Ihren beschleunigten Android-Emulator ausführen.

Problembehandlung

Hilfe zur Problembehandlung bei der Hardwarebeschleunigung finden Sie im Handbuch zur Problembehandlung für den Android-Emulator.