Controlli, impostazioni e guida estesi

Usa i controlli estesi dell'emulatore Android per inviare dati, modificare le proprietà dei dispositivi, controllare le app e altro ancora. Per aprire la finestra Controlli estesi, fai clic su Altro Icona dei controlli estesi dell'emulatore nel riquadro dell'emulatore. Tieni presente che alcune di queste opzioni di controllo esteso sono disponibili soltanto se esegui l'emulatore in una finestra separata al di fuori di Android Studio.

Puoi utilizzare le scorciatoie da tastiera per eseguire molte di queste attività. Per un elenco completo delle scorciatoie nell'emulatore, premi F1 (Comando+/ su macOS) per aprire il riquadro della Guida.

Tabella 1. Dettagli dei controlli estesi

Funzionalità Descrizione
Posizione

L'emulatore ti consente di simulare le informazioni relative alla "mia posizione", ovvero dove si trova il dispositivo emulato. Ad esempio, se fai clic su La mia posizione Icona 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: Singoli punti e Percorsi.

Singoli punti

Nella scheda Singoli punti, puoi utilizzare il componente WebView di Google Maps per cercare punti d'interesse, proprio come faresti quando usi Google Maps su un telefono o in un browser. Quando cerchi (o fai clic) un luogo sulla mappa, puoi salvarlo selezionando Salva punto nella parte inferiore della mappa. Tutte le località 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 nella parte in basso a destra della finestra Controlli estesi.

Percorsi

Analogamente alla scheda Singoli punti, la scheda Percorsi offre un componente WebView di Google Maps che puoi utilizzare per creare un percorso tra due o più luoghi. Per creare e salvare un percorso:

  1. Nella visualizzazione mappa, utilizza il campo di testo per cercare la prima destinazione nel percorso.
  2. Seleziona la località nei 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 fermate al percorso.
  6. Salva il percorso facendo clic su Salva percorso nella visualizzazione mappa.
  7. Specifica un nome per il percorso e fai clic su Salva.

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

Per simulare continuamente l'emulatore che segue il percorso specificato, attiva l'opzione 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 GPX (GPS Exchange format) o di Keyhole Markup Language (KML):

  1. Fai clic su Carica GPX/KML.
  2. Nella finestra di dialogo dei file, seleziona un file sul computer e fai clic su Apri.
  3. (Facoltativo) Seleziona una Velocità.
  4. Per impostazione predefinita, la velocità è sul Ritardo (Velocità 1X). È possibile aumentare la velocità di due volte (Velocità 2X), tripla (Velocità 3X) e così via.

  5. Fai clic su Esegui Icona Esegui.
Display

L'emulatore ti consente di eseguire il deployment della tua app su più display, che supportano dimensioni personalizzabili e possono aiutarti a testare le app che supportano multi-finestra e multi-display. Mentre un dispositivo virtuale è in esecuzione, puoi aggiungere altri due display come segue:

  1. Aggiungi un display facendo clic su Aggiungi display secondario.
  2. Nel menu in Display secondari, esegui una delle seguenti operazioni:
    1. Seleziona una delle proporzioni preimpostate.
    2. Seleziona personalizzato e imposta l'altezza, la larghezza e i dpi per la visualizzazione personalizzata.
  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.
Rete dati

L'emulatore ti consente di simulare varie condizioni di rete. Puoi approssimare la velocità di rete per diversi protocolli di rete oppure specificare Completo per trasferire i dati alla velocità consentita dal tuo computer. La specifica di un protocollo di rete è sempre più lenta di Completa. Puoi anche specificare lo stato della rete vocale e di dati, ad esempio il roaming. I valori predefiniti sono impostati nella durata di visualizzazione media.

Seleziona un tipo di rete:

  • GSM: sistema globale per le comunicazioni mobili
  • HSCSD: dati con commutazione da circuito ad alta velocità
  • GPRS: servizio radio pacchetti generico
  • EDGE: tariffe dati migliorate per GSM Evolution
  • UMTS: sistema universale di telecomunicazioni per dispositivi mobili
  • HSPDA: accesso al pacchetto di downlink ad alta velocità
  • LTE: evoluzione a lungo termine
  • Completa (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 in corso...
  • Rifiutata (solo chiamate di emergenza)
  • Non registrato (disattivato)
Batteria

Puoi simulare le proprietà della batteria di un dispositivo per vedere le prestazioni dell'app in condizioni diverse. Per selezionare un Livello di carica, utilizza il controllo del cursore.

Seleziona un valore di Connessione del caricabatterie:

  • Assente
  • Caricabatterie CA

Seleziona un valore per Integrità della batteria:

  • Buono (valore predefinito)
  • Non riuscita
  • Morto
  • Sovratensione
  • surriscaldamento
  • Sconosciuto

Seleziona un valore per lo stato della batteria :

  • Sconosciuto
  • Ricarica (impostazione predefinita)
  • In esaurimento
  • Non in carica
  • Completa
Fotocamera Puoi caricare le immagini nella scena simulata quando apri la fotocamera dell'emulatore. Per maggiori informazioni, consulta Aggiungere immagini potenziate alla scena nella documentazione di ARCore.
Telefono

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

Per avviare una chiamata all'emulatore:

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

Per inviare un messaggio 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.
D-pad

Se nell'AVD il d-pad è abilitato nel profilo hardware, puoi usarli con l'emulatore. Tuttavia, non tutti i dispositivi supportano il d-pad; ad esempio, gli smartwatch Android non lo supportano. I pulsanti simulano le seguenti azioni:

Controllo pad direzionale
Microfono Quando l'opzione Il microfono virtuale utilizza l'input audio dell'host è attiva, l'emulatore riceve l'input audio dal microfono host; in caso contrario, l'emulatore non riceve alcun input audio. Al momento le opzioni Connettore per cuffie virtuali inserito, Le cuffie virtuali hanno un microfono e le opzioni Assistente vocale non sono al momento implementate.
Impronta

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

Per simulare una scansione dell'impronta sul dispositivo virtuale:

  1. Preparare un'app per ricevere l'impronta.
  2. Seleziona un valore per l'impronta.
  3. Fai clic su Sensore touch.
Sensori virtuali > Posizione del dispositivo

Questo controllo ti consente di testare l'app in base a cambiamenti di posizione, orientamento o entrambe le cose del dispositivo. Ad esempio, puoi simulare gesti come l'inclinazione e la rotazione. L'accelerometro non tiene traccia della posizione assoluta del dispositivo, ma rileva solo quando è in corso una modifica. 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 AVD.

Il controllo segnala gli eventi TYPE_ACCELEROMETER sugli assi x, y e z. Questi valori includono la gravità. Ad esempio, se il dispositivo è sospeso nello spazio cosmico, l'accelerazione sarà pari a zero (tutti gli attributi x, y e z sono 0). Quando il dispositivo è sulla Terra e lo schermo è posizionato sopra un tavolo, l'accelerazione è pari a 0, 0 e 9, 8 a causa della gravità.

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

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

  • Regola i dispositivi di scorrimento Scarto, Angolazione e Rotazione e osserva la posizione nel riquadro superiore.
  • Sposta la rappresentazione del dispositivo nel riquadro superiore e osserva i campi Yaw, Pitch e Roll, nonché come cambiano i valori dell'accelerometro risultanti.

Consulta Calcolare l'orientamento del dispositivo per ulteriori informazioni su come vengono calcolati lo scarto, il bersaglio e il rollio.

Per spostare il dispositivo orizzontalmente (x) o verticalmente (y), seleziona Sposta ed esegui una delle seguenti operazioni:

  • Regola i dispositivi di scorrimento 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.

Quando modifichi il dispositivo, i campi Valori risultanti cambiano di conseguenza. Si tratta dei valori a cui può accedere un'app.

Per ulteriori informazioni su questi sensori, consulta le pagine Panoramica dei sensori, Sensori di movimento e Sensori di posizione.

Sensori virtuali > Sensori aggiuntivi

L'emulatore può simulare vari sensori di posizione e ambientali. Ti consente di regolare i seguenti sensori per testarli con la tua app:

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

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

Segnalazione di bug Se hai problemi con l'emulatore, puoi preparare e inviare una segnalazione di bug. L'emulatore raccoglie automaticamente screenshot, log e altri dati per la segnalazione di bug.
Registrazione e riproduzione Vedi Registrazione dello schermo.
Google Play Se l'immagine di sistema AVD include l'app Play Store, vengono visualizzate le informazioni sulla versione di Google Play Services.
Impostazioni > Generali
  • Tema delle finestre emulatore: seleziona Chiaro o Scuro.
  • Invia scorciatoie da tastiera a: per impostazione predefinita, alcune combinazioni da tastiera attivano le scorciatoie di controllo dell'emulatore. Se stai sviluppando un'app che include scorciatoie da tastiera, ad esempio quella destinata ai dispositivi con tastiere Bluetooth, puoi modificare questa impostazione per inviare tutti gli input da tastiera al dispositivo virtuale, incluso quello che costituirebbe una scorciatoia nell'emulatore.
  • Posizione di salvataggio degli screenshot: fai clic sull'icona della cartella per specificare un percorso in cui salvare gli screenshot della schermata dell'emulatore.
  • Utilizza la posizione ADB rilevata: se esegui l'emulatore da Android Studio, seleziona questa impostazione (predefinita). Se esegui l'emulatore dall'esterno di Android Studio e vuoi che utilizzi un eseguibile adb 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 con trascinamento non funzioneranno.
  • Quando inviare i report sugli arresti anomali: seleziona Sempre, Mai o Chiedi.
  • Mostra il frame della finestra intorno al dispositivo: per impostazione predefinita, gli emulatori con file delle skin del dispositivo vengono mostrati senza il riquadro della finestra circostante.
Impostazioni > Proxy

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

Impostazioni > Avanzate
  • Renderer OpenID ES: seleziona il tipo di accelerazione grafica. Equivale 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 dell'hardware grafico e utilizza invece la CPU.
    • ANGLE: (solo Windows) Usa ANGLE Direct3D per eseguire il rendering delle immagini nel software.
    • SwiftShader: utilizza SwiftShader per eseguire il rendering delle immagini nel software.
    • OpenGL nativo desktop: utilizza la GPU sul computer host. Questa opzione è in genere la più veloce. Tuttavia, alcuni driver riscontrano problemi con il rendering della grafica OpenGL, pertanto potrebbe non essere un'opzione affidabile.
  • Livello API OpenID ES: seleziona la versione massima di OpenGL ES da utilizzare nell'emulatore.
    • Selezione automatica: consenti all'emulatore di scegliere la versione OpenGL ES in base al supporto di host e ospiti.
    • Numero massimo del renderer (fino a OpenGL ES 3.1): prova a 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.
Guida > Scorciatoie da tastiera

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 da tastiera funzionino, l'opzione Invia scorciatoie da tastiera nel riquadro delle impostazioni Generali deve essere impostata su Controlli emulatore (impostazione predefinita).

Guida > Guida emulatore

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

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

Guida > Informazioni

Scopri quale porta adb utilizza l'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 il software più recente.

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