Esegui app sull'emulatore Android

L'emulatore Android simula i dispositivi Android sul tuo computer, in modo da consentirti di testare la tua applicazione su una varietà di dispositivi e livelli API Android senza dover avere ogni dispositivo fisico. L'emulatore offre i seguenti vantaggi:

  • Flessibilità: oltre a essere in grado di simulare una varietà di dispositivi e livelli API Android, l'emulatore include configurazioni predefinite per diversi telefoni e tablet Android, Wear OS e Android TV.

  • Alta fedeltà: l'emulatore offre quasi tutte le funzionalità di un dispositivo Android reale. Puoi simulare telefonate e SMS in arrivo, specificare la posizione del dispositivo, simulare diverse velocità di rete, simulare la rotazione e altri sensori hardware, accedere al Google Play Store e molto altro.

  • Velocità: testare l'app sull'emulatore è in qualche modo più veloce e più semplice rispetto a un dispositivo fisico. Ad esempio, puoi trasferire i dati più velocemente all'emulatore anziché a un dispositivo connesso tramite USB.

Nella maggior parte dei casi, l'emulatore è l'opzione migliore per le tue esigenze di test. Questa pagina illustra le funzionalità di base dell'emulatore e spiega come iniziare a utilizzarle.

In alternativa, puoi eseguire il deployment dell'app su un dispositivo fisico. Per maggiori informazioni, vedi Eseguire app su un dispositivo hardware.

Inizia a utilizzare l'emulatore

L'emulatore Android ti consente di testare la tua app su tanti dispositivi diversi virtualmente. L'emulatore viene fornito con Android Studio, quindi non è necessario installarlo separatamente. Per utilizzare l'emulatore, segui questi passaggi di base, descritti più dettagliatamente nelle sezioni successive:

  1. Verifica di soddisfare i requisiti di sistema.
  2. Creare un dispositivo virtuale Android.
  3. Esegui l'app sull'emulatore.
  4. Esplora l'emulatore.

Questa pagina illustra i passaggi per configurare ed esplorare in maggiore dettaglio l'ambiente di test virtuale. Se l'app è già in esecuzione sull'emulatore e vuoi utilizzare funzionalità più avanzate, consulta Utilizzo avanzato dell'emulatore.

Se riscontri problemi con l'emulatore, vedi Risolvere i problemi noti relativi all'emulatore Android. A seconda delle tue esigenze e risorse, potrebbe valere la pena di esaminare i requisiti di sistema e le configurazioni tecniche oppure potrebbe essere meglio utilizzare un dispositivo fisico.

Requisiti di sistema dell'emulatore

Per un'esperienza ottimale, ti consigliamo di utilizzare l'emulatore in Android Studio su un computer con almeno le seguenti specifiche:

  • 16 GB di RAM
  • Sistema operativo Windows 10 o versioni successive a 64 bit, MacOS 12 o versioni successive, Linux o ChromeOS
  • 16 GB di spazio su disco

L'esecuzione di livelli API più elevati e/o di dispositivi virtuali con schermi più grandi potrebbero richiedere specifiche di sistema più elevate rispetto a quelle elencate sopra. Se non hai queste specifiche, l'emulatore potrebbe comunque funzionare, ma non con facilità. In questo caso, valuta la possibilità di eseguire i test su un dispositivo fisico seguendo le indicazioni riportate in Eseguire app su un dispositivo hardware.

Crea un dispositivo virtuale Android

Ogni istanza dell'emulatore Android utilizza un dispositivo virtuale Android (AVD) per specificare la versione di Android e le caratteristiche hardware del dispositivo simulato. Per creare una durata di visualizzazione media, vedi Creare e gestire dispositivi virtuali.

Ogni durata di visualizzazione media funziona come un dispositivo indipendente con un proprio spazio di archiviazione privato per i dati utente, la scheda SD e così via. Per impostazione predefinita, l'emulatore archivia i dati utente, i dati della scheda SD e la cache in una directory specifica per la durata di visualizzazione media. All'avvio, l'emulatore carica i dati utente e quelli della scheda SD dalla directory AVD.

Esegui l'app sull'emulatore

Dopo aver creato una durata di visualizzazione media, puoi avviare l'emulatore Android ed eseguire un'app nel tuo progetto:

  1. Nella barra degli strumenti, seleziona la durata di visualizzazione media su cui vuoi eseguire l'app dal menu del dispositivo di destinazione.

    Menu del dispositivo di destinazione
    Figura 1. Il menu del dispositivo di destinazione.
  2. Fai clic su Esegui. L'emulatore potrebbe richiedere circa un minuto per essere avviato per la prima volta, ma quelli successivi utilizzano uno snapshot e dovrebbero avviarsi più velocemente. Se riscontri problemi, consulta la guida alla risoluzione dei problemi.

Una volta installata l'app nella tua cartella di lavoro, puoi eseguirla dal dispositivo come faresti con qualsiasi app su un dispositivo. Ogni volta che vuoi eseguire il deployment di nuove modifiche, devi fare di nuovo clic su Esegui o Applica modifiche.

Assistente per l'accoppiamento di Wear OS

Se vuoi testare la tua app con dispositivi Wear OS, l'assistente di accoppiamento per Wear OS ti guida passo passo nell'accoppiamento degli emulatori Wear OS con telefoni fisici o virtuali direttamente in Android Studio. Per scoprire di più, vedi Utilizzare l'assistente di accoppiamento dell'emulatore di Wear OS.

Mentre l'emulatore è in esecuzione, puoi utilizzare il puntatore del mouse del computer per simulare il dito sul touchscreen e utilizzare il riquadro dell'emulatore per eseguire azioni comuni.

Utilizza il puntatore del mouse del computer per simulare il dito sul touchscreen, seleziona le voci di menu e i campi di immissione e fai clic su pulsanti e controlli. Usa la tastiera del computer per digitare caratteri e inserire le scorciatoie dell'emulatore.

Tabella 1. I gesti per esplorare l'emulatore

Funzionalità Descrizione
Scorri sullo schermo Posiziona il cursore del mouse sullo schermo, tieni premuto il pulsante principale del mouse, fai scorrere il dito sullo schermo e rilascia.
Trascinare un elemento Posiziona il puntatore del mouse su un elemento sullo schermo, tieni premuto il pulsante principale del mouse, sposta l'elemento e rilascialo.
Tocca Posiziona il cursore del mouse sullo schermo, premi il pulsante principale del mouse e rilascia.
Toccare due volte Posiziona il cursore del mouse sullo schermo, fai doppio clic velocemente sul pulsante principale del mouse e rilascia.
Tocca e tieni premuto Posiziona il puntatore del mouse su un elemento sullo schermo, premi il pulsante principale del mouse, tieni premuto e poi rilascia.
Tipo Puoi digitare nell'emulatore utilizzando la tastiera del computer o una tastiera visualizzata nella schermata dell'emulatore.
Pizzica e allarga
Se premi Ctrl (Comando su macOS) viene visualizzata l'interfaccia multi-touch con gesto di pizzicamento. Il mouse è come primo dito e, tra il punto di ancoraggio, è presente il secondo dito. Trascina il cursore per spostare il primo punto.
Facendo clic sul pulsante sinistro del mouse, simula il tocco su entrambi i punti e il rilascio di imitazioni che acquisiscono entrambi i punti.
Scorrimento verticale Apri un menu verticale sullo schermo e utilizza la rotellina del mouse per scorrere le voci di menu. Fai clic su una voce di menu per selezionarla.

Eseguire azioni comuni utilizzando il pannello dell'emulatore

Per eseguire azioni comuni con l'emulatore, utilizza la barra degli strumenti dell'emulatore, se esegui l'emulatore in Android Studio, o il riquadro sul lato destro, se esegui l'emulatore in una finestra esterna ad Android Studio. La tabella 2 descrive le azioni più comuni dell'emulatore e i pulsanti associati.

Puoi utilizzare le scorciatoie da tastiera per eseguire molte azioni comuni nell'emulatore. Per un elenco completo delle scorciatoie nell'emulatore, premi F1 (Comando+/ su macOS) per aprire il riquadro Guida nella finestra Controlli estesi.

Tabella 2. Azioni comuni nell'emulatore

Funzionalità Descrizione
Chiudi
Icona Chiudi
Chiudi l'emulatore.
Riduci a icona
Icona Riduci a icona
Riduci a icona la finestra dell'emulatore.
Ridimensiona Ridimensiona l'emulatore come faresti con qualsiasi altra finestra del sistema operativo. L'emulatore mantiene le proporzioni appropriate per il tuo dispositivo.
Alimentazione
Icona di accensione
Fai clic per attivare o disattivare lo schermo.
Fai clic e tieni premuto per accendere o spegnere il dispositivo.
Alza il volume
Icona Alza il volume
Fai clic per visualizzare il controllo di un cursore e alzare il volume. Fai di nuovo clic per alzarlo ulteriormente o usa il controllo di scorrimento per regolare il volume.
Abbassa il volume
Icona Abbassa il volume
Fai clic per visualizzare il controllo di un cursore e abbassare il volume. Fai di nuovo clic per abbassarlo ulteriormente o utilizza il controllo di scorrimento per regolare il volume.
Ruota a sinistra
Icona Ruota a sinistra
Ruota il dispositivo di 90 gradi in senso antiorario.
Ruota verso destra
Icona Ruota a destra
Ruota il dispositivo di 90 gradi in senso orario.
Acquisisci screenshot
Icona Acquisisci screenshot
Fai clic per acquisire uno screenshot del dispositivo.
Attiva la modalità zoom
Icona per attivare la modalità zoom

Fai clic per impostare il cursore sull'icona dello zoom. Per uscire dalla modalità zoom, fai di nuovo clic sul pulsante.

Per aumentare e diminuire lo zoom in modalità zoom:

  • Fai clic con il tasto sinistro dello schermo per aumentare lo zoom del 25%, fino a un massimo di circa il doppio della risoluzione dello schermo del dispositivo virtuale.
  • Fai clic con il tasto destro del mouse per diminuire lo zoom.
  • Fai clic con il pulsante sinistro del mouse e trascina per selezionare un riquadro a forma di casella su cui aumentare lo zoom.
  • Fai clic con il tasto destro del mouse e trascina una casella di selezione per reimpostare lo zoom predefinito.

Per eseguire la panoramica in modalità zoom, tieni premuto Ctrl (Comando su macOS) mentre premi i tasti freccia sulla tastiera.

Per toccare lo schermo del dispositivo in modalità zoom, fai clic tenendo premuto Ctrl (Comando e fai clic su macOS).

Indietro
Icona Indietro
Torna alla schermata precedente o chiudi una finestra di dialogo, un menu opzioni, il riquadro Notifiche o la tastiera sullo schermo.
Casa
Icona Home
Torna alla schermata Home.
Panoramica
Icona Panoramica
(App recenti)
Tocca per aprire un elenco di immagini in miniatura delle app con cui hai lavorato di recente. Per aprire un'app, tocca la relativa miniatura. Per rimuovere una miniatura dall'elenco, fai scorrere il dito verso sinistra o destra. Questo pulsante non è supportato per Wear OS.
Piega
Icona Piega
Per i dispositivi pieghevoli, devi chiudere il dispositivo per visualizzare la configurazione dello schermo più piccolo.
Espandi
Icona Apri
Per i dispositivi pieghevoli, apri il dispositivo per visualizzare la configurazione dello schermo più grande.
Pulsante 1
Icona pulsante 1
Per i dispositivi Wear, premi il pulsante 1 sul dispositivo. Disponibile solo su dispositivi Wear con livello API 28 o superiore.
Pulsante 2
Icona pulsante 2
Per i dispositivi Wear, premi il pulsante 2 sul dispositivo. Disponibile solo su dispositivi Wear con livello API 30 o superiore.
Palma
Icona pulsante con il palmo
Per i dispositivi Wear, premi il palmo sullo schermo del dispositivo. In questo modo viene impostata la modalità Ambient sul dispositivo. Disponibile solo su dispositivi Wear con livello API 28 o successivo.
Inclinazione
Icona del pulsante di inclinazione
Per i dispositivi Wear, inclina il dispositivo. Verrà chiusa la modalità Ambient. Disponibile solo su dispositivi Wear con livello API 28 o superiore.
Menu Premi Ctrl+M (Comando+M su macOS) per simulare il pulsante Menu.
Altro
Icona Altro
Fai clic per accedere ad altre funzionalità e impostazioni.

Aggiorna l'emulatore

Per aggiornare Android Emulator, seleziona il componente Android Emulator nella scheda SDK Tools di SDK Manager. Per le istruzioni, vedi Aggiornare gli strumenti utilizzando SDK Manager.