Configura l'accelerazione hardware per l'emulatore Android

L'emulatore funziona al meglio se è in grado di utilizzare l'hardware della tua macchina, ad esempio CPU, GPU e modem, anziché funzionare come software puro. La capacità di utilizzare l'hardware della macchina per migliorare le prestazioni si chiama accelerazione hardware.

L'emulatore può utilizzare l'accelerazione hardware per migliorare la tua esperienza in due modi principali:

  • Accelerazione grafica per migliorare il rendering dello schermo
  • Accelerazione delle macchine virtuali (VM) per una maggiore velocità di esecuzione

L'accelerazione hardware è abilitata per impostazione predefinita sulla maggior parte delle macchine. Se non è abilitato sul tuo computer, in questa pagina viene descritto come configurare la grafica e l'accelerazione delle macchine virtuali (VM) per ottenere prestazioni migliori dall'emulatore.

Configura l'accelerazione grafica

I dispositivi Android utilizzano OpenGL per sistemi integrati (OpenGL ES o GLES) e API Vulkan per il rendering delle grafiche sullo schermo. L'accelerazione grafica consente di utilizzare l'hardware del computer (in genere la GPU) per rendere più veloce il rendering. Sebbene per le prestazioni sia consigliata l'accelerazione hardware, potrebbe essere necessario utilizzare la modalità software se il computer non è compatibile a causa del supporto del driver di grafica o dei requisiti dell'immagine di sistema mancanti.

Quando crei un dispositivo virtuale Android in Gestione AVD, puoi specificare se l'emulatore utilizza il rendering hardware o software. In modalità automatica, l'emulatore decide se utilizzare l'accelerazione grafica hardware o software in base al computer. Puoi anche eseguire l'override dell'impostazione se avvii l'emulatore dalla riga di comando.

Configura l'accelerazione grafica in Gestione AVD

Per configurare l'accelerazione grafica per una durata di visualizzazione media, segui questi passaggi:

  1. Apri Gestione dispositivi.
  2. Crea una nuova durata di visualizzazione media o modifica una durata di visualizzazione media esistente.
  3. Nella finestra Configurazione, individua la sezione Prestazioni emulate nella scheda Impostazioni aggiuntive.
  4. Seleziona un valore per l'opzione Accelerazione grafica.
  5. Fai clic su Fine.

Configura l'accelerazione grafica dalla riga di comando

Per specificare un tipo di accelerazione grafica quando esegui una durata di visualizzazione media dalla riga di comando, includi l'opzione -gpu, come mostrato nell'esempio seguente:

emulator -avd avd_name -gpu mode [{-option [value]} ... ]

Il valore di mode può essere impostato su una delle seguenti opzioni:

  • auto: consenti all'emulatore di scegliere tra l'accelerazione grafica hardware o software in base alla durata di visualizzazione media, alla configurazione del computer e alle metriche sulla qualità.
  • host: utilizza la GPU del computer per l'accelerazione hardware. Questa opzione in genere offre la massima qualità grafica e prestazioni per l'emulatore e può abilitare MoltenVK su macOS per un rendering Vulkan accelerato. Tuttavia, se riscontri problemi con l'emulazione grafica, potrebbe essere necessario passare al rendering software.
  • swiftshader_indirect: usa una variante di SwiftShader compatibile con Avvio rapido per eseguire il rendering della grafica utilizzando l'accelerazione software. Questa opzione è una buona alternativa alla modalità host se il tuo computer non può utilizzare l'accelerazione hardware.

Le seguenti opzioni di mode sono deprecate:

  • swiftshader: deprecata nella versione 27.0.2. Usa invece swiftshader_indirect.
  • angle: deprecata nella versione 27.0.2. Usa invece il criterio swiftshader_indirect.
  • mesa: ritirata nella versione 25.3. Usa invece il criterio swiftshader_indirect.
  • guest: ritirato per i livelli API 28 e successivi. Usa invece swiftshader_indirect.
  • angle_indirect: ritirata nella versione 34.2.14. Usa invece swiftshader_indirect.

Configura l'accelerazione delle VM

L'accelerazione delle VM utilizza il processore del computer per migliorare notevolmente la velocità di esecuzione dell'emulatore. Uno strumento chiamato hypervisor gestisce questa interazione utilizzando le estensioni di virtualizzazione fornite dal processore del computer. Questa sezione descrive i requisiti per utilizzare l'accelerazione VM e descrive come configurarla su ciascun sistema operativo.

Requisiti generali

Per utilizzare l'accelerazione delle VM con l'emulatore, il computer deve soddisfare i requisiti generali in questa sezione. Il computer deve inoltre soddisfare altri requisiti specifici del sistema operativo.

Requisiti dell'ambiente di sviluppo

Per utilizzare l'accelerazione delle VM, l'ambiente di sviluppo deve soddisfare i seguenti requisiti:

  • Strumenti dell'SDK: versione minima 17; versione consigliata 26.1.1 o successiva

  • Durata di visualizzazione media: la versione di Android obbligatoria è descritta nella tabella che segue.

    Architettura CPU Requisito dell'immagine di sistema
    X86_64 Immagini di sistema x86 o x86_64 per Android 2.3.3 (livello API 10) e versioni successive
    ARM64 immagini di sistema arm64-v8a per Android 5.0 (livello API 21) e versioni successive

Requisiti delle estensioni di virtualizzazione

Oltre ai requisiti dell'ambiente di sviluppo, il processore del computer deve supportare le estensioni di virtualizzazione. I processori supportati sono:

  • Processori Intel con tecnologia di virtualizzazione Intel (VT-x, vmx), ad esempio i processori Intel Core iX e Intel Core Ultra
  • Processori AMD con AMD-V (SVM), come i processori AMD Ryzen
  • Mela

Requisiti aggiuntivi per i processori Intel e AMD:

Per i processori Intel e AMD è richiesta la traduzione degli indirizzi di secondo livello (Intel EPT o AMD RVI). I processori Intel e AMD più moderni supportano la traduzione di indirizzi di secondo livello. Solo i processori Intel o AMD di prima generazione che offrono estensioni di virtualizzazione potrebbero non avere traduzioni di pagine di secondo livello.

Se non hai la certezza che il tuo processore supporti le estensioni richieste, controlla le specifiche del processore sul sito del produttore. Se il processore non supporta queste estensioni, non puoi utilizzare l'accelerazione delle VM.

Restrizioni

L'accelerazione delle VM presenta le seguenti limitazioni:

  • Non puoi eseguire un emulatore con accelerazione VM all'interno di un'altra VM, ad esempio una VM ospitata da VirtualBox, VMWare o Docker. Devi eseguire un emulatore con accelerazione VM direttamente sul computer host.
  • A seconda del sistema operativo e dell'hypervisor, non è possibile eseguire software che utilizza un'altra tecnologia di virtualizzazione contemporaneamente a un emulatore con accelerazione VM. A titolo esemplificativo, questo software include, a titolo esemplificativo, soluzioni per macchine virtuali, alcuni programmi antivirus e alcune soluzioni antitrucco. La situazione si osserva principalmente su Windows con Hyper-V disattivato. La maggior parte di questo software può coesistere con l'emulatore Android senza problemi. Tuttavia, in caso di conflitti, consigliamo di non eseguire contemporaneamente l'emulatore con accelerazione VM con questo software.

Informazioni sugli hypervisor

L'accelerazione delle VM richiede un hypervisor, uno strumento che utilizza le estensioni di virtualizzazione fornite dal processore del computer.

Senza un hypervisor e un'accelerazione della VM, l'emulatore deve tradurre il codice macchina dalla VM blocco per blocco per renderlo conforme all'architettura del computer host. Questo processo può essere piuttosto lento. Con un hypervisor, quando la VM e l'architettura del computer host corrispondono, l'emulatore può eseguire il codice direttamente sul processore host utilizzando l'hypervisor. Questo miglioramento aumenta drasticamente la velocità e le prestazioni dell'emulatore.

L'hypervisor più adatto a te dipende dal sistema operativo e dalla configurazione del tuo computer. Per ulteriori informazioni, consulta una delle seguenti sezioni:

Verificare se è installato un hypervisor

Puoi utilizzare l'opzione della riga di comando dell'emulatore -accel-check per verificare se un hypervisor è attualmente installato sul tuo computer.

I seguenti esempi mostrano come utilizzare l'opzione dell'emulatore accel-check. In ogni esempio, Sdk è la posizione dell'SDK Android:

Windows: 

c:\Users\janedoe\AppData\Local\Android> Sdk\emulator\emulator -accel-check
accel:
0
WHPX(10.0.22631) is installed and usable.
accel
Su Windows sono disponibili diverse opzioni di hypervisor. Quindi quello che vedi potrebbe essere diverso dall'esempio qui riportato. Ad esempio, nel messaggio potresti vedere una delle seguenti parole chiave: AEHD, GVM (nome precedente di AEHD).

macOS: 

janedoe-macbookpro:Android janedoe$ ./Sdk/emulator/emulator -accel-check
accel:
0
Hypervisor.Framework OS X Version 13.2
accel

Linux: 

janedoe:~/Android$ ./Sdk/emulator/emulator -accel-check
accel:
0
KVM (version 12) is installed and usable.

Configurare l'accelerazione delle VM su Windows

L'accelerazione delle VM su Windows può utilizzare uno dei due hypervisor:

  • Windows Hypervisor Platform (WHPX)
  • Il driver hypervisor Android Emulator (AEHD)

Windows Hypervisor Platform utilizza l'Hypervisor Hyper-V fornito da Windows e offre la migliore compatibilità con instabilità ridotta. Se possibile, è consigliabile utilizzare WHPX.

Se il tuo sistema non supporta WHPX o se hai altri dubbi sul suo utilizzo, puoi utilizzare Android Emulator Hypervisor Driver.

Configurare l'accelerazione delle VM utilizzando Windows Hypervisor Platform

Per poter attivare WHPX, il computer deve soddisfare i seguenti requisiti:

  • Processori Intel: supporto per la tecnologia di virtualizzazione (VT-x), Extended Page Tables (EPT) e le funzionalità Ospite senza restrizioni (UG). VT-x deve essere abilitato nelle impostazioni del BIOS del computer.
  • Processori AMD: si consiglia il processore AMD Ryzen. La virtualizzazione o SVM deve essere abilitata nelle impostazioni del BIOS del computer.
  • Android Studio 3.2 Beta 1 o versioni successive
  • Emulatore Android 27.3.8 o versioni successive
  • Windows 10 o versioni successive

Per installare WHPX su Windows, segui questa procedura:

  1. Dal desktop di Windows, fai clic sull'icona di Windows per aprire il menu Start.

  2. Nella barra di ricerca, digita Attivare o disattivare le funzionalità di Windows.

    Viene visualizzato il pannello di controllo Attivazione o disattivazione delle funzionalità di Windows, che può essere selezionato.

  3. Premi il tasto Invio o fai clic su Attiva o disattiva le funzionalità di Windows per avviare il pannello di controllo.

  4. Seleziona la casella accanto a Windows Hypervisor Platform.

  5. Fai clic su OK.

  6. Al termine dell'installazione, riavvia il computer.

Configurare l'accelerazione delle VM utilizzando il driver hypervisor Android Emulator (AEHD) su Windows

Prima di poter installare e utilizzare il driver hypervisor Android Emulator, il computer deve soddisfare i seguenti requisiti:

  • Processori Intel o AMD con estensione di virtualizzazione.

  • Windows 11 o Windows 10 a 64 bit (Windows a 32 bit non è supportato)

    Gli utenti di Windows 8.1, Windows 8 e Windows 7 possono continuare a utilizzare AEHD 1.7 o versioni precedenti. Tuttavia, non viene fornita assistenza per questi scenari.

  • Le funzionalità che utilizzano anche Windows Hyper-V Hypervisor devono essere disabilitate nella finestra di dialogo delle funzionalità di Windows.

    Inoltre, alcuni componenti di Windows attivano e utilizzano Windows Hyper-V Hypervisor, anche quando Windows Hypervisor Platform non è selezionato nella finestra di dialogo delle funzionalità di Windows. tra cui funzionalità di sicurezza come Hyper-V, Core Isolation e altre. Tieni presente che la funzionalità Hyper-V NON è la stessa dell'hypervisor Hyper-V. Se hai bisogno di queste funzionalità, utilizza WHPX.

Sui processori AMD, il driver hypervisor Android Emulator può essere installato tramite SDK Manager in Android Studio 4.0 Canary 5 o versioni successive.

Sui processori Intel, il driver hypervisor Android Emulator può essere installato tramite il Gestore di SDK in Android Studio Flamingo o versioni successive.

Per eseguire l'installazione da SDK Manager, segui questi passaggi:

  1. Seleziona Strumenti > SDK Manager.
  2. Fai clic sulla scheda SDK Tools (Strumenti SDK) e seleziona Android Emulator hypervisor driver.
  3. Fai clic su OK per scaricare e installare il driver hypervisor Android Emulator.

  4. Dopo l'installazione, verifica che il driver funzioni correttamente utilizzando il seguente comando a riga di comando:

    AEHD 2.1 e versioni successive

    sc query aehd

    Un messaggio di stato include le seguenti informazioni:

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

    Il seguente messaggio di errore indica che l'estensione di virtualizzazione non è abilitata nel tuo BIOS o che Hyper-V non è disabilitato:

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

    AEHD 2.0 e versioni precedenti

    sc query gvm

    Un messaggio di stato include le seguenti informazioni:

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

    Il seguente messaggio di errore indica che l'estensione di virtualizzazione non è abilitata nel tuo BIOS o che Hyper-V non è disabilitato:

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

Il driver hypervisor Android Emulator può essere anche scaricato e installato da GitHub. Dopo aver decompresso il pacchetto del driver, esegui silent_install.bat da una riga di comando con privilegi amministrativi.

Disinstalla il driver hypervisor Android Emulator utilizzando i seguenti comandi in una riga di comando con privilegi amministrativi:

AEHD 2.1 e versioni successive

   sc stop aehd
   sc delete aehd

AEHD 2.0 e versioni precedenti

   sc stop gvm
   sc delete gvm

Configurare l'accelerazione delle VM su macOS

Su macOS, l'emulatore Android utilizza la versione integrata Hypervisor.Framework, che richiede macOS v10.10 (Yosemite) e versioni successive. Tuttavia, Android Studio potrebbe richiedere una versione superiore per macOS. In questi casi, segui i requisiti di sistema di Android Studio.

Configurare l'accelerazione delle VM su Linux

I sistemi basati su Linux supportano l'accelerazione delle VM tramite il pacchetto software KVM. Segui le istruzioni per installare KVM sul tuo sistema Linux, quindi verifica che KVM sia abilitato. Per i sistemi Ubuntu, vedi Installazione di KVM Ubuntu.

Requisiti

L'esecuzione di una KVM richiede autorizzazioni utente specifiche. Assicurati di disporre di autorizzazioni sufficienti, come specificato nelle istruzioni di installazione di KVM.

Per utilizzare l'accelerazione delle VM su Linux, il computer deve soddisfare anche i seguenti requisiti:

  • Per i processori Intel: supporto per la tecnologia di virtualizzazione (VT-x), funzionalità di Intel EM64T (Intel 64) e funzionalità di esecuzione dei bit (XD) abilitate.
  • Per i processori AMD: supporto per AMD Virtualization (AMD-V).

Controllare se KVM è attualmente installato su Linux

Per verificare se hai installato una KVM, puoi utilizzare l'opzione a riga di comando dell'emulatore -accel-check. In alternativa, puoi installare il pacchetto cpu-checker contenente il comando kvm-ok.

L'esempio seguente mostra come utilizzare il comando kvm-ok:

  1. Installa il pacchetto cpu-checker:

    sudo apt-get install cpu-checker
egrep -c '(vmx|svm)' /proc/cpuinfo

    Un output pari a 1 o superiore indica che la virtualizzazione è supportata. Un output pari a 0 significa che la CPU non supporta la virtualizzazione hardware.

  2. Esegui il comando kvm-ok:

    sudo kvm-ok

    Risultato previsto:

    INFO: /dev/kvm exists
KVM acceleration can be used

    Se viene visualizzato il seguente errore, significa che puoi comunque eseguire macchine virtuali. Tuttavia, la tua macchina virtuale è più lenta senza le estensioni KVM.

    INFO: Your CPU does not support KVM extensions
KVM acceleration can NOT be used

Installare KVM su Linux

Utilizza il seguente comando per installare la KVM:

Cosmico (18.10) o versioni successive: 

sudo apt-get install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils

Lucid (10.04) o versioni successive: 

sudo apt-get install qemu-kvm libvirt-bin ubuntu-vm-builder bridge-utils

Karmic (9.10) o versioni precedenti: 

sudo aptitude install kvm libvirt-bin ubuntu-vm-builder bridge-utils

Guida alla disinstallazione di Intel HAXM

A partire dall'emulatore 33.x.x.x, HAXM è deprecato poiché Intel interrompe lo sviluppo di HAXM. Android Emulator Hypervisor Driver (AEHD) sostituisce Intel HAXM con processori Intel.

Ti consigliamo di rimuovere completamente Intel HAXM dal sistema Windows, a meno che tu non abbia installato un altro software che dipende da HAXM e tu scelga di mantenere Intel HAXM e gestirlo autonomamente.

Per disinstallare Intel HAXM, procedi nel seguente modo:

Controlla se Intel HAXM è installato

Per determinare se Intel HAXM è installato sul tuo sistema Windows, apri una console dei comandi di Windows ed esegui questo comando:

   sc query intelhaxm

Se Intel HAXM è installato e in esecuzione, nell'output comando dovrebbe essere visualizzato il seguente messaggio.

Se Intel HAXM è installato ma disabilitato, nell'output comando dovrebbe essere visualizzato il seguente messaggio.

In entrambi i casi, indipendentemente dal fatto che Intel HAXM sia in esecuzione o disabilitato, viene installato. Devi andare al passaggio successivo per continuare a disinstallare Intel HAXM.

Se Intel HAXM non è installato, dovrebbe essere visualizzato il seguente messaggio.

Disinstalla Intel HAXM utilizzando SDK Manager da Android Studio

Apri SDK Manager da Android Studio, vai alla scheda "Strumenti SDK", quindi vai alla riga "Intel x86 Emulator Accelerator (programma di installazione HAXM) - Obsoleto". Dovrebbe essere simile allo screenshot seguente.

Deseleziona la casella di controllo come mostrato nello screenshot seguente.

Fai clic sul pulsante "Applica" e verrà visualizzata la seguente finestra di dialogo.

Dopo la disinstallazione di Intel HAXM, dovresti vedere quanto segue. La disinstallazione è terminata e puoi fermarti qui.

In caso di errori, vai al passaggio successivo.

Disinstalla Intel HAXM utilizzando le "impostazioni" di Windows.

Apri le "Impostazioni" di Windows e vai a "App > App installate".

Individua la voce "Intel Hardware Accelerated Execution Manager" e fai clic su "Disinstalla", come mostrato nello screenshot seguente.

Dovrebbe essere eseguito il programma di disinstallazione di Intel HAXM e segnalare il risultato. Se la disinstallazione riesce, vai a Elimina il pacchetto di installazione di Intel HAXM. In caso contrario, vai al passaggio successivo.

Disinstallare tramite riga di comando

  1. Interrompi il servizio Intel HAXM eseguendo "sc stop intelhaxm". Dovresti vedere l'output seguente.

  2. Elimina il servizio Intel HAXM eseguendo "sc delete intelhaxm". Dovresti vedere l'output seguente.

  3. Vai a Elimina il pacchetto di installazione Intel HAXM.

Elimina il pacchetto di installazione Intel HAXM.

Questo passaggio è necessario solo se disinstalli Intel HAXM utilizzando le "impostazioni" di Windows o la riga di comando. Senza questo passaggio, il gestore degli SDK di Android Studio potrebbe continuare a indicare Intel HAXM come "Installato".

Il pacchetto di installazione si trova in<cartella SDK Android>\extras\intel. Per impostazione predefinita, l'SDK Android viene installato in "C:\Users\<il tuo ID utente Windows >\AppData\Local\Android\Sdk". Guarda l'esempio nello screenshot seguente.