Creare e modificare le configurazioni di esecuzione/debug

Quando esegui, esegui il debug o testi 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 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:

Informazioni sulle configurazioni di esecuzione/debug

Le configurazioni di esecuzione/debug specificano dettagli quali opzioni di installazione, avvio e test dell'app. Puoi definire una configurazione per un utilizzo una tantum o salvarla per un utilizzo futuro. Dopo averla salvata, puoi selezionare la configurazione dall'elenco a discesa Seleziona configurazione di esecuzione/debug all'interno della barra degli strumenti. Android Studio salva le configurazioni come parte 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 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 modifiche alle configurazioni di esecuzione/debug e ai modelli vengono applicate solo al progetto corrente. Puoi condividere una configurazione di esecuzione/debug (ma non un modello) tramite il tuo sistema di controllo delle versioni. Per ulteriori informazioni su come condividere una configurazione, vedi Opzioni di denominazione e condivisione della configurazione.

Apri la finestra di dialogo Run/Debug Configurations (Configurazioni di esecuzione/debug)

Per aprire la finestra di dialogo Run/Debug Configurations (Esegui/Esegui debug delle configurazioni), seleziona Run (Esegui) > Edit Configurations (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 ti 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 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 basarsi su un template di configurazione.

La finestra di dialogo Run/Debug Configurations (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 Android App, Android Instrumented Tests 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 Configurazioni di esecuzione/debug, 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 questa impostazione predefinita, apri le impostazioni di Android Studio e modifica Impostazioni avanzate > Esegui/Debug > Limite configurazioni temporanee. Per ulteriori informazioni sulle configurazioni temporanee, consulta Creazione e salvataggio di 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 Configurazioni di esecuzione/debug.
  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 esigenze.
  6. Assicurati di correggere gli eventuali errori visualizzati nella parte inferiore della finestra di dialogo.

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

  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.
  6. Assicurati di correggere gli eventuali errori visualizzati nella parte inferiore della finestra di dialogo.

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

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

  1. Apri un progetto nella visualizzazione Android o Progetto.
  2. Nella finestra Progetto, fai clic con il tasto destro del mouse su un elemento testabile e seleziona Esegui filename o Esegui 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. Salvataggio della 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 di esecuzione del test per una classe o un metodo e quindi di eseguirla. Ad esempio, se crei un nuovo corso, puoi creare ed eseguire un test. Se il test viene superato, puoi eseguire i test per il resto del progetto per assicurarti che il nuovo codice non interrompa nulla altrove.

Android Studio utilizza il modello Android Instrumented Tests o Android JUnit, a seconda del set di origine. Per un test delle unità locale, puoi facoltativamente eseguire 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 nella visualizzazione Android o Progetto.
  2. Apri un file Java nell'editor di codice.
  3. Seleziona una classe o un metodo nel codice, quindi premi Ctrl+Maiusc+T (Cmd+Maiusc+T).
  4. Seleziona Crea nuovo test dal menu visualizzato.
  5. Nella finestra di dialogo Crea test, se vuoi, modifica o imposta i valori e fai clic su Ok.
  6. Nella finestra di dialogo Scegli directory di destinazione, seleziona la posizione in cui vuoi che Android Studio inserisca il test nel progetto. Puoi specificare la posizione in base alla struttura delle directory o selezionando una classe vicina.
  7. Fai clic su OK.

    Il nuovo test viene visualizzato nella finestra Progetto nel set di origini di 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 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 Salva configurazione dalle opzioni accanto alla configurazione che vuoi salvare.

    Figura 3. Salvataggio della 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 all'interno della barra degli strumenti.
  2. L'elenco a discesa si trova a sinistra di Esegui e Debug ; ad esempio, .

  3. Seleziona Esegui > Esegui o Esegui > Debug.
  4. In alternativa, fai clic su Esegui o 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 esigenze.
  4. Assicurati di correggere gli eventuali errori visualizzati nella parte inferiore della finestra di dialogo.

  5. Fai clic su Applica o Ok.

Modificare un modello di configurazione di esecuzione/debug

Puoi modificare i modelli di configurazione forniti da Android Studio in base al tuo processo di sviluppo. Quando modifichi un modello, non influisce sulle configurazioni esistenti che lo utilizzano. Ad esempio, se devi creare una serie di configurazioni di un determinato tipo, puoi modificare il modello e poi ripristinarlo 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:

  1. Apri la finestra di dialogo Configurazioni di esecuzione/debug.
  2. Fai clic su Modifica modelli di configurazione….
  3. Seleziona un modello di configurazione.
  4. Modifica la configurazione in base alle esigenze.
  5. Assicurati di correggere gli eventuali errori visualizzati nella parte inferiore della finestra di dialogo.

  6. Fai clic su Applica o Ok.

Ordinare e raggruppare le configurazioni

Nella finestra di dialogo Configurazioni di 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:

  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à pre-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 quando compili dalla riga di comando.

    Per creare un elenco di attività:

    1. Nella parte inferiore della finestra di dialogo Run/Debug Configurations (Configurazioni di esecuzione/debug), in Before launch (Prima del lancio) (potresti dover scorrere verso il basso), fai clic su Add (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 seleziona un'attività e fai clic su Su e Giù per spostarla in alto o in 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 attiva se vuoi che la finestra degli strumenti Esegui o Debug venga attivata quando esegui o esegui il debug dell'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 che si apre, 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 da eseguire e poi fai clic su Ok. Se l'applicazione non è ancora definita in Android Studio, aggiungi la sua 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 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 Make Module se la configurazione di esecuzione/debug specifica un modulo particolare oppure esegue il comando Make Project se non sono specificati moduli.
    Crea progetto Compila il progetto. Android Studio esegue il comando Crea progetto.
    Make, no error check Questa opzione è uguale a Crea, 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 l'attività Gradle Esegui un'attività Gradle. Nella finestra di dialogo che si apre, specifica i dettagli e poi fai clic su Ok. Per ulteriori informazioni, vedi Gradle.
    Make compatibile con Gradle Compila il progetto ed esegui Gradle.
    Builder Gradle di App Engine L'attività di compilazione Gradle di App Engine sincronizza il progetto e poi compila il modulo.

    Modelli di configurazione

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

    Nota:Android Studio 2.1.x e versioni precedenti avevano un modello di applicazione nativa, che le versioni più recenti non hanno. 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'utilizzo di questi modelli, segui i link alla documentazione di IntelliJ IDEA.

    Opzioni di configurazione comuni

    Le opzioni Nome, Consenti esecuzione parallela e Memorizza come file di progetto sono comuni a più modelli di configurazione. Per saperne di più, consulta 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 la sezione 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 Generale, puoi specificare le opzioni di installazione, avvio e implementazione. 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 la tua app da un Android App Bundle. ovvero Android Studio converte prima il progetto dell'app in un app bundle che include tutto il codice e le risorse compilati dell'app. Quindi, 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 estende il tempo di compilazione totale.
    • Custom Artifact: non supportato in Android Studio.
    • Nessuna azione: non installare un APK su un dispositivo. Ad esempio, se preferisci installare manualmente l'APK, non hai bisogno di Android Studio per farlo.
    Opzioni di installazione: esegui il deployment come app istantanea Se la tua app supporta le esperienze istantanee, ovvero se aggiungi il supporto per le app istantanee quando crei un nuovo progetto o se crei uno o più moduli delle funzionalità compatibili con le app istantanee, puoi scegliere di eseguire il deployment di questi moduli 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à da 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 di moduli di funzionalità on demand, devi farlo dopo aver pubblicato l'app bundle e poi utilizzare il gruppo di test interno di Play Console. Per saperne di più, leggi Caricare l'app bundle su Play Console.

    Opzioni di installazione: installa flag Digita le opzioni adb pm install che vuoi utilizzare. Formatta le opzioni nello stesso modo in cui le formatteresti nella riga di comando, ma senza un percorso. Ecco alcuni esempi:

    -i foo.bar.baz -r /path/to/apk

    e

    -d -r

    Impostazione predefinita: nessuna opzione.

    Opzioni di avvio: avvia

    Seleziona un'opzione:

    • Nessuna: 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 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 un'attività di app specifica nel modulo. Se selezionato, viene visualizzato il campo Attività, in cui puoi digitare il nome dell'attività che vuoi avviare o fare clic su Altro per selezionare un'attività da un elenco.
    • URL: avvia un URL che corrisponde a un filtro per intent nel manifest dell'app. Se selezionato, viene visualizzato il campo URL di seguito, in cui puoi inserire l'URL.

      Devi compilare questo campo per avviare un'app istantanea per Android. Puoi anche utilizzarlo per testare i link per app Android.

    Opzioni di avvio: flag di lancio Digita le opzioni adb am start che vuoi utilizzare. Formatta le opzioni nello stesso modo in cui le formatti nella riga di comando, ma senza un intent. Ad esempio:

    -W

    Questa opzione non viene visualizzata se hai scelto un valore Avvio di Niente.

    Impostazione predefinita: nessuna opzione.

    Opzioni di destinazione di deployment: destinazione

    Seleziona un'opzione:

    • Apri la finestra di dialogo Seleziona destinazione di distribuzione: apri la finestra di dialogo Seleziona destinazione di distribuzione per selezionare un dispositivo virtuale o hardware.
    • Dispositivo USB: utilizza un dispositivo hardware collegato al computer di sviluppo tramite una porta USB. Se ce n'è più di uno, viene visualizzata una finestra di dialogo per consentirti di selezionarlo.
    • Emulatore: utilizza un dispositivo virtuale. In una configurazione, puoi selezionare un AVD; altrimenti, viene utilizzato il primo AVD nell'elenco.

    Opzioni di destinazione di distribuzione: utilizza lo stesso dispositivo per i lanci futuri

    Per impostazione predefinita, questa opzione è deselezionata in modo che ogni volta che esegui un'app, venga visualizzata la finestra di dialogo Seleziona distribuzione per consentirti di selezionare un dispositivo. Quando selezioni questa opzione e poi esegui un'app, viene visualizzata la finestra di dialogo Seleziona distribuzione per selezionare un dispositivo. Poi, ogni volta che esegui l'app, questa viene avviata sul dispositivo selezionato senza visualizzare la finestra di dialogo Seleziona distribuzione. Per eseguire l'app su un altro dispositivo, deseleziona Usa lo stesso dispositivo per i lanci futuri oppure arresta l'app con Esegui > Arresta app o Arresta , quindi riavviala. Viene visualizzata la finestra di dialogo Seleziona implementazione per consentirti di selezionare un dispositivo.
    Prima del lancio Vedi Definizione delle operazioni pre-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 Logcat automaticamente Quando questa opzione è selezionata, la finestra Logcat si apre ogni volta che esegui il deployment e avvii un'app utilizzando questa configurazione. Impostazione predefinita: selezionata.
    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 selezionata, Android Studio non esegue nuovamente il deployment dell'APK se rileva che è 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'arresto dell'applicazione in esecuzione prima di avviare l'attività

    Se selezionata, quando Android Studio rileva che non deve reinstallare un APK perché non è cambiato, interrompe forzatamente l'app in modo che l'app venga avviata dall'attività di avvio predefinita. Se questa opzione è deselezionata, Android Studio non arresta forzatamente l'app.

    Questa opzione funziona con l'opzione precedente che controlla se un APK è installato o meno. Per entrambi i campi Opzioni di installazione, lascia i valori predefiniti 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 del metodo di input (IME), l'arresto forzato dell'app la deseleziona come tastiera corrente, cosa che potresti non volere.

    Valore predefinito: selezionato

    Prima del lancio Consulta la sezione Definizione delle operazioni pre-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 comandi LLDB durante il debug. Puoi inserire gli stessi comandi che Android Studio utilizza 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-attach di LLDB, nella scheda Debugger. A tale scopo, 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 verso l'alto nell'elenco.
    • Giù - Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento verso il basso nell'elenco.

    Consulta Eseguire il debug dell'app per ulteriori informazioni sul debug in Android Studio.

    Campo Descrizione
    Tipo di debug

    Seleziona una delle seguenti opzioni:

    • Solo Java: esegui il debug solo del codice Java.
    • Rileva automaticamente: consente 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.
    • Doppio (Java + nativo): esegui il debug del codice Java e 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 C o C++ generate al di fuori di Android Studio, puoi aggiungere una o più directory qui. Android Studio utilizza preferibilmente 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ò di cui ha bisogno. Esegue la ricerca in modo ricorsivo nei file della directory. Per ottimizzare l'elenco e risparmiare tempo, metti le directory utilizzate più spesso in cima all'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 diverse interfacce binarie Android (ABI), puoi scegliere di aggiungere una directory per una ABI specifica o per tutte le ABI. Sebbene la ricerca nella directory di livello superiore possa richiedere più tempo, è anche più sicura 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 di 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.

    LLDB Post Attach Commands

    Aggiungi i comandi LLDB che vuoi eseguire subito dopo che il debugger si collega 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 di LLDB.
    Registrazione: canali di destinazione

    Specifica le opzioni di log di LLDB. Android Studio imposta le opzioni predefinite in base all'esperienza del team, in modo che non sia troppo lento ma contenga le informazioni necessarie per la risoluzione dei problemi. Il log viene spesso richiesto per i report sui 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 unplatform 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 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 inseriti nel percorso seguente, 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 Vedi Definizione delle operazioni pre-lancio.

    Scheda Profilazione

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

    Test Android

    Il modello di test da utilizzare dipende dal tuo insieme di origini. Il modello Test strumentati Android è per un test strumentato. Il modello JUnit di Android è per un test delle unità locale.

    Nota:se utilizzi Firebase Test Lab per eseguire test su una serie di dispositivi, puoi utilizzare il modello Android JUnit per definire i test strumentati. Per ulteriori informazioni, consulta Esegui i test con Firebase Test Lab.

    Le seguenti descrizioni delle schede riguardano le schede e i campi del modello di test strumentato Android. Per informazioni sulle schede e sui campi del modello di test JUnit per Android, consulta la pagina Run/Debug Configuration: JUnit di IntelliJ.

    Scheda Generali

    Nella scheda Generali, puoi specificare la posizione del test, lo strumento di esecuzione dell'instrumentation, adb shell e le opzioni di deployment.

    Campo Descrizione
    Modulo Seleziona un modulo a cui applicare questa configurazione.
    Test

    In questa sezione, specifica la posizione dei test che vuoi eseguire:

    • Tutti nel modulo: avvia tutti i test del modulo selezionato.
    • Tutti 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.
    • Classe: avvia i test della classe specificata nel campo Classe. 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.
    Runner di strumentazione specifico (facoltativo) Digita la posizione del runner di strumentazione; fai clic su Altro per utilizzare una finestra di dialogo. Il file build.gradle specifica la posizione del runner di strumentazione; questo valore lo sostituisce. Il valore predefinito è in genere la classe AndroidJUnitRunner di AndroidX Test.
    Opzioni aggiuntive

    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 distribuzione: apri la finestra di dialogo Seleziona destinazione di distribuzione per selezionare un dispositivo virtuale o hardware.
    • Dispositivo USB: utilizza un dispositivo hardware collegato al computer di sviluppo tramite una porta USB. Se ce n'è più di uno, viene visualizzata una finestra di dialogo per consentirti di selezionarlo.
    • Emulatore: utilizza un dispositivo virtuale. In una configurazione, puoi selezionare un AVD; altrimenti, viene utilizzato il primo AVD nell'elenco.
    • Matrice dei dispositivi Firebase Test Lab: consulta Esegui i test con Firebase Test Lab.
    Opzioni di destinazione di distribuzione: utilizza lo stesso dispositivo per i lanci futuri Se in futuro vuoi utilizzare automaticamente il dispositivo scelto tramite la finestra di dialogo Seleziona destinazione di distribuzione, seleziona questa opzione. Se il dispositivo non è disponibile, riceverai una finestra di dialogo. Valore predefinito: deselezionato
    Prima del lancio Vedi Definizione delle operazioni pre-lancio.

    Scheda Varie

    La scheda Varie contiene le opzioni di logcat e 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 è stato modificato Se selezionata, Android Studio non esegue nuovamente il deployment dell'APK se rileva che è 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'arresto dell'applicazione in esecuzione prima di avviare l'attività

    Se selezionata, quando Android Studio rileva che non deve reinstallare un APK perché non è cambiato, interrompe forzatamente l'app in modo che l'app venga avviata dall'attività di avvio predefinita. Se questa opzione è deselezionata, Android Studio non arresta forzatamente l'app.

    Questa opzione funziona insieme a quella precedente, che controlla se un APK viene installato o meno. Per entrambi i campi Opzioni di installazione, lascia i valori predefiniti 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 del metodo di input (IME), l'arresto forzato dell'app la deseleziona come tastiera corrente, cosa che potresti non volere.

    Valore predefinito: selezionato

    Prima del lancio Vedi Definizione delle operazioni pre-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 comandi LLDB durante il debug. Puoi inserire gli stessi comandi che Android Studio utilizza 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-attach di LLDB, nella scheda Debugger. A tale scopo, 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 verso l'alto nell'elenco.
    • Giù - Seleziona una directory o un comando, quindi fai clic su questo pulsante per spostare l'elemento verso il basso nell'elenco.

    Consulta Eseguire il debug dell'app per ulteriori informazioni sul debug in Android Studio.

    Campo Descrizione
    Tipo di debug

    Seleziona una delle seguenti opzioni:

    • Solo Java: esegui il debug solo del codice Java.
    • Rileva automaticamente: consente 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.
    • Doppio (Java + nativo): esegui il debug del codice Java e 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 C o C++ generate al di fuori di Android Studio, puoi aggiungere una o più directory qui. Android Studio utilizza preferibilmente 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ò di cui ha bisogno. Esegue la ricerca in modo ricorsivo nei file della directory. Per ottimizzare l'elenco e risparmiare tempo, metti le directory utilizzate più spesso in cima all'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 diverse interfacce binarie Android (ABI), puoi scegliere di aggiungere una directory per una ABI specifica o per tutte le ABI. Sebbene la ricerca nella directory di livello superiore possa richiedere più tempo, è anche più sicura 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 di 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.

    LLDB Post Attach Commands

    Aggiungi i comandi LLDB che vuoi eseguire subito dopo che il debugger si collega 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 di LLDB.
    Registrazione: canali di destinazione

    Specifica le opzioni di log di LLDB. Android Studio imposta le opzioni predefinite in base all'esperienza del team, in modo che non sia troppo lento ma contenga le informazioni necessarie per la risoluzione dei problemi. Il log viene spesso richiesto per i report sui 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 unplatform 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 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 inseriti nel percorso seguente, 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 Vedi Definizione delle operazioni pre-lancio.

    App Engine DevAppServer

    Questa configurazione di esecuzione/debug si applica a Google Cloud. Quando segui questi passaggi e sincronizzi il progetto con il file build.gradle, Android Studio crea una configurazione App Engine DevAppServer.

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

    Campo Descrizione
    Solo singola istanza Se vuoi assicurarti che venga eseguita una sola istanza della configurazione di esecuzione/debug, seleziona questa opzione. Non consente più esecuzioni della stessa configurazione contemporaneamente. Valore predefinito: selezionato
    Modulo Seleziona un modulo a cui applicare questa configurazione.
    Sincronizzare con la configurazione di build.gradle Se aggiungi un modulo App Engine e lo sincronizzi con il file build.gradle, i campi di configurazione di App Engine DevAppServer vengono compilati automaticamente (consigliato). Se selezioni File > Sincronizza progetto con file Gradle, il progetto viene sincronizzato. Valore predefinito: selezionato
    SDK di App Engine Digita un percorso a un SDK Google App Engine per Java sulla macchina locale. Fai clic su per selezionarlo da una finestra di dialogo.
    Sentiero di guerra Digita un percorso alla directory WAR (Web Application Archive) dell'app che 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 trasmettere 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 delle virgolette (\").

    Per ulteriori informazioni sulle opzioni della VM, consulta la documentazione della tua versione di J2SE, ad esempio java JDK 7 e java JDK 8.

    Impostazione predefinita: 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 rete. Un indirizzo 0.0.0.0 consente sia l'accesso localhost che l'accesso al nome host. Valore predefinito: localhost
    Porta server Digita il numero di porta da utilizzare per il server. Valore predefinito: 8080
    Disabilita Controlla aggiornamenti SDK per App Engine Se specificato, 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 Vedi Definizione delle operazioni pre-lancio.

    Configurazioni di esecuzione/debug di Wear OS

    I modelli di complicazione, riquadro e quadrante di Wear OS ti consentono di eseguire o eseguire il debug delle app Wear OS su dispositivi virtuali o hardware. La maggior parte delle opzioni di configurazione del modello sono uguali a quelle delle app per Android. Ecco 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 di 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 della complicazione Wear OS, devi scegliere lo Slot in cui inserire i dati della complicazione forniti dall'origine dati della complicazione. Puoi scegliere di posizionarlo 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 di 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 spazio scelto. Per un elenco dei tipi di dati delle complicazioni, vedi Tipi e campi.

    In alternativa, puoi eseguire queste superfici dall'icona della canaletta che si trova accanto alla dichiarazione della superficie, come mostrato nell'immagine seguente. Se si verifica un errore, ad esempio "Errore durante l'impostazione del riquadro", verifica di aver configurato correttamente la superficie, inclusa la dichiarazione della superficie nel manifest.

    Pulsante Esegui nel margine accanto a una classe WatchFaceService.
    Figura 1. Esegui una superficie Wear OS direttamente utilizzando l'icona della barra laterale.