Configura l'accelerazione hardware per l'emulatore Android

L'emulatore funziona al meglio se può utilizzare l'hardware della tua macchina, ad esempio CPU, GPU e modem, anziché essere eseguito come software puro. La capacità di utilizzare l'hardware della tua 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:

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

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

Configura l'accelerazione grafica

L'accelerazione grafica utilizza l'hardware del computer (in genere la GPU) per rendere più veloce il rendering dello schermo. I dispositivi Android utilizzano OpenGL per sistemi incorporati (OpenGL ES o GLES) per il rendering di grafica 2D e 3D sullo schermo.

Quando crei un dispositivo virtuale Android (AVD) in AVD Manager, puoi specificare se l'emulatore utilizza hardware o software per emulare la GPU della durata di visualizzazione media. L'accelerazione hardware consigliata è consigliata e in genere è più veloce. Tuttavia, potrebbe essere necessario utilizzare l'accelerazione software se il computer utilizza driver di grafica non compatibili con l'emulatore.

Per impostazione predefinita, l'emulatore decide se utilizzare l'accelerazione grafica hardware o software in base alla configurazione del computer. Se l'hardware e i driver della GPU sono compatibili, l'emulatore utilizza la GPU. In caso contrario, l'emulatore utilizza l'accelerazione software (mediante la CPU del computer) per simulare l'elaborazione della GPU.

Se avvii l'emulatore dalla riga di comando, puoi sostituire l'impostazione dell'accelerazione grafica nella durata di visualizzazione media per l'istanza del dispositivo virtuale.

Requisiti

Per utilizzare l'accelerazione grafica, l'ambiente di sviluppo deve avere quanto segue:

  • Strumenti SDK: è consigliata l'ultima release (versione minima 17)
  • Piattaforma SDK: ultima release consigliata (Android 4.0.3, revisione 3, minima)

Configura l'accelerazione grafica in AVD Manager

Per configurare l'accelerazione grafica per una durata di visualizzazione media:

  1. Apri Gestione AVD.
  2. Crea una nuova durata di visualizzazione media o modifica una durata di visualizzazione media esistente.
  3. Nella finestra Verifica configurazione, individua la sezione Prestazioni emulate.
  4. Seleziona un valore per l'opzione Elementi grafici:.
  5. Fai clic su Fine.

Configurare 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: l'emulatore può scegliere tra l'accelerazione grafica hardware o software in base alla configurazione del computer.
  • host: usa la GPU del computer per l'accelerazione hardware. Questa opzione offre in genere la qualità grafica e le prestazioni massime per l'emulatore. Tuttavia, se i driver di grafica riscontrano problemi di rendering OpenGL, potresti dover utilizzare le opzioni swiftshader_indirect o angle_indirect.
  • swiftshader_indirect: utilizza una variante di SwiftShader compatibile con l'Avvio rapido per eseguire il rendering degli elementi grafici utilizzando l'accelerazione software. Questa opzione è una buona alternativa alla modalità host se il computer non può utilizzare l'accelerazione hardware.
  • angle_indirect: (solo Windows) utilizza una variante di ANGLE Direct3D compatibile con Avvio rapido per eseguire il rendering degli elementi grafici utilizzando l'accelerazione software. Questa opzione è una buona alternativa alla modalità host se il computer non può utilizzare l'accelerazione hardware. Nella maggior parte dei casi, le prestazioni di ANGLE sono simili a quelle dell'utilizzo della modalità host perché ANGLE utilizza Microsoft Direct invece di OpenGL.

    Su Windows, i driver Microsoft DirectX in genere hanno meno problemi rispetto ai driver OpenGL. Questa opzione utilizza Direct3D 11 e richiede Windows 10, Windows 8.1 o Windows 7 SP1 con l'aggiornamento della piattaforma Windows 7.

  • guest: utilizza il rendering software lato ospite. Questa opzione offre la qualità grafica e le prestazioni più basse per l'emulatore.

Le seguenti opzioni mode sono deprecate:

  • swiftshader: deprecata nella versione 27.0.2. Usa invece swiftshader_indirect.
  • angle: deprecata nella versione 27.0.2. Utilizza invece angle_indirect (solo Windows).
  • mesa: deprecata nella versione 25.3. Usa invece il criterio swiftshader_indirect.

Attiva rendering Skia per UI Android

Quando utilizzi immagini per il livello API 27 o successivo, l'emulatore può eseguire il rendering della UI di Android con Skia. Skia aiuta l'emulatore a eseguire il rendering della grafica in modo più fluido ed efficiente.

Per attivare il rendering Skia, utilizza i seguenti comandi nella shell adb:

su
setprop debug.hwui.renderer skiagl
stop
start

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 tuo computer. Questa sezione illustra i requisiti per l'utilizzo dell'accelerazione delle VM e descrive come configurarla in ciascun sistema operativo.

Requisiti generali

Per utilizzare l'accelerazione delle VM con l'emulatore, il tuo 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 SDK: versione minima 17; versione consigliata 26.1.1 o successive
  • Durata di visualizzazione media: la versione di Android obbligatoria è descritta nella tabella che segue.

    Architettura della CPU Requisito per le immagini 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)
  • Processori AMD con AMD-V (SVM)
  • Silicio mela

Requisiti aggiuntivi per processori Intel e AMD:

La traduzione dell'indirizzo di secondo livello (Intel EPT o AMD RVI) è necessaria per i processori Intel e AMD. La maggior parte dei processori Intel e AMD moderni supporta la traduzione degli indirizzi di secondo livello. Solo i processori Intel o AMD di prima generazione che offrono estensioni di virtualizzazione possono 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 tuo processore sul sito del produttore. Se il tuo processore non supporta queste estensioni, non puoi utilizzare l'accelerazione della VM.

Restrizioni

L'accelerazione delle VM prevede 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 puoi eseguire software che utilizzano un'altra tecnologia di virtualizzazione nello stesso momento in cui esegui un emulatore con accelerazione VM. Tra gli esempi di software di questo tipo rientrano, a titolo esemplificativo, soluzioni di macchine virtuali, alcuni programmi antivirus e alcune soluzioni anti-cheat. La situazione si verifica 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 l'emulatore con accelerazione VM insieme a questo software.

Informazioni sugli hypervisor

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

Senza un'accelerazione hypervisor e VM, l'emulatore deve tradurre il codice macchina della VM blocco per blocco per conformarsi all'architettura del computer host. Questo processo può essere piuttosto lento. Nel caso di 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 sia la velocità che le prestazioni dell'emulatore.

L'hypervisor che funziona meglio per te dipende dal sistema operativo e dalla configurazione del computer. Per ulteriori informazioni, consulta una delle seguenti sezioni:

Verificare se un hypervisor è installato

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
AEHD (version 2.0) is installed and usable.
accel
Su Windows sono disponibili diverse opzioni di hypervisor. Ciò che vedete potrebbe essere diverso da questo esempio. Ad esempio, nel messaggio potresti visualizzare una delle seguenti parole chiave: GVM(ex nome di AEHD), WHPX, HAXM.

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 tre hypervisor:

  • Il driver hypervisor Android Emulator (AEHD)
  • Windows Hypervisor Platform (WHPX)
  • Intel Hardware Accelerated Execution Manager (HAXM)

Scegliere un hypervisor su Windows

Questa sezione mostra i criteri per determinare quale hypervisor utilizzare. Il processo per configurare l'accelerazione delle VM utilizzando ciascun hypervisor è descritto nelle sezioni seguenti.

A partire dall'emulatore 33.x.x.x, HAXM è deprecato poiché Intel interrompe lo sviluppo di HAXM. Il driver hypervisor di Android Emulator (AEHD) sostituisce Intel HAXM sui processori Intel.

Criteri (emulatore 33.x.x.x e versioni successive) Hypervisor
Non è necessario eseguire Hyper-V contemporaneamente all'emulatore Android. Utilizza il driver hypervisor Android Emulator.
Devi eseguire Hyper-V contemporaneamente all'emulatore Android. Utilizza WHPX.

Per l'emulatore 32.x.x.x e versioni precedenti, continua a seguire i vecchi criteri per determinare quale hypervisor utilizzare.

Criteri (emulatore 32.x.x.x e precedenti) Hypervisor
Disponi di un processore Intel e non è necessario eseguire Hyper-V contemporaneamente all'emulatore Android. Utilizza Intel HAXM.
Disponi di un processore AMD e non è necessario eseguire Hyper-V contemporaneamente all'emulatore Android. Utilizza il driver hypervisor Android Emulator.
Disponi di un processore Intel o AMD ed è necessario eseguire Hyper-V contemporaneamente all'emulatore Android. Utilizza WHPX.

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, Windows 10, Windows 8 o Windows 7 a 64 bit (Windows a 32 bit non è supportato)

  • Su Windows 11, Windows 10 o Windows 8, devi disattivare Hyper-V nella finestra di dialogo delle funzionalità di Windows.

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 SDK Manager 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 Strumenti SDK e seleziona Driver hypervisor Android Emulator.
  3. Fai clic su OK per scaricare e installare il driver dell'hypervisor Android Emulator.
  4. Dopo l'installazione, verifica che il driver funzioni correttamente utilizzando il seguente comando della 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 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 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 scaricato e installato anche da GitHub. Dopo aver decompresso il pacchetto del driver, esegui silent_install.bat in una riga di comando con privilegi di amministratore.

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

AEHD 2.1 e versioni successive

   sc stop aehd
   sc delete aehd

AEHD 2.0 e versioni precedenti

   sc stop gvm
   sc delete gvm

Configurazione dell'accelerazione delle VM utilizzando Intel HAXM su Windows

Prima di poter installare e utilizzare Intel HAXM, il computer deve soddisfare i seguenti requisiti:

  • Processore Intel con tecnologia di virtualizzazione (VT-x), funzionalità Intel EM64T (Intel 64) e funzionalità Executedisable (XD) bit abilitate
  • Windows 11, Windows 10, Windows 8 o Windows 7 a 64 bit (o versione a 32 bit del sistema operativo su un processore a 64 bit)
  • Su Windows 11, Windows 10 o Windows 8, devi disattivare Hyper-V nella finestra di dialogo delle funzionalità di Windows.

Per installare il driver Intel HAXM, procedi nel seguente modo:

  1. Apri SDK Manager.
  2. Fai clic sulla scheda Siti di aggiornamento SDK e seleziona Intel HAXM.
  3. Fai clic su OK.
  4. Al termine del download, esegui il programma di installazione.

    In genere, si trova il programma di installazione nel seguente percorso: sdk\extras\intel\Hardware_Accelerated_Execution_Manager\intelhaxm-android.exe

  5. Utilizza la procedura guidata per completare l'installazione.

  6. Dopo aver installato Intel HAXM, conferma che il driver di virtualizzazione funzioni correttamente utilizzando il seguente comando della riga di comando:

    sc query intelhaxm
    

    Un messaggio di stato include le seguenti informazioni:

    SERVICE_NAME: intelhaxm
           ...
           STATE              : 4  RUNNING
           ...
    

Per ulteriori informazioni, consulta le istruzioni di installazione di Intel HAXM su Windows.

Per disinstallare Intel HAXM, utilizza il programma di installazione o il pannello di controllo di Windows. Prima di disinstallare Intel HAXM, disattiva tutti gli emulatori x86 in esecuzione.

Configurare l'accelerazione delle VM utilizzando Windows Hypervisor Platform

Prima di poter attivare WHPX, il tuo computer deve soddisfare i seguenti requisiti:

  • Processori Intel: supporto per le funzionalità delle tecnologie di virtualizzazione (VT-x), Extended Page Tables (EPT) e Unrestricted Guest (UG). VT-x deve essere abilitato nelle impostazioni del BIOS del computer.
  • Processori AMD: è consigliato un processore AMD Ryzen. La virtualizzazione o la SVM devono essere abilitate 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, procedi nel seguente modo:

  1. Sul desktop di Windows, fai clic con il tasto destro del mouse sull'icona di Windows e seleziona App e funzionalità.
  2. In Impostazioni correlate, fai clic su Programmi e funzionalità.
  3. Fai clic su Attiva o disattiva le funzionalità Windows.
  4. Seleziona Windows Hypervisor Platform.

  5. Fai clic su OK.

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

Ricontrolla quando disattivi Hyper-V

Hyper-V deve essere disabilitato per utilizzare il driver hypervisor Android Emulator o Intel HAXM. Tuttavia, la deselezione di "Hyper-V" nella finestra di dialogo delle funzionalità di Windows non garantisce che Hyper-V sia disattivato.

Molte funzionalità di Windows 10 abilitano Hyper-V in modo implicito. Gli utenti potrebbero anche non sapere che Hyper-V è attivato quando abilitano una di queste funzionalità. Tali funzionalità includono:

  • Piattaforma per macchine virtuali
  • Windows Hypervisor Platform
  • Sandbox Windows
  • Isolamento del nucleo
  • Protezione delle credenziali

Inoltre, il sottosistema Windows per Linux versione 2 richiede Virtual Machine Platform, il che significa che richiede implicitamente Hyper-V. Questo elenco non è completo; invia un bug se trovi un elemento che dovrebbe essere incluso qui.

Verifica che le funzionalità elencate siano disabilitate anche quando disattivi Hyper-V. Fai riferimento alla documentazione Microsoft e agli esempi riportati di seguito per scoprire come disattivare ogni singola funzionalità.

Alcune piattaforme non riescono a disabilitare immediatamente Hyper-V quando viene spento. In questo caso, il sistema operativo Windows non restituisce alcun errore e Hyper-V risulta disabilitato nella finestra di dialogo delle funzionalità di Windows. Segnala un bug nel tracker dei problemi di Microsoft quando questo si verifica.

Configurare l'accelerazione delle VM su macOS

Su MacOS, Android Emulator utilizza Hypervisor.Framework integrato, che richiede MacOS v10.10 (Yosemite) e versioni successive.

Configurazione dell'accelerazione delle VM su Linux

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

Requisiti

L'esecuzione di KVM richiede autorizzazioni utente specifiche. Assicurati di disporre di autorizzazioni sufficienti come specificato nelle istruzioni per l'installazione del KVM.

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

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

Controlla se il sistema KVM è attualmente installato su Linux

Puoi utilizzare l'opzione della riga di comando dell'emulatore -accel-check per verificare se hai installato un KVM. 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 o superiore a 1 indica che la virtualizzazione è supportata. Un output pari a 0 indica che la CPU non supporta la virtualizzazione hardware.

  2. Esegui il comando kvm-ok:

    sudo kvm-ok
    

    Output previsto:

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

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

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

Installazione di KVM su Linux

Utilizza questo comando per installare KVM:

Cosmico (18.10) o versioni successive:

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

Lucido (10.04) o versioni successive:

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

Karmico (9:10) o precedente:

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