Controlli, impostazioni e guida estesi

Utilizza i controlli avanzati su Android Emulator per inviare dati, modificare le proprietà del dispositivo, controllare le app e altro ancora. Per aprire la finestra Controlli avanzati, fai clic su Altro Icona dei controlli avanzati dell'emulatore nel pannello dell'emulatore. Tieni presente che alcune di queste opzioni di controllo estese sono disponibili solo 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 Guida.

Tabella 1. Dettagli dei controlli avanzati

Funzionalità Descrizione
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 il multi-finestra e il multi-display. Quando un dispositivo virtuale è in esecuzione, puoi aggiungere fino a due display aggiuntivi come segue:

  1. Aggiungi un display facendo clic su Aggiungi display secondario.
  2. Nel menu 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 le visualizzazioni specificate al dispositivo virtuale in esecuzione.
Cellulare

L'emulatore ti consente di simulare varie condizioni di rete. Puoi stimare la velocità di rete per diversi protocolli di rete oppure specificare Completa, che trasferisce i dati alla massima velocità consentita dal computer. La specifica di un protocollo di rete è sempre più lenta rispetto a Completa. Puoi anche specificare lo stato della rete di 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: dati con commutazione di circuito ad alta velocità
  • GPRS: Generic Packet Radio Service
  • EDGE: Enhanced Data rates for GSM Evolution
  • UMTS: Universal Mobile Telecommunications System
  • HSDPA: High-Speed Downlink Packet Access
  • LTE: Long-Term Evolution
  • Completa (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)
Batteria

Puoi simulare le proprietà della batteria di un dispositivo per vedere il rendimento della 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:

  • Buono (valore predefinito)
  • Non riuscita
  • Morto
  • Sovralimentazione
  • Surriscaldamento
  • Sconosciuto

Seleziona un valore Stato batteria :

  • Sconosciuto
  • In carica (impostazione predefinita)
  • Scarico
  • Non in carica
  • Completa
Fotocamera Puoi caricare nella scena simulata le immagini quando apri la fotocamera dell'emulatore. Per saperne di più, consulta Aggiungere immagini aumentate alla scena nella documentazione di ARCore.
Posizione

L'emulatore ti consente di simulare le informazioni "La mia posizione": 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: Punti singoli e Percorsi.

Punti singoli

Nella scheda Punti singoli, puoi utilizzare la visualizzazione web di Google Maps per cercare punti d'interesse, come faresti quando utilizzi Google Maps su uno smartphone o in un browser. Quando cerchi (o fai clic) su una località sulla mappa, puoi salvarla selezionando Salva punto nella parte inferiore della mappa. Tutti i luoghi salvati sono elencati sul lato destro della finestra Controlli avanzati.

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

Route

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

  1. Nella visualizzazione mappa, utilizza il campo di testo per cercare la prima destinazione nel percorso.
  2. Seleziona la stazione di ricarica 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 dei Percorsi salvati e fai clic su Riproduci percorso in corrispondenza del lato in basso a destra della finestra Controlli avanzati. Per interrompere la simulazione, fai clic su Interrompi percorso.

Per simulare continuamente l'emulatore seguendo il percorso specificato, attiva l'opzione accanto a Ripeti la 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 da un formato di scambio GPS (GPX) o da un file 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. Se vuoi, seleziona una Velocità.
  4. La velocità predefinita è il valore Ritardo (Velocità 1X). Puoi raddoppiare la velocità (Velocità 2X), triplicarla (Velocità 3X) e così via.

  5. Fai clic su Esegui Icona Esegui.
Telefono

L'emulatore ti consente di simulare chiamate 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, fai clic su Metti in attesa 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 è attivato il d-pad nel profilo hardware, puoi utilizzare i controlli del d-pad con l'emulatore. Tuttavia, non tutti i dispositivi supportano i tasti direzionali, ad esempio gli smartwatch Android. I pulsanti simulano le seguenti azioni:

Controllo del pad direzionale
Microfono

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 microfoni:

  • Il microfono virtuale utilizza l'ingresso audio dell'host: se questa opzione è attivata, l'emulatore riceve l'input audio dal microfono dell'host. Se è disattivata, l'emulatore non riceve 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 attivi questa opzione.
  • Connettore virtuale per cuffie inserito: questa opzione simula l'inserimento di cuffie e microfono in un jack audio da 3,5 mm. L'attivazione/la disattivazione di questa opzione attiva sia gli eventi di input SW_HEADPHONE_INSERT sia quelli SW_MICROPHONE_INSERT, informando il sistema Android della connessione hardware simulata.
  • Le cuffie virtuali hanno un microfono: questa opzione simula la presenza di un microfono su un paio di cuffie collegate. L'attivazione/la disattivazione di questa opzione attiva l'evento chiave KEY_HEADSETHOOK. Questo codice a chiave Android viene comunemente utilizzato per azioni come rispondere alle chiamate, terminare le chiamate e controllare la riproduzione dei contenuti multimediali.
  • Voice Assist: questa opzione simula l'attivazione dell'assistente vocale del dispositivo. L'attivazione/la disattivazione di questa opzione attiva l'evento chiave KEYCODE_ASSIST. Questo codice chiave Android viene utilizzato per avviare l'app di assistenza del dispositivo, ad esempio l'Assistente Google.
Impronta

Questo controllo può simulare 10 diverse scansioni di impronte. Puoi utilizzarla 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 una scansione dell'impronta sul dispositivo virtuale:

  1. Prepara un'app per ricevere un'impronta.
  2. Seleziona un valore Impronta.
  3. Fai clic su Sensore tocco.
Sensori virtuali > Posizione del dispositivo

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

Per utilizzare questo controllo, devi attivare il sensore di accelerazione nell'AVD.

Il controllo registra gli eventi TYPE_ACCELEROMETER sull'asse x, y e z. Questi valori includono la gravità. Ad esempio, se il dispositivo è sospeso nello spazio cosmico, non subirà alcuna accelerazione (tutti i valori x, y e z sono pari a 0). Quando il dispositivo è sulla Terra e appoggiato con lo schermo rivolto verso l'alto su un tavolo, l'accelerazione è 0, 0 e 9, 8 a causa della gravità.

Il controllo registra 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 attorno agli assi x, y e z, seleziona Ruota e procedi in uno dei seguenti modi:

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

Per ulteriori informazioni su come vengono calcolati yaw, inclinazione e roll, consulta calcolare l'orientamento del dispositivo.

Per spostare il dispositivo orizzontalmente (x) o verticalmente (y), seleziona Sposta e svolgi 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 la modalità di variazione dei valori dell'accelerometro risultanti.

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

  • Nell'area Rotazione del 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 ulteriori informazioni su questi sensori, consulta la Panoramica dei sensori, i sensori di movimento e i sensori di posizione.

Sensori virtuali > Sensori aggiuntivi

L'emulatore può simulare vari sensori di posizione e ambientali. 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ò avvisare uno smartphone che un volto è vicino per effettuare una chiamata. Per poter usare questo controllo, il sensore di prossimità deve essere attivo nel tuo AVD.
  • Luce: questo sensore ambientale misura l'illuminazione. I valori sono in unità di lux.
  • Pressione: questo sensore ambientale misura la pressione dell'aria ambiente. I valori sono in 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 Consulta la sezione 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 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 un'app destinata a dispositivi con tastiere Bluetooth, puoi modificare questa impostazione per inviare tutti gli input da tastiera al dispositivo virtuale, inclusi quelli 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.
  • Usa 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 executable adb specifico, deseleziona questa opzione e specifica la posizione degli strumenti SDK. Se questa impostazione non è corretta, funzionalità come l'acquisizione di screenshot e l'installazione di app con il trascinamento non funzionano.
  • Quando inviare i report sugli arresti anomali: seleziona Sempre, Mai o Chiedi.
  • Mostra il frame della finestra attorno al dispositivo: per impostazione predefinita, gli emulatori con file di skin del dispositivo vengono visualizzati senza un frame 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, consulta Utilizzare l'emulatore con un proxy.

Impostazioni > Avanzate
  • Renditore OpenGL ES: seleziona il tipo di accelerazione grafica. Questo è equivalente all'opzione della riga di comando -gpu.
    • Rilevamento automatico in base all'host: lascia che sia l'emulatore a scegliere l'accelerazione hardware o software delle grafiche in base alla configurazione del computer. Controlla se il driver della GPU corrisponde a un elenco di driver GPU noti come difettosi e, in questo caso, l'emulatore disattiva l'emulazione hardware della grafica e utilizza la CPU.
    • ANGLE: (solo Windows). Utilizza ANGLE Direct3D per eseguire il rendering della grafica in software.
    • SwiftShader: utilizza SwiftShader per eseguire il rendering della grafica in software.
    • OpenGL nativo per computer: utilizza la GPU sul computer host. Questa è in genere l'opzione più rapida. Tuttavia, alcuni driver hanno problemi con il rendering delle immagini OpenGL, pertanto questa potrebbe non essere un'opzione affidabile.
  • Livello API OpenGL ES: seleziona la versione massima di OpenGL ES da utilizzare nell'emulatore.
    • Selezione automatica: lascia che sia l'emulatore a scegliere la versione OpenGL ES in base al supporto dell'host e dell'ospite.
    • 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.
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 emulatore (predefinito).

Guida > Guida all'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 ulteriori informazioni, scopri come segnalare i bug dell'emulatore.

Guida > Informazioni

Controlla quale porta adb viene utilizzata dall'emulatore, nonché i numeri di versione di Android e dell'emulatore. Confronta la versione dell'emulatore più recente disponibile con la tua versione per determinare se hai installato il software più recente.

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