Controlli, impostazioni e guida estesi

L'emulatore ti consente di eseguire il deployment della tua app su più display, che supportano dimensioni personalizzabili e possono aiutarti a testare app che supportano la modalità multi-finestra e multi-display. Mentre un dispositivo virtuale è in esecuzione, puoi aggiungere fino a due display aggiuntivi nel seguente modo:

1. Aggiungi un display facendo clic su Aggiungi display secondario.
2. Dal menu sotto Display secondari, esegui una delle seguenti operazioni:
   1. Seleziona una delle proporzioni preimpostate.
   2. Seleziona Personalizzata e imposta altezza, larghezza e dpi per il display personalizzato.
3. (Facoltativo) Fai di nuovo clic su Aggiungi display secondario per aggiungere un terzo display.
4. Fai clic su Applica modifiche per aggiungere i display specificati al dispositivo virtuale in esecuzione.

L'emulatore ti consente di simulare varie condizioni di rete. Puoi approssimare la velocità di rete per diversi protocolli di rete oppure specificare Completa, che trasferisce i dati alla velocità consentita dal computer. La specifica di un protocollo di rete è sempre più lenta di Full. Puoi anche specificare lo stato della rete voce e dati, ad esempio il roaming. I valori predefiniti sono impostati nell'AVD.

Seleziona un Tipo di rete:

• GSM: Global System for Mobile Communications
• HSCSD: High-Speed Circuit-Switched Data
• GPRS: Generic Packet Radio Service
• EDGE: Enhanced Data rates for GSM Evolution
• UMTS: Universal Mobile Telecommunications System
• HSPDA: High-Speed Downlink Packet Access
• LTE: Long-Term Evolution
• Completo (impostazione predefinita): utilizza la rete fornita dal computer

Seleziona un'intensità del segnale:

• Assente
• Scadente
• Moderata (impostazione predefinita)
• Buono
• Ottimo

Seleziona uno Stato di Voice, uno Stato dei dati o entrambi:

• Home (impostazione predefinita)
• Roaming
• Ricerca
• Rifiutato (solo chiamate di emergenza)
• Unregistered (off)

Puoi simulare le proprietà della batteria di un dispositivo per vedere come si comporta la tua app in condizioni diverse. Per selezionare un Livello di carica, utilizza il cursore.

Seleziona un valore per Connessione caricabatterie:

• Assente
• Caricabatterie CA

Seleziona un valore per Integrità batteria:

• Buona (impostazione predefinita)
• Operazione non riuscita
• Dead
• Sovratensione
• Surriscaldato
• Sconosciuto

Seleziona un valore per Stato batteria :

• Sconosciuto
• Ricarica (impostazione predefinita)
• Scarico
• Non in carica
• Completo

L'emulatore ti consente di simulare le informazioni su "la mia posizione": dove si trova il dispositivo emulato. Ad esempio, se fai clic su La mia posizione in Google Maps e poi invii una posizione, la mappa la mostra.

I controlli per le informazioni sulla posizione del dispositivo sono organizzati in due schede: Punti singoli e Percorsi.

Punti singoli

Nella scheda Punti singoli, puoi utilizzare la webview di Google Maps per cercare punti di interesse, proprio come faresti quando utilizzi Google Maps su uno smartphone o in un browser. Quando cerchi (o fai clic su) una posizione nella mappa, puoi salvarla selezionando Salva punto nella parte inferiore della mappa. Tutte le posizioni salvate sono elencate sul lato destro della finestra Controlli estesi.

Per impostare la posizione dell'emulatore sulla posizione selezionata sulla mappa, fai clic sul pulsante Imposta posizione in basso a destra della finestra Controlli estesi.

Route

Simile alla scheda Punti singoli, la scheda Percorsi fornisce una webview di Google Maps che puoi utilizzare per creare un percorso tra due o più località. Per creare e salvare un percorso:

1. Nella visualizzazione della mappa, utilizza il campo di testo per cercare la prima destinazione del tuo percorso.
2. Seleziona la posizione dai risultati di ricerca.
3. Seleziona il pulsante Naviga .
4. Seleziona il punto di partenza del percorso dalla mappa.
5. (Facoltativo) Fai clic su Aggiungi destinazione per aggiungere altre tappe al tuo percorso.
6. Salva il percorso facendo clic su Salva percorso nella visualizzazione della mappa.
7. Specifica un nome per l'itinerario e fai clic su Salva.

Per simulare l'emulatore che segue il percorso che hai salvato, seleziona il percorso dall'elenco dei Percorsi salvati e fai clic su Riproduci percorso in basso a destra della finestra Controlli estesi. Per interrompere la simulazione, fai clic su Interrompi percorso.

Per simulare continuamente l'emulatore seguendo il percorso specificato, attiva l'opzione accanto a Ripeti riproduzione. Per modificare la velocità con cui l'emulatore segue il percorso specificato, seleziona un'opzione dal menu Velocità di riproduzione.

Importare dati GPX e KML

Per utilizzare i dati geografici di un file GPS Exchange Format (GPX) o Keyhole Markup Language (KML):

1. Fai clic su Carica GPX/KML.
2. Nella finestra di dialogo del file, seleziona un file sul computer e fai clic su Apri.
3. (Facoltativo) Seleziona una velocità.

La velocità è impostata per impostazione predefinita sul valore Ritardo (Velocità 1x). Puoi aumentare la velocità del doppio (Velocità 2X), del triplo (Velocità 3X) e così via.

4. Fai clic su Esegui .

L'emulatore ti consente di simulare chiamate telefoniche e messaggi in arrivo.

Per avviare una chiamata all'emulatore:

1. Seleziona o digita un numero di telefono nel campo Da.
2. Fai clic su Chiama dispositivo.
3. (Facoltativo) Fai clic su Metti in attesa per mettere la chiamata in attesa.
4. Per terminare la chiamata, fai clic su Termina chiamata.

Per inviare un messaggio di testo all'emulatore:

1. Seleziona o digita un numero di telefono nel campo Da.
2. Digita un messaggio nel campo Messaggio SMS.
3. Fai clic su Invia messaggio.

Se l'AVD ha il d-pad abilitato nel profilo hardware, puoi utilizzare i controlli del d-pad con l'emulatore. Tuttavia, non tutti i dispositivi supportano il D-pad, ad esempio gli smartwatch Android. I pulsanti simulano le seguenti azioni:

Per motivi di privacy e prestazioni, l'input del microfono è disattivato per impostazione predefinita in Android Emulator. Per attivare l'input del microfono, attiva l'opzione Il microfono virtuale utilizza l'input audio dell'host. L'emulatore Android offre pulsanti di attivazione/disattivazione ed eventi chiave per simulare vari scenari di cuffie e microfono:

• Il microfono virtuale utilizza l'input audio dell'host: se questa opzione è attivata, l'emulatore riceve l'input audio dal microfono dell'host. Se disattivata, l'emulatore non riceve alcun input audio. Tieni presente che il sistema operativo host (Windows, macOS o Linux) potrebbe chiederti l'autorizzazione di accesso al microfono la prima volta che questa opzione viene attivata.
• Inserimento del jack per cuffie virtuale: questa opzione simula l'inserimento di cuffie e microfono in un jack audio da 3,5 mm. Se attivi questa opzione, vengono attivati gli eventi di input SW_HEADPHONE_INSERT e SW_MICROPHONE_INSERT, che informano il sistema Android della connessione hardware simulata.
• Le cuffie virtuali hanno un microfono: questa opzione simula la presenza di un microfono su un headset connesso. Se attivi questa opzione, viene attivato l'evento chiave KEY_HEADSETHOOK. Questo codice chiave Android viene comunemente utilizzato per azioni come rispondere alle chiamate, terminare le chiamate e controllare la riproduzione dei contenuti multimediali.
• Assistenza vocale: questa opzione simula l'attivazione dell'assistente vocale del dispositivo. Se attivi questa opzione, viene attivato l'evento chiave KEYCODE_ASSIST. Questo codice chiave Android viene utilizzato per avviare l'app di assistenza del dispositivo, ad esempio l'Assistente Google.

Questo controllo può simulare 10 diverse scansioni delle impronte. Puoi utilizzarlo per testare l'integrazione dell'impronta nella tua app. Questa funzionalità è disattivata per Android 5.1 (livello API 22) e versioni precedenti e per Wear OS.

Per simulare la scansione dell'impronta sul dispositivo virtuale:

1. Prepara un'app a ricevere un'impronta.
2. Seleziona un valore Impronta.
3. Fai clic su Sensore a tocco.

Questo controllo ti consente di testare la tua app in base alle modifiche della posizione, dell'orientamento o di entrambi del dispositivo. Ad esempio, puoi simulare gesti come l'inclinazione e la rotazione. L'accelerometro non rileva la posizione assoluta del dispositivo: rileva solo quando si verifica una variazione. Il controllo simula il modo in cui i sensori dell'accelerometro e del magnetometro rispondono quando sposti o ruoti un dispositivo reale.

Per utilizzare questo controllo, devi attivare il sensore dell'accelerometro nel tuo AVD.

I report sui controlli TYPE_ACCELEROMETER eventi sugli assi x, y e z. Questi valori includono la gravità. Ad esempio, se il dispositivo è sospeso nello spazio esterno, non subirà alcuna accelerazione (tutti i valori di x, y e z sono 0). Quando il dispositivo è sulla Terra e appoggiato con lo schermo verso l'alto su un tavolo, l'accelerazione è 0, 0 e 9, 8 a causa della gravità.

Il controllo segnala anche TYPE_MAGNETIC_FIELD eventi, che misurano il campo magnetico ambientale sugli assi x, y e z in microtesla (μT).

Per ruotare il dispositivo attorno agli assi x, y e z, seleziona Ruota ed esegui una delle seguenti operazioni:

• Regola i cursori Imbardata, Beccheggio e Rollio e osserva la posizione nel riquadro in alto.
• Sposta la rappresentazione del dispositivo nel riquadro superiore e osserva Imbardata, Beccheggio e Rollio e come cambiano i valori dell'accelerometro risultanti.

Per saperne di più su come vengono calcolati imbardata, beccheggio e rollio, consulta Calcolare l'orientamento del dispositivo.

Per spostare il dispositivo orizzontalmente (x) o verticalmente (y), seleziona Sposta e procedi in uno dei seguenti modi:

• Regola i cursori X e Y e osserva la posizione nel riquadro superiore.
• Sposta la rappresentazione del dispositivo nel riquadro superiore e osserva i valori dei cursori X e Y e come cambiano i valori dell'accelerometro risultanti.

Per posizionare il dispositivo a 0, 90, 180 o 270 gradi:

• Nell'area Rotazione dispositivo, seleziona un pulsante per modificare la rotazione.

Man mano che regoli il dispositivo, i campi Valori risultanti cambiano di conseguenza. Questi sono i valori a cui un'app può accedere.

Per saperne di più su questi sensori, consulta Panoramica dei sensori, Sensori di movimento e Sensori di posizione.

L'emulatore può simulare vari sensori di posizione e ambiente. Ti consente di regolare i seguenti sensori in modo da poterli testare con la tua app:

• Temperatura ambiente: questo sensore ambientale misura la temperatura dell'aria ambiente.
• Campo magnetico: questo sensore di posizione misura il campo magnetico ambientale rispettivamente sugli assi X, Y e Z. I valori sono in microtesla (μT).
• Prossimità: questo sensore di posizione misura la distanza da un oggetto; ad esempio, può notificare a uno smartphone che un volto è vicino per effettuare una chiamata. Per utilizzare questo controllo, il sensore di prossimità deve essere attivato nell'AVD.
• Luce: questo sensore ambientale misura l'illuminazione. I valori sono in unità lux.
• Pressione: questo sensore ambientale misura la pressione dell'aria ambiente. I valori sono espressi in unità millibar (hPa).
• Umidità relativa: questo sensore ambientale misura l'umidità relativa dell'ambiente.

Per ulteriori informazioni su questi sensori, consulta Panoramica dei sensori, Sensori di posizione e Sensori ambientali .

• Tema della finestra dell'emulatore: seleziona Chiaro o Scuro.
• Invia scorciatoie da tastiera a:per impostazione predefinita, alcune combinazioni di tasti attivano le scorciatoie di controllo dell'emulatore. Se stai sviluppando un'app che include scorciatoie da tastiera, ad esempio una destinata a dispositivi con tastiere Bluetooth, puoi modificare questa impostazione per inviare tutti gli input da tastiera al dispositivo virtuale, inclusi gli input che sarebbero una scorciatoia nell'emulatore.
• Posizione di salvataggio degli screenshot: fai clic sull'icona della cartella per specificare una posizione in cui salvare gli screenshot della schermata dell'emulatore.
• Utilizza la posizione ADB rilevata: se esegui l'emulatore da Android Studio, seleziona questa impostazione (quella predefinita). Se esegui l'emulatore al di fuori di Android Studio e vuoi che utilizzi un adbeseguibile specifico, deseleziona questa opzione e specifica la posizione di SDK Tools. Se questa impostazione non è corretta, funzionalità come l'acquisizione di screenshot e l'installazione di app tramite trascinamento non funzionano.
• Quando inviare i report sugli arresti anomali: seleziona Sempre, Mai o Chiedi.
• Mostra cornice della finestra intorno al dispositivo: per impostazione predefinita, gli emulatori con file skin del dispositivo vengono visualizzati senza una cornice della finestra circostante.

Per impostazione predefinita, l'emulatore utilizza le impostazioni proxy HTTP di Android Studio. Questa schermata ti consente di definire manualmente una configurazione proxy HTTP per l'emulatore. Per ulteriori informazioni, consulta Utilizzare l'emulatore con un proxy.

• Renderer OpenGL ES: seleziona il tipo di accelerazione grafica. (Questo è equivalente all'opzione della riga di comando -gpu.)
  • Rilevamento automatico in base all'host: Consenti all'emulatore di scegliere l'accelerazione grafica hardware o software in base alla configurazione del computer. Verifica se il driver GPU corrisponde a un elenco di driver GPU difettosi noti e, in caso affermativo, l'emulatore disattiva l'emulazione hardware grafica e utilizza invece la CPU.
  • ANGLE: (solo Windows). Utilizza ANGLE Direct3D per eseguire il rendering della grafica nel software.
  • SwiftShader: utilizza SwiftShader per il rendering della grafica nel software.
  • OpenGL nativo per computer: utilizza la GPU del computer host. Questa opzione è in genere la più rapida. Tuttavia, alcuni driver hanno problemi con il rendering della grafica OpenGL, quindi potrebbe non essere un'opzione affidabile.
• Livello API OpenGL ES: seleziona la versione massima di OpenGL ES da utilizzare nell'emulatore.
  • Selezione automatica: consente all'emulatore di scegliere la versione OpenGL ES in base al supporto dell'host e del guest.
  • Renderer massimo (fino a OpenGL ES 3.1): tenta di utilizzare la versione massima di OpenGL ES.
  • Compatibilità (OpenGL ES 1.1/2.0): utilizza la versione di OpenGL ES compatibile con la maggior parte degli ambienti.

Questo riquadro fornisce un elenco completo delle scorciatoie da tastiera per l'emulatore. Per aprire questo riquadro mentre lavori nell'emulatore, premi F1 (Comando+/ su macOS).

Affinché le scorciatoie funzionino, l'opzione Invia scorciatoie da tastiera nel riquadro delle impostazioni Generali deve essere impostata su Controlli dell'emulatore (impostazione predefinita).

Questa opzione di menu non è disponibile quando l'emulatore è in esecuzione in modalità incorporata con Android Studio. Se utilizzi l'emulatore in modalità incorporata, puoi trovare le scorciatoie da tastiera in File (Android Studio su macOS) > Impostazioni > Mappa tastiera in Dispositivi in esecuzione.

Per accedere alla documentazione online dell'emulatore, fai clic su Documentazione.

Per segnalare un bug relativo all'emulatore, fai clic su Invia feedback. Per ulteriori informazioni, scopri come segnalare bug dell'emulatore.

Questa opzione di menu non è disponibile quando l'emulatore è in esecuzione in modalità incorporata con Android Studio. Se utilizzi l'emulatore in modalità incorporata, apri il modello di bug facendo clic su Guida > Invia una segnalazione di bug e aggiungi manualmente i dettagli per i bug dell'emulatore Android.

Visualizza la porta adb utilizzata dall'emulatore, nonché i numeri di versione di Android e dell'emulatore. Confronta l'ultima versione disponibile dell'emulatore con la tua versione per determinare se hai installato l'ultimo software.

Il numero di serie dell'emulatore è emulator-adb_port, che puoi specificare, ad esempio, come opzione della riga di comando adb.