Questa pagina è stata tradotta dall'API Cloud Translation.

Creare e modificare le configurazioni di esecuzione/debug

Quando esegui, sottoponi a debug o verifichi il tuo codice, Android Studio utilizza una configurazione di esecuzione/debug per determinare come eseguire l'operazione. In genere, la configurazione iniziale è sufficiente per eseguire o eseguire il debug di un'app. Tuttavia, puoi modificare e creare nuove configurazioni, nonché modificare i modelli di configurazione in base al processo di sviluppo, come descritto in questa pagina.

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

Configurazioni di esecuzione/debug

Informazioni sulle configurazioni di esecuzione/debug

Le configurazioni di esecuzione/debug specificano dettagli come le opzioni di installazione, avvio e test dell'app. Puoi definire una configurazione da usare una volta sola o salvarla per un uso futuro. Dopo averla salvata, puoi selezionare la configurazione dall'elenco a discesa Seleziona configurazione esecuzione/debug nella barra degli strumenti. Android Studio salva le configurazioni come parte del progetto.

Configurazione di esecuzione/debug inizialmente creata

Quando crei un progetto per la prima volta, Android Studio crea una configurazione di esecuzione/debug per l'attività principale in base al modello di app Android. Per eseguire o eseguire il debug del progetto, devi sempre avere almeno una configurazione di esecuzione/debug definita. Per questo motivo, ti consigliamo di non eliminare la configurazione creata inizialmente.

Ambito del progetto e controllo della versione

Le configurazioni di esecuzione/debug e le modifiche ai modelli si applicano solo al progetto attuale. Puoi condividere una configurazione di esecuzione/debug (ma non un modello) tramite il tuo sistema di controllo della versione. Per saperne di più su come condividere una configurazione, vedi Opzioni di nome e condivisione di configurazione.

Apri la finestra di dialogo Configurazioni Esegui/Debug

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

Figura 1. La finestra di dialogo Configurazioni esecuzione/debug

Il riquadro a sinistra della finestra di dialogo raggruppa le configurazioni definite per tipo di modello e consente di modificare i modelli di configurazione in basso. Puoi modificare la configurazione selezionata nel riquadro a destra. Ridimensiona la finestra di dialogo per visualizzare gli elementi nascosti.

In questa finestra di dialogo puoi:

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

Crea una nuova configurazione di esecuzione/debug

Puoi definire nuove configurazioni di esecuzione/debug dalla finestra di dialogo Configurazioni esecuzione/Debug, dalla finestra Progetto o dall'editor di codice. La nuova configurazione deve essere basata su un modello di configurazione.

La finestra di dialogo Configurazioni esecuzione/debug mostra le configurazioni di esecuzione/debug e i modelli di configurazione disponibili. Puoi avviare una nuova configurazione direttamente da un modello o da una copia di un'altra configurazione. Puoi quindi modificare i valori dei campi in base alle tue esigenze.

In alternativa, puoi fare clic con il tasto destro del mouse su un elemento nella finestra Progetto per creare automaticamente una configurazione specifica per quell'elemento. Ad esempio, se vuoi eseguire una determinata attività, puoi fare clic con il tasto destro del mouse sul file Java dell'attività e selezionare Esegui. A seconda dell'elemento, Android Studio utilizza un modello di configurazione per App Android, Android Instrumented Tests o JUnit per creare la configurazione.

Nell'editor di codice, puoi facilmente creare una configurazione di test ed esecuzione/debug per una classe o un metodo, quindi eseguirla.

Quando crei una configurazione all'esterno della finestra di dialogo Configurazioni Esegui/Debug, è temporanea, a meno che non la salvi. Per impostazione predefinita, puoi avere fino a cinque configurazioni temporanee nel progetto prima che Android Studio inizi a rimuoverle. Per modificare questa impostazione predefinita, apri le impostazioni di Android Studio e modifica Impostazioni avanzate > Esegui/Debug > Limite configurazioni temporaneo. Per ulteriori informazioni sulle configurazioni temporanee, consulta Creazione e salvataggio di configurazioni di esecuzione/debug temporanee.

Avvia una configurazione basata su un modello

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

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

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

Fai clic su Applica o OK.

Avvia una configurazione da una copia

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

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

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 del progetto

Android Studio può creare una configurazione di esecuzione/debug per alcuni elementi visualizzati nella finestra Progetto. La configurazione si basa su un modello di configurazione, come segue:

File Java di attività: il modello per app per Android.
Pacchetto: Android Instrumented Tests o modello Android JUnit, a seconda del set di origini. Se selezioni un test instrumentato, viene utilizzato il modello Android Instrumented Tests. Se selezioni un test delle unità locali, viene utilizzato il modello JUnit per Android. Per un test delle unità locali, puoi eseguire la copertura del codice. Per ulteriori informazioni, consulta Copertura del codice.

Per creare una configurazione di esecuzione/debug per un elemento del progetto:

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

Figura 2. Salva la configurazione

Nota: se fai clic con il tasto destro del mouse ed esegui o esegui il debug dello stesso elemento (ma non di un'attività), Android Studio crea una nuova configurazione.

Definisci una configurazione di test per una classe o un metodo

Android Studio ti consente di definire una configurazione dell'esecuzione di test per una classe o un metodo e quindi di eseguirla. Ad esempio, se crei un nuovo corso, puoi creare ed eseguire un test per il corso. Se il test ha esito positivo, puoi eseguire i test per il resto del progetto per assicurarti che il nuovo codice non rompa nulla da nessun'altra parte.

Android Studio utilizza il modello Android Instrumented Tests o Android JUnit a seconda del set di sorgenti. Per un test delle unità locali, puoi facoltativamente eseguirlo con la copertura del codice.

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

Apri un progetto nella vista Android o Progetto.
Apri un file Java nell'editor di codice.
Seleziona una classe o un metodo nel codice, quindi premi Ctrl+Maiusc+T (Comando+Maiusc+T).
Seleziona Crea nuovo test dal menu visualizzato.
Nella finestra di dialogo Crea test, facoltativamente, modifica o imposta i valori e fai clic su OK.
Nella finestra di dialogo Scegli directory di destinazione, seleziona la posizione del progetto in cui vuoi che Android Studio esegua il test. Puoi specificare la località in base alla struttura della directory o selezionando una classe vicina.
Fai clic su Ok.
Il nuovo test viene visualizzato nella finestra Progetto nel set di origini del test corrispondente.
Per eseguire il test, effettua una delle seguenti operazioni:
- Nella finestra Progetto, fai clic con il tasto destro del mouse sul test e seleziona Esegui o Debug.
- Nell'editor di codice, fai clic con il tasto destro del mouse sulla definizione di una classe o sul nome di un metodo nel file di test e seleziona Esegui o Debug per testare tutti i metodi della classe.
Apri l'elenco a discesa Seleziona configurazione esecuzione/debug nella barra degli strumenti.
Seleziona Save Configuration (Salva configurazione) dalle opzioni accanto alla configurazione che vuoi salvare.

Figura 3. Salva la configurazione

Eseguire o eseguire il debug di un'app utilizzando una configurazione salvata

Se hai salvato una configurazione di esecuzione/debug, puoi selezionarla prima di eseguire o eseguire il debug dell'app.

Per utilizzare una configurazione di esecuzione/debug salvata:

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

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:

Apri la finestra di dialogo Esegui/Debug Configurazioni.
Seleziona una configurazione nel riquadro a sinistra.
Modifica la configurazione in base alle tue esigenze.

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 per adattarli al tuo processo di sviluppo. La modifica di un modello non influisce sulle configurazioni esistenti che lo utilizzano. Quindi, ad esempio, se devi creare una serie di configurazioni di un certo tipo, puoi modificare il modello e ripristinarlo di nuovo al termine dell'operazione.

Anche se non puoi creare nuovi modelli, puoi creare configurazioni da utilizzare in modo simile a un modello. Puoi copiare una configurazione e modificarla per creare nuove configurazioni.

Per modificare un modello, procedi nel seguente modo:

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

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 Configurazioni esecuzione/debug, puoi ordinare le configurazioni per trovarle rapidamente. Puoi ordinare gli elementi nella cartella in ordine alfabetico e creare nuove cartelle per raggruppare le configurazioni.

Per ordinare le configurazioni in ordine alfabetico:

Apri la finestra di dialogo Esegui/Debug Configurazioni.
Seleziona una cartella che contiene configurazioni.
Fai clic su Configurazioni di ordinamento .
Fai clic su OK per chiudere la finestra di dialogo.

Per raggruppare le configurazioni in cartelle:

Apri la finestra di dialogo Esegui/Debug Configurazioni.
Seleziona una cartella che contiene configurazioni.
Fai clic su Crea nuova cartella .
Digita un nome nel campo Nome cartella.
Fai clic su Applica per salvare il nome.

Trascina nella cartella gli elementi della stessa categoria di modello.

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 prima del lancio

Puoi specificare le attività da eseguire prima di applicare la configurazione di esecuzione/debug. Le attività vengono eseguite nell'ordine in cui appaiono nell'elenco.

Nota: la definizione delle attività prima del lancio è una funzionalità avanzata. Anziché utilizzare questa funzionalità, ti consigliamo di inserire qualsiasi logica di preparazione come attività nel file build.gradle, in modo da eseguirle durante la creazione dalla riga di comando.

Per creare un elenco di attività:

Nella parte inferiore della finestra di dialogo Configurazioni esecuzione/debug in Prima del lancio (potrebbe essere necessario scorrere verso il basso), fai clic su Aggiungi e seleziona un tipo di attività. Se si apre una finestra di dialogo, compila i campi e fai clic su OK.
Aggiungi altre attività in base alle esigenze.
Per ordinare le attività, trascinale o selezionane una e fai clic su Su e Giù per spostarla in alto o in basso nell'elenco.
Seleziona Mostra questa pagina se vuoi visualizzare le impostazioni di configurazione di esecuzione/debug prima di applicarle.
Questa opzione è deselezionata per impostazione predefinita.
Seleziona Finestra degli strumenti attivi se vuoi che la finestra dello strumento Esegui o Debug venga attivata quando esegui o esegui il debug della tua app.
Questa opzione è selezionata per impostazione predefinita.

Per rimuovere un'attività dall'elenco:

Seleziona un'attività.
Fai clic su Rimuovi .

Per modificare un'attività:

Seleziona un'attività.
Fai clic su Modifica .
Modifica le impostazioni dell'attività nella finestra di dialogo visualizzata, quindi fai clic su OK.

La tabella seguente elenca le attività disponibili che puoi aggiungere.

Attività	Descrizione
Esegui strumento esterno	Eseguire un'applicazione esterna ad Android Studio. Nella finestra di dialogo Strumenti esterni, seleziona una o più applicazioni che vuoi eseguire e fai clic su OK. Se l'applicazione non è ancora definita in Android Studio, aggiungine la definizione nella finestra di dialogo Crea strumenti. Per ulteriori informazioni, consulta le sezioni Configurazione di strumenti di terze parti e Strumenti esterni.
Esegui un'altra configurazione	Esegui una delle configurazioni di esecuzione/debug esistenti. Nella finestra di dialogo Scegli la configurazione per eseguire, seleziona una configurazione da eseguire e fai clic su OK.
Crea	Compila il progetto o il modulo. Android Studio esegue il comando Make Module se la configurazione di esecuzione/debug specifica un determinato modulo oppure esegue il comando Make Project se non vengono specificati moduli.
Crea progetto	Compila il progetto. Android Studio esegue il comando Make Project.
Esegui, nessun controllo degli errori	Questa opzione è uguale a Crea, ad eccezione del fatto che Android Studio esegue la configurazione di esecuzione/debug indipendentemente dal risultato della compilazione.
Artefatti build	Non supportata in Android Studio.
Esegui attività Gradle	Esegui un'attività Gradle. Nella finestra di dialogo visualizzata, specifica i dettagli e fai clic su OK. Per ulteriori informazioni, consulta Gradle.
Marca che riconosce Gradle	Compila il progetto ed esegui Gradle.
Builder Gradle di App Engine	L'attività Builder Gradle di App Engine sincronizza il progetto e quindi crea il modulo.

Modelli di configurazione

Android Studio fornisce modelli di configurazione per aiutarti a iniziare rapidamente. Le seguenti sezioni descrivono i modelli applicabili allo sviluppo Android con Android Studio:

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

Nota: Android Studio 2.1.x e versioni precedenti avevano un modello di applicazione nativa, che non disponeva delle versioni più recenti. Se in un progetto è presente un modello di applicazione nativa, Android Studio lo converte in un'app per Android quando carichi il progetto. La finestra di dialogo Converti progetto ti guida nella procedura.

Modelli non supportati

I seguenti modelli non supportati provengono da IntelliJ IDEA e non sono specifici dello sviluppo Android con Android Studio. Per informazioni sull'uso di questi modelli, segui i link alla documentazione di IntelliJ IDEA.

Opzioni di configurazione comuni

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

Android Studio archivia la configurazione di esecuzione/debug condivisa in singoli file XML all'interno della cartella project_directory/.idea/runConfigurations/. Per maggiori informazioni, consulta la sezione Formato basato su directory nella documentazione dei progetti IntelliJ.

App per Android

Puoi eseguire o eseguire il debug di app e attività Android su dispositivi virtuali o hardware utilizzando configurazioni basate su questo modello.

Scheda Generali

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

Campo	Descrizione
Module	Seleziona un modulo a cui applicare questa configurazione.
Opzioni di installazione: deployment	Seleziona un'opzione: 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 e le risorse dell'app. Da questo app bundle, Android Studio genera solo gli APK necessari per implementare l'app sul dispositivo connesso. In genere, ti conviene utilizzare questa opzione durante il test dell'app bundle che intendi caricare su Google Play, in quanto il deployment da un app bundle estende il tempo di build totale. Artefatto 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: esegui il deployment come app istantanea	Se la tua app supporta le app istantanee, ovvero aggiungi il supporto per le app istantanee quando crei un nuovo progetto oppure crei uno o più moduli di funzionalità con attivazione istantanea, puoi scegliere di eseguire il deployment di questi moduli attivando le app istantanee selezionando la casella accanto a Esegui il deployment come app istantanea.
Opzioni di installazione: funzionalità di cui implementare	Se la tua app include moduli delle funzionalità, seleziona la casella accanto a ogni funzionalità da includere quando esegui il deployment dell'app. Questa opzione viene visualizzata solo se la tua app include moduli delle funzionalità. Nota: se vuoi testare il download e l'installazione di moduli di funzionalità on demand, devi farlo dopo aver pubblicato l'app bundle e dopo aver utilizzato il canale di test interno di Play Console. Per scoprire di più, consulta Caricare l'app bundle in Play Console.
Opzioni di installazione: installazione di flag	Digita le opzioni `pm install` ADB che vuoi utilizzare. Formatta le opzioni come faresti nella riga di comando, ma senza un percorso. Ecco alcuni esempi: `-i foo.bar.baz -r /path/to/apk` che per gli `-d -r` Predefinito: nessuna opzione.
Opzioni di lancio: lancio	Seleziona un'opzione: Niente: non avviare nulla quando selezioni Esegui o Debug. Tuttavia, se l'app è già in esecuzione e selezioni Debug, Android Studio allega il debugger al processo dell'app. Attività predefinita: avvia l'attività che hai contrassegnato come avvio 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: consente di avviare una determinata attività dell'app nel modulo. Quando viene selezionato, viene visualizzato il campo Attività di seguito, dove puoi digitare il nome dell'attività che vuoi 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 file manifest dell'app. Se selezioni questa opzione, il campo URL viene visualizzato sotto, 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 `am start` ADB che vuoi utilizzare. Formatta le opzioni come faresti nella riga di comando, ma senza intent. Ecco alcuni esempi: `-W` Questa opzione non viene visualizzata se hai scelto il valore Launch (Avvia) di Nothing. Predefinito: nessuna opzione.
Opzioni di destinazione dell'implementazione: target	Seleziona un'opzione: Apri la finestra di dialogo Seleziona destinazione deployment: apri la finestra di dialogo Seleziona destinazione 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: utilizza un dispositivo virtuale. Puoi selezionare una durata di visualizzazione media in una configurazione, altrimenti viene usata solo la prima durata di visualizzazione dell'elenco.
Opzioni di destinazione dell'implementazione: utilizza lo stesso dispositivo per lanci futuri	Per impostazione predefinita questa opzione è deselezionata in modo che ogni volta che esegui un'app, venga visualizzata la finestra di dialogo Seleziona deployment per selezionare un dispositivo. Quando selezioni questa opzione ed esegui un'app, viene visualizzata la finestra di dialogo Seleziona deployment in cui puoi selezionare un dispositivo. Ogni volta che esegui l'app, questa viene avviata sul dispositivo selezionato senza visualizzare la finestra di dialogo Seleziona deployment. Per eseguire l'app su un altro dispositivo, deseleziona Utilizza lo stesso dispositivo per i lanci futuri oppure interrompi l'app selezionando Esegui > Interrompi `app` o Interrompi , quindi riavviala. Viene visualizzata la finestra di dialogo Seleziona deployment in cui puoi selezionare un dispositivo.
Prima del lancio	Consulta Definizione delle operazioni prima del lancio.

Scheda Varie

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

Campo	Descrizione
Logcat: mostra logcat automaticamente	Quando questa opzione è selezionata, la finestra Logcat si apre ogni volta che esegui correttamente il deployment e l'avvio di un'app utilizzando questa configurazione. Valore predefinito: selezionato.
Logcat: cancella il log prima dell'avvio	Seleziona questa opzione se vuoi che Android Studio rimuova i dati delle sessioni precedenti dal file di log prima di avviare l'app. Impostazione predefinita: deselezionata.
Opzioni di installazione: salta l'installazione se l'APK non è cambiato.	Se selezioni questa opzione, Android Studio non esegue nuovamente il deployment dell'APK se rileva che è rimasto invariato. Se vuoi che Android Studio forzi l'installazione dell'APK, anche se non è cambiato, deseleziona questa opzione. Predefinita: selezionata
Opzioni di installazione: Forza l'interruzione dell'esecuzione dell'applicazione prima di avviare l'attività	Se questa opzione è selezionata, quando Android Studio rileva che non è necessario reinstallare un APK perché non è cambiato, l'app viene arrestata forzatamente in modo che l'app venga avviata dall'attività in Avvio applicazioni predefinita. Se questa opzione è deselezionata, Android Studio non forza l'interruzione dell'app. Questa opzione funziona con l'opzione precedente, che controlla se un APK è installato o meno. Lascia invariati i valori predefiniti di entrambi i campi Opzioni di installazione, a meno che tu non voglia esplicitamente forzare un'installazione ogni volta. In alcuni casi potresti voler deselezionare questa opzione. Ad esempio, se stai scrivendo un motore del metodo di immissione (IME), l'arresto forzato dell'app la deseleziona come tastiera corrente, cosa che potresti non volere. Predefinita: selezionata
Prima del lancio	Consulta Definizione delle operazioni prima del lancio.

Scheda Debugger

Specifica le opzioni di debug nella scheda Debugger.

Per i codici C e C++, Android Studio utilizza il debugger LLDB. Oltre alla normale interfaccia utente di Android Studio, la finestra del debugger include una scheda LLDB che consente di inserire comandi LLDB durante il debug. Puoi inserire gli stessi comandi utilizzati da Android Studio per visualizzare le informazioni nell'interfaccia utente del debugger ed eseguire operazioni aggiuntive.

Per i progetti C e C++, puoi aggiungere directory di simboli, nonché comandi di avvio e post-collegamento LLDB, nella scheda Debugger. Per farlo, utilizza pulsanti simili ai seguenti:

Aggiungi - Aggiungi una directory o un comando.
Rimuovi - Seleziona una directory o un comando, quindi fai clic su questo pulsante per rimuovere l'elemento.
Su - Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento in alto nell'elenco.
Freccia giù - Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento in basso nell'elenco.

Vedi Debug dell'app per ulteriori informazioni sul debug in Android Studio.

Campo	Descrizione
Tipo di debug	Seleziona una delle seguenti opzioni: Solo Java: solo il debug del codice Java. Rileva automaticamente. Consenti ad Android Studio di scegliere il tipo di debug migliore per il tuo progetto. Solo nativo: esegue il debug del codice C o C++ nativo. Doppio (Java + nativo): esegui il debug di Java e del codice nativo in due sessioni di debug separate. L'opzione Rileva automaticamente è consigliata perché sceglie il tipo di debug corretto per il tuo progetto.
Directory dei simboli	Se vuoi aggiungere file di simboli per fornire al debugger informazioni su C o C++ generate al di fuori di Android Studio, puoi aggiungere una o più directory qui. Android Studio utilizza preferibilmente qualsiasi file all'interno di queste directory rispetto ai file generati dal plug-in Android per Gradle. Il debugger cerca le directory dall'alto verso il basso, in ordine, finché non trova ciò di cui ha bisogno. Cerca in modo ricorsivo tra i file della directory. Per ottimizzare l'elenco e risparmiare tempo, metti le directory utilizzate più spesso in cima all'elenco. Se specifichi una directory nella parte superiore della struttura, la ricerca in tutte le sottodirectory potrebbe richiedere più tempo. Se aggiungi una directory molto specifica, la ricerca richiederà meno tempo. Devi trovare il giusto equilibrio tra velocità e ricerca dei file necessari per il debug. Ad esempio, se hai una directory che contiene sottodirectory per diverse ABI (Android Binary Interfaces) diverse, puoi scegliere di aggiungerne una per un'ABI specifica o per tutte le ABI. Anche se la ricerca nella directory di livello superiore può richiedere più tempo, è comunque più infallibile se decidi di eseguire il debug su un altro dispositivo. Tieni presente che non devi aggiungere directory contenenti file di simboli Gradle perché il debugger li utilizza automaticamente.
Comandi di avvio LLDB	Aggiungi i comandi LLDB da eseguire prima che il debugger si colleghi al processo. Ad esempio, puoi definire le impostazioni per l'ambiente, come mostrato nel seguente comando: `settings set target.max-memory-read-size 2048` LLDB esegue i comandi in ordine dall'alto verso il basso.
Comandi di collegamento post-collegamento LLDB	Aggiungi i comandi LLDB che vuoi eseguire subito dopo che il debugger è collegato al processo. Ecco alcuni esempi: `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 target	Specifica le opzioni di log LLDB. Android Studio imposta le opzioni predefinite in base all'esperienza del team, quindi non è troppo lento, ma contiene le informazioni necessarie per la risoluzione dei problemi. Questo log viene spesso richiesto per le segnalazioni di bug di Android Studio. L'impostazione predefinita è `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 `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 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` Oppure, se più utenti accedono a un dispositivo, i log vengono inseriti nella seguente posizione, dove `AndroidUserId` è un identificatore univoco di un utente sul dispositivo: `/data/user/AndroidUserId/ApplicationId/lldb/log` Per informazioni sull'utilizzo di LLDB per il debug remoto, vedi Debug remoto.
Prima del lancio	Consulta Definizione delle operazioni prima del lancio.

Scheda Profilazione

L'opzione Attiva profilazione avanzata deve essere selezionata per attivare determinate funzionalità in Android Profiler se sul tuo dispositivo è in esecuzione Android 7.1 o versioni precedenti.

Test Android

Il modello di test da utilizzare dipende dal tuo set di origine. Il modello Android Instrumented Tests è per un test instrumented. Il modello di JUnit per Android serve per il test delle unità locali.

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

Le seguenti descrizioni delle schede coprono le schede e i campi per il modello di test Android Instrumented. Per informazioni sulle schede e sui campi per il modello di test della JUnit per Android, visita la pagina Esegui/debug configurazione: JUnit di IntelliJ.

Scheda Generali

Nella scheda Generale, puoi specificare la località di test, l'esecutore della strumentazione, la shell adb e le opzioni di deployment.

Campo	Descrizione
Module	Seleziona un modulo a cui applicare questa configurazione.
Test	In questa area, specifica la località dei test che vuoi eseguire: 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 Metodo, specifica il metodo. Digita il nome o fai clic su Altro per selezionare la classe o il metodo da una finestra di dialogo.
Runner della strumentazione specifica (facoltativo)	Digita la posizione del runner della strumentazione; fai clic su Altro per utilizzare una finestra di dialogo. Il file `build.gradle` specifica la posizione del runner della strumentazione; questo valore la sostituisce. In genere, l'impostazione predefinita è la classe `AndroidJUnitRunner` di AndroidX Test.
Opzioni extra	Digita le opzioni `am instrument` ADB che vuoi utilizzare. Non digitare il componente. Ad esempio, se utilizzi `AndroidJUnitRunner` da AndroidX Test, puoi usare questo campo per trasmettere opzioni aggiuntive al runner, come `-e size small`. Predefinito:nessuna opzione
Opzioni di destinazione dell'implementazione: target	Seleziona un'opzione: Apri la finestra di dialogo Seleziona destinazione deployment: apri la finestra di dialogo Seleziona destinazione 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: utilizza un dispositivo virtuale. Puoi selezionare una durata di visualizzazione media in una configurazione, altrimenti viene usata solo la prima durata di visualizzazione dell'elenco. Matrice dei dispositivi di 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 vorrai utilizzare automaticamente il dispositivo che hai scelto tramite la finestra di dialogo Seleziona il target del deployment, seleziona questa opzione. Se il dispositivo non è disponibile, verrà visualizzata una finestra di dialogo. Predefinita: deselezionata
Prima del lancio	Consulta Definizione delle operazioni prima del lancio.

Scheda Varie

La scheda Miscellaneous (Varie) contiene logcat e opzioni di installazione.

Campo	Descrizione
Logcat: cancella il log prima dell'avvio	Seleziona questa opzione se vuoi che Android Studio rimuova i dati delle sessioni precedenti dal file di log prima di avviare l'app. Impostazione predefinita: deselezionata.
Opzioni di installazione: salta l'installazione se l'APK non è cambiato	Se selezioni questa opzione, Android Studio non esegue nuovamente il deployment dell'APK se rileva che è rimasto invariato. Se vuoi che Android Studio forzi l'installazione dell'APK, anche se non è cambiato, deseleziona questa opzione. Predefinita: selezionata
Opzioni di installazione: Forza l'interruzione dell'esecuzione dell'applicazione prima di avviare l'attività	Se questa opzione è selezionata, quando Android Studio rileva che non è necessario reinstallare un APK perché non è cambiato, l'app viene arrestata forzatamente in modo che l'app venga avviata dall'attività in Avvio applicazioni predefinita. Se questa opzione è deselezionata, Android Studio non forza l'interruzione dell'app. Questa opzione funziona in combinazione con l'opzione precedente, che controlla se un APK è installato o meno. Lascia invariati i valori predefiniti di entrambi i campi Opzioni di installazione, a meno che tu non voglia esplicitamente forzare un'installazione ogni volta. In alcuni casi potresti voler deselezionare questa opzione. Ad esempio, se stai scrivendo un motore del metodo di immissione (IME), l'arresto forzato dell'app la deseleziona come tastiera corrente, cosa che potresti non volere. Predefinita: selezionata
Prima del lancio	Consulta Definizione delle operazioni prima del lancio.

Scheda Debugger

Specifica le opzioni di debug nella scheda Debugger.

Per i progetti C e C++, puoi aggiungere directory di simboli, nonché comandi di avvio e post-collegamento LLDB, nella scheda Debugger. Per farlo, utilizza pulsanti simili ai seguenti:

Aggiungi - Aggiungi una directory o un comando.
Rimuovi - Seleziona una directory o un comando, quindi fai clic su questo pulsante per rimuovere l'elemento.
Su - Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento in alto nell'elenco.
Freccia giù - Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento in basso nell'elenco.

Vedi Debug dell'app per ulteriori informazioni sul debug in Android Studio.

Campo	Descrizione
Tipo di debug	Seleziona una delle seguenti opzioni: Solo Java: solo il debug del codice Java. Rileva automaticamente. Consenti ad Android Studio di scegliere il tipo di debug migliore per il tuo progetto. Solo nativo: esegue il debug del codice C o C++ nativo. Doppio (Java + nativo): esegui il debug di Java e del codice nativo in due sessioni di debug separate. L'opzione Rileva automaticamente è consigliata perché sceglie il tipo di debug corretto per il tuo progetto.
Directory dei simboli	Se vuoi aggiungere file di simboli per fornire al debugger informazioni su C o C++ generate al di fuori di Android Studio, puoi aggiungere una o più directory qui. Android Studio utilizza preferibilmente qualsiasi file all'interno di queste directory rispetto ai file generati dal plug-in Android per Gradle. Il debugger cerca le directory dall'alto verso il basso, in ordine, finché non trova ciò di cui ha bisogno. Cerca in modo ricorsivo tra i file della directory. Per ottimizzare l'elenco e risparmiare tempo, metti le directory utilizzate più spesso in cima all'elenco. Se specifichi una directory nella parte superiore della struttura, la ricerca in tutte le sottodirectory potrebbe richiedere più tempo. Se aggiungi una directory molto specifica, la ricerca richiederà meno tempo. Devi trovare il giusto equilibrio tra velocità e ricerca dei file necessari per il debug. Ad esempio, se hai una directory che contiene sottodirectory per diverse ABI (Android Binary Interfaces) diverse, puoi scegliere di aggiungerne una per un'ABI specifica o per tutte le ABI. Anche se la ricerca nella directory di livello superiore può richiedere più tempo, è comunque più infallibile se decidi di eseguire il debug su un altro dispositivo. Tieni presente che non devi aggiungere directory contenenti file di simboli Gradle perché il debugger li utilizza automaticamente.
Comandi di avvio LLDB	Aggiungi i comandi LLDB da eseguire prima che il debugger si colleghi al processo. Ad esempio, puoi definire le impostazioni per l'ambiente, come mostrato nel seguente comando: `settings set target.max-memory-read-size 2048` LLDB esegue i comandi in ordine dall'alto verso il basso.
Comandi di collegamento post-collegamento LLDB	Aggiungi i comandi LLDB che vuoi eseguire subito dopo che il debugger è collegato al processo. Ecco alcuni esempi: `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 target	Specifica le opzioni di log LLDB. Android Studio imposta le opzioni predefinite in base all'esperienza del team, quindi non è troppo lento, ma contiene le informazioni necessarie per la risoluzione dei problemi. Questo log viene spesso richiesto per le segnalazioni di bug di Android Studio. L'impostazione predefinita è `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 `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 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` Oppure, se più utenti accedono a un dispositivo, i log vengono inseriti nella seguente posizione, dove `AndroidUserId` è un identificatore univoco di un utente sul dispositivo: `/data/user/AndroidUserId/ApplicationId/lldb/log` Per informazioni sull'utilizzo di LLDB per il debug remoto, vedi Debug remoto.
Prima del lancio	Consulta Definizione delle operazioni prima del lancio.

DevAppServer di App Engine

Questa configurazione di esecuzione/debug si applica alla piattaforma Google Cloud. Per ulteriori informazioni, consulta Esecuzione, test e deployment del backend. Quando segui questi passaggi e sincronizzi il tuo progetto con il file build.gradle, Android Studio crea per te una configurazione DevAppServer di App Engine.

Tieni presente che il modello App Engine Server di IntellJ IDEA è un modello diverso non disponibile in Android Studio.

Campo	Descrizione
Solo istanza singola	Se vuoi assicurarti che al momento sia eseguita una sola istanza della configurazione di esecuzione/debug, seleziona questa opzione. Non consente più esecuzioni della stessa configurazione contemporaneamente. Predefinita: selezionata
Module	Seleziona un modulo a cui applicare questa configurazione.
Sincronizzazione con la configurazione build.gradle	Se aggiungi un modulo App Engine ed esegui la sincronizzazione al file `build.gradle`, i campi di configurazione di App Engine DevAppServer vengono compilati automaticamente (consigliato). Il progetto viene sincronizzato anche selezionando File > Sincronizza progetto con i file Gradle. Predefinita: selezionata
SDK App Engine	Digita un percorso di un SDK Google App Engine per Java sulla macchina locale. Fai clic su ... per selezionarlo da una finestra di dialogo.
Percorso di guerra	Digita un percorso della directory WAR (Web Application Archive) dell'app di cui stai eseguendo il deployment sul server di sviluppo locale. Fai clic su ... per selezionarlo da una finestra di dialogo.
Arg VM	Specifica le opzioni della riga di comando da passare alla VM per l'avvio di DevAppServer. Quando specifichi le opzioni: 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 ulteriori informazioni sulle opzioni della VM, consulta la documentazione per la tua versione di J2SE, ad esempio `java` JDK 7 e `java` JDK 8. Predefinito: nessuna opzione
Indirizzo del server	Digita l'indirizzo host da utilizzare per il server. Potrebbe essere necessario fornire l'indirizzo per poter accedere al server di sviluppo da un altro computer sulla rete. Un indirizzo 0.0.0.0 consente sia l'accesso localhost che l'accesso per nome host. Valore predefinito: localhost
Porta server	Digita il numero della porta da utilizzare per il server. Valore predefinito: 8080
Disabilita il controllo degli aggiornamenti dell'SDK di App Engine	Se fornito, il server di sviluppo non contatterà App Engine per verificare la disponibilità di una nuova versione dell'SDK. Per impostazione predefinita, il server verifica la presenza di una nuova versione all'avvio e stampa un messaggio se è disponibile una nuova versione.
Prima del lancio	Consulta Definizione delle operazioni prima del lancio.

Configurazioni di esecuzione/debug per Wear OS

I modelli Complicazione, Tile e Quadrante per Wear OS ti consentono di eseguire o eseguire il debug delle app per Wear OS su dispositivi virtuali o hardware. La maggior parte delle opzioni di configurazione dei modelli corrispondono alle opzioni delle app per Android. Di seguito sono riportate le opzioni più specifiche per le configurazioni di esecuzione/debug di Wear OS:

Per tutte le configurazioni di esecuzione/debug di Wear, devi selezionare un'origine dati, un riquadro o un quadrante specifico per la complicazione (a seconda del modello) a cui applicare la configurazione. In genere, ciascuna di queste entità corrisponde a una classe nel codice.
Per la configurazione di esecuzione/debug delle complicazioni per Wear OS, devi scegliere lo Slot in cui vuoi inserire i dati sulle complicazioni forniti dall'origine dati delle complicazioni. Puoi scegliere di posizionarlo in alto, a destra, in basso, a sinistra o sullo sfondo del quadrante.
Per la configurazione di esecuzione/debug delle complicazioni per Wear OS, devi selezionare anche il Tipo dei dati sulle complicazioni forniti dall'origine dati delle complicazioni. I tipi tra cui puoi scegliere sono limitati a quelli forniti dall'origine dati della complicazione scelta e supportati dallo slot scelto. Per un elenco dei tipi di dati relativi alle complicazioni, consulta Tipi e campi.

In alternativa, puoi anche eseguire queste superfici dall'icona grondaia che si trova accanto alla dichiarazione della superficie, come mostrato nell'immagine seguente.