Esegui app sull'emulatore Android

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

  • Flessibilità: oltre alla possibilità di simulare una serie di dispositivi e livelli di API Android, l'emulatore include configurazioni predefinite per vari 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 le telefonate e gli 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 altro ancora.

  • Velocità: testare la tua app nell'emulatore è in qualche modo più veloce e semplice rispetto a farlo su un dispositivo fisico. Ad esempio, puoi trasferire i dati nell'emulatore più velocemente che su un dispositivo collegato tramite USB.

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

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

Inizia a utilizzare l'emulatore

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

  1. Verifica di soddisfare i requisiti di sistema.
  2. Crea un dispositivo virtuale Android.
  3. Esegui la tua app nell'emulatore.
  4. Esplora l'emulatore.

In questa pagina vengono illustrati i passaggi per configurare ed esplorare il tuo ambiente di test virtuale in modo più dettagliato. Se hai già la tua app in esecuzione sull'emulatore e sei pronto a usare funzionalità più avanzate, consulta Utilizzo avanzato dell'emulatore.

Se hai problemi con l'emulatore, vedi Risolvere i problemi noti relativi all'emulatore Android. A seconda delle tue esigenze e delle tue risorse, potrebbe essere utile approfondire i requisiti di sistema e le configurazioni tecniche oppure utilizzare un dispositivo fisico.

Requisiti di sistema dell'emulatore

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

  • 16 GB di RAM
  • Sistema operativo Windows, macOS, Linux o ChromeOS a 64 bit
  • 16 GB di spazio su disco

Se non hai queste specifiche, l'emulatore potrebbe funzionare, ma non senza intoppi. In questo caso, valuta la possibilità di eseguire il test su un dispositivo fisico seguendo le indicazioni fornite nell'articolo Eseguire app su un dispositivo hardware.

Crea un dispositivo virtuale Android

Ogni istanza dell'emulatore Android utilizza un dispositivo virtuale Android per specificare la versione di Android e le caratteristiche hardware del dispositivo simulato. Per testare la tua app in modo efficace, crea una durata di visualizzazione media che modelli ciascun dispositivo su cui è progettata l'app. Per creare una durata di visualizzazione media, consulta 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 memorizza nella cache in una directory specifica della durata di visualizzazione media. Quando avvii l'emulatore, questo carica i dati utente e della scheda SD dalla directory AVD.

Esegui la tua app nell'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. Il primo avvio dell'emulatore potrebbe richiedere circa un minuto, ma i lanci successivi utilizzano un'istantanea e dovrebbero essere avviati più rapidamente. Se riscontri problemi, consulta la guida alla risoluzione dei problemi.

Dopo aver installato l'app sulla durata di visualizzazione media, 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 di accoppiamento Wear OS

Se vuoi testare la tua app con dispositivi Wear OS, l'assistente di accoppiamento Wear OS ti guiderà passo passo nell'accoppiamento di emulatori Wear OS con telefoni fisici o virtuali direttamente in Android Studio. Per ulteriori informazioni, consulta la pagina Utilizzare l'assistente di accoppiamento dell'emulatore di Wear OS.

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

Utilizza il puntatore del mouse del computer per simulare il tuo 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 i caratteri e inserire le scorciatoie dell'emulatore.

Tabella 1. I gesti per navigare nell'emulatore

Funzionalità Descrizione
Fai scorrere lo schermo Posiziona il puntatore del mouse sullo schermo, tieni premuto il pulsante principale del mouse, fai scorrere lo schermo e poi rilascia.
Trascina un elemento Posiziona il puntatore del mouse su un elemento sullo schermo, tieni premuto il pulsante principale del mouse, sposta l'elemento e rilascialo.
Toccare Posiziona il puntatore del mouse sullo schermo, premi il pulsante principale del mouse e poi rilascia.
Toccare due volte Posiziona il puntatore del mouse sullo schermo, fai doppio clic rapidamente sul pulsante principale del mouse, quindi 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 che si apre nella schermata dell'emulatore.
Pizzica e allarga
Premendo Ctrl (Comando su macOS) viene visualizzata un'interfaccia multi-touch con gesto di pizzico. Il mouse funge da primo dito e il secondo dito si trova lungo il punto di ancoraggio. Trascina il cursore per spostare il primo punto.
Il clic con il pulsante sinistro del mouse simula il tocco verso il basso di entrambi i punti e rilascia l'emozione di premere entrambi i punti.
Scorrimento verticale Apri un menu verticale sullo schermo e utilizza la rotellina del mouse per scorrere le voci del menu. Fai clic su una voce di menu per selezionarla.

Esecuzione di azioni comuni utilizzando il riquadro dell'emulatore

Per eseguire azioni comuni con l'emulatore, utilizza la relativa barra degli strumenti, se esegui l'emulatore in Android Studio, oppure il riquadro a destra se esegui l'emulatore in una finestra esterna ad Android Studio. La tabella 2 descrive le azioni 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 della 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 adatte al 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 volume
Fai clic per visualizzare un controllo di scorrimento e alzare il volume. Fai di nuovo clic per alzare ulteriormente il volume oppure usa il dispositivo di scorrimento per regolare il volume.
Abbassa il volume
Icona Abbassa il volume
Fai clic per visualizzare un dispositivo di scorrimento e abbassare il volume. Fai di nuovo clic per abbassarlo ulteriormente oppure utilizza il dispositivo 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 Attiva la modalità zoom

Fai clic per spostare 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 del mouse sullo 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 tasto sinistro del mouse e trascina per selezionare un'area a forma di riquadro su cui aumentare lo zoom.
  • Fai clic con il pulsante destro del mouse e trascina una casella di selezione per ripristinare 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 (clic Comando su macOS).

Indietro
Icona Indietro
Torna alla schermata precedente o chiudi una finestra di dialogo, un menu di 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 utilizzate di recente. Per aprire un'app, tocca la relativa miniatura. Per rimuovere una miniatura dall'elenco, falla scorrere verso sinistra o destra. Questo pulsante non è supportato per Wear OS.
Piega
Icona Chiudi
Per i dispositivi pieghevoli, piega il dispositivo in modo da 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 versioni successive.
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 versioni successive.
Palmo
Icona del pulsante con il palmo
Per i dispositivi Wear, premi il palmo sullo schermo del dispositivo. In questo modo il dispositivo viene impostato in modalità Ambient. 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à disattivata la modalità Ambient. Disponibile solo su dispositivi Wear con livello API 28 o successivo.
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, consulta la pagina Aggiornare gli strumenti utilizzando SDK Manager.