Questa pagina è stata tradotta dall'API Cloud Translation.

Creare e modificare le configurazioni di esecuzione/debug

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.

Figura 1. La finestra di dialogo Esegui/configura configurazioni di 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 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.

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

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

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

Fai clic su Applica o OK.

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.

Figura 2. Salva la configurazione

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.

Figura 3. Salva la configurazione

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.

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

Seleziona Esegui > Esegui o Esegui > Debug.

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.

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

Fai clic su Applica o OK.

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.

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

Fai clic su Applica o OK.

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.

Trascina nella cartella gli elementi della stessa categoria di modelli.

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

Fai clic su OK per chiudere la finestra di dialogo.

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:

App per Android
Test Android
DevAppServer di App Engine
Complicazione Wear OS, riquadro e quadrante

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.

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: APK predefinito: crea ed esegui il deployment di un APK per la variante attualmente selezionata. APK da app bundle: crea ed esegui il deployment della tua app da un Android App Bundle. In altre parole, Android Studio converte prima il progetto dell'app in un app bundle che include tutto il codice compilato e le risorse dell'app. Dopodiché, dall'app bundle, Android Studio genera solo gli APK necessari per eseguire il deployment dell'app sul dispositivo collegato. In genere dovresti usare questa opzione quando testi l'app bundle che intendi caricare su Google Play, perché il deployment da un app bundle aumenta il tempo totale di compilazione. Artefatto personalizzato: non supportato in Android Studio. Niente: non installare un APK su un dispositivo. Ad esempio, se preferisci installare manualmente l'APK, non devi installare Android Studio.
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: `-i foo.bar.baz -r /path/to/apk` e `-d -r` Predefinito: nessuna opzione.
Opzioni di avvio: Avvia	Seleziona un'opzione: Niente: non avviare nulla quando selezioni Esegui o Debug. Tuttavia, se la tua 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 avvio nel 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à nell'app nel modulo. Se selezioni questa opzione, viene visualizzato di seguito il campo Attività, dove puoi digitare il nome dell'attività da avviare o fare clic su Altro per selezionare un'attività da un elenco. URL: lancia un URL che corrisponde a un filtro per intent nel manifest dell'app. Se selezionato, viene visualizzato il campo URL in cui puoi inserire l'URL. Devi compilare questo campo per avviare un'app istantanea per Android. Puoi utilizzarlo anche per testare i tuoi link per app Android.
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: `-W` Questa opzione non viene visualizzata se scegli Avvio come valore Nothing. Predefinito: nessuna opzione.
Opzioni di destinazione del deployment: destinazione	Seleziona un'opzione: Apri la finestra di dialogo Seleziona destinazione del deployment: apri la finestra di dialogo Seleziona target 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 in cui puoi selezionarla. Emulatore: usa un dispositivo virtuale. In una configurazione, puoi selezionare una durata di visualizzazione media, in caso contrario, viene utilizzata solo la prima durata di visualizzazione media dell'elenco.
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: Solo Java: esegui il debug solo del codice Java. Rileva automaticamente: consenti ad Android Studio di scegliere il tipo di debug migliore per il tuo progetto. Solo nativo: esegui il debug del codice C o C++ nativo. Dual (Java + nativo): esegui il debug del codice Java e nativo in due sessioni di debug separate. È 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: `settings set target.max-memory-read-size 2048` 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: `process handle SIGPIPE -n true -p true -s false` 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 è `lldb process:gdb-remote packets` Puoi modificare l'impostazione predefinita per raccogliere più informazioni. Ad esempio, le seguenti opzioni di log raccolgono informazioni su un elemento `platform` specifico: `lldb process platform:gdb-remote packets` Per un elenco completo dei comandi di log, inserisci il comando `log list` da una finestra della shell di LLDB in Android Studio. Android Studio inserisce i log del dispositivo nella seguente posizione, dove `ApplicationId` è l'ID applicazione univoco utilizzato nel file manifest dell'APK creato 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 collocati 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 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: Tutto nel modulo: avvia tutti i test dal modulo selezionato. Tutto nel pacchetto: avvia tutti i test dal pacchetto specificato nel campo Pacchetto. Digita il nome o fai clic su Altro per selezionare il pacchetto da una finestra di dialogo. Class - Avvia i test della classe specificata nel campo Class. 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 Class, specifica la classe che contiene il metodo. Nel campo Method (Metodo), specifica il metodo. Digita il nome o fai clic su Altro per selezionare la classe o il metodo da una finestra di dialogo.
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 `am instrument` ab che vuoi utilizzare. Non digitare il componente. Ad esempio, se utilizzi `AndroidJUnitRunner` dal test AndroidX, puoi usare questo campo per passare opzioni aggiuntive al runner, come `-e size small`. Predefinito:nessuna opzione
Opzioni di destinazione del deployment: destinazione	Seleziona un'opzione: Apri la finestra di dialogo Seleziona destinazione del deployment: apri la finestra di dialogo Seleziona target 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 in cui puoi selezionarla. Emulatore: usa un dispositivo virtuale. In una configurazione, puoi selezionare una durata di visualizzazione media, in caso contrario, viene utilizzata solo la prima durata di visualizzazione media dell'elenco. Matrice di dispositivi di Firebase Test Lab: consulta Eseguire i test con Firebase Test Lab.
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 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: Solo Java: esegui il debug solo del codice Java. Rileva automaticamente: consenti ad Android Studio di scegliere il tipo di debug migliore per il tuo progetto. Solo nativo: esegui il debug del codice C o C++ nativo. Dual (Java + nativo): esegui il debug del codice Java e nativo in due sessioni di debug separate. È 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: `settings set target.max-memory-read-size 2048` 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: `process handle SIGPIPE -n true -p true -s false` 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 è `lldb process:gdb-remote packets` Puoi modificare l'impostazione predefinita per raccogliere più informazioni. Ad esempio, le seguenti opzioni di log raccolgono informazioni su un elemento `platform` specifico: `lldb process platform:gdb-remote packets` Per un elenco completo dei comandi di log, inserisci il comando `log list` da una finestra della shell di LLDB in Android Studio. Android Studio inserisce i log del dispositivo nella seguente posizione, dove `ApplicationId` è l'ID applicazione univoco utilizzato nel file manifest dell'APK creato 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 collocati 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 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: Utilizza gli spazi per separare le diverse opzioni. Per le opzioni che contengono spazi, racchiudi lo spazio tra virgolette (`"` `"`). Se un'opzione include le virgolette, aggiungi una barra rovesciata prima delle virgolette (`\"`). Per saperne di più sulle opzioni VM, consulta la documentazione relativa alla tua versione J2SE, ad esempio `java` JDK 7 e `java` JDK 8. 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.