Creare e modificare le configurazioni di esecuzione/debug

Quando esegui, sottoponi o sottoponi a debug il tuo 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 e modificare i modelli di configurazione in base al tuo processo di sviluppo, come descritto in questa pagina.

Per ulteriori informazioni, consulta anche la seguente documentazione di IntelliJ:

• Configurazioni di esecuzione/debug

Informazioni sulle configurazioni di esecuzione/debug

Le configurazioni di esecuzione/debug specificano dettagli come opzioni di installazione, lancio e test dell'app. Puoi definire una configurazione per un utilizzo una tantum 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 all'interno del progetto.

Configurazione di esecuzione/debug creata inizialmente

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 per Android. Per eseguire o eseguire il debug del progetto, devi sempre avere 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 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 di esecuzione/debug

Per aprire la finestra di dialogo Configurazioni di esecuzione/debug, seleziona Esegui > Modifica configurazioni. Viene visualizzata la finestra di dialogo Configurazioni di esecuzione/debug, come mostrato nella figura 1.

Figura 1. La finestra di dialogo Configurazioni di 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:

• Creare nuove configurazioni di esecuzione/debug.
• Modifica le configurazioni di esecuzione/debug.
• Modifica i modelli di configurazione.
• Configurazioni di ordinamento e raggruppamento.

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 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 di app per Android, test di strumenti 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, quindi eseguirla.

Quando crei una configurazione al di fuori della finestra di dialogo Esegui/Esegui il debug delle configurazioni, la configurazione è temporanea, a meno che tu non la salvi. Per impostazione predefinita, puoi avere fino a cinque configurazioni temporanee nel progetto prima che Android Studio inizi a rimuoverle. Per modificare questo valore predefinito, apri le impostazioni di Android Studio e modifica Impostazioni avanzate > Esegui/Debug > Limite di configurazioni temporanee. Per ulteriori informazioni sulle configurazioni temporanee, consulta Creare e salvare configurazioni di esecuzione/debug temporanee.

Avviare una configurazione basata su un modello

Per definire una configurazione di esecuzione/debug basata su un modello:

1. Apri la finestra di dialogo Esegui/Debug Configurazioni.
2. Fai clic su Aggiungi nuova configurazione .
3. Seleziona un modello di configurazione.
4. Digita un nome nel campo Nome.
5. Modifica la configurazione in base alle tue esigenze.

Assicurati di correggere eventuali errori visualizzati nella parte inferiore della finestra di dialogo.

6. Fai clic su Applica o OK.

Avviare una configurazione da una copia

Per definire una configurazione di esecuzione/debug a partire da una copia di un'altra configurazione:

1. Apri la finestra di dialogo Configurazioni di esecuzione/debug.
2. Seleziona una configurazione di esecuzione/debug esistente nel riquadro a sinistra.
3. Fai clic su Copia configurazione .
4. Digita un nome nel campo Nome.
5. Modifica la configurazione in base alle esigenze.

Assicurati di correggere eventuali errori visualizzati nella parte inferiore della finestra di dialogo.

6. Fai clic su Applica o OK.

Definire 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 dell'attività: il modello App per Android.
• Pacchetto: modello Test di automazione Android o Android JUnit, a seconda del set di origine. Se selezioni un test instrumentato, viene utilizzato il modello Android Instrumented Tests. Se selezioni un test unitario locale, 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:

1. Apri un progetto in Android o nella visualizzazione Progetto.
2. Nella finestra Progetto, fai clic con il tasto destro del mouse su un elemento verificabile e seleziona Esegui filename o Esegui il debug filename. Android Studio crea una configurazione di esecuzione/debug temporanea e avvia l'app.
3. Apri l'elenco a discesa Seleziona configurazione di esecuzione/debug nella barra degli strumenti.
4. Seleziona Salva configurazione dalle opzioni accanto alla configurazione che vuoi salvare.
   

   Figura 2. Salvare 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.

Definire una configurazione di test per una classe o un metodo

Android Studio ti consente di definire una configurazione di esecuzione del test per una classe o un metodo, quindi di eseguirla. Ad esempio, se crei un nuovo corso, puoi creare e eseguire un test. 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 qualche altra parte.

Android Studio utilizza il modello Test di automazione Android o Android JUnit, a seconda del set di origine. Per un test unitario locale, puoi eseguire facoltativamente il test con la copertura del codice.

Per creare una configurazione di esecuzione/debug per una classe o un metodo nel codice Java:

1. Apri un progetto in Android o nella visualizzazione Progetto.
2. Apri un file Java nell'editor di codice.
3. Seleziona una classe o un metodo nel codice, quindi premi Ctrl+Maiusc+T (Comando+Maiusc+T).
4. Seleziona Crea nuovo test dal menu visualizzato.
5. Nella finestra di dialogo Crea test, facoltativamente, modifica o imposta i valori e fai clic su OK.
6. Nella finestra di dialogo Scegli la directory di destinazione, seleziona la posizione nel progetto in cui vuoi che Android Studio inserisca il test. Puoi specificare la località in base alla struttura della directory o selezionando una classe vicina.
7. Fai clic su OK.

   Il nuovo test viene visualizzato nella finestra Progetto nell'insieme di origini test corrispondente.

8. Per eseguire il test, procedi in uno dei seguenti modi:
   • 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 Esegui il debug per testare tutti i metodi della classe.
9. Apri l'elenco a discesa Seleziona configurazione di esecuzione/debug nella barra degli strumenti.
10. 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:

1. Seleziona la configurazione di esecuzione/debug dall'elenco a discesa Seleziona configurazione di esecuzione/debug nella barra degli strumenti.

L'elenco a discesa si trova a sinistra di Esegui e Debug ; ad esempio .

2. Seleziona Esegui > Esegui o Esegui > Debug.

In alternativa, fai clic su Esegui o su Debug .

Modificare una configurazione di esecuzione/debug

Per modificare una configurazione di esecuzione/debug:

1. Apri la finestra di dialogo Configurazioni di esecuzione/debug.
2. Seleziona una configurazione nel riquadro a sinistra.
3. Modifica la configurazione in base alle tue esigenze.

Assicurati di correggere eventuali errori visualizzati nella parte inferiore della finestra di dialogo.

4. Fai clic su Applica o OK.

Modificare 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:

1. Apri la finestra di dialogo Esegui/Debug Configurazioni.
2. Fai clic su Modifica modelli di configurazione....
3. Seleziona un modello di configurazione.
4. Modifica la configurazione in base alle esigenze.

Assicurati di correggere eventuali errori visualizzati nella parte inferiore della finestra di dialogo.

5. Fai clic su Applica o OK.

Ordina e raggruppa le configurazioni

Nella finestra di dialogo Configurazioni esegui/Debug, puoi ordinare le configurazioni in modo da trovarle rapidamente. Puoi ordinare gli elementi della cartella in ordine alfabetico e creare nuove cartelle per raggruppare le configurazioni.

Per ordinare le configurazioni in ordine alfabetico:

1. Apri la finestra di dialogo Configurazioni di esecuzione/debug.
2. Seleziona una cartella contenente le configurazioni.
3. Fai clic su Ordina configurazioni .
4. Fai clic su OK per chiudere la finestra di dialogo.

Per raggruppare le configurazioni in cartelle:

1. Apri la finestra di dialogo Configurazioni di esecuzione/debug.
2. Seleziona una cartella contenente le configurazioni.
3. Fai clic su Crea nuova cartella .
4. Digita un nome nel campo Nome cartella.
5. Fai clic su Applica per salvare il nome.

Trascina gli elementi della stessa categoria di modelli nella cartella.

Ordina le cartelle e le configurazioni nella stessa categoria di modelli trascinandole in posizione.

Fai clic su OK per chiudere la finestra di dialogo.

Definisci le operazioni pre-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 che vengano eseguite durante la compilazione dalla riga di comando.

Per creare un elenco di attività:

1. 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.
2. Aggiungi altre attività in base alle esigenze.
3. Per ordinare le attività, trascinale o selezionane una e fai clic su Su e Giù per spostarla verso l'alto o verso il basso nell'elenco.
4. Seleziona Mostra questa pagina se vuoi visualizzare le impostazioni di configurazione di esecuzione/debug prima di applicarle.

   Questa opzione è deselezionata per impostazione predefinita.

5. 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:

1. Seleziona un'attività.
2. Fai clic su Rimuovi .

Per modificare un'attività:

1. Seleziona un'attività.
2. Fai clic su Modifica .
3. 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	Esegui 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, aggiungi la relativa 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 configurazione da eseguire, seleziona una configurazione da eseguire e poi fai clic su OK.
Marca	Compila il progetto o il modulo. Android Studio esegue il comando MakeModule se la configurazione di esecuzione/debug specifica un determinato modulo oppure il comando MakeProject se non sono specificati moduli.
Crea progetto	Compila il progetto. Android Studio esegue il comando MakeProject.
Make, nessun controllo degli errori	Questa opzione è la stessa di Make, tranne per il fatto che Android Studio esegue la configurazione di esecuzione/debug indipendentemente dal risultato della compilazione.
Artefatti build	Non supportato 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.
Make consapevole di Gradle	Compila il progetto ed esegui Gradle.
App Engine Gradle Builder	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 è presente nelle versioni più recenti. Se hai un modello di applicazione nativa in un progetto, Android Studio lo converte in app per Android quando carichi il progetto. Una 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 per lo sviluppo Android con Android Studio. Per informazioni sull'uso di questi modelli, segui i link alla documentazione di IntelliJ IDEA.

• Applicazione
• Complesso
• Gradle
• Groovy
• Applicata JAR
• Java Scratch
• JUnit
• Kotlin
• Script Kotlin
• Debug remoto
• Script shell
• TestNG

Opzioni di configurazione comuni

Le opzioni Nome, Consenti esecuzione in parallelo e Salva come file di progetto sono comuni a più modelli di configurazione. Per saperne di più, vedi Impostazioni comuni.

Android Studio memorizza la configurazione di esecuzione/debug condivisa in singoli file XML nella cartella project_directory/.idea/runConfigurations/. Per saperne di più, consulta Formato basato su directory nella documentazione dei progetti IntelliJ.

App 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 Generali, puoi specificare le opzioni di installazione, lancio e deployment. La scheda Varie contiene anche le opzioni di installazione.

Campo	Descrizione
Modulo	Seleziona un modulo a cui applicare questa configurazione.
Opzioni di installazione: esegui il deployment	Seleziona un'opzione: APK predefinito: crea e implementa un APK per la variante attualmente selezionata. APK da app bundle. Crea e implementa l'app da un Android App Bundle. In altre parole, Android Studio converte innanzitutto il progetto dell'app in un app bundle che include tutto il codice compilato dell'app e le risorse. Da questo app bundle, Android Studio genera solo gli APK necessari per eseguire il deployment dell'app sul dispositivo connesso. In genere, devi utilizzare questa opzione quando testi l'app bundle che intendi caricare su Google Play, perché il deployment da un app bundle prolunga il tempo di compilazione totale. Elemento personalizzato: non supportato in Android Studio. Niente: non installare un APK su un dispositivo. Ad esempio, se preferisci installare manualmente l'APK, non hai bisogno di Android Studio per installarlo.
Opzioni di installazione: 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à da implementare	Se la tua app include moduli delle funzionalità, seleziona la casella accanto a ogni funzionalità che vuoi includere durante 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 dei moduli di 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 Caricare l'app bundle in Play Console.
Opzioni di installazione: flag di installazione	Digita le opzioni adb pm install che vuoi utilizzare. Formatta le opzioni come faresti nella riga di comando, ma senza un percorso. Ecco alcuni esempi: -i foo.bar.baz -r /path/to/apk e -d -r Valore predefinito: nessuna opzione.
Opzioni di lancio: Avvia	Seleziona un'opzione: Niente: non avviare nulla quando selezioni Esegui o Debug. Tuttavia, se l'app è già in esecuzione e selezioni Debug, Android Studio collega il debugger al processo dell'app. Attività predefinita: avvia l'attività che hai contrassegnato come iniziale nel file manifest. Ad esempio: <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> Attività specificata: avvia una determinata attività dell'app nel modulo. Se selezioni questa opzione, viene visualizzato il campo Attività, in cui puoi digitare il nome dell'attività che vuoi avviare oppure fare clic su Altro per selezionare un'attività da un elenco. URL: lancia un URL che corrisponde a un filtro per intent nel file manifest dell'app. Se lo selezioni, viene visualizzato il campo URL in cui puoi inserire l'URL. Devi compilare questo campo per avviare un'app istantanea Android. Puoi utilizzarla anche per testare i link per app Android.
Opzioni di lancio: segnalazioni di lancio	Digita le opzioni adb am start che vuoi utilizzare. Formatta le opzioni come faresti sulla riga di comando, ma senza un'intenzione. Ad esempio: -W Questa opzione non viene visualizzata se hai scelto un valore Avvio di Niente. Valore predefinito: nessuna opzione.
Opzioni di destinazione dell'implementazione: target	Seleziona un'opzione: Apri la finestra di dialogo Seleziona destinazione di deployment: apri la finestra di dialogo Seleziona destinazione di deployment per selezionare un dispositivo virtuale o hardware. Dispositivo USB: utilizza un dispositivo hardware collegato al computer di sviluppo tramite una porta USB. Se sono presenti più opzioni, viene visualizzata una finestra di dialogo che ti consente di selezionarne una. Emulatore: utilizza un dispositivo virtuale. In una configurazione, puoi selezionare un AVD; in caso contrario, viene utilizzato solo il primo AVD nell'elenco.
Opzioni di destinazione di implementazione: utilizza lo stesso dispositivo per i lanci futuri	Per impostazione predefinita, questa opzione non è selezionata, quindi ogni volta che esegui un'app viene visualizzata la finestra di dialogo Seleziona deployment per consentirti di 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 si avvia sul dispositivo selezionato senza visualizzare la finestra di dialogo Seleziona il deployment. Per eseguire l'app su un altro dispositivo, deseleziona Usa lo stesso dispositivo per i lanci futuri o interrompi l'app con Esegui > Interrompi app o Interrompi , quindi riavviala. Viene visualizzata la finestra di dialogo Seleziona deployment in cui puoi selezionare un dispositivo.
Prima del lancio	Consulta Definire le operazioni prima del lancio.

Scheda Varie

Nella scheda Varie, puoi specificare le opzioni di logcat, installazione, avvio e deployment. La scheda Generale contiene anche le opzioni di installazione.

Campo	Descrizione
Logcat: mostra automaticamente Logcat	Quando questa opzione è selezionata, la finestra Logcat si apre ogni volta che esegui il deployment e avvii un'app utilizzando questa configurazione. Valore predefinito: selezionato.
Logcat: cancella il log prima del lancio	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. Valore predefinito: selezionato
Opzioni di installazione: Forza l'interruzione dell'esecuzione dell'applicazione prima di avviare l'attività	Se selezionata, quando Android Studio rileva che non deve reinstallare un APK perché non è cambiato, arresta forzatamente l'app in modo che venga avviata dall'attività di avvio predefinita. Se questa opzione non è selezionata, Android Studio non arresta forzatamente l'app. Questa opzione è compatibile 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 di metodo di inserimento (IME), l'interruzione forzata dell'app ne comporta la deselezionazione come tastiera corrente, cosa che potresti non volere. Valore predefinito: selezionato
Prima del lancio	Consulta Definire le operazioni precedenti al 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 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-aggancio 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 e poi fai clic su questo pulsante per spostare l'elemento verso il basso nell'elenco.

Per ulteriori informazioni sul debug in Android Studio, consulta Eseguire il debug della app.

Campo	Descrizione
Tipo di debug	Seleziona una delle seguenti opzioni: Solo Java: esegui il debug solo del codice Java. Rileva automaticamente: lascia che sia Android Studio a scegliere il tipo di debug migliore per il tuo progetto. Solo nativo: esegui il debug del codice C o C++ nativo. Doppia (Java + nativo): esegui il debug del codice Java e nativo in due sessioni di debug distinte. L'opzione Rileva automaticamente è consigliata 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 Android per Gradle. Il debugger cerca le directory dall'alto verso il basso, in ordine, finché non trova ciò che gli serve. Cerca in modo ricorsivo tra i file della directory. Per ottimizzare l'elenco e risparmiare tempo, posiziona le directory utilizzate più di frequente nella parte superiore dell'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 richiede 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 diversi Android Binary Interfaces (ABI), puoi scegliere di aggiungere una directory per un ABI specifico o per tutti gli ABI. Anche se la ricerca nella directory di primo livello può richiedere più tempo, è anche più sicura se decidi di eseguire il debug su un altro dispositivo. Tieni presente che non è necessario aggiungere directory contenenti file di simboli Gradle perché il debugger li utilizza automaticamente.
Comandi di avvio LLDB	Aggiungi i comandi LLDB che vuoi eseguire prima che il debugger si colleghi al processo. Ad esempio, puoi definire le impostazioni per l'ambiente, come mostrato nel seguente comando: settings set target.max-memory-read-size 2048 LLDB esegue i comandi in ordine dall'alto verso il basso.
Comandi post-collegamento LLDB	Aggiungi i comandi LLDB che vuoi eseguire subito dopo che il debugger si è collegato al processo. Ad esempio: process handle SIGPIPE -n true -p true -s false LLDB esegue i comandi in ordine dall'alto verso il basso.
Directory di lavoro dell'host	Specifica la directory di lavoro LLDB.
Log: 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 risolvere i problemi. Questo log viene spesso richiesto per le segnalazioni di bug di Android Studio. L'impostazione predefinita è lldb process:gdb-remote packets Puoi modificare il valore predefinito per raccogliere ulteriori informazioni. Ad esempio, le seguenti opzioni di log raccolgono informazioni su un determinatoplatform: lldb process platform:gdb-remote packets Per un elenco completo dei comandi di log, inserisci il comando log list da una finestra della shell LLDB in Android Studio. Android Studio posiziona i log del dispositivo nella seguente posizione, dove ApplicationId è l'ID applicazione univoco utilizzato nel file manifest dell'APK compilato e identifica la tua app sul dispositivo e nel Google Play Store: /data/data/ApplicationId/lldb/log In alternativa, se più utenti accedono a un dispositivo, i log vengono posizionati nella seguente posizione, dove AndroidUserId è un identificatore univoco per un utente sul dispositivo: /data/user/AndroidUserId/ApplicationId/lldb/log Per informazioni sull'utilizzo di LLDB per il debug remoto, consulta 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 set di origine. Il modello di test instrumentati Android è destinato a un test instrumentato. Il modello di JUnit per Android serve per il test delle unità locali.

Nota:se utilizzi Firebase Test Lab per eseguire test su vari dispositivi, puoi utilizzare il modello JUnit per Android per definire i test con strumenti. Per ulteriori informazioni, consulta Eseguire i test con Firebase Test Lab.

Le descrizioni delle schede riportate di seguito riguardano le schede e i campi del modello di test instrumentato Android. Per informazioni sulle schede e sui campi del modello di test JUnit per Android, consulta la pagina Configurazione di IntelliJ per l'esecuzione/il debug: JUnit.

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
Modulo	Seleziona un modulo a cui applicare questa configurazione.
Test	In questa area, specifica la posizione dei test che vuoi eseguire: Tutti nel modulo: avvia tutti i test dal modulo selezionato. Tutti nel pacchetto: avvia tutti i test dal pacchetto specificato nel pacchetto. Digita il nome o fai clic su Altro per selezionare il pacchetto da una finestra di dialogo. Corso: avvia i test del corso specificato nel campo Corso. Digita il nome o fai clic su Altro per selezionare il corso da una finestra di dialogo. Metodo: avvia un metodo di test. Nel campo Classe, specifica la classe che contiene il metodo. Nel campo Metodo, specifica il metodo. Digita il nome o fai clic su Altro per selezionare la classe o il metodo da una finestra di dialogo.
(Facoltativo) Programma di esecuzione dell'instrumentazione specifico	Digita la posizione del compilatore dell'instrumentazione; fai clic su Altro per utilizzare una finestra di dialogo. Il file build.gradle specifica la posizione del programma di esecuzione dell'instrumentazione; questo valore la sostituisce. Il valore predefinito è in genere la classe AndroidJUnitRunner di AndroidX Test.
Opzioni extra	Digita le opzioni adb am instrument che vuoi utilizzare. Non digitare il componente. Ad esempio, se utilizzi AndroidJUnitRunner di AndroidX Test, puoi utilizzare questo campo per passare opzioni aggiuntive al runner, ad esempio -e size small. Predefinito:nessuna opzione
Opzioni di destinazione di deployment: Destinazione	Seleziona un'opzione: Apri la finestra di dialogo Seleziona destinazione di deployment: apri la finestra di dialogo Seleziona destinazione di deployment per selezionare un dispositivo virtuale o hardware. Dispositivo USB: utilizza un dispositivo hardware collegato al computer di sviluppo tramite una porta USB. Se sono presenti più opzioni, viene visualizzata una finestra di dialogo che ti consente di selezionarne una. Emulatore: utilizza un dispositivo virtuale. In una configurazione, puoi selezionare un AVD; in caso contrario, viene utilizzato solo il primo AVD nell'elenco. Matrice dei dispositivi Firebase Test Lab: consulta Eseguire i test con Firebase Test Lab.
Opzioni di destinazione dell'implementazione: utilizza lo stesso dispositivo per lanci futuri	Se in futuro vuoi utilizzare automaticamente il dispositivo che hai scelto tramite la finestra di dialogo Seleziona destinazione di 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 Varie contiene le opzioni di logcat e di installazione.

Campo	Descrizione
Logcat: cancella il log prima del lancio	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 questa opzione è selezionata, Android Studio non esegue il redeployment dell'APK se rileva che non è cambiato. Se vuoi che Android Studio forzi un'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 selezionata, quando Android Studio rileva che non deve reinstallare un APK perché non è cambiato, arresta forzatamente l'app in modo che venga avviata dall'attività di avvio predefinita. Se questa opzione non è selezionata, Android Studio non arresta forzatamente l'app. Questa opzione funziona in combinazione con l'opzione precedente che controlla se un APK è installato o meno. Per entrambi i campi Opzioni di installazione, mantieni l'impostazione predefinita, a meno che tu non voglia forzare esplicitamente un'installazione ogni volta. In alcuni casi, potresti voler deselezionare questa opzione. Ad esempio, se stai scrivendo un motore di metodo di inserimento (IME), l'interruzione forzata dell'app ne comporta la deselezionazione come tastiera corrente, cosa che potresti non volere. Valore predefinito: selezionato
Prima del lancio	Consulta Definire le 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 UI di Android Studio, la finestra del debugger ha 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-aggancio 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.

Per ulteriori informazioni sul debug in Android Studio, vedi Debug dell'app.

Campo	Descrizione
Tipo di debug	Seleziona una delle seguenti opzioni: Solo Java: esegui il debug solo del codice Java. Rileva automaticamente: lascia che sia Android Studio a scegliere il tipo di debug migliore per il tuo progetto. Solo nativo: esegui il debug del codice C o C++ nativo. Doppia (Java + nativo): esegui il debug del codice Java e nativo in due sessioni di debug distinte. L'opzione Rileva automaticamente è consigliata 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 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ò che gli serve. Cerca in modo ricorsivo tra i file della directory. Per ottimizzare l'elenco e risparmiare tempo, posiziona le directory utilizzate più di frequente nella parte superiore dell'elenco. Se specifichi una directory in alto nell'albero, la ricerca di tutte le sottodirectory può richiedere più tempo. Se aggiungi una directory molto specifica, la ricerca richiede 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 diversi Android Binary Interfaces (ABI), puoi scegliere di aggiungere una directory per un ABI specifico o per tutti gli ABI. Anche se la ricerca nella directory di primo livello può richiedere più tempo, è anche più sicura se decidi di eseguire il debug su un altro dispositivo. Tieni presente che non è necessario aggiungere directory contenenti file di simboli Gradle perché il debugger li utilizza automaticamente.
Comandi di avvio LLDB	Aggiungi i comandi LLDB che vuoi eseguire prima che il debugger si colleghi al processo. Ad esempio, puoi definire le impostazioni per l'ambiente, come mostrato nel seguente comando: settings set target.max-memory-read-size 2048 LLDB esegue i comandi in ordine dall'alto verso il basso.
Comandi post-collegamento LLDB	Aggiungi i comandi LLDB che vuoi eseguire subito dopo che il debugger si è collegato al processo. Ad esempio: process handle SIGPIPE -n true -p true -s false LLDB esegue i comandi in ordine dall'alto verso il basso.
Directory di lavoro dell'host	Specifica la directory di lavoro LLDB.
Log: 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 risolvere i problemi. Questo log viene spesso richiesto per le segnalazioni di bug di Android Studio. L'impostazione predefinita è lldb process:gdb-remote packets Puoi modificare il valore predefinito per raccogliere ulteriori informazioni. Ad esempio, le seguenti opzioni di log raccolgono informazioni su un determinatoplatform: lldb process platform:gdb-remote packets Per un elenco completo dei comandi di log, inserisci il comando log list da una finestra della shell LLDB in Android Studio. Android Studio posiziona i log del dispositivo nella seguente posizione, dove ApplicationId è l'ID applicazione univoco utilizzato nel file manifest dell'APK compilato e identifica la tua app sul dispositivo e nel Google Play Store: /data/data/ApplicationId/lldb/log In alternativa, se più utenti accedono a un dispositivo, i log vengono posizionati nella seguente posizione, dove AndroidUserId è un identificatore univoco per un utente sul dispositivo: /data/user/AndroidUserId/ApplicationId/lldb/log Per informazioni sull'utilizzo di LLDB per il debug remoto, consulta Debug remoto.
Prima del lancio	Consulta Definire le 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 IntelliJ IDEA è un modello diverso non disponibile in Android Studio.

Campo	Descrizione
Solo istanza singola	Se vuoi assicurarti che al momento sia in esecuzione una sola istanza della configurazione di esecuzione/debug, seleziona questa opzione. Non consente più esecuzioni contemporaneamente della stessa configurazione. Valore predefinito: selezionato
Modulo	Seleziona un modulo a cui applicare questa configurazione.
Sincronizzare 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). Puoi sincronizzare il progetto anche selezionando File > Sincronizza progetto con i file Gradle. Valore predefinito: selezionato
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.
War Path	Digita il percorso della directory dell'archivio dell'applicazione web (WAR) dell'app di cui stai eseguendo il deployment sul server di sviluppo locale. Fai clic su … per selezionarlo da una finestra di dialogo.
VM Args	Specifica le opzioni della riga di comando da passare alla VM per avviare DevAppServer. Quando specifichi le opzioni: Utilizza gli spazi per separare le diverse opzioni. Per le opzioni che contengono spazi, racchiudi lo spazio tra virgolette (" "). Se un'opzione include virgolette, aggiungi una barra rovesciata prima della virgola. (\"). Per ulteriori informazioni sulle opzioni di VM, consulta la documentazione relativa alla versione J2SE, ad esempio java JDK 7 e java JDK 8. Predefinito: nessuna opzione
Indirizzo del server	Digita l'indirizzo dell'host da utilizzare per il server. Potresti dover fornire l'indirizzo per poter accedere al server di sviluppo da un altro computer della tua rete. Un indirizzo di 0.0.0.0 consente sia l'accesso a 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
Disattivare la ricerca di aggiornamenti dell'SDK 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 cerca una nuova versione all'avvio e stampa un messaggio se è disponibile.
Prima del lancio	Consulta Definire le 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 del modello è uguale a quelle delle 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, un riquadro o un quadrante con complicazioni 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 della complicazione Wear OS, devi scegliere lo slot in cui inserire i dati della complicazione forniti dall'origine dati della complicazione. Puoi scegliere di posizionarla in alto, a destra, in basso, a sinistra o sullo sfondo del quadrante.
• Per la configurazione di esecuzione/debug della complicazione Wear OS, devi anche selezionare il Tipo dei dati della complicazione forniti dall'origine dati della complicazione. 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 delle complicazioni, consulta Tipi e campi.

In alternativa, puoi eseguire queste piattaforme anche dall'icona della canalina accanto alla dichiarazione della piattaforma, come mostrato nell'immagine seguente.