Quando esegui, sottoponi a debug o test il codice, Android Studio utilizza una configurazione di esecuzione/debug per determinare come eseguire l'operazione. In genere, la configurazione creata inizialmente è 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 installazione, avvio e test dell'app. Puoi definire una configurazione da usare una sola volta o salvarla per un uso futuro. Dopo averla salvata, puoi selezionare la configurazione dall'elenco a discesa Seleziona configurazione di esecuzione/debug nella barra degli strumenti. Android Studio salva le configurazioni nell'ambito del progetto.
Configurazione di esecuzione/debug creata inizialmente
Quando crei per la prima volta un progetto, 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 avere sempre definito almeno una configurazione di esecuzione/debug. 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 corrente. Puoi condividere una configurazione di esecuzione/debug (ma non un modello) tramite il sistema di controllo della versione. Per ulteriori informazioni su come condividere una configurazione, vedi Nome e condivisione delle opzioni di configurazione.
Apri la finestra di dialogo Esegui/configura configurazioni di debug
Per aprire la finestra di dialogo Esegui/configurazioni debug, seleziona Esegui > Modifica configurazioni. Viene visualizzata la finestra di dialogo Esegui/configurazioni debug, come mostrato nella Figura 1.
Il riquadro a sinistra della finestra di dialogo raggruppa le configurazioni definite per tipo di modello e consente di modificare i modelli di configurazione nella parte inferiore. 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.
- Modificare i modelli di configurazione.
- Ordinare e raggruppare le configurazioni.
Creare una nuova configurazione di esecuzione/debug
Puoi definire nuove configurazioni di esecuzione/debug dalla finestra di dialogo Configurazioni di 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 di esecuzione/debug visualizza 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. Potrai 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, Test strumentali Android o JUnit per creare la configurazione.
Nell'editor di codice, puoi creare facilmente una configurazione di test ed esecuzione/debug per una classe o un metodo ed eseguirlo.
Quando crei una configurazione al di fuori della finestra di dialogo Esegui/configurazioni di debug, la configurazione è 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 cambiare questa impostazione predefinita, apri le impostazioni di Android Studio e modifica Impostazioni avanzate > Esegui/Debug > Limite di configurazioni temporanee. Per saperne di più sulle configurazioni temporanee, consulta Creazione e salvataggio delle 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/configurazioni di debug.
- Fai clic su Aggiungi nuova configurazione .
- Seleziona un modello di configurazione.
- Digita un nome nel campo Nome.
- Modifica la configurazione, se necessario.
- Fai clic su Applica o OK.
Assicurati di correggere eventuali errori visualizzati nella parte inferiore della finestra di dialogo.
Avviare 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/configurazioni di debug.
- 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, se necessario.
- 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 nel 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: modello Android Instrumented Tests o Android JUnit, a seconda del tuo set di origine. Se selezioni un test strumentato, viene utilizzato il modello Android Instrumented Tests. Se selezioni un test delle unità locali, viene utilizzato il modello JUnit di Android. Per un test delle unità locali, puoi eseguirlo con il codice di copertura. Per ulteriori informazioni, consulta Copertura del codice.
Per creare una configurazione di esecuzione/debug per un elemento del progetto, segui questi passaggi:
- Apri un progetto in Android o nella visualizzazione 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 di esecuzione/debug nella barra degli strumenti.
- Seleziona Salva configurazione dalle opzioni accanto alla configurazione che
vuoi salvare.
Nota: se fai clic con il tasto destro del mouse ed esegui lo stesso elemento (ma non un'attività) o ne esegui il debug, Android Studio crea una nuova configurazione.
Definisci una configurazione di test per una classe o un metodo
Android Studio consente di definire e poi eseguire la configurazione di un'esecuzione di test per una classe o un metodo. Ad esempio, se crei una nuova classe, puoi creare ed eseguire un test. Se il test ha esito positivo, puoi eseguirlo per il resto del progetto per assicurarti che il nuovo codice non comprometta il funzionamento.
Android Studio utilizza il modello Android Instrumented Tests o Android JUnit, a seconda del set di origine. Per un test delle unità locali, puoi facoltativamente eseguire la copertura del codice.
Per creare una configurazione di esecuzione/debug per una classe o un metodo nel codice Java, procedi nel seguente modo:
- Apri un progetto in Android o nella visualizzazione 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, se vuoi, modifica o imposta i valori e fai clic su OK.
- Nella finestra di dialogo Scegli directory di destinazione, seleziona la posizione all'interno del progetto in cui vuoi che Android Studio esegua il test. Puoi specificare la posizione in base alla struttura della directory o selezionando una classe vicina.
- Fai clic su Ok.
Il nuovo test viene visualizzato nella finestra Progetto del set di origini di test corrispondente.
- Per eseguire il test, esegui 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 su una definizione di 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 di esecuzione/debug nella barra degli strumenti.
- Seleziona Salva configurazione dalle opzioni accanto alla configurazione che vuoi salvare.
Esecuzione o 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, procedi nel seguente modo:
- Seleziona la configurazione di esecuzione/debug dall'elenco a discesa Seleziona configurazione di 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, segui questi passaggi:
- Apri la finestra di dialogo Esegui/configurazioni di debug.
- Seleziona una configurazione nel riquadro a sinistra.
- Modifica la configurazione, se necessario.
- 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 in base al tuo processo di sviluppo. La modifica di un modello non influisce sulle configurazioni esistenti che lo utilizzano. Se ad esempio devi creare una serie di configurazioni di un determinato tipo, puoi modificare il modello e modificarlo 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 modificare la copia per creare nuove configurazioni.
Per modificare un modello:
- Apri la finestra di dialogo Esegui/configurazioni di debug.
- Fai clic su Modifica modelli di configurazione....
- Seleziona un modello di configurazione.
- Modifica la configurazione, se necessario.
- 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 Esegui/configura configurazioni di debug, puoi ordinare le configurazioni per trovarle rapidamente. Puoi ordinare gli elementi nella cartella in ordine alfabetico e creare nuove cartelle per le configurazioni di gruppo.
Per ordinare le configurazioni in ordine alfabetico, segui questi passaggi:
- Apri la finestra di dialogo Esegui/configurazioni di debug.
- Seleziona una cartella che contiene le configurazioni.
- Fai clic su Ordina configurazioni .
- Fai clic su OK per chiudere la finestra di dialogo.
Per raggruppare le configurazioni in cartelle:
- Apri la finestra di dialogo Esegui/configurazioni di debug.
- Seleziona una cartella che contiene le 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 sono visualizzate nell'elenco.
Nota:la definizione di 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 che venga eseguita quando crei dalla riga di comando.
Per creare un elenco di attività:
- Nella parte inferiore della finestra di dialogo Esegui/configurazioni 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 un'attività e fai clic sui pulsanti 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 venga attivata la finestra dello strumento Esegui o Debug quando esegui l'app o ne esegui il debug.
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, quindi fai clic su OK. Se l'applicazione non è ancora definita in Android Studio, aggiungi la relativa definizione nella finestra di dialogo Crea strumenti. Per saperne di più, consulta 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 da eseguire, seleziona una configurazione da eseguire e fai clic su OK. |
Crea | Compila il progetto o il modulo. Android Studio esegue il comando Crea modulo se la configurazione di esecuzione/debug specifica un modulo specifico oppure il comando Crea progetto se non è specificato alcun modulo. |
Crea progetto | Compila il progetto. Android Studio esegue il comando Make Project. |
Esegui un 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 che si apre, specifica i dettagli e fai clic su OK. Per ulteriori informazioni, consulta Gradle. |
Marca compatibile con Gradle | Compila il progetto ed esegui Gradle. |
Builder Gradle di App Engine | L'attività del builder di 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:
Nota: Android Studio 2.1.x e versioni precedenti avevano un modello di applicazione nativa, ma non le versioni più recenti. Se in un progetto è presente un modello di applicazione nativa, Android Studio lo converte in app per Android quando carichi il progetto. La finestra di dialogo Converti progetto ti guiderà nella procedura.
Modelli non supportati
I seguenti modelli non supportati provengono da IntelliJ IDEA e non sono specifici per lo sviluppo Android con Android Studio. Per informazioni sull'utilizzo di questi modelli, segui i link alla documentazione di IntelliJ IDEA.
- App
- Composto
- Valutazione
- Blocchi
- Applicazione JAR
- Java Scratch
- Unità J
- Kotlin
- Script Kotlin
- Debug remoto
- Script shell
- TestNG
Opzioni di configurazione comuni
Le opzioni Nome, Consenti esecuzione in parallelo e Archivia come file di progetto sono comuni a più modelli di configurazione. Per scoprire di più in merito, vedi Impostazioni comuni.
Android Studio archivia la configurazione di esecuzione/debug condivisa in singoli file XML
nella 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 le configurazioni basate su questo modello.
Scheda Generali
Nella scheda Generali, puoi specificare le opzioni di installazione, lancio e deployment. La scheda Varie contiene anche opzioni di installazione.
Campo | Descrizione |
---|---|
Module | Seleziona un modulo a cui applicare questa configurazione. |
Opzioni di installazione: esegui il deployment | Seleziona un'opzione:
|
Opzioni di installazione: esegui il deployment come app istantanea | Se la tua app supporta le app istantanee, ovvero se aggiungi il supporto per le app istantanee quando crei un nuovo progetto o crei uno o più moduli di funzionalità ad attivazione istantanea, puoi scegliere di eseguire il deployment di questi moduli ad attivazione istantanea selezionando la casella accanto a Esegui il deployment come app istantanea. |
Opzioni di installazione: funzionalità di cui eseguire il deployment |
Se la tua app include moduli delle funzionalità, seleziona la casella accanto a ogni funzionalità che vuoi includere quando esegui il deployment dell'app. Questa opzione viene visualizzata solo se l'app include moduli delle funzionalità.
Nota: se vuoi testare il download e l'installazione dei moduli delle funzionalità on demand, devi farlo dopo aver pubblicato l'app bundle e aver utilizzato il canale di test interno di Play Console. Per scoprire di più, consulta la pagina Caricare l'app bundle in Play Console. |
Opzioni di installazione: flag di installazione | Digita le eventuali opzioni pm
install ab che vuoi utilizzare. Formatta le opzioni come faresti nella
riga di comando, ma senza un percorso. Ecco alcuni esempi:
e
Predefinito: nessuna opzione. |
Opzioni di avvio: Avvia | Seleziona un'opzione:
|
Opzioni di avvio: flag di avvio | Digita le eventuali opzioni am
start ab che vuoi utilizzare. Formatta le opzioni come faresti nella riga di comando, ma senza un intento. Ecco alcuni esempi:
Questa opzione non viene visualizzata se scegli Avvio come valore Nothing. Predefinito: nessuna opzione. |
Opzioni di destinazione del deployment: destinazione | Seleziona un'opzione:
|
Opzioni di destinazione del deployment: usa lo stesso dispositivo per i lanci futuri |
Per impostazione predefinita, questa opzione è deselezionata in modo che ogni volta che esegui un'app viene visualizzata la finestra di dialogo Seleziona deployment in cui puoi 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. Poi, 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 con Esegui > Arresta app o Interrompi , quindi riavviala. Viene visualizzata la finestra di dialogo Seleziona deployment, in cui puoi selezionare un dispositivo. |
Prima del lancio | Consulta la sezione Definizione delle operazioni prima del lancio. |
Scheda Varie
Nella scheda Varie, puoi specificare le opzioni logcat, di installazione, avvio e deployment. La scheda Generali 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. Predefinito: deselezionato. |
Opzioni di installazione: ignora l'installazione se l'APK non è cambiato. | Quando questa opzione è selezionata, Android Studio non esegue nuovamente il deployment dell'APK se rileva che non è stato modificato. Se vuoi che Android Studio imponi l'installazione dell'APK, anche se non è cambiata, deseleziona questa opzione. Valore predefinito: selezionato |
Opzioni di installazione: forza l'interruzione dell'applicazione in esecuzione prima di avviare l'attività | Se questa opzione è selezionata, quando Android Studio rileva che non è necessario reinstallare un APK perché non è cambiato, ne forza l'interruzione in modo che l'app venga avviata dall'attività predefinita di Avvio app. Se questa opzione è deselezionata, Android Studio non forza l'interruzione dell'app. Questa opzione funziona con l'opzione precedente, che controlla se è stato installato o meno un APK. Lascia invariati i valori predefiniti di entrambi i campi Opzioni di installazione, a meno che tu non voglia forzare esplicitamente un'installazione ogni volta. In alcuni casi, può essere utile deselezionare questa opzione. Ad esempio, se stai scrivendo un motore del metodo di immissione (IME), l'arresto forzato dell'app lo deseleziona come tastiera corrente, cosa che potresti non volere. Valore predefinito: selezionato |
Prima del lancio | Consulta la sezione Definizione delle operazioni prima del lancio. |
Scheda Debugger
Specifica le opzioni di debug nella scheda Debugger.
Per il codice C e C++, Android Studio utilizza il debugger LLDB. Oltre alla normale UI di Android Studio, la finestra del debugger ha una scheda LLDB che ti consente di inserire i comandi LLDB durante il debug. Puoi inserire gli stessi comandi utilizzati da Android Studio per visualizzare le informazioni nell'interfaccia utente del debugger, oltre a eseguire operazioni aggiuntive.
Per i progetti C e C++, puoi aggiungere directory dei simboli, nonché comandi di avvio e post di 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.
- Giù - Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento in basso nell'elenco.
Per ulteriori informazioni sul debug in Android Studio, consulta Eseguire il debug dell'app.
Campo | Descrizione |
---|---|
Tipo di debug | Seleziona una delle seguenti opzioni:
È consigliata l'opzione Rileva automaticamente perché sceglie il tipo di debug corretto per il progetto. |
Directory di simboli | Se vuoi aggiungere file di simboli per fornire al debugger informazioni C o C++ generate al di fuori di Android Studio, puoi aggiungere una o più directory qui. Android Studio utilizza preferenzialmente i file all'interno di queste directory rispetto ai file generati dal plug-in di Android per Gradle. Il debugger cerca nelle directory dall'alto verso il basso, in ordine, finché non trova ciò di cui ha bisogno. Cerca in modo ricorsivo i file nella directory. Per ottimizzare l'elenco e risparmiare tempo, posiziona le directory utilizzate più spesso in cima all'elenco. Se specifichi una directory in cima alla struttura, la ricerca in tutte le sottodirectory può richiedere più tempo. Se aggiungi una directory molto specifica, la ricerca richiederà meno tempo. Devi trovare il giusto equilibrio tra velocità e individuazione dei file necessari per il debug. Ad esempio, se hai una directory che contiene sottodirectory di diverse ABI (Binary Interfaces) Android, puoi scegliere di aggiungere una directory per un'ABI specifica o per tutte le ABI. Sebbene la ricerca nella directory di livello superiore richieda più tempo, è anche 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 post-attacco LLDB | Aggiungi i comandi LLDB da 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 di destinazione | 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. Il log viene spesso richiesto per le segnalazioni di bug di Android Studio. Questo valore predefinito è
Puoi modificare l'impostazione predefinita per raccogliere più informazioni. Ad esempio, le seguenti opzioni di log raccolgono informazioni su un elemento 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
In alternativa, se
più utenti accedono a un dispositivo, i log vengono collocati nella seguente posizione,
dove
Per informazioni sull'utilizzo di LLDB per il debug remoto, consulta Debug remoto. |
Prima del lancio | Consulta la sezione Definizione delle operazioni prima del lancio. |
Scheda Profilazione
L'opzione Attiva profilazione avanzata deve essere selezionata per attivare determinate funzionalità in Android Profiler quando il dispositivo utilizza Android 7.1 o versioni precedenti.
Test di Android
Il modello di test da utilizzare dipende dal tuo set di origine. Il modello Test strumentali di Android è per un test instrumentato. Il modello JUnit di Android è destinato al test delle unità locali.
Nota: se ti avvali di Firebase Test Lab per eseguire test su vari dispositivi, puoi utilizzare il modello JUnit di Android per definire i test instrumentati. Per ulteriori informazioni, consulta la pagina Eseguire i test con Firebase Test Lab.
Le seguenti descrizioni delle schede coprono le schede e i campi del modello di test Android Instrumented. Per informazioni sulle schede e sui campi del modello di test JUnit per Android, consulta la pagina Configurazione esecuzione/debug: JUnit di IntelliJ.
Scheda Generali
Nella scheda Generale, puoi specificare posizione di test, runner della strumentazione, shell ADB e opzioni di deployment.
Campo | Descrizione |
---|---|
Module | Seleziona un modulo a cui applicare questa configurazione. |
Test | In questa area, specifica la posizione dei test che vuoi eseguire:
|
Corridore 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 corridore della strumentazione; questo valore la sostituisce. Il valore predefinito è in genere la classe AndroidJUnitRunner di AndroidX Test.
|
Opzioni extra | Digita le eventuali opzioni Predefinito:nessuna opzione |
Opzioni di destinazione del deployment: destinazione | Seleziona un'opzione:
|
Opzioni di destinazione del deployment: usa lo stesso dispositivo per i lanci futuri | Se in futuro vuoi utilizzare automaticamente il dispositivo scelto nella finestra di dialogo Seleziona target di deployment, seleziona questa opzione. Se il dispositivo non è disponibile, viene visualizzata una finestra di dialogo. Valore predefinito: deselezionato |
Prima del lancio | Consulta la sezione Definizione delle operazioni prima del lancio. |
Scheda Varie
La scheda 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. Predefinito: deselezionato. |
Opzioni di installazione: ignora l'installazione se l'APK non è cambiato | Quando questa opzione è selezionata, Android Studio non esegue nuovamente il deployment dell'APK se rileva che non è stato modificato. Deseleziona questa opzione se vuoi che Android Studio imponi l'installazione dell'APK, anche se non è cambiata. Valore predefinito: selezionato |
Opzioni di installazione: forza l'interruzione dell'applicazione in esecuzione prima di avviare l'attività | Se questa opzione è selezionata, quando Android Studio rileva che non è necessario reinstallare un APK perché non è cambiato, ne forza l'interruzione in modo che l'app venga avviata dall'attività predefinita di Avvio app. 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 forzare esplicitamente un'installazione ogni volta. In alcuni casi, può essere utile deselezionare questa opzione. Ad esempio, se stai scrivendo un motore del metodo di immissione (IME), l'arresto forzato dell'app lo deseleziona come tastiera corrente, cosa che potresti non volere. Valore predefinito: selezionato |
Prima del lancio | Consulta la sezione Definizione delle operazioni prima del lancio. |
Scheda Debugger
Specifica le opzioni di debug nella scheda Debugger.
Per il codice C e C++, Android Studio utilizza il debugger LLDB. Oltre alla normale UI di Android Studio, la finestra del debugger ha una scheda LLDB che ti consente di inserire i comandi LLDB durante il debug. Puoi inserire gli stessi comandi utilizzati da Android Studio per visualizzare le informazioni nell'interfaccia utente del debugger, oltre a eseguire operazioni aggiuntive.
Per i progetti C e C++, puoi aggiungere directory dei simboli, nonché comandi di avvio e post di 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.
- Giù - Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento in basso nell'elenco.
Per ulteriori informazioni sul debug in Android Studio, consulta Eseguire il debug dell'app.
Campo | Descrizione |
---|---|
Tipo di debug | Seleziona una delle seguenti opzioni:
È consigliata l'opzione Rileva automaticamente perché sceglie il tipo di debug corretto per il progetto. |
Directory di simboli | Se vuoi aggiungere file di simboli per fornire al debugger informazioni C o C++ generate al di fuori di Android Studio, puoi aggiungere una o più directory qui. Android Studio utilizza preferenzialmente i file all'interno di queste directory rispetto ai file generati dal plug-in di Android per Gradle. Il debugger cerca nelle directory dall'alto verso il basso, in ordine, finché non trova ciò di cui ha bisogno. Cerca in modo ricorsivo i file nella directory. Per ottimizzare l'elenco e risparmiare tempo, posiziona le directory utilizzate più spesso in cima all'elenco. Se specifichi una directory in cima alla struttura, la ricerca in tutte le sottodirectory può richiedere più tempo. Se aggiungi una directory molto specifica, la ricerca richiederà meno tempo. Devi trovare il giusto equilibrio tra velocità e individuazione dei file necessari per il debug. Ad esempio, se hai una directory che contiene sottodirectory di diverse ABI (Binary Interfaces) Android, puoi scegliere di aggiungere una directory per un'ABI specifica o per tutte le ABI. Sebbene la ricerca nella directory di livello superiore richieda più tempo, è anche 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 post-attacco LLDB | Aggiungi i comandi LLDB da 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 di destinazione | 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. Il log viene spesso richiesto per le segnalazioni di bug di Android Studio. Questo valore predefinito è
Puoi modificare l'impostazione predefinita per raccogliere più informazioni. Ad esempio, le seguenti opzioni di log raccolgono informazioni su un elemento 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
In alternativa, se
più utenti accedono a un dispositivo, i log vengono collocati nella seguente posizione,
dove
Per informazioni sull'utilizzo di LLDB per il debug remoto, consulta Debug remoto. |
Prima del lancio | Consulta la sezione 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 automaticamente 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 venga attualmente eseguita una sola istanza della configurazione di esecuzione/debug, seleziona questa opzione. Non consente più esecuzioni contemporaneamente della stessa configurazione. Valore predefinito: selezionato |
Module | Seleziona un modulo a cui applicare questa configurazione. |
Sincronizza con la configurazione build.gradle | Se aggiungi un modulo App Engine ed esegui la sincronizzazione con il file build.gradle , i campi di configurazione DevAppServer di App Engine vengono compilati automaticamente (opzione consigliata).
Anche la selezione di File > Sincronizza progetto con file Gradle sincronizza il progetto. Valore predefinito: selezionato
|
SDK App Engine | Digita un percorso a un SDK di Google App Engine per Java sulla macchina locale. Fai clic su ... per selezionarlo da una finestra di dialogo. |
Sentiero della guerra | Digita un percorso alla directory Web Application Archive (WAR) 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 che vuoi passare alla VM per l'avvio di DevAppServer. Quando specifichi le opzioni:
Per saperne di più sulle opzioni VM, consulta la documentazione relativa alla tua versione J2SE, ad esempio Predefinito: nessuna opzione |
Indirizzo server | Digita l'indirizzo host da utilizzare per il server. Potresti dover fornire l'indirizzo per poter accedere al server di sviluppo da un altro computer sulla rete. L'indirizzo 0.0.0.0 consente sia l'accesso localhost sia l'accesso al nome host. Valore predefinito: localhost |
Porta server | Digita il numero di porta da utilizzare per il server. Valore predefinito: 8080 |
Disabilita la verifica degli aggiornamenti dell'SDK di App Engine | Se fornito, il server di sviluppo non contatterà App Engine per verificare la disponibilità di una nuova release 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 la sezione Definizione delle operazioni prima del lancio. |
Configurazioni di esecuzione/debug di Wear OS
I modelli Complicazione Wear OS, Riquadro e Quadrante orologio consentono di eseguire o eseguire il debug di app Wear OS su dispositivi virtuali o hardware. La maggior parte delle opzioni di configurazione del modello corrisponde alle opzioni per le 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 della complicazione, un riquadro o un quadrante specifico (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 per Wear OS, devi scegliere lo slot in cui vuoi inserire i dati relativi alle 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 per Wear OS, devi selezionare anche il tipo dei dati della complicazione 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 eseguire queste superfici anche dall'icona della grondaia che si trova accanto alla dichiarazione della superficie, come mostrato nell'immagine seguente.