Esegui app sull'emulatore Android

L'emulatore Android simula i dispositivi Android sul tuo computer per consentirti di testare l'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 a simulare una varietà di dispositivi e di livelli API Android, l'emulatore include configurazioni predefinite per vari dispositivi Android, telefoni e tablet Android, Wear OS e Android TV.

  • Alta fedeltà: l'emulatore offre quasi tutte le funzionalità di un vero dispositivo Android. 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 sull'emulatore è in qualche modo più rapido e semplice rispetto a farlo su un dispositivo fisico. Ad esempio, puoi trasferire i dati più velocemente nell'emulatore che su un dispositivo collegato tramite USB.

Nella maggior parte dei casi, l'emulatore è l'opzione migliore per le tue esigenze di test. In questa pagina vengono spiegate le funzionalità di base dell'emulatore e 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 Android ti consente di testare la tua app su tanti dispositivi diversi virtualmente. L'emulatore viene fornito con Android Studio, quindi non devi installarlo separatamente. Per usare l'emulatore, segui questi passaggi di base, descritti più dettagliatamente nelle sezioni seguenti:

  1. Verifica di disporre dei 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 vuoi usare le 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 esigenze e delle risorse, potrebbe valere la pena approfondire i requisiti di sistema e le configurazioni tecniche oppure è preferibile 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 comunque funzionare, ma in modo non ottimale. In questo caso, prendi in considerazione 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 (AVD) per specificare la versione Android e le caratteristiche hardware del dispositivo simulato. Per testare la tua app in modo efficace, crea una durata di visualizzazione media che modelli ogni dispositivo su cui è progettata l'app. Per creare una durata di visualizzazione media, consulta Creare e gestire dispositivi virtuali.

Ogni AVD funziona come un dispositivo indipendente con il 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. Quando avvii l'emulatore, vengono caricati i dati utente e quelli della scheda SD dalla directory AVD.

Esegui la tua app nell'emulatore

Dopo aver creato una durata di visualizzazione media, puoi avviare Android Emulator 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.

    Il 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 uno snapshot e dovrebbero avviarsi 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 guida passo passo nell'abbinamento degli emulatori di Wear OS a telefoni fisici o virtuali direttamente in Android Studio. Per scoprire di più, consulta la pagina Utilizzare l'assistente di accoppiamento dell'emulatore di Wear OS.

Quando 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.

Usa 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 i caratteri e inserire le scorciatoie dell'emulatore.

Tabella 1. Gesti per navigare nell'emulatore

Feature Descrizione
Fai scorrere il dito sullo schermo Posiziona il puntatore del mouse sullo schermo, tieni premuto il pulsante principale del mouse, scorri sullo schermo e 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 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 rilascia.
Tipo Puoi digitare nell'emulatore utilizzando la tastiera del computer o una tastiera che appare nella schermata dell'emulatore.
Pizzica e allarga
Premendo Ctrl (Comando su macOS) viene visualizzata un'interfaccia multi-touch con gesto di pizzicatura. Il mouse funge da primo dito e lungo il punto di ancoraggio si trova il secondo dito. Trascina il cursore per spostare il primo punto.
Se fai clic con il pulsante sinistro del mouse, viene simulato il tocco verso il basso di entrambi i punti e il rilascio dell'immagine simulata che li seleziona entrambi.
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.

Esegui azioni comuni utilizzando il riquadro dell'emulatore

Per eseguire le azioni più comuni con l'emulatore, utilizza la barra degli strumenti dell'emulatore, 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

Feature 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 il volume
Fai clic per visualizzare un dispositivo di scorrimento e alzare il volume. Fai di nuovo clic per alzare ulteriormente il volume oppure usa il cursore per regolare il volume.
Abbassa il volume
Icona Abbassa il volume
Fai clic per visualizzare un controllo del dispositivo di scorrimento e abbassare il volume. Fai di nuovo clic per abbassarlo ulteriormente oppure usa il cursore per regolare il volume.
Ruota verso 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, premi Ctrl e fai clic (Comando 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 utilizzate di recente. Per aprire un'app, tocca la relativa miniatura. Per rimuovere una miniatura dall'elenco, falla scorrere verso sinistra o verso destra. Questo pulsante non è supportato per Wear OS.
Piega
Icona Piega
Per i dispositivi pieghevoli, piega il dispositivo per visualizzare la configurazione dello schermo più piccolo.
Apri
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.
Palma
Icona del pulsante con il palmo
Per i dispositivi Wear, premi il palmo sullo schermo del dispositivo. In questo modo viene impostata la modalità Ambient del dispositivo. Disponibile solo su dispositivi Wear con livello API 28 o versioni successive.
Inclina
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 versioni successive.
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 l'emulatore Android, seleziona il componente Android Emulator nella scheda SDK Tools di SDK Manager. Per le istruzioni, consulta la pagina Aggiornare gli strumenti con SDK Manager.