Quando esegui, sottoponi a debug o verifichi il tuo codice, Android Studio utilizza una configurazione di esecuzione/debug per determinare come eseguire l'operazione. In genere, la configurazione iniziale è sufficiente per eseguire o eseguire il debug di un'app. Tuttavia, puoi modificare e creare nuove configurazioni, nonché modificare i modelli di configurazione in base al processo di sviluppo, come descritto in questa pagina.
Per ulteriori informazioni, consulta anche la seguente documentazione di IntelliJ:
Informazioni sulle configurazioni di esecuzione/debug
Le configurazioni di esecuzione/debug specificano dettagli come le opzioni di installazione, avvio e test dell'app. Puoi definire una configurazione da usare una volta sola o salvarla per un uso futuro. Dopo averla salvata, puoi selezionare la configurazione dall'elenco a discesa Seleziona configurazione esecuzione/debug nella barra degli strumenti. Android Studio salva le configurazioni come parte del progetto.
Configurazione di esecuzione/debug inizialmente creata
Quando crei un progetto per la prima volta, Android Studio crea una configurazione di esecuzione/debug per l'attività principale in base al modello di app Android. Per eseguire o eseguire il debug del progetto, devi sempre avere almeno una configurazione di esecuzione/debug definita. Per questo motivo, ti consigliamo di non eliminare la configurazione creata inizialmente.
Ambito del progetto e controllo della versione
Le configurazioni di esecuzione/debug e le modifiche ai modelli si applicano solo al progetto attuale. Puoi condividere una configurazione di esecuzione/debug (ma non un modello) tramite il tuo sistema di controllo della versione. Per saperne di più su come condividere una configurazione, vedi Opzioni di nome e condivisione di configurazione.
Apri la finestra di dialogo Configurazioni Esegui/Debug
Per aprire la finestra di dialogo Configurazioni di esecuzione/debug, seleziona Esegui > Modifica configurazioni. Viene visualizzata la finestra di dialogo Configurazioni esecuzione/debug, come mostrato nella figura 1.
Figura 1. La finestra di dialogo Configurazioni esecuzione/debug
Il riquadro a sinistra della finestra di dialogo raggruppa le configurazioni definite per tipo di modello e consente di modificare i modelli di configurazione in basso. Puoi modificare la configurazione selezionata nel riquadro a destra. Ridimensiona la finestra di dialogo per visualizzare gli elementi nascosti.
In questa finestra di dialogo puoi:
- Crea nuove configurazioni di esecuzione/debug.
- Modifica le configurazioni di esecuzione/debug.
- Modifica i modelli di configurazione.
- Configurazioni di ordinamento e raggruppamento.
Crea una nuova configurazione di esecuzione/debug
Puoi definire nuove configurazioni di esecuzione/debug dalla finestra di dialogo Configurazioni esecuzione/Debug, dalla finestra Progetto o dall'editor di codice. La nuova configurazione deve essere basata su un modello di configurazione.
La finestra di dialogo Configurazioni esecuzione/debug mostra le configurazioni di esecuzione/debug e i modelli di configurazione disponibili. Puoi avviare una nuova configurazione direttamente da un modello o da una copia di un'altra configurazione. Puoi quindi modificare i valori dei campi in base alle tue esigenze.
In alternativa, puoi fare clic con il tasto destro del mouse su un elemento nella finestra Progetto per creare automaticamente una configurazione specifica per quell'elemento. Ad esempio, se vuoi eseguire una determinata attività, puoi fare clic con il tasto destro del mouse sul file Java dell'attività e selezionare Esegui. A seconda dell'elemento, Android Studio utilizza un modello di configurazione per App Android, Android Instrumented Tests o JUnit per creare la configurazione.
Nell'editor di codice, puoi facilmente creare una configurazione di test ed esecuzione/debug per una classe o un metodo, quindi eseguirla.
Quando crei una configurazione all'esterno della finestra di dialogo Configurazioni Esegui/Debug, è temporanea, a meno che non la salvi. Per impostazione predefinita, puoi avere fino a cinque configurazioni temporanee nel progetto prima che Android Studio inizi a rimuoverle. Per modificare questa impostazione predefinita, apri le impostazioni di Android Studio e modifica Impostazioni avanzate > Esegui/Debug > Limite configurazioni temporaneo. Per ulteriori informazioni sulle configurazioni temporanee, consulta Creazione e salvataggio di configurazioni di esecuzione/debug temporanee.
Avvia una configurazione basata su un modello
Per definire una configurazione di esecuzione/debug basata su un modello:
- Apri la finestra di dialogo Esegui/Debug Configurazioni.
- Fai clic su Aggiungi nuova configurazione
.
- Seleziona un modello di configurazione.
- Digita un nome nel campo Nome.
- Modifica la configurazione in base alle tue esigenze.
- Fai clic su Applica o OK.
Assicurati di correggere eventuali errori visualizzati nella parte inferiore della finestra di dialogo.
Avvia una configurazione da una copia
Per definire una configurazione di esecuzione/debug a partire da una copia di un'altra configurazione, segui questi passaggi:
- Apri la finestra di dialogo Esegui/Debug Configurazioni.
- Seleziona una configurazione di esecuzione/debug esistente nel riquadro a sinistra.
- Fai clic su Copia configurazione
.
- Digita un nome nel campo Nome.
- Modifica la configurazione in base alle tue esigenze.
- Fai clic su Applica o OK.
Assicurati di correggere eventuali errori visualizzati nella parte inferiore della finestra di dialogo.
Definisci una configurazione per un elemento del progetto
Android Studio può creare una configurazione di esecuzione/debug per alcuni elementi visualizzati nella finestra Progetto. La configurazione si basa su un modello di configurazione, come segue:
- File Java di attività: il modello per app per Android.
- Pacchetto: Android Instrumented Tests o modello Android JUnit, a seconda del set di origini. Se selezioni un test instrumentato, viene utilizzato il modello Android Instrumented Tests. Se selezioni un test delle unità locali, viene utilizzato il modello JUnit per Android. Per un test delle unità locali, puoi eseguire la copertura del codice. Per ulteriori informazioni, consulta Copertura del codice.
Per creare una configurazione di esecuzione/debug per un elemento del progetto:
- Apri un progetto nella vista Android o Progetto.
- Nella finestra Progetto, fai clic con il tasto destro del mouse su un elemento testabile e seleziona Esegui filename o Debug filename. Android Studio crea una configurazione di esecuzione/debug temporanea e avvia l'app.
- Apri l'elenco a discesa Seleziona configurazione esecuzione/debug nella barra degli strumenti.
- Seleziona Salva configurazione dalle opzioni accanto alla configurazione che vuoi salvare.
Figura 2. Salva la configurazione
Nota: se fai clic con il tasto destro del mouse ed esegui o esegui il debug dello stesso elemento (ma non di un'attività), Android Studio crea una nuova configurazione.
Definisci una configurazione di test per una classe o un metodo
Android Studio ti consente di definire una configurazione dell'esecuzione di test per una classe o un metodo e quindi di eseguirla. Ad esempio, se crei un nuovo corso, puoi creare ed eseguire un test per il corso. Se il test ha esito positivo, puoi eseguire i test per il resto del progetto per assicurarti che il nuovo codice non rompa nulla da nessun'altra parte.
Android Studio utilizza il modello Android Instrumented Tests o Android JUnit a seconda del set di sorgenti. Per un test delle unità locali, puoi facoltativamente eseguirlo con la copertura del codice.
Per creare una configurazione di esecuzione/debug per una classe o un metodo nel codice Java, segui questi passaggi:
- Apri un progetto nella vista Android o Progetto.
- Apri un file Java nell'editor di codice.
- Seleziona una classe o un metodo nel codice, quindi premi Ctrl+Maiusc+T (Comando+Maiusc+T).
- Seleziona Crea nuovo test dal menu visualizzato.
- Nella finestra di dialogo Crea test, facoltativamente, modifica o imposta i valori e fai clic su OK.
- Nella finestra di dialogo Scegli directory di destinazione, seleziona la posizione del progetto in cui vuoi che Android Studio esegua il test. Puoi specificare la località in base alla struttura della directory o selezionando una classe vicina.
- Fai clic su Ok.
Il nuovo test viene visualizzato nella finestra Progetto nel set di origini del test corrispondente.
- Per eseguire il test, effettua una delle seguenti operazioni:
- Nella finestra Progetto, fai clic con il tasto destro del mouse sul test e seleziona Esegui o Debug.
- Nell'editor di codice, fai clic con il tasto destro del mouse sulla definizione di una classe o sul nome di un metodo nel file di test e seleziona Esegui o Debug per testare tutti i metodi della classe.
- Apri l'elenco a discesa Seleziona configurazione esecuzione/debug nella barra degli strumenti.
- Seleziona Save Configuration (Salva configurazione) dalle opzioni accanto alla configurazione che vuoi salvare.
Figura 3. Salva la configurazione
Eseguire o eseguire il debug di un'app utilizzando una configurazione salvata
Se hai salvato una configurazione di esecuzione/debug, puoi selezionarla prima di eseguire o eseguire il debug dell'app.
Per utilizzare una configurazione di esecuzione/debug salvata:
- Seleziona la configurazione di esecuzione/debug dall'elenco a discesa Seleziona configurazione esecuzione/debug nella barra degli strumenti.
- Seleziona Esegui > Esegui o Esegui > Debug.
L'elenco a discesa si trova a sinistra di Esegui
e Debug
;
ad esempio
.
In alternativa, fai clic su Esegui o
Debug
.
Modificare una configurazione di esecuzione/debug
Per modificare una configurazione di esecuzione/debug:
- Apri la finestra di dialogo Esegui/Debug Configurazioni.
- Seleziona una configurazione nel riquadro a sinistra.
- Modifica la configurazione in base alle tue esigenze.
- Fai clic su Applica o OK.
Assicurati di correggere eventuali errori visualizzati nella parte inferiore della finestra di dialogo.
Modifica un modello di configurazione di esecuzione/debug
Puoi modificare i modelli di configurazione forniti da Android Studio per adattarli al tuo processo di sviluppo. La modifica di un modello non influisce sulle configurazioni esistenti che lo utilizzano. Quindi, ad esempio, se devi creare una serie di configurazioni di un certo tipo, puoi modificare il modello e ripristinarlo di nuovo al termine dell'operazione.
Anche se non puoi creare nuovi modelli, puoi creare configurazioni da utilizzare in modo simile a un modello. Puoi copiare una configurazione e modificarla per creare nuove configurazioni.
Per modificare un modello, procedi nel seguente modo:
- Apri la finestra di dialogo Esegui/Debug Configurazioni.
- Fai clic su Modifica modelli di configurazione....
- Seleziona un modello di configurazione.
- Modifica la configurazione in base alle tue esigenze.
- Fai clic su Applica o OK.
Assicurati di correggere eventuali errori visualizzati nella parte inferiore della finestra di dialogo.
Ordina e raggruppa le configurazioni
Nella finestra di dialogo Configurazioni esecuzione/debug, puoi ordinare le configurazioni per trovarle rapidamente. Puoi ordinare gli elementi nella cartella in ordine alfabetico e creare nuove cartelle per raggruppare le configurazioni.
Per ordinare le configurazioni in ordine alfabetico:
- Apri la finestra di dialogo Esegui/Debug Configurazioni.
- Seleziona una cartella che contiene configurazioni.
- Fai clic su Configurazioni di ordinamento
.
- Fai clic su OK per chiudere la finestra di dialogo.
Per raggruppare le configurazioni in cartelle:
- Apri la finestra di dialogo Esegui/Debug Configurazioni.
- Seleziona una cartella che contiene configurazioni.
- Fai clic su Crea nuova cartella
.
- Digita un nome nel campo Nome cartella.
- Fai clic su Applica per salvare il nome.
Definisci le operazioni prima del lancio
Puoi specificare le attività da eseguire prima di applicare la configurazione di esecuzione/debug. Le attività vengono eseguite nell'ordine in cui appaiono nell'elenco.
Nota: la definizione delle attività prima del lancio è una funzionalità avanzata. Anziché utilizzare questa funzionalità, ti consigliamo di inserire qualsiasi logica di preparazione come attività nel file build.gradle
, in modo da eseguirle durante la creazione dalla riga di comando.
Per creare un elenco di attività:
- Nella parte inferiore della finestra di dialogo Configurazioni esecuzione/debug in Prima del lancio
(potrebbe essere necessario scorrere verso il basso),
fai clic su Aggiungi
e seleziona un tipo di attività. Se si apre una finestra di dialogo, compila i campi e fai clic su OK.
- Aggiungi altre attività in base alle esigenze.
- Per ordinare le attività, trascinale o selezionane una e fai clic su Su
e Giù
per spostarla in alto o in basso nell'elenco.
- Seleziona Mostra questa pagina se vuoi visualizzare le impostazioni di configurazione di esecuzione/debug prima di applicarle.
Questa opzione è deselezionata per impostazione predefinita.
- Seleziona Finestra degli strumenti attivi se vuoi che la finestra dello strumento Esegui o Debug venga attivata quando esegui o esegui il debug della tua app.
Questa opzione è selezionata per impostazione predefinita.
Per rimuovere un'attività dall'elenco:
- Seleziona un'attività.
- Fai clic su Rimuovi
.
Per modificare un'attività:
- Seleziona un'attività.
- Fai clic su Modifica
.
- Modifica le impostazioni dell'attività nella finestra di dialogo visualizzata, quindi fai clic su OK.
La tabella seguente elenca le attività disponibili che puoi aggiungere.
Attività | Descrizione |
---|---|
Esegui strumento esterno | Eseguire un'applicazione esterna ad Android Studio. Nella finestra di dialogo Strumenti esterni, seleziona una o più applicazioni che vuoi eseguire e fai clic su OK. Se l'applicazione non è ancora definita in Android Studio, aggiungine la definizione nella finestra di dialogo Crea strumenti. Per ulteriori informazioni, consulta le sezioni Configurazione di strumenti di terze parti e Strumenti esterni. |
Esegui un'altra configurazione | Esegui una delle configurazioni di esecuzione/debug esistenti. Nella finestra di dialogo Scegli la configurazione per eseguire, seleziona una configurazione da eseguire e fai clic su OK. |
Crea | Compila il progetto o il modulo. Android Studio esegue il comando Make Module se la configurazione di esecuzione/debug specifica un determinato modulo oppure esegue il comando Make Project se non vengono specificati moduli. |
Crea progetto | Compila il progetto. Android Studio esegue il comando Make Project. |
Esegui, nessun controllo degli errori | Questa opzione è uguale a Crea, ad eccezione del fatto che Android Studio esegue la configurazione di esecuzione/debug indipendentemente dal risultato della compilazione. |
Artefatti build | Non supportata in Android Studio. |
Esegui attività Gradle | Esegui un'attività Gradle. Nella finestra di dialogo visualizzata, specifica i dettagli e fai clic su OK. Per ulteriori informazioni, consulta Gradle. |
Marca che riconosce Gradle | Compila il progetto ed esegui Gradle. |
Builder Gradle di App Engine | L'attività Builder Gradle di App Engine sincronizza il progetto e quindi crea il modulo. |
Modelli di configurazione
Android Studio fornisce modelli di configurazione per aiutarti a iniziare rapidamente. Le seguenti sezioni descrivono i modelli applicabili allo sviluppo Android con Android Studio:
- App per Android
- Test Android
- DevAppServer di App Engine
- Complicazione, riquadro e quadrante di Wear OS
Nota: Android Studio 2.1.x e versioni precedenti avevano un modello di applicazione nativa, che non disponeva delle versioni più recenti. Se in un progetto è presente un modello di applicazione nativa, Android Studio lo converte in un'app per Android quando carichi il progetto. La finestra di dialogo Converti progetto ti guida nella procedura.
Modelli non supportati
I seguenti modelli non supportati provengono da IntelliJ IDEA e non sono specifici dello sviluppo Android con Android Studio. Per informazioni sull'uso di questi modelli, segui i link alla documentazione di IntelliJ IDEA.
- Applicazione
- Complesso
- Gradle
- Scusa
- Applicazione JAR
- Java Scratch
- JUnit
- Kotlin
- Script Kotlin
- Debug remoto
- Script shell
- TestNG
Opzioni di configurazione comuni
Le opzioni Nome, Consenti esecuzione parallela e Archivia come file di progetto sono comuni a più modelli di configurazione. Per saperne di più, vedi Impostazioni comuni.
Android Studio archivia la configurazione di esecuzione/debug condivisa in singoli file XML
all'interno della cartella project_directory/.idea/runConfigurations/
.
Per maggiori informazioni, consulta la sezione Formato basato su directory nella documentazione dei progetti IntelliJ.
App per Android
Puoi eseguire o eseguire il debug di app e attività Android su dispositivi virtuali o hardware utilizzando configurazioni basate su questo modello.
Scheda Generali
Nella scheda Generale, puoi specificare le opzioni di installazione, avvio e deployment. La scheda Varie contiene anche le opzioni di installazione.
Campo | Descrizione |
---|---|
Module | Seleziona un modulo a cui applicare questa configurazione. |
Opzioni di installazione: deployment | Seleziona un'opzione:
|
Opzioni di installazione: esegui il deployment come app istantanea | Se la tua app supporta le app istantanee, ovvero aggiungi il supporto per le app istantanee quando crei un nuovo progetto oppure crei uno o più moduli di funzionalità con attivazione istantanea, puoi scegliere di eseguire il deployment di questi moduli attivando le app istantanee selezionando la casella accanto a Esegui il deployment come app istantanea. |
Opzioni di installazione: funzionalità di cui implementare |
Se la tua app include
moduli delle funzionalità,
seleziona la casella accanto a ogni funzionalità da includere quando esegui il deployment dell'app. Questa opzione viene visualizzata solo se la tua app include moduli delle funzionalità.
Nota: se vuoi testare il download e l'installazione di moduli di funzionalità on demand, devi farlo dopo aver pubblicato l'app bundle e dopo aver utilizzato il canale di test interno di Play Console. Per scoprire di più, consulta Caricare l'app bundle in Play Console. |
Opzioni di installazione: installazione di flag | Digita le opzioni pm
install ADB che vuoi utilizzare. Formatta le opzioni come faresti
nella riga di comando, ma senza un percorso. Ecco alcuni esempi:
che per gli
Predefinito: nessuna opzione. |
Opzioni di lancio: lancio | Seleziona un'opzione:
|
Opzioni di lancio: segnalazioni di lancio | Digita le opzioni am
start ADB che vuoi utilizzare. Formatta le opzioni come faresti
nella riga di comando, ma senza intent. Ecco alcuni esempi:
Questa opzione non viene visualizzata se hai scelto il valore Launch (Avvia) di Nothing. Predefinito: nessuna opzione. |
Opzioni di destinazione dell'implementazione: target | Seleziona un'opzione:
|
Opzioni di destinazione dell'implementazione: utilizza lo stesso dispositivo per lanci futuri |
Per impostazione predefinita questa opzione è deselezionata in modo che ogni volta che esegui un'app, venga visualizzata la finestra di dialogo Seleziona
deployment per selezionare un dispositivo. Quando selezioni questa opzione ed esegui un'app, viene visualizzata la finestra di dialogo Seleziona deployment in cui puoi selezionare un dispositivo. Ogni volta che esegui l'app, questa viene avviata sul dispositivo selezionato senza visualizzare la finestra di dialogo Seleziona deployment. Per eseguire l'app su un altro dispositivo, deseleziona Utilizza lo stesso dispositivo per i lanci futuri oppure interrompi l'app selezionando Esegui > Interrompi app o Interrompi ![]() |
Prima del lancio | Consulta Definizione delle operazioni prima del lancio. |
Scheda Varie
Nella scheda Vari, puoi specificare le opzioni di logcat, installazione, avvio e deployment. La scheda Generale contiene anche le opzioni di installazione.
Campo | Descrizione |
---|---|
Logcat: mostra logcat automaticamente | Quando questa opzione è selezionata, la finestra Logcat si apre ogni volta che esegui correttamente il deployment e l'avvio di un'app utilizzando questa configurazione. Valore predefinito: selezionato. |
Logcat: cancella il log prima dell'avvio | Seleziona questa opzione se vuoi che Android Studio rimuova i dati delle sessioni precedenti dal file di log prima di avviare l'app. Impostazione predefinita: deselezionata. |
Opzioni di installazione: salta l'installazione se l'APK non è cambiato. | Se selezioni questa opzione, Android Studio non esegue nuovamente il deployment dell'APK se rileva che è rimasto invariato. Se vuoi che Android Studio forzi l'installazione dell'APK, anche se non è cambiato, deseleziona questa opzione. Predefinita: selezionata |
Opzioni di installazione: Forza l'interruzione dell'esecuzione dell'applicazione prima di avviare l'attività | Se questa opzione è selezionata, quando Android Studio rileva che non è necessario reinstallare un APK perché non è cambiato, l'app viene arrestata forzatamente in modo che l'app venga avviata dall'attività in Avvio applicazioni predefinita. Se questa opzione è deselezionata, Android Studio non forza l'interruzione dell'app. Questa opzione funziona con l'opzione precedente, che controlla se un APK è installato o meno. Lascia invariati i valori predefiniti di entrambi i campi Opzioni di installazione, a meno che tu non voglia esplicitamente forzare un'installazione ogni volta. In alcuni casi potresti voler deselezionare questa opzione. Ad esempio, se stai scrivendo un motore del metodo di immissione (IME), l'arresto forzato dell'app la deseleziona come tastiera corrente, cosa che potresti non volere. Predefinita: selezionata |
Prima del lancio | Consulta Definizione delle operazioni prima del lancio. |
Scheda Debugger
Specifica le opzioni di debug nella scheda Debugger.
Per i codici C e C++, Android Studio utilizza il debugger LLDB. Oltre alla normale interfaccia utente di Android Studio, la finestra del debugger include una scheda LLDB che consente di inserire comandi LLDB durante il debug. Puoi inserire gli stessi comandi utilizzati da Android Studio per visualizzare le informazioni nell'interfaccia utente del debugger ed eseguire operazioni aggiuntive.
Per i progetti C e C++, puoi aggiungere directory di simboli, nonché comandi di avvio e post-collegamento LLDB, nella scheda Debugger. Per farlo, utilizza pulsanti simili ai seguenti:
- Aggiungi
- Aggiungi una directory o un comando.
- Rimuovi
- Seleziona una directory o un comando, quindi fai clic su questo pulsante per rimuovere l'elemento.
- Su
- Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento in alto nell'elenco.
- Freccia giù
- Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento in basso nell'elenco.
Vedi Debug dell'app per ulteriori informazioni sul debug in Android Studio.
Campo | Descrizione |
---|---|
Tipo di debug | Seleziona una delle seguenti opzioni:
L'opzione Rileva automaticamente è consigliata perché sceglie il tipo di debug corretto per il tuo progetto. |
Directory dei simboli | Se vuoi aggiungere file di simboli per fornire al debugger informazioni su C o C++ generate al di fuori di Android Studio, puoi aggiungere una o più directory qui. Android Studio utilizza preferibilmente qualsiasi file all'interno di queste directory rispetto ai file generati dal plug-in Android per Gradle. Il debugger cerca le directory dall'alto verso il basso, in ordine, finché non trova ciò di cui ha bisogno. Cerca in modo ricorsivo tra i file della directory. Per ottimizzare l'elenco e risparmiare tempo, metti le directory utilizzate più spesso in cima all'elenco. Se specifichi una directory nella parte superiore della struttura, la ricerca in tutte le sottodirectory potrebbe richiedere più tempo. Se aggiungi una directory molto specifica, la ricerca richiederà meno tempo. Devi trovare il giusto equilibrio tra velocità e ricerca dei file necessari per il debug. Ad esempio, se hai una directory che contiene sottodirectory per diverse ABI (Android Binary Interfaces) diverse, puoi scegliere di aggiungerne una per un'ABI specifica o per tutte le ABI. Anche se la ricerca nella directory di livello superiore può richiedere più tempo, è comunque più infallibile se decidi di eseguire il debug su un altro dispositivo. Tieni presente che non devi aggiungere directory contenenti file di simboli Gradle perché il debugger li utilizza automaticamente. |
Comandi di avvio LLDB | Aggiungi i comandi LLDB da eseguire prima che il debugger si colleghi al processo. Ad esempio, puoi definire le impostazioni per l'ambiente, come mostrato nel seguente comando:
LLDB esegue i comandi in ordine dall'alto verso il basso. |
Comandi di collegamento post-collegamento LLDB | Aggiungi i comandi LLDB che vuoi eseguire subito dopo che il debugger è collegato al processo. Ecco alcuni esempi:
LLDB esegue i comandi in ordine dall'alto verso il basso. |
Directory di lavoro host | Specifica la directory di lavoro LLDB. |
Logging: canali target | Specifica le opzioni di log LLDB. Android Studio imposta le opzioni predefinite in base all'esperienza del team, quindi non è troppo lento, ma contiene le informazioni necessarie per la risoluzione dei problemi. Questo log viene spesso richiesto per le segnalazioni di bug di Android Studio. L'impostazione predefinita è
Puoi modificare l'impostazione predefinita per raccogliere più informazioni. Ad esempio, le seguenti opzioni di log raccolgono informazioni su un lldb process
platform:gdb-remote packets
Per un elenco completo dei comandi di log, inserisci il comando
Android Studio inserisce i log del dispositivo nella seguente posizione, dove
Oppure, se
più utenti accedono a un dispositivo, i log vengono inseriti nella seguente posizione,
dove
Per informazioni sull'utilizzo di LLDB per il debug remoto, vedi Debug remoto. |
Prima del lancio | Consulta Definizione delle operazioni prima del lancio. |
Scheda Profilazione
L'opzione Attiva profilazione avanzata deve essere selezionata per attivare determinate funzionalità in Android Profiler se sul tuo dispositivo è in esecuzione Android 7.1 o versioni precedenti.
Test Android
Il modello di test da utilizzare dipende dal tuo set di origine. Il modello Android Instrumented Tests è per un test instrumented. Il modello di JUnit per Android serve per il test delle unità locali.
Nota: se utilizzi Firebase Test Lab per eseguire test su diversi dispositivi, puoi usare il modello Android JUnit per definire i test instrumentati. Per ulteriori informazioni, consulta Eseguire i test con Firebase Test Lab.
Le seguenti descrizioni delle schede coprono le schede e i campi per il modello di test Android Instrumented. Per informazioni sulle schede e sui campi per il modello di test della JUnit per Android, visita la pagina Esegui/debug configurazione: JUnit di IntelliJ.
Scheda Generali
Nella scheda Generale, puoi specificare la località di test, l'esecutore della strumentazione, la shell adb e le opzioni di deployment.
Campo | Descrizione |
---|---|
Module | Seleziona un modulo a cui applicare questa configurazione. |
Test | In questa area, specifica la località dei test che vuoi eseguire:
|
Runner della strumentazione specifica (facoltativo) | Digita la posizione del runner della strumentazione; fai clic su Altro per utilizzare una finestra di dialogo. Il file build.gradle specifica la posizione del runner della strumentazione; questo valore la sostituisce. In genere, l'impostazione predefinita è la classe AndroidJUnitRunner
di AndroidX Test.
|
Opzioni extra | Digita le opzioni Predefinito:nessuna opzione |
Opzioni di destinazione dell'implementazione: target | Seleziona un'opzione:
|
Opzioni di destinazione dell'implementazione: utilizza lo stesso dispositivo per lanci futuri | Se in futuro vorrai utilizzare automaticamente il dispositivo che hai scelto tramite la finestra di dialogo Seleziona il target del deployment, seleziona questa opzione. Se il dispositivo non è disponibile, verrà visualizzata una finestra di dialogo. Predefinita: deselezionata |
Prima del lancio | Consulta Definizione delle operazioni prima del lancio. |
Scheda Varie
La scheda Miscellaneous (Varie) contiene logcat e opzioni di installazione.
Campo | Descrizione |
---|---|
Logcat: cancella il log prima dell'avvio | Seleziona questa opzione se vuoi che Android Studio rimuova i dati delle sessioni precedenti dal file di log prima di avviare l'app. Impostazione predefinita: deselezionata. |
Opzioni di installazione: salta l'installazione se l'APK non è cambiato | Se selezioni questa opzione, Android Studio non esegue nuovamente il deployment dell'APK se rileva che è rimasto invariato. Se vuoi che Android Studio forzi l'installazione dell'APK, anche se non è cambiato, deseleziona questa opzione. Predefinita: selezionata |
Opzioni di installazione: Forza l'interruzione dell'esecuzione dell'applicazione prima di avviare l'attività | Se questa opzione è selezionata, quando Android Studio rileva che non è necessario reinstallare un APK perché non è cambiato, l'app viene arrestata forzatamente in modo che l'app venga avviata dall'attività in Avvio applicazioni predefinita. Se questa opzione è deselezionata, Android Studio non forza l'interruzione dell'app. Questa opzione funziona in combinazione con l'opzione precedente, che controlla se un APK è installato o meno. Lascia invariati i valori predefiniti di entrambi i campi Opzioni di installazione, a meno che tu non voglia esplicitamente forzare un'installazione ogni volta. In alcuni casi potresti voler deselezionare questa opzione. Ad esempio, se stai scrivendo un motore del metodo di immissione (IME), l'arresto forzato dell'app la deseleziona come tastiera corrente, cosa che potresti non volere. Predefinita: selezionata |
Prima del lancio | Consulta Definizione delle operazioni prima del lancio. |
Scheda Debugger
Specifica le opzioni di debug nella scheda Debugger.
Per i codici C e C++, Android Studio utilizza il debugger LLDB. Oltre alla normale interfaccia utente di Android Studio, la finestra del debugger include una scheda LLDB che consente di inserire comandi LLDB durante il debug. Puoi inserire gli stessi comandi utilizzati da Android Studio per visualizzare le informazioni nell'interfaccia utente del debugger ed eseguire operazioni aggiuntive.
Per i progetti C e C++, puoi aggiungere directory di simboli, nonché comandi di avvio e post-collegamento LLDB, nella scheda Debugger. Per farlo, utilizza pulsanti simili ai seguenti:
- Aggiungi
- Aggiungi una directory o un comando.
- Rimuovi
- Seleziona una directory o un comando, quindi fai clic su questo pulsante per rimuovere l'elemento.
- Su
- Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento in alto nell'elenco.
- Freccia giù
- Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento in basso nell'elenco.
Vedi Debug dell'app per ulteriori informazioni sul debug in Android Studio.
Campo | Descrizione |
---|---|
Tipo di debug | Seleziona una delle seguenti opzioni:
L'opzione Rileva automaticamente è consigliata perché sceglie il tipo di debug corretto per il tuo progetto. |
Directory dei simboli | Se vuoi aggiungere file di simboli per fornire al debugger informazioni su C o C++ generate al di fuori di Android Studio, puoi aggiungere una o più directory qui. Android Studio utilizza preferibilmente qualsiasi file all'interno di queste directory rispetto ai file generati dal plug-in Android per Gradle. Il debugger cerca le directory dall'alto verso il basso, in ordine, finché non trova ciò di cui ha bisogno. Cerca in modo ricorsivo tra i file della directory. Per ottimizzare l'elenco e risparmiare tempo, metti le directory utilizzate più spesso in cima all'elenco. Se specifichi una directory nella parte superiore della struttura, la ricerca in tutte le sottodirectory potrebbe richiedere più tempo. Se aggiungi una directory molto specifica, la ricerca richiederà meno tempo. Devi trovare il giusto equilibrio tra velocità e ricerca dei file necessari per il debug. Ad esempio, se hai una directory che contiene sottodirectory per diverse ABI (Android Binary Interfaces) diverse, puoi scegliere di aggiungerne una per un'ABI specifica o per tutte le ABI. Anche se la ricerca nella directory di livello superiore può richiedere più tempo, è comunque più infallibile se decidi di eseguire il debug su un altro dispositivo. Tieni presente che non devi aggiungere directory contenenti file di simboli Gradle perché il debugger li utilizza automaticamente. |
Comandi di avvio LLDB | Aggiungi i comandi LLDB da eseguire prima che il debugger si colleghi al processo. Ad esempio, puoi definire le impostazioni per l'ambiente, come mostrato nel seguente comando:
LLDB esegue i comandi in ordine dall'alto verso il basso. |
Comandi di collegamento post-collegamento LLDB | Aggiungi i comandi LLDB che vuoi eseguire subito dopo che il debugger è collegato al processo. Ecco alcuni esempi:
LLDB esegue i comandi in ordine dall'alto verso il basso. |
Directory di lavoro host | Specifica la directory di lavoro LLDB. |
Logging: canali target | Specifica le opzioni di log LLDB. Android Studio imposta le opzioni predefinite in base all'esperienza del team, quindi non è troppo lento, ma contiene le informazioni necessarie per la risoluzione dei problemi. Questo log viene spesso richiesto per le segnalazioni di bug di Android Studio. L'impostazione predefinita è
Puoi modificare l'impostazione predefinita per raccogliere più informazioni. Ad esempio, le seguenti opzioni di log raccolgono informazioni su un lldb process
platform:gdb-remote packets
Per un elenco completo dei comandi di log, inserisci il comando
Android Studio inserisce i log del dispositivo nella seguente posizione, dove
Oppure, se
più utenti accedono a un dispositivo, i log vengono inseriti nella seguente posizione,
dove
Per informazioni sull'utilizzo di LLDB per il debug remoto, vedi Debug remoto. |
Prima del lancio | Consulta Definizione delle operazioni prima del lancio. |
DevAppServer di App Engine
Questa configurazione di esecuzione/debug si applica alla piattaforma Google Cloud. Per ulteriori informazioni, consulta
Esecuzione, test e deployment del backend. Quando segui questi passaggi e sincronizzi il tuo progetto con il file build.gradle
, Android Studio crea per te una configurazione DevAppServer di App Engine.
Tieni presente che il modello App Engine Server di IntellJ IDEA è un modello diverso non disponibile in Android Studio.
Campo | Descrizione |
---|---|
Solo istanza singola | Se vuoi assicurarti che al momento sia eseguita una sola istanza della configurazione di esecuzione/debug, seleziona questa opzione. Non consente più esecuzioni della stessa configurazione contemporaneamente. Predefinita: selezionata |
Module | Seleziona un modulo a cui applicare questa configurazione. |
Sincronizzazione con la configurazione build.gradle | Se aggiungi un modulo App Engine ed esegui la sincronizzazione al file build.gradle , i campi di configurazione di App Engine DevAppServer vengono compilati automaticamente (consigliato).
Il progetto viene sincronizzato anche selezionando File > Sincronizza progetto con i file Gradle. Predefinita: selezionata
|
SDK App Engine | Digita un percorso di un SDK Google App Engine per Java sulla macchina locale. Fai clic su ... per selezionarlo da una finestra di dialogo. |
Percorso di guerra | Digita un percorso della directory WAR (Web Application Archive) dell'app di cui stai eseguendo il deployment sul server di sviluppo locale. Fai clic su ... per selezionarlo da una finestra di dialogo. |
Arg VM | Specifica le opzioni della riga di comando da passare alla VM per l'avvio di DevAppServer. Quando specifichi le opzioni:
Per ulteriori informazioni sulle opzioni della VM, consulta la documentazione per la tua versione di J2SE, ad esempio Predefinito: nessuna opzione |
Indirizzo del server | Digita l'indirizzo host da utilizzare per il server. Potrebbe essere necessario fornire l'indirizzo per poter accedere al server di sviluppo da un altro computer sulla rete. Un indirizzo 0.0.0.0 consente sia l'accesso localhost che l'accesso per nome host. Valore predefinito: localhost |
Porta server | Digita il numero della porta da utilizzare per il server. Valore predefinito: 8080 |
Disabilita il controllo degli aggiornamenti dell'SDK di App Engine | Se fornito, il server di sviluppo non contatterà App Engine per verificare la disponibilità di una nuova versione dell'SDK. Per impostazione predefinita, il server verifica la presenza di una nuova versione all'avvio e stampa un messaggio se è disponibile una nuova versione. |
Prima del lancio | Consulta Definizione delle operazioni prima del lancio. |
Configurazioni di esecuzione/debug per Wear OS
I modelli Complicazione, Tile e Quadrante per Wear OS ti consentono di eseguire o eseguire il debug delle app per Wear OS su dispositivi virtuali o hardware. La maggior parte delle opzioni di configurazione dei modelli corrispondono alle opzioni delle app per Android. Di seguito sono riportate le opzioni più specifiche per le configurazioni di esecuzione/debug di Wear OS:
- Per tutte le configurazioni di esecuzione/debug di Wear, devi selezionare un'origine dati, un riquadro o un quadrante specifico per la complicazione (a seconda del modello) a cui applicare la configurazione. In genere, ciascuna di queste entità corrisponde a una classe nel codice.
- Per la configurazione di esecuzione/debug delle complicazioni per Wear OS, devi scegliere lo Slot in cui vuoi inserire i dati sulle complicazioni forniti dall'origine dati delle complicazioni. Puoi scegliere di posizionarlo in alto, a destra, in basso, a sinistra o sullo sfondo del quadrante.
- Per la configurazione di esecuzione/debug delle complicazioni per Wear OS, devi selezionare anche il Tipo dei dati sulle complicazioni forniti dall'origine dati delle complicazioni. I tipi tra cui puoi scegliere sono limitati a quelli forniti dall'origine dati della complicazione scelta e supportati dallo slot scelto. Per un elenco dei tipi di dati relativi alle complicazioni, consulta Tipi e campi.
In alternativa, puoi anche eseguire queste superfici dall'icona grondaia che si trova accanto alla dichiarazione della superficie, come mostrato nell'immagine seguente.
![Pulsante Esegui nel gutter accanto a una classe WatchFaceService.](https://developer.android.com/static/studio/images/run/wearos_os_gutter_run.png?authuser=6&hl=it)