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 solo quando 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 Guida.

Tabella 1. Dettagli dei controlli estesi

Funzionalità Descrizione
Display

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

  1. Aggiungi una visualizzazione facendo clic su Aggiungi display secondario.
  2. Dal menu nella sezione Display secondari, esegui una delle seguenti operazioni:
    1. Seleziona una delle proporzioni predefinite.
    2. Seleziona custom e imposta height, width e dpi per la tua 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 consente di simulare diverse condizioni di rete. Puoi approssimare la velocità di rete per diversi protocolli di rete oppure puoi specificare Completa, che consente di trasferire i dati rapidamente quanto consentito dal computer. Specificare un protocollo di rete è sempre più lento rispetto a Full. 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 comunicazioni mobili
  • HSCSD: dati interruttori di circuito ad alta velocità
  • GPRS: servizio radio pacchetti generico
  • EDGE: tariffe dati avanzate per GSM Evolution
  • UMTS: sistema universale di telecomunicazioni mobile
  • HSPDA: accesso ai pacchetti di downlink ad alta velocità
  • LTE: evoluzione a lungo termine
  • Completa (opzione predefinita): utilizza la rete fornita dal computer

Seleziona un'Intensità del segnale:

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

Seleziona uno stato di voce, stato dei dati o entrambi:

  • Home (opzione predefinita)
  • Roaming
  • Ricerca in corso...
  • Rifiutata (solo chiamate di emergenza)
  • Non registrata (disattivata)
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 di scorrimento.

Seleziona un valore per Connessione caricabatterie:

  • Assente
  • Caricabatterie CA

Seleziona un valore per Integrità della batteria:

  • Buono (predefinito)
  • Non riuscita
  • Morto
  • Sovratensione
  • surriscaldato
  • Sconosciuto

Seleziona un valore per Stato batteria :

  • Sconosciuto
  • Ricarica (impostazione predefinita)
  • In esaurimento
  • Non in carica
  • Completo
Fotocamera Puoi caricare immagini nella scena simulata all'apertura della fotocamera dell'emulatore. Per maggiori informazioni, consulta la sezione su come aggiungere immagini aumentate alla scena nella documentazione di ARCore.
Posizione

L'emulatore ti consente di simulare le informazioni "La 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 mostrerà.

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

Singoli punti

Nella scheda Punti singoli puoi utilizzare la WebView di Google Maps per cercare punti d'interesse, proprio come faresti quando utilizzi 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 località che hai selezionato 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 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 mappa, utilizza il campo di testo per cercare la prima destinazione del percorso.
  2. Seleziona la località 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 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 Percorsi salvati e fai clic su Riproduci percorso in basso a destra nella finestra Controlli estesi. Per arrestare la simulazione, fai clic su Interrompi percorso.

Per simulare continuamente l'emulatore seguendo il percorso specificato, abilita l'opzione accanto a Riproduzione ripetuta. 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 dati geografici in un formato di scambio GPS (GPX) o in un file KML (Keyhole Markup Language):

  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à.
  4. Per impostazione predefinita, la velocità è impostata sul valore Delay (Velocità 1X). Puoi aumentare la velocità del doppio (Velocità 2X), tripla (Velocità 3X) e così via.

  5. Fai clic su Esegui Icona Esegui.
Telefono

L'emulatore ti consente di simulare telefonate 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. Se vuoi, puoi fare clic su Aspetta 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.
Cuscinetto direzionale

Se la durata di visualizzazione media 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 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, altrimenti l'emulatore non riceve alcun input audio. Le opzioni Presa per cuffie virtuale inserito, Cuffie virtuali con microfono e Assistente vocale al momento non sono implementate.
Impronta

Questo controllo può simulare 10 diverse scansioni dell'impronta. 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. Prepara un'app per ricevere un'impronta.
  2. Seleziona un valore per Fingerprint (Impronta digitale).
  3. Fai clic su Sensore touch.
Sensori virtuali > Posa dispositivo

Questo controllo ti consente di testare l'app in base alle variazioni di posizione del dispositivo, all'orientamento o a entrambi. Ad esempio, puoi simulare gesti come inclinazione e rotazione. L'accelerometro non traccia la posizione assoluta del dispositivo, ma solo rileva quando è in corso un cambiamento. 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 nella durata di visualizzazione media.

Il controllo registra TYPE_ACCELEROMETER gli eventi sugli assi x, y e z. Questi valori includono la gravità. Ad esempio, se il dispositivo viene sospeso nello spazio, sperimenta un'accelerazione pari a zero (tutti x, y e z sono 0). Quando il dispositivo è sulla Terra e disteso sullo schermo sopra un tavolo, l'accelerazione è 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 microtesla (μT).

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

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

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

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

  • 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 dispositivi, seleziona un pulsante per modificare la rotazione.

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

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

Sensori virtuali > Sensori aggiuntivi

L'emulatore può simulare vari sensori di posizione e ambiente. 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 microtesla (μT).
  • Prossimità: questo sensore di posizione misura la distanza da un oggetto; ad esempio, può notificare a uno smartphone che un volto è nelle vicinanze per effettuare una chiamata. Per utilizzare questo controllo, il sensore di prossimità deve essere abilitato nella Durata di visualizzazione media.
  • 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 unità di 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 .

Segnalazione di bug Se riscontri 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 Quando l'immagine di sistema AVD include l'app Play Store, vengono visualizzate le informazioni sulla versione di Google Play Services.
Impostazioni > Generali
  • Tema finestra emulatore: seleziona Chiaro o Scuro.
  • Invia scorciatoie da tastiera a:per impostazione predefinita, alcune combinazioni da tastiera attivano le scorciatoie da tastiera per il controllo dell'emulatore. Se stai sviluppando un'app che include scorciatoie da tastiera, ad esempio una destinata ai dispositivi con tastiere Bluetooth, puoi modificare questa impostazione per inviare tutti gli input da tastiera al dispositivo virtuale, incluso l'input che verrebbe una scorciatoia nell'emulatore.
  • Posizione di salvataggio degli screenshot: fai clic sull'icona a forma di cartella per specificare una posizione in cui salvare gli screenshot della schermata dell'emulatore.
  • Usa la posizione ADB rilevata: se utilizzi l'emulatore da Android Studio, seleziona questa impostazione (impostazione predefinita). Se esegui l'emulatore al di fuori 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 cornice della finestra attorno al dispositivo: per impostazione predefinita, gli emulatori con file skin del dispositivo vengono mostrati senza un 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 maggiori informazioni, vedi Utilizzare l'emulatore con un proxy.

Impostazioni > Avanzate
  • Renderer OpenGL 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. Controlla se il driver della GPU corrisponde a un elenco di driver GPU difettosi noti e, in caso affermativo, l'emulatore disabilita l'emulazione hardware grafica e utilizza la CPU.
    • ANGLE: (solo Windows). Utilizza ANGLE Direct3D per eseguire il rendering della grafica nel software.
    • SwiftShader: utilizza SwiftShader per eseguire il rendering della grafica nel software.
    • OpenGL nativo desktop: utilizza la GPU sul computer host. Questa opzione è in genere la più veloce. 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: consenti all'emulatore di scegliere la versione OpenGL ES in base al supporto di host e ospite.
    • Renderer massimo (fino a OpenGL ES 3.1): tentativo 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.
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 funzionino, l'opzione Invia scorciatoie da tastiera nel riquadro delle impostazioni Generali deve essere impostata su Controlli dell'emulatore (impostazione predefinita).

Guida > Guida dell'emulatore

Per andare 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 i 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 è installata la versione più recente del software.

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