Creare e modificare le configurazioni di esecuzione/debug

Quando esegui, sottoponi a debug o verifichi il tuo codice, Android Studio utilizza un'istanza di esecuzione/debug configurazione per determinare come eseguire l'operazione. In genere, configurazione iniziale sia sufficiente per eseguire eseguire il debug di un'app. Tuttavia, puoi modificare e creare nuove configurazioni, nonché modificare più adatti 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 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 Seleziona l'elenco a discesa Esegui/Debug configurazione 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 un'esecuzione/debug per l'attività principale basata sul modello di app Android. Per eseguire o eseguire il debug del tuo 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 di controllo della versione. Per ulteriori informazioni su come condividere una configurazione, consulta Opzioni di configurazione dei nomi e della condivisione.

Apri la finestra di dialogo Configurazioni Esegui/Debug

Per aprire la finestra di dialogo Esegui/configurazioni di debug: seleziona Esegui > Modifica configurazioni. La 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 una nuova configurazione di esecuzione/debug

Puoi definire nuove configurazioni di esecuzione/debug dal menu Esegui/Debug Configurazioni, la finestra Progetto o la finestra Codice Editor. 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 di configurazione dei modelli. Puoi avviare una nuova configurazione direttamente da un modello o da un 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 sezione Progetto finestra per creare automaticamente una configurazione specifica per l'elemento. Per Ad esempio, per eseguire una determinata attività, puoi fare clic con il tasto destro del mouse file Java delle attività e seleziona Esegui. A seconda dell'elemento, Android Studio utilizza un'app per Android, Test strumentati Android o JUnit di configurazione del deployment per creare la configurazione.

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

Quando crei una configurazione al di fuori del campo Esegui/Debug Configurazioni, la configurazione è temporanea a meno che non lo 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 di 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:

  1. Apri il comando Esegui/Debug Finestra di dialogo Configurazioni.
  2. Fai clic su Aggiungi nuova configurazione .
  3. Seleziona un modello di configurazione.
  4. Digita un nome nel campo Nome.
  5. Modifica la configurazione in base alle tue esigenze.
  6. Assicurati di correggere gli eventuali errori visualizzati nella parte inferiore della finestra di dialogo.

  7. Fai clic su Applica o OK.

Avvia una configurazione da una copia

definire una configurazione di esecuzione/debug a partire da una copia di un altro segui questi passaggi:

  1. Apri il comando Esegui/Debug Finestra di dialogo Configurazioni.
  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 tue 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 in il progetto

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

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

  1. Aprire un progetto in Android o vista progetto.
  2. 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.
  3. Apri l'elenco a discesa Seleziona configurazione esecuzione/debug nella barra degli strumenti.
  4. Seleziona Save Configuration (Salva configurazione) dalle opzioni accanto alla configurazione. 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 metodo

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

Android Studio utilizza Android Instrumented Tests o Android JUnit modello, a seconda della fonte impostata. Per un test delle unità locali, puoi facoltativamente eseguire il codice dell'audiodescrizione.

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

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

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

  8. 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 nella .
  9. Apri l'elenco a discesa Seleziona configurazione esecuzione/debug nella barra degli strumenti.
  10. Seleziona Save Configuration (Salva configurazione) dalle opzioni accanto alla configurazione. 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 eseguirla eseguire il debug dell'app.

Per utilizzare una configurazione di esecuzione/debug salvata:

  1. Seleziona la configurazione di esecuzione/debug da Seleziona configurazione di esecuzione/debug nell'elenco a discesa nella barra degli strumenti.
  2. L'elenco a discesa si trova a sinistra di Esegui. e Debug ; ad esempio .

  3. Seleziona Esegui > Corsa o Esegui > Debug.
  4. In alternativa, fai clic su Esegui oppure Debug .

Modificare una configurazione di esecuzione/debug

Per modificare una configurazione di esecuzione/debug:

  1. Apri il comando Esegui/Debug Finestra di dialogo Configurazioni.
  2. Seleziona una configurazione nel riquadro a sinistra.
  3. Modifica la configurazione in base alle tue esigenze.
  4. Assicurati di correggere gli eventuali errori visualizzati nella parte inferiore della finestra di dialogo.

  5. 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 alle tue il processo di sviluppo. La modifica di un modello non influisce su quelli esistenti configurazioni che utilizzano il modello. Ad esempio, se devi creare un'etichetta configurazioni di un certo tipo, puoi modificare il modello e modificarla 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, procedi nel seguente modo:

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

  6. Fai clic su Applica o OK.

Ordina e raggruppa configurazioni

Nella finestra di dialogo Configurazioni esecuzione/debug, puoi ordinare configurazioni per trovarli rapidamente. Puoi ordinare gli elementi nella la cartella in ordine alfabetico e crearne di nuove per raggruppare le configurazioni.

Per ordinare le configurazioni in ordine alfabetico:

  1. Apri il comando Esegui/Debug Finestra di dialogo Configurazioni.
  2. Seleziona una cartella che contiene configurazioni.
  3. Fai clic su Configurazioni di ordinamento .
  4. Fai clic su OK per chiudere la finestra di dialogo.

Per raggruppare le configurazioni in cartelle:

  1. Apri il comando Esegui/Debug Finestra di dialogo Configurazioni.
  2. Seleziona una cartella che contiene 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 nella cartella gli elementi della stessa categoria di modello.
  • Ordina le cartelle e le configurazioni nella stessa categoria di modelli per trascinandole in posizione.
  • Fai clic su OK per chiudere la finestra di dialogo.
  • Definisci prima del lancio suite operativa

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

    Nota: la definizione delle attività prima del lancio è una funzionalità avanzata. Invece di funzione, ti consigliamo di inserire qualsiasi logica di preparazione come attività build.gradle, in modo che vengano eseguite durante la creazione dalla riga di comando.

    Per creare un elenco di attività:

    1. Nella parte inferiore della finestra di dialogo Configurazioni esecuzione/debug, in Prima del lancio (potrebbe essere necessario scorrere verso il basso), fai clic su Aggiungi e seleziona un tipo di attività. Se si apre una finestra di dialogo, compila i campi e fai clic su OK.
    2. Aggiungi altre attività in base alle esigenze.
    3. Per ordinare le attività, trascinale o selezionane una e fai clic su Su e Freccia giù per spostarla in alto o in basso nell'elenco.
    4. Seleziona Mostra questa pagina se vuoi visualizzare il comando run/debug le impostazioni di configurazione prima di applicarle.

      Questa opzione è deselezionata per predefinito.

    5. Seleziona Finestra degli strumenti attivi se vuoi che Corsa o Debug da attivare 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 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 sezione Esterni Strumenti, seleziona una o più applicazioni che vuoi eseguire e fai clic su OK. Se l'applicazione non è definita in Android Studio, aggiungi la relativa definizione nella sezione Crea Finestra di dialogo Strumenti. Per ulteriori informazioni, consulta Configurazione Strumenti di terze parti ed esterni Strumenti.
    Esegui un'altra configurazione Esegui una delle configurazioni di esecuzione/debug esistenti. Nella Scegli la finestra di dialogo Scegli la configurazione per eseguire e seleziona una configurazione. per eseguire l'operazione, quindi fai clic su OK.
    Crea Compila il progetto o il modulo. Android Studio esegue Make Comando del modulo se la configurazione di esecuzione/debug specifica un determinato modulo, oppure esegue il comando Make Comando Progetto se non vengono specificati moduli.
    Crea progetto Compila il progetto. Android Studio esegue Make progetto.
    Esegui, nessun controllo degli errori Questa opzione è uguale a Crea, ad eccezione del fatto che per Android Studio esegue la configurazione di esecuzione/debug indipendentemente dalla compilazione o il risultato finale.
    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 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 a Sviluppo di Android con Android Studio:

    Nota: Android Studio 2.1.x e versioni precedenti avevano un Modello di applicazione, che non sono presenti nelle versioni più recenti. Se hai un modello di applicazione nativa in un progetto, Android Studio lo converte in un'app per Android quando lo carichi. 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 allo sviluppo di 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 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 un file XML file nella cartella project_directory/.idea/runConfigurations/. Per ulteriori informazioni, vedi Formato basato su directory nella documentazione dei progetti IntelliJ.

    App Android

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

    Scheda Generali

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

    Campo Descrizione
    Modulo Seleziona uno modulo a cui applicare questa configurazione.
    Opzioni di installazione: deployment

    Seleziona un'opzione:

    • APK predefinito. Crea e implementa un APK per il tuo variante attualmente selezionata.
    • APK da app bundle. Crea e implementa l'app da un Android App Bundle. Vale a dire, Android Studio converte innanzitutto il progetto dell'app in un app bundle che include tutto il codice compilato dell'app e Google Cloud. Da questo app bundle, Android Studio genera solo gli APK necessari. per eseguire il deployment dell'app sul dispositivo connesso. In genere questa opzione è consigliata per il test che intendi caricare su Google Play perché il deployment da un app bundle estende la tempo di compilazione totale.
    • Artefatto personalizzato: non supportato in Android Studio.
    • Niente. Non installare un APK su un dispositivo. Ad esempio, se preferisci 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, significa che puoi aggiungere il supporto per le app istantanee. quando crei un nuovo progetto o ne crei uno o più ad attivazione istantanea moduli di funzionalità: puoi scegliere di eseguire il deployment dei moduli ad attivazione istantanea controllando il 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 distribuisci la tua app. Vedi questa opzione solo se la tua app include moduli delle funzionalità.

    Nota: se vuoi testare il download e l'installazione dei moduli delle funzionalità su domanda, devi farlo dopo aver pubblicato l'app bundle e poi aver usato Play Console canale di test interno. Per saperne di più, leggi Caricare l'app bundle su Google Play Google Cloud.

    Opzioni di installazione: installazione di flag Digita le opzioni pm install ADB che vuoi utilizzare. Formatta le opzioni come faresti la 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 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 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: consente di avviare una determinata attività dell'app nel modulo. Quando questa opzione è selezionata, viene visualizzato il campo Attività di seguito, dove puoi digitare il nome del l'attività che desideri avviare o fai 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. Puoi utilizzarlo anche per testare 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. Ad esempio:

    -W

    Questa opzione non viene visualizzata se hai scelto il valore Avvia Niente.

    Predefinito: nessuna opzione.

    Opzioni di destinazione dell'implementazione: target

    Seleziona un'opzione:

    • Apri la finestra di dialogo Seleziona destinazione deployment: apri la finestra Seleziona deployment Scegli come target 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 selezionare li annotino.
    • Emulatore: utilizza un dispositivo virtuale. In una configurazione, puoi selezionare una durata di visualizzazione media; altrimenti utilizza solo la prima durata di visualizzazione media 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, il pulsante Seleziona Viene visualizzata la finestra di dialogo Deployment per consentirti di selezionare un dispositivo. Quando selezioni questa opzione ed esegui un'app, viene visualizzata la finestra di dialogo Seleziona deployment in cui puoi selezionare un dispositivo. Poi, ogni volta che esegui l'app, questa viene avviata sul dispositivo selezionato senza visualizzare Finestra di dialogo Seleziona Deployment. Per eseguire l'app su un altro dispositivo, deseleziona Usa stesso dispositivo per lanci futuri oppure interrompi l'app con Esegui > Interrompi app o Interrompi , e poi riavviarla di nuovo. Viene visualizzata la finestra di dialogo Seleziona deployment in cui puoi selezionare un dispositivo.
    Prima del lancio Consulta la sezione Definire le impostazioni prima del lancio Suite operativa.

    Scheda Varie

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

    Campo Descrizione
    Logcat: mostra logcat automaticamente Quando questa opzione è selezionata, la finestra Logcat si apre ogni volta di aver implementato e avviare 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 da sessioni precedenti dal file di log prima di avviare l'app. Impostazione predefinita: deselezionato.
    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, e poi deseleziona questa opzione. Predefinita: selezionata
    Opzioni di installazione: forza l'interruzione dell'esecuzione dell'applicazione prima dell'avvio attività

    Se questa opzione è selezionata, quando Android Studio rileva che non è necessario reinstallare un APK perché non è cambiato, l'app verrà arrestata forzatamente in modo che l'app viene avviata dall'attività predefinita in Avvio applicazioni. Se questa opzione è deselezionata, Android Studio non forza l'interruzione dell'app.

    Questa opzione funziona con l'opzione precedente, che controlla se se un APK è installato o meno. Per entrambe le opzioni di installazione lascia i valori predefiniti, a meno che tu non voglia esplicitamente forzare l'installazione ogni volta.

    In alcuni casi potresti voler deselezionare questa opzione. Ad esempio, se stai scrivere un motore del metodo di input (IME), l'arresto forzato dell'app lo deseleziona tastiera attuale, cosa che potrebbe non interessare.

    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 Nell'interfaccia utente di Android Studio, la finestra di debug ha una scheda LLDB che consente di inserire comandi LLDB durante il debug. Puoi inserire gli stessi comandi usate da Android Studio per visualizzare le informazioni nell'interfaccia utente del debugger e puoi eseguire operazioni aggiuntive.

    Per i progetti C e C++, puoi aggiungere directory di simboli, nonché istruzioni di avvio e i comandi post attach, nella scheda Debugger. Per farlo, utilizzi simili ai seguenti:

    • Aggiungi - Aggiungi una directory o un comando.
    • Rimuovi - Seleziona una directory o un comando e fai clic su questo pulsante per rimuovere l'elemento.
    • In aumento di - Seleziona una directory o un comando e fai clic su questo pulsante per spostare l'elemento in alto dall'elenco.
    • In calo - Seleziona una directory o un comando e fai clic su questo pulsante per spostare l'elemento in basso dall'elenco.

    Consulta la sezione Debug 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 la il tipo di debug giusto per il tuo progetto.

    Directory dei simboli

    Se vuoi aggiungere file di simboli per fornire al debugger con C o C++ generate al di fuori di Android Studio, puoi aggiungere uno o più directory qui. Android Studio utilizza preferibilmente qualsiasi file all'interno di questi le directory sui file generati Android Plug-in 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, inserisci le directory utilizzata più spesso in cima all'elenco.

    Se specifichi una directory nella parte superiore della struttura, la ricerca in tutti i pod può richiedere più tempo nelle sottodirectory. Se aggiungi una directory molto specifica, occorre meno tempo eseguire una ricerca. Devi trovare il giusto equilibrio tra velocità e ricerca dei file necessario per il debug. Ad esempio, se hai una directory che contiene per le varie sottodirectory Programma binario Android interfacce (ABI), puoi scegliere di aggiungere una directory per un'ABI specifica per tutte le ABI. Anche se la ricerca nel livello superiore può richiedere più tempo è anche più infallibile se decidi di eseguire il debug su dispositivo.

    Tieni presente che non è necessario aggiungere directory contenenti i file di simboli Gradle perché il debugger li utilizza automaticamente.

    Comandi di avvio LLDB

    Aggiungi i comandi LLDB da eseguire prima del collegamento del debugger al processo. Per Ad esempio, puoi definire le impostazioni per l'ambiente, come illustrato :

    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 da eseguire subito dopo 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 host Specifica la directory di lavoro LLDB.
    Logging: canali target

    Specifica le opzioni di log LLDB. Android Studio imposta le opzioni predefinite in base sull'esperienza del team, quindi non è troppo lento ma contiene le informazioni necessarie. per la risoluzione dei problemi. Il log viene spesso richiesto per il bug di Android Studio report. 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 uno specifico platform:

    lldb process platform:gdb-remote packets

    Per un elenco completo dei log inserisci il comando log list da una finestra della shell LLDB nel Android Studio.

    Android Studio inserisce i log del dispositivo nella seguente posizione, dove ApplicationId è l'ID applicazione univoco usato nel file manifest dell'APK creato e identifica il tuo sul tuo dispositivo e nel Google Play Store:

    /data/data/ApplicationId/lldb/log

    Oppure, se se più utenti accedono a un dispositivo, i log vengono inseriti nella seguente posizione, dove AndroidUserId è un identificatore univoco di un utente nella 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 Definire le impostazioni prima del lancio Suite operativa.

    Scheda Profilazione

    È necessario selezionare l'opzione Attiva profilazione avanzata per attivare determinate in Android Profiler il tuo dispositivo ha Android 7.1 o versioni precedenti.

    Test Android

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

    Nota: se utilizzi Firebase Test Lab per eseguire test su una varietà di dispositivi, puoi utilizzare la JUnit per Android per definire i test instrumentati. Per ulteriori informazioni, consulta la sezione Esecuzione dei test. con Firebase Test Lab.

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

    Scheda Generali

    Nella scheda Generale, puoi specificare la località per il test, runner di strumentazione, adb shell e opzioni di deployment.

    Campo Descrizione
    Modulo 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 nella Pacchetto. Digita il nome o fai clic su Altro per selezionare il pacchetto da una finestra di dialogo.
    • Corso - Avvio dei test del corso specificato nel Corso . Digita il nome o fai clic su Altro per selezionare il corso da una finestra di dialogo.
    • Metodo: avvia un metodo di test. Nel campo Class, specifica la classe che contiene il metodo. Nel campo Metodo, specificare 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 della strumentazione. runner; fai clic su Altro per utilizzare una finestra di dialogo. La Il file build.gradle specifica la posizione della strumentazione runner; questo valore lo sostituisce. In genere, il valore predefinito è 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 per passare 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 Seleziona deployment Scegli come target 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 selezionare li annotino.
    • Emulatore: utilizza un dispositivo virtuale. In una configurazione, puoi selezionare una durata di visualizzazione media; altrimenti utilizza solo la prima durata di visualizzazione media dell'elenco.
    • Matrice dei dispositivi di Firebase Test Lab - Consulta Corsa I tuoi test con Firebase Test Lab.
    Opzioni di destinazione dell'implementazione: utilizza lo stesso dispositivo per lanci futuri Se desideri utilizzare automaticamente il dispositivo scelto tramite In futuro, seleziona questa finestra di dialogo Seleziona il target del deployment, . Se il dispositivo non è disponibile, verrà visualizzata una finestra di dialogo. Valore predefinito: deselezionato
    Prima del lancio Consulta la sezione Definire le impostazioni prima del lancio Suite operativa.

    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 da sessioni precedenti dal file di log prima di avviare l'app. Impostazione predefinita: deselezionato.
    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 non venga modificato. Se vuoi che Android Studio forzi l'installazione dell'APK: anche se non è cambiata, deseleziona questa opzione. Predefinita: selezionata
    Opzioni di installazione: forza l'interruzione dell'esecuzione dell'applicazione prima dell'avvio attività

    Se questa opzione è selezionata, quando Android Studio rileva che non è necessario reinstallare un APK perché non è cambiato, l'app verrà arrestata forzatamente in modo che l'app viene avviata dall'attività predefinita in Avvio applicazioni. Se questa opzione è deselezionata, Android Studio non forza l'interruzione dell'app.

    Questa opzione funziona in combinazione con l'opzione precedente che controlla se se un APK è installato o meno. Per entrambe le opzioni di installazione lascia i valori predefiniti, a meno che tu non voglia esplicitamente forzare l'installazione ogni volta.

    In alcuni casi potresti voler deselezionare questa opzione. Ad esempio, se stai scrivere un motore del metodo di input (IME), l'arresto forzato dell'app lo deseleziona tastiera attuale, cosa che potrebbe non interessare.

    Predefinita: selezionata

    Prima del lancio Consulta la sezione Definire le impostazioni prima del lancio Suite operativa.

    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 Nell'interfaccia utente di Android Studio, la finestra di debug ha una scheda LLDB che consente di inserire comandi LLDB durante il debug. Puoi inserire gli stessi comandi usate da Android Studio per visualizzare le informazioni nell'interfaccia utente del debugger e puoi eseguire operazioni aggiuntive.

    Per i progetti C e C++, puoi aggiungere directory di simboli, nonché istruzioni di avvio e i comandi post attach, nella scheda Debugger. Per farlo, utilizzi simili ai seguenti:

    • Aggiungi - Aggiungi una directory o un comando.
    • Rimuovi - Seleziona una directory o un comando e fai clic su questo pulsante per rimuovere l'elemento.
    • In aumento di - Seleziona una directory o un comando e fai clic su questo pulsante per spostare l'elemento in alto dall'elenco.
    • In calo - Seleziona una directory o un comando e fai clic su questo pulsante per spostare l'elemento in basso dall'elenco.

    Consulta la sezione Debug 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 la il tipo di debug giusto per il tuo progetto.

    Directory dei simboli

    Se vuoi aggiungere file di simboli per fornire al debugger con C o C++ generate al di fuori di Android Studio, puoi aggiungere uno o più directory qui. Android Studio utilizza preferibilmente qualsiasi file all'interno di questi le directory sui file generati Android Plug-in 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, inserisci le directory utilizzata più spesso in cima all'elenco.

    Se specifichi una directory nella parte superiore della struttura, la ricerca in tutti i pod può richiedere più tempo nelle sottodirectory. Se aggiungi una directory molto specifica, occorre meno tempo eseguire una ricerca. Devi trovare il giusto equilibrio tra velocità e ricerca dei file necessario per il debug. Ad esempio, se hai una directory che contiene per le varie sottodirectory Programma binario Android interfacce (ABI), puoi scegliere di aggiungere una directory per un'ABI specifica per tutte le ABI. Anche se la ricerca nel livello superiore può richiedere più tempo è anche più infallibile se decidi di eseguire il debug su dispositivo.

    Tieni presente che non è necessario aggiungere directory contenenti i file di simboli Gradle perché il debugger li utilizza automaticamente.

    Comandi di avvio LLDB

    Aggiungi i comandi LLDB da eseguire prima del collegamento del debugger al processo. Per Ad esempio, puoi definire le impostazioni per l'ambiente, come illustrato :

    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 da eseguire subito dopo 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 host Specifica la directory di lavoro LLDB.
    Logging: canali target

    Specifica le opzioni di log LLDB. Android Studio imposta le opzioni predefinite in base sull'esperienza del team, quindi non è troppo lento ma contiene le informazioni necessarie. per la risoluzione dei problemi. Il log viene spesso richiesto per il bug di Android Studio report. 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 uno specifico platform:

    lldb process platform:gdb-remote packets

    Per un elenco completo dei log inserisci il comando log list da una finestra della shell LLDB nel Android Studio.

    Android Studio inserisce i log del dispositivo nella seguente posizione, dove ApplicationId è l'ID applicazione univoco usato nel file manifest dell'APK creato e identifica il tuo sul tuo dispositivo e nel Google Play Store:

    /data/data/ApplicationId/lldb/log

    Oppure, se se più utenti accedono a un dispositivo, i log vengono inseriti nella seguente posizione, dove AndroidUserId è un identificatore univoco di un utente nella 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 Definire le impostazioni prima del lancio Suite operativa.

    DevAppServer di App Engine

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

    Tieni presente che l'app IntellJ IDEA Engine Server è un modello diverso non disponibile in Android Studio.

    Campo Descrizione
    Solo istanza singola Se vuoi assicurarti che solo un'istanza del comando run/debug configurazione attualmente in esecuzione, seleziona questa opzione. Non consente è in grado di eseguire più esecuzioni contemporaneamente della stessa configurazione. Predefinita: selezionata
    Modulo Seleziona un modulo. a cui applicare questa configurazione.
    Sincronizzazione con la configurazione build.gradle Se aggiungi un modulo di App Engine ed esegui la sincronizzazione con build.gradle i campi di configurazione di App Engine DevAppServer vengono compilati automaticamente (consigliato). Selezionando File > Sync Project with Gradle Files consente inoltre di sincronizzare il progetto. Predefinita: selezionata
    SDK App Engine Digita il percorso di un indirizzo SDK App Engine per Java sulla macchina locale. Fai clic su ... per selezionarla da una finestra di dialogo.
    Percorso di guerra Digita un percorso dell'applicazione web Archiviare la directory (WAR) dell'app di cui stai eseguendo il deployment sulla 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 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 contiene virgolette, aggiungi una barra rovesciata prima delle virgolette. (\").

    Per ulteriori informazioni sulle opzioni della VM, consulta la documentazione per J2SE della versione precedente, come java JDK 7 e java JDK 8.

    Predefinito: nessuna opzione

    Indirizzo del server Digita l'indirizzo host da usare per il server. Potresti dover 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 al nome host. Valore predefinito: localhost
    Porta server Digita la porta. numero da usare per il server. Valore predefinito: 8080
    Disabilita il controllo degli aggiornamenti dell'SDK di App Engine Se fornito, il server di sviluppo non contattare App Engine per verificare la disponibilità di una nuova release l'SDK. Per impostazione predefinita, il server verifica la presenza di una nuova versione all'avvio e stampa un se è disponibile una nuova versione.
    Prima del lancio Consulta la sezione Definire le impostazioni prima del lancio Suite operativa.

    Configurazioni di esecuzione/debug per Wear OS

    I modelli Complicazione, Tile e Quadrante 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 alla Opzioni app per Android. Di seguito sono riportate altre opzioni specifiche per le configurazioni di esecuzione/debug di Wear OS:

    • Per tutte le configurazioni di esecuzione/debug di Wear, devi selezionare un'origine dati specifica sulle complicazioni, o il quadrante (a seconda del modello) a cui applicare la configurazione. Generalmente, ciascuna delle queste entità corrispondono a una classe nel tuo codice.
    • Per la configurazione di esecuzione/debug delle complicazioni di Wear OS, devi scegliere lo Slot dove inserire i dati sulle complicazioni forniti dall'origine dati sulle complicazioni. Puoi scegliere di inserirlo in alto, a destra, in basso, a sinistra o sullo sfondo del quadrante.
    • Per la configurazione di esecuzione/debug delle complicazioni di Wear OS, devi selezionare anche il Tipo di i dati sulle complicazioni forniti dall'origine dati sulle complicazioni. I tipi tra cui puoi scegliere sono limitati a quelli forniti dall'origine dati delle complicazioni scelta e supportati dal l'area scelta. Per un elenco dei tipi di dati relativi alle complicazioni, vedi Tipi e campi.

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

    Pulsante Esegui nel gutter accanto a una classe WatchFaceService.
    . Figura 1. Esegui una piattaforma Wear OS direttamente utilizzando l'icona grondaia.