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 le 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. Nel menu sotto Display secondari, esegui una delle seguenti operazioni:
   1. Seleziona una delle proporzioni preimpostate.
   2. Seleziona Personalizzato 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 rispetto all'opzione Completa. Puoi anche specificare lo stato della rete dati e vocale, 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
• 5G: rete mobile di quinta generazione
• Completo (impostazione predefinita): utilizza la rete fornita dal computer

Seleziona un'intensità del segnale:

• Nessuno
• Scadente
• Moderato (valore predefinito)
• Buono
• Ottimo

Seleziona uno Stato della voce, uno Stato dei dati o entrambi:

• Home (valore predefinito)
• Roaming
• Ricerca in corso…
• Rifiutato (solo chiamate di emergenza)
• Non registrato (disattivato)

Puoi simulare le proprietà della batteria di un dispositivo per vedere il rendimento della tua app in condizioni diverse. Per selezionare un Livello di ricarica, utilizza il controllo di scorrimento.

Seleziona un valore per Connessione caricabatterie:

• Nessuno
• Caricabatterie CA

Seleziona un valore per Stato della batteria:

• Buono (valore predefinito)
• Non riuscito
• Dead
• Sovratensione
• Surriscaldato
• Sconosciuto

Seleziona un valore per Stato batteria :

• Sconosciuto
• Ricarica (valore predefinito)
• Scarico
• Non in carica
• Completo

Quando la modalità della videocamera è impostata per utilizzare la scena dell'ambiente definita con il file di configurazione dell'ambiente AVD, puoi ricaricare le impostazioni della scena per modificare dinamicamente i contenuti di origine in fase di runtime.

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 in Google Maps e poi invii una posizione, la mappa la mostra.

I controlli per i dati 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 mappa, utilizza il campo di testo per cercare la prima destinazione del 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 percorso.
6. Salva il percorso facendo clic su Salva percorso nella visualizzazione mappa.
7. Specifica un nome per l'itinerario e fai clic su Salva.

Per simulare l'emulatore che segue il percorso salvato, seleziona il percorso dall'elenco di Percorsi salvati e fai clic su Riproduci percorso in basso a destra nella 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 dei file, seleziona un file sul computer e fai clic su Apri.
3. (Facoltativo) Seleziona una velocità.

La velocità è impostata sul valore Ritardo (Velocità 1x). Puoi aumentare la velocità raddoppiandola (Velocità 2X), triplicandola (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. Facoltativamente, 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 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 tastierino direzionale abilitato nel profilo hardware, puoi utilizzare i controlli del tastierino direzionale con l'emulatore. Tuttavia, non tutti i dispositivi supportano il tastierino direzionale, 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 nell'emulatore Android. Per abilitare l'input del microfono, attiva Abilita l'accesso al microfono dell'host. L'emulatore Android offre anche controlli per simulare una cuffia con cavo:

• Attiva l'accesso al microfono 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.
• Simula inserimento cuffie: questa opzione simula il collegamento di un paio di cuffie a un jack audio da 3,5 mm. Se attivi questa opzione, vengono inviati gli eventi di attivazione/disattivazione SW_HEADPHONE_INSERT e SW_MICROPHONE_INSERT, che informano il sistema Android della connessione hardware simulata. Le cuffie vengono segnalate come dotate di microfono solo se è selezionata l'opzione Microfono virtuale collegato.
• Microfono virtuale collegato: disponibile solo quando l'opzione Simula inserimento cuffie è attiva. Questa opzione simula se le cuffie con microfono collegate hanno un microfono. Se attivi questa opzione, viene inviato l'evento di attivazione/disattivazione SW_MICROPHONE_INSERT.
• Assistente vocale: questo pulsante simula l'attivazione dell'assistente vocale del dispositivo. Se lo premi, viene inviato l'evento chiave KEYCODE_ASSIST, che avvia l'app di assistenza del dispositivo, ad esempio l'Assistente Google. Questo pulsante non è disponibile sui livelli API precedenti alla versione 24 (Android 7.0) o sugli AVD Android Automotive.

Questo controllo può simulare 10 diverse scansioni delle impronte. Puoi utilizzarlo per testare l'integrazione dell'impronta nell'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 a ricevere un'impronta.
2. Seleziona un valore per Impronta.
3. Fai clic su Sensore touch.

Questo controllo ti consente di testare la tua app in base alle modifiche alla posizione, all'orientamento o a entrambi i parametri 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 risponderebbero quando sposti o ruoti un dispositivo reale.

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

I report di controllo TYPE_ACCELEROMETER eventi sugli assi x, y e z. Questi valori includono la gravità. Ad esempio, se il dispositivo è sospeso nello spazio, l'accelerazione è pari a zero (i valori di X, Y e Z sono tutti pari a 0). Quando il dispositivo si trova sulla Terra ed è appoggiato su un tavolo con lo schermo rivolto verso l'alto, 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 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 superiore.
• Sposta la rappresentazione del dispositivo nel riquadro superiore e osserva i valori di 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 ulteriori informazioni 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 per 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 sugli assi X, Y e Z, rispettivamente. 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 nel tuo AVD.
• Luce: questo sensore ambientale misura l'illuminamento. I valori sono in unità lux.
• Pressione: questo sensore ambientale misura la pressione dell'aria ambiente. I valori sono espressi in millibar (hPa).
• Umidità relativa: questo sensore ambientale misura l'umidità relativa dell'ambiente.

Per saperne di più 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 tutto l'input da tastiera al dispositivo virtuale, incluso l'input che sarebbe 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 posizione ADB rilevata: se esegui l'emulatore da Android Studio, seleziona questa impostazione (quella 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 degli strumenti SDK. 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 la cornice della finestra intorno al dispositivo: per impostazione predefinita, gli emulatori con file di skin del dispositivo vengono visualizzati senza una cornice della finestra circostante.

Per maggiori dettagli, consulta Utilizzo dei proxy con l'emulatore Android .

• Accelerazione grafica: seleziona il tipo di accelerazione grafica.
  • Selezione automatica: Seleziona automaticamente l'accelerazione grafica hardware o software in base alla configurazione del sistema. L'emulatore valuta le funzionalità della GPU e la compatibilità dei driver per determinare il backend più stabile.
  • Software: seleziona i driver di rendering software ottimali in base alla configurazione dell'AVD, alle funzionalità richieste e alle metriche di qualità dell'emulatore.
  • Hardware: sfrutta la GPU del computer per ottenere le massime prestazioni. Consigliato per le prestazioni, anche se alcune configurazioni hardware potrebbero presentare errori di compatibilità.
  Per un controllo più preciso sulla selezione del backend grafico, puoi utilizzare l'opzione della riga di comando -gpu.
• 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 maximum (up to 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 (predefinito).

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 consultare la documentazione online dell'emulatore, fai clic su Documentazione.

Per segnalare un bug relativo all'emulatore, fai clic su Invia feedback. Per saperne di più, scopri come segnalare i 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.