Per vedere l'aspetto e il comportamento della tua app su un dispositivo, devi crearla ed eseguirla. Android Studio configura i nuovi progetti in modo che tu possa eseguire il deployment della tua app su un dispositivo virtuale o un dispositivo fisico con pochi clic.
Questa panoramica si concentra su come utilizzare Android Studio per creare ed eseguire la tua app per test e debug. Per informazioni su come utilizzare Android Studio per creare la tua app in modo che possa essere rilasciata agli utenti, consulta Crea la tua app per il rilascio agli utenti. Per informazioni più dettagliate sulla gestione e sulla personalizzazione della build con o senza Android Studio, consulta Configura la build.
Build ed esecuzione di base
Per creare ed eseguire l'app, segui questi passaggi:
- Nella barra degli strumenti, seleziona la tua app dal menu delle configurazioni di esecuzione.
Nel menu del dispositivo di destinazione, seleziona il dispositivo su cui vuoi eseguire l'app.
Menu dei dispositivi di destinazione nella barra degli strumenti di Android Studio. Se non hai configurato alcun dispositivo, devi creare un Android Virtual Device per utilizzare l'emulatore Android o connettere un dispositivo fisico.
Fai clic su Esegui
.
Android Studio ti avvisa se tenti di avviare il progetto su un dispositivo a cui è associato un errore o un avviso. Le modifiche stilistiche e iconografiche distinguono tra errori (selezioni di dispositivi che comportano una configurazione non funzionante) e avvisi (selezioni di dispositivi che potrebbero comportare un comportamento imprevisto, ma sono comunque eseguibili).
Monitora il processo di build
Per visualizzare i dettagli del processo di build, seleziona Visualizza > Finestre degli strumenti > Build o fai clic su Build
nella barra della finestra degli strumenti. La finestra degli strumenti Build mostra le attività eseguite da Gradle per creare l'app, come mostrato nella figura 1.
- Scheda Sincronizzazione: mostra le attività eseguite da Gradle per la sincronizzazione con i file di progetto. Analogamente alla scheda Output build, se si verifica un errore di sincronizzazione, seleziona gli elementi nell'albero per visualizzare ulteriori informazioni sull'errore. Mostra anche un riepilogo dell'impatto dei download per determinare se i download delle dipendenze influiscono negativamente sulla build.
- Scheda Build Output (Output build): mostra le attività eseguite da Gradle sotto forma di albero, in cui ogni nodo rappresenta una fase di build o un gruppo di dipendenze delle attività. Se ricevi errori in fase di build o di compilazione,
esamina l'albero e seleziona un elemento per leggere l'output dell'errore, come mostrato nella
figura 2.
Figura 2. Controlla la scheda Build Output per individuare eventuali messaggi di errore. - Scheda Build Analyzer: fornisce informazioni sull'analisi delle prestazioni della build. Per saperne di più, consulta Risolvi i problemi relativi alle prestazioni della build con Build Analyzer.
- Riavvia: esegue nuovamente l'ultima azione di build. Se l'ultima volta hai eseguito Build > Make Selected Module, verrà creato il modulo corrente. Se l'ultima volta hai eseguito Build > Make Project, verranno generati file di build intermedi per tutti i moduli del progetto.
- Filtri: filtra gli avvisi, le attività o entrambi gli elementi completati correttamente. In questo modo è più facile trovare i problemi nell'output.
Se le varianti di compilazione utilizzano versioni prodotto, Gradle richiama anche le attività per creare queste versioni prodotto. Per visualizzare l'elenco di tutte le attività di build disponibili,
fai clic su Visualizza > Finestre degli strumenti > Gradle o su Gradle
nella barra della finestra degli strumenti.
Se si verifica un errore durante il processo di build, Gradle potrebbe consigliare opzioni della riga di comando per aiutarti a risolvere il problema, ad esempio --stacktrace o --debug. Per utilizzare le opzioni della riga di comando con il processo di build:
- Apri la finestra di dialogo Impostazioni o Preferenze:
- Su Windows o Linux, seleziona File > Impostazioni dalla barra dei menu.
- Su macOS, seleziona Android Studio > Preferenze dalla barra dei menu.
- Vai a Build, Execution, Deployment > Compiler (Build, esecuzione, deployment > Compilatore).
- Nel campo di testo accanto a Opzioni della riga di comando, inserisci le opzioni della riga di comando.
- Fai clic su OK per salvare e uscire.
Gradle applica queste opzioni della riga di comando al successivo tentativo di creazione dell'app.
Crea ed esegui utilizzando l'agente AI
L'agente AI di Android Studio ha accesso a strumenti che gli consentono di creare ed eseguire il deployment della tua app, quindi di verificarne lo stato per tuo conto. Quando utilizzi la modalità Agente, l'agente può eseguire attività come:
- Esegui il deployment dell'app su un dispositivo fisico o un emulatore connesso.
- Ispeziona lo schermo e acquisisci screenshot per verificare le modifiche alla UI.
- Controlla Logcat per individuare errori di runtime o messaggi di log specifici.
- Interagisci con l'app utilizzando i comandi di
adb shellper navigare o inserire dati.
L'utilizzo dell'agente AI per creare ed eseguire l'app è utile per le attività multifase in cui l'agente deve apportare modifiche in modo iterativo e verificare che funzionino come previsto.
Funzionalità avanzate di creazione ed esecuzione
Il metodo predefinito per creare ed eseguire l'app in Android Studio dovrebbe essere sufficiente per testare un'app. Tuttavia, puoi utilizzare queste funzionalità di creazione ed esecuzione per casi d'uso più avanzati:
Per eseguire il deployment dell'app in modalità di debug, fai clic su Debug
.
L'esecuzione dell'app in modalità di debug ti consente di impostare punti di interruzione nel codice, esaminare le variabili e valutare le espressioni in fase di runtime, nonché eseguire strumenti di debug. Per scoprire di più, consulta Esegui il debug dell'app.Se hai un'app più grande e complessa, utilizza Applica modifiche anziché fare clic su Esegui
. In questo modo risparmi tempo, perché eviti di riavviare l'app ogni volta che vuoi eseguire il deployment di una modifica. Per ulteriori informazioni su Applica modifiche, consulta la sezione Esegui il deployment in modo incrementale con Applica modifiche.Se utilizzi Jetpack Compose, Modifica in tempo reale è una funzionalità sperimentale che ti consente di aggiornare i componibili in tempo reale senza dover fare di nuovo clic su Esegui
. In questo modo, puoi concentrarti sulla scrittura del codice della UI con interruzioni minime. Per saperne di più, consulta la sezione Modifica dal vivo (sperimentale).Se hai un'app con più varianti di compilazione o versioni, puoi scegliere quale variante di compilazione distribuire utilizzando la finestra degli strumenti Varianti di compilazione. Per saperne di più sull'esecuzione di una variante di compilazione specifica, consulta la sezione Modifica la variante di compilazione.
Per perfezionare le opzioni di installazione, avvio e test dell'app, puoi modificare la configurazione di esecuzione/debug. Per saperne di più sulla creazione di configurazioni di esecuzione/debug personalizzate, consulta la sezione Crea configurazioni di esecuzione/debug.
Ti consigliamo di utilizzare Android Studio per le tue esigenze di sviluppo, ma puoi anche eseguire il deployment della tua app su un dispositivo virtuale o fisico dalla riga di comando. Per saperne di più, consulta Crea la tua app dalla riga di comando.
Esegui il deployment in modo incrementale con Applica modifiche
In Android Studio 3.5 e versioni successive, Applica modifiche ti consente di applicare le modifiche al codice e alle risorse all'app in esecuzione senza riavviarla e, in alcuni casi, senza riavviare l'attività corrente. Questa flessibilità ti aiuta a controllare la quantità di app che viene riavviata quando vuoi eseguire il deployment e testare piccole modifiche incrementali, preservando lo stato attuale del dispositivo.
Applica modifiche utilizza le funzionalità dell'implementazione JVMTI di Android supportate sui dispositivi con Android 8.0 (livello API 26) o versioni successive. Per scoprire di più sul funzionamento di Applica modifiche, consulta Android Studio Project Marble: Applica modifiche.
Requisiti
Le azioni Applica modifiche sono disponibili solo se soddisfi le seguenti condizioni:
- Crei l'APK della tua app utilizzando una variante di build di debug.
- Esegui il deployment della tua app su un dispositivo di destinazione o emulatore con Android 8.0 (livello API 26) o versioni successive.
Utilizza Applica modifiche
Utilizza le seguenti opzioni per eseguire il deployment delle modifiche su un dispositivo compatibile:
Applica modifiche e riavvia l'attività
: tenta di applicare le modifiche alle risorse e al codice riavviando l'attività, ma senza riavviare l'app. In genere, puoi utilizzare questa opzione se hai modificato il codice nel corpo di un metodo o se hai modificato una risorsa esistente.
Puoi anche eseguire questa azione premendo Ctrl+Alt+F10 (Ctrl+Comando+Maiusc+R su macOS).
Applica modifiche al codice
: tenta di applicare solo le modifiche al codice senza riavviare nulla. In genere, puoi utilizzare questa opzione quando hai modificato il codice nel corpo di un metodo, ma non hai modificato alcuna risorsa. Se hai modificato sia il codice sia le risorse, utilizza invece Applica modifiche e riavvia l'attività.
Puoi eseguire questa azione anche premendo Control+F10 (Control+Comando+R su macOS).
Esegui
: esegue il deployment di tutte le modifiche e riavvia l'app. Utilizza questa opzione quando le modifiche apportate non possono essere applicate utilizzando una delle opzioni Applica modifiche. Per scoprire di più sui tipi di modifiche che richiedono il riavvio dell'app, consulta la sezione Limitazioni di Applica modifiche.
Abilita l'esecuzione del fallback per Applica modifiche
Quando fai clic su Applica modifiche e riavvia l'attività o su Applica modifiche al codice, Android Studio crea un nuovo APK e determina se le modifiche possono essere applicate. Se le modifiche non possono essere applicate e causerebbero
un errore di Applica modifiche, Android Studio ti chiede di eseguire
di nuovo l'app.
Se non vuoi che ti venga chiesto ogni volta, puoi configurare Android Studio in modo che esegua automaticamente di nuovo l'app quando non è possibile applicare le modifiche. Per attivare questo comportamento, segui questi passaggi:
Apri la finestra di dialogo Impostazioni o Preferenze:
- In Windows o Linux, seleziona File > Impostazioni dal menu.
- Su macOS, seleziona Android Studio > Preferenze dal menu.
Vai a Build, Execution, Deployment > Deployment.
Seleziona le caselle di controllo per attivare il fallback dell'esecuzione automatica per una o entrambe le azioni Applica modifiche.
Fai clic su OK.
Modifiche dipendenti dalla piattaforma
Alcune funzionalità di Applica modifiche dipendono da versioni specifiche della piattaforma Android. Per applicare questo tipo di modifiche, devi eseguire il deployment della tua app su un dispositivo con questa versione di Android (o versioni successive). Ad esempio, l'aggiunta di un metodo richiede Android 11 o versioni successive.
Limitazioni di Applica modifiche
Applica modifiche è progettato per velocizzare il processo di deployment delle app. Tuttavia, esistono alcune limitazioni relative al momento in cui può essere utilizzato.
Modifiche al codice che richiedono il riavvio dell'app
Alcune modifiche al codice e alle risorse non possono essere applicate finché l'app non viene riavviata, tra cui:
- Aggiunta o rimozione di un campo
- Rimozione di un metodo
- Modifica delle firme dei metodi
- Modifica dei modificatori di metodi o classi
- Modifica dell'ereditarietà della classe
- Modifica dei valori negli enum
- Aggiunta o rimozione di una risorsa
- Modifica del manifest dell'app
- Modifica delle librerie native (file SO)
Librerie e plug-in
Alcune librerie e plug-in apportano automaticamente modifiche ai file manifest dell'app o alle risorse a cui viene fatto riferimento nel manifest. Questi aggiornamenti automatici possono interferire con Applica modifiche nei seguenti modi:
- Se una libreria o un plug-in apporta modifiche al manifest della tua app, non puoi utilizzare Applica modifiche. Per visualizzare le modifiche, devi riavviare l'app.
- Se una libreria o un plug-in apporta modifiche ai file di risorse della tua app, non puoi utilizzare Applica modifiche al codice
. Per visualizzare le modifiche, devi utilizzare Applica modifiche e riavvia l'attività
(o riavviare l'app).
Per evitare queste limitazioni, disattiva tutti gli aggiornamenti automatici per le varianti di build di debug.
Ad esempio, Firebase Crashlytics aggiorna le risorse dell'app con un ID build univoco durante ogni build, il che ti impedisce di utilizzare Applica modifiche al codice
e ti richiede di riavviare l'attività dell'app per visualizzare le modifiche. Disattiva questo comportamento per utilizzare
Applica modifiche al codice insieme a Crashlytics con le build di debug.
Codice che fa riferimento direttamente ai contenuti di un APK installato
Se il codice fa riferimento direttamente ai contenuti dell'APK della tua app installato sul dispositivo, questo codice può causare arresti anomali o comportamenti anomali dopo aver fatto clic su Applica modifiche al codice
. Questo comportamento si verifica perché, quando fai clic su Applica modifiche al codice, l'APK sottostante sul dispositivo viene sostituito durante l'installazione. In questi casi, puoi fare clic su Applica modifiche e riavvia l'attività
o su Esegui
.
Se riscontri altri problemi durante l'utilizzo di Applica modifiche, segnala un bug.
Live Edit
Modifica in tempo reale è una funzionalità sperimentale di Android Studio che ti consente di aggiornare i componibili in emulatori e dispositivi fisici in tempo reale. Questa funzionalità riduce al minimo i cambi di contesto tra la scrittura e la creazione dell'app, consentendoti di concentrarti sulla scrittura del codice più a lungo senza interruzioni.
Modifica la variante di compilazione
Per impostazione predefinita, Android Studio crea la versione di debug dell'app, destinata all'utilizzo solo durante lo sviluppo, quando fai clic su Esegui
.
Per modificare la variante di compilazione utilizzata da Android Studio, esegui una delle seguenti operazioni:
- Seleziona Build > Select Build Variant (Seleziona variante di compilazione) nel menu.
- Seleziona Visualizza > Finestre degli strumenti > Varianti di compilazione nel menu.
- Fai clic sulla scheda Varianti di compilazione nella barra della finestra degli strumenti.
Per i progetti senza codice nativo/C++, il riquadro Varianti di compilazione ha due colonne: Modulo e Variante di compilazione attiva. Il valore Variante di compilazione attiva per il modulo determina la variante di compilazione di cui l'IDE esegue il deployment sul dispositivo connesso ed è visibile nell'editor.
Per passare da una variante all'altra, fai clic sulla cella Variante di compilazione attiva di un modulo e scegli la variante che preferisci dall'elenco.
Per i progetti con codice nativo/C++, il riquadro Varianti di compilazione contiene tre colonne:
- Modulo
- Variante di compilazione attiva
- ABI attiva
Il valore Variante di compilazione attiva per il modulo determina la variante di compilazione di cui l'IDE esegue il deployment sul tuo dispositivo e che è visibile nell'editor. Per i moduli nativi, il valore ABI attiva determina l'ABI utilizzata dall'editor, ma non influisce su ciò che viene distribuito.
Per modificare la variante di compilazione o l'ABI, fai clic sulla cella della colonna Variante di build attiva o ABI attiva e scegli la variante di compilazione o l'ABI che preferisci dall'elenco. Dopo aver modificato la selezione, l'IDE sincronizza automaticamente il progetto. La modifica di una delle colonne per un modulo di app o libreria applica la modifica a tutte le righe dipendenti.
Per impostazione predefinita, i nuovi progetti vengono configurati con due varianti di compilazione: una variante di debug e una variante di release. Devi creare la variante di release per preparare l'app per la release pubblica. Per definire altre varianti della tua app con funzionalità o requisiti dei dispositivi diversi, puoi definire varianti di compilazione aggiuntive.
Conflitti nella finestra di dialogo Varianti di compilazione di Android Studio
Nella finestra di dialogo Varianti di compilazione di Android Studio, potresti visualizzare messaggi di errore che indicano conflitti tra le varianti di compilazione, ad esempio:
Questo errore non indica un problema di build con Gradle. Indica che l'IDE di Android Studio non riesce a risolvere i simboli tra le varianti dei moduli selezionati.
Ad esempio, se hai un modulo M1 che dipende dalla variante v1 del modulo
M2, ma M2 ha la variante v2 selezionata nell'IDE, hai simboli non risolti
nell'IDE. Supponiamo che M1 dipenda da una classe disponibile solo in v1; quando
v2 è selezionata, questa classe non è nota all'IDE. Pertanto, non riesce a risolvere il nome della classe e mostra errori nel codice del modulo M1.
Questi messaggi di errore vengono visualizzati perché l'IDE non può caricare il codice per più varianti contemporaneamente. Tuttavia, per quanto riguarda la build dell'app, la variante selezionata in questa finestra di dialogo non ha alcun effetto, perché Gradle crea l'app con il codice sorgente specificato nelle ricette di build di Gradle, non in base a ciò che è attualmente caricato nell'IDE.
Modifica la configurazione di esecuzione/debug
Quando esegui l'app per la prima volta, Android Studio utilizza una configurazione di esecuzione predefinita. La configurazione di esecuzione specifica se eseguire il deployment dell'app da un APK o da un Android App Bundle, nonché il modulo da eseguire, il pacchetto di cui eseguire il deployment, l'attività da avviare, il dispositivo di destinazione, le impostazioni dell'emulatore, le opzioni di Logcat e altro ancora.
La configurazione di esecuzione/debug predefinita crea un APK, avvia l'attività predefinita del progetto e utilizza la finestra di dialogo Seleziona target di deployment per la selezione del dispositivo di destinazione. Se le impostazioni predefinite non sono adatte al tuo progetto o modulo, puoi personalizzare la configurazione di esecuzione/debug o crearne una nuova a livello di progetto, predefinito e modulo.
Per modificare una configurazione di esecuzione/debug, seleziona Esegui > Modifica configurazioni. Per saperne di più, consulta Crea e modifica le configurazioni di esecuzione/debug.