Migliora il codice con i controlli di lint

Oltre alla creazione di test per assicurarti che la tua app soddisfi i suoi requisiti funzionali, è importante eseguire il codice anche tramite lo strumento lint per garantire che il codice non abbia per risolvere problemi di produzione e facilità d'uso. Lo strumento Lint consente di trovare codice strutturato male che può influire l'affidabilità e l'efficienza delle tue app per Android e rendere il tuo codice più difficile da gestire. Ti consigliamo vivamente di correggere eventuali errori rilevati da lint prima di pubblicare l'app.

Ad esempio, se i file di risorse XML contengono spazi dei nomi inutilizzati, questo occupa spazio e richiede l'elaborazione non necessaria. Altri problemi strutturali, come l'utilizzo di elementi deprecati o chiamate API che non sono supportate dalle versioni dell'API target, potrebbero causare un errore di esecuzione del codice. Lint può aiutarti a risolvere questi problemi.

Per migliorare le prestazioni dei lint, puoi anche aggiungere annotazioni al codice.

Panoramica

Android Studio offre uno strumento di scansione del codice chiamato lint che può aiutarti a identificare e correggere i problemi relativi alla qualità strutturale del codice senza dover eseguire l'app o scrivere scenari di test. Ogni problema rilevato dallo strumento viene segnalato con un messaggio descrittivo e un livello di gravità, in modo da poter dare la priorità i miglioramenti critici da apportare. Puoi anche ridurre il livello di gravità di un problema a ignora i problemi che non sono pertinenti al tuo progetto o aumenta il livello di gravità a per evidenziare problemi specifici.

Lo strumento Lint controlla i file di origine dei progetti Android per individuare potenziali bug. miglioramenti dell'ottimizzazione per correttezza, sicurezza, prestazioni, usabilità, accessibilità e internazionalizzazione. Quando usi Android Studio, le ispezioni lint e IDE configurate vengono eseguite quando crei l'app. Tuttavia, puoi eseguire le ispezioni manualmente esegui lint dalla riga di comando, come descritto in questa pagina.

Lo strumento Lint integrato controlla il codice mentre utilizzi Android Studio. Puoi visualizzare avvisi ed errori in due modi:

  • Come testo popup nella finestra dell'editor. Quando lint trova un problema, evidenzia il codice problematico in giallo. In caso di problemi più gravi, sottolinea il codice in rosso.
  • Nella finestra Risultati ispezione lint quando fai clic su Codice > Ispeziona il codice.

Nota: quando il codice viene compilato in Android Studio, vengono aggiunte altre Esecuzione di ispezioni del codice Intelligence per semplificare il codice per la revisione.

La figura 1 mostra in che modo lo strumento Lint elabora i file di origine delle app.

Flusso di lavoro di scansione del codice con lo strumento Lint.
Figura 1. Flusso di lavoro di scansione del codice con lint strumento di authoring.
File di origine delle app
I file sorgente sono costituiti dai file che compongono il tuo progetto Android, inclusi Kotlin, Java e File XML, icone e file di configurazione ProGuard.
Il file lint.xml
Un file di configurazione che puoi usare per specificare i controlli lint che vuoi escludere e personalizzare i livelli di gravità dei problemi.
Lo strumento Lint
Uno strumento di scansione statico del codice che puoi eseguire nel tuo progetto Android tramite dalla riga di comando Android Studio. Il pelucchi verifica la presenza di problemi strutturali di codice che potrebbero influire sulla qualità e sulle prestazioni del App per Android.
di Gemini Advanced.
Risultati del controllo lint
Puoi visualizzare i risultati di lint nella console o nella sezione Risultati ispezione in Android Studio. Se esegui lint dalla riga di comando, i risultati sono vengono scritte nella cartella build/. Per ulteriori dettagli, consulta la sezione su eseguire ispezioni manualmente.

Esegui lint dalla riga di comando

Se utilizzi Android Studio o Gradle, usa il wrapper Gradle per richiamare l'attività lint per il progetto inserendo uno dei seguenti comandi dalla directory radice del progetto:

  • Su Windows:
    gradlew lint
    
  • Su Linux o macOS:
    ./gradlew lint
    

Dovresti vedere un output simile al seguente:

> Task :app:lintDebug
Wrote HTML report to file:<path-to-project>/app/build/reports/lint-results-debug.html

Quando lo strumento Lint completa i controlli, fornisce i percorsi ai file XML e HTML tutte le versioni del report lint. Puoi quindi andare al report HTML e aprirlo nel tuo browser. come mostrato nella Figura 2.

Esempio di report lint HTML
Figura 2. Esempio di report lint HTML.

Se il progetto include build varianti, lint controlla solo la variante predefinita. Se vuoi eseguire lint su un altro la variante, devi scrivere in maiuscolo il nome della variante e anteporre lint.

./gradlew lintRelease

Per scoprire di più sulla corsa, Attività Gradle dalla riga di comando, leggi Creare un'app dalla riga di comando.

Esegui lint utilizzando lo strumento autonomo

Se non utilizzi Android Studio o Gradle, Installare gli strumenti a riga di comando dell'SDK per Android per usare lo strumento Lint autonomo. Individuare lo strumento Lint alle ore android_sdk/cmdline-tools/version/bin/lint.

Nota:se tenti di eseguire lo strumento autonomo su un progetto Gradle, ottieni un errore. Dovresti usare sempre gradle lint (su Windows) o ./gradlew lint (su macOS o Linux) per eseguire lint su un progetto Gradle.

Per eseguire lint su un elenco di file in una directory di progetto, usa il comando seguente:

lint [flags] <project directory>

Ad esempio, puoi inviare il seguente comando per eseguire la scansione dei file nel Directory myproject e relative sottodirectory. ID problema MissingPrefix indica a lint di analizzare solo gli attributi XML privi del prefisso dello spazio dei nomi Android.

lint --check MissingPrefix myproject 

Per visualizzare l'elenco completo dei flag e degli argomenti della riga di comando supportati dallo strumento, utilizza seguente comando:

lint --help

L'esempio seguente mostra l'output della console quando il comando lint viene eseguito su un progetto chiamato Earthquake:

$ lint Earthquake

Scanning Earthquake: ...............................................................................................................................
Scanning Earthquake (Phase 2): .......
AndroidManifest.xml:23: Warning: <uses-sdk> tag appears after <application> tag [ManifestOrder]
  <uses-sdk android:minSdkVersion="7" />
  ^
AndroidManifest.xml:23: Warning: <uses-sdk> tag should specify a target API level (the highest verified version; when running on later versions, compatibility behaviors may be enabled) with android:targetSdkVersion="?" [UsesMinSdkAttributes]
  <uses-sdk android:minSdkVersion="7" />
  ^
res/layout/preferences.xml: Warning: The resource R.layout.preferences appears to be unused [UnusedResources]
res: Warning: Missing density variation folders in res: drawable-xhdpi [IconMissingDensityFolder]
0 errors, 4 warnings

L'output di esempio elenca quattro avvisi senza errori.

Due avvisi riguardano il file AndroidManifest.xml del progetto:

  • ManifestOrder
  • UsesMinSdkAttributes
di Gemini Advanced. Un avviso riguarda il file di layout Preferences.xml: UnusedResources.

Un avviso riguarda la directory res: IconMissingDensityFolder.

Configura il lint per eliminare gli avvisi

Per impostazione predefinita, quando esegui una scansione lint lo strumento controlla tutti i problemi supportati da lint. Puoi anche limitare i problemi da verificare per il lint e assegnare la gravità i livelli di sicurezza. Ad esempio, puoi eliminare il controllo lint per problemi specifici che non sono pertinenti al tuo progetto e puoi configurare lint per segnalare problemi non critici in con un livello di gravità inferiore.

I livelli di gravità sono:

  • enable
  • disable o ignore
  • informational
  • warning
  • error
  • fatal

Puoi configurare il controllo lint per diversi livelli:

  • A livello globale (intero progetto)
  • Modulo Progetto
  • Modulo Produzione
  • Modulo di test
  • Apri i file
  • Gerarchia delle classi
  • Ambiti del sistema di controllo delle versioni (VCS)

Configura il file lint

Puoi specificare le preferenze di controllo lint nel file lint.xml. Se stai creando questo file manualmente, inseriscilo nella directory principale del tuo progetto Android.

Il file lint.xml è costituito da un tag principale <lint> che include contiene uno o più elementi <issue> secondari. Lint definisce un valore Valore dell'attributo id per ogni <issue>:

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- list of issues to configure -->
</lint>

Per modificare il livello di gravità di un problema o disattivare il controllo lint per il problema: Imposta l'attributo gravità nel tag <issue>.

Suggerimento:per un elenco completo dei problemi supportati da lint e i relativi problemi ID problema, esegui il comando lint --list.

File lint.xml di esempio

L'esempio seguente mostra i contenuti di un file lint.xml:

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- Disable the IconMissingDensityFolder check in this project -->
    <issue id="IconMissingDensityFolder" severity="ignore" />

    <!-- Ignore the ObsoleteLayoutParam issue in the specified files -->
    <issue id="ObsoleteLayoutParam">
        <ignore path="res/layout/activation.xml" />
        <ignore path="res/layout-xlarge/activation.xml" />
    </issue>

    <!-- Ignore the UselessLeaf issue in the specified file -->
    <issue id="UselessLeaf">
        <ignore path="res/layout/main.xml" />
    </issue>

    <!-- Change the severity of hardcoded strings to "error" -->
    <issue id="HardcodedText" severity="error" />
</lint>

Questo esempio mostra come vengono segnalati i diversi tipi di problemi. La IconMissingDensityFolder il controllo è completamente disattivato e il controllo ObsoleteLayoutParam è disattivato solo nei file specificati nelle dichiarazioni <ignore ... /> allegate.

Configura il controllo lint per i file di origine Kotlin, Java e XML

Puoi disattivare il controllo lint per i file sorgente Kotlin, Java e XML. Nella finestra di dialogo Preferenze:

  1. Seleziona File > Impostazioni (su Windows) o Android Studio > Preferenze (su macOS o Linux).
  2. Seleziona Editor > Ispezioni.
  3. Per disattivarla, deseleziona il file di origine appropriato.

Puoi impostarle per l'IDE o per singoli progetti selezionando il profilo appropriato.

Configura il controllo lint in Java o Kotlin

Per disattivare il controllo lint specificatamente per una classe o un metodo nel tuo progetto Android: aggiungi l'annotazione @SuppressLint al codice.

L'esempio seguente mostra come disattivare il controllo lint per NewApi nel metodo onCreate. Lo strumento Lint continua a controllare NewApi problema in altri metodi di questa classe.

Kotlin

@SuppressLint("NewApi")
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main)

Java

@SuppressLint("NewApi")
@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

Lo stesso può essere fatto su qualsiasi componibile. Il seguente snippet di codice mostra come attivare controlli NewApi su qualsiasi componibile.

Kotlin

  @SuppressLint("NewApi")
  @Composable
  fun MyComposable{
    ...
  }
  

L'esempio seguente mostra come disattivare il controllo lint per ParserError problema nella classe FeedProvider:

Kotlin

@SuppressLint("ParserError")
class FeedProvider : ContentProvider() {

Java

@SuppressLint("ParserError")
public class FeedProvider extends ContentProvider {

Per evitare il controllo di tutti i problemi di lint nel file, utilizza la parola chiave all:

Kotlin

@SuppressLint("all")

Java

@SuppressLint("all")

Puoi utilizzare la stessa annotazione per eliminare i controlli lint su qualsiasi funzione componibile.

Configura il controllo dei lint in XML

Utilizza l'attributo tools:ignore per disattivare il controllo lint per specifiche dei tuoi file XML. Inserisci il seguente valore dello spazio dei nomi nel file lint.xml in modo che lo strumento lint riconosca l'attributo:

namespace xmlns:tools="http://schemas.android.com/tools"

L'esempio seguente mostra come disattivare il controllo lint per Problema UnusedResources in un elemento <LinearLayout> di un XML di layout. L'attributo ignore viene ereditato dagli elementi secondari dell'elemento principale in cui viene dichiarato l'attributo. In questo esempio, il controllo lint è disabilitato anche per elemento secondario <TextView>:

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    tools:ignore="UnusedResources" >

    <TextView
        android:text="@string/auto_update_prompt" />
</LinearLayout>

Per disattivare più di un problema, elencali in una stringa separata da virgole. Per esempio:

tools:ignore="NewApi,StringFormatInvalid"

Per evitare il controllo di tutti i problemi di lint nell'elemento XML, utilizza all parola chiave:

tools:ignore="all"

Configura le opzioni lint con Gradle

Il plug-in Android per Gradle consente di configurare determinate opzioni lint, ad esempio quali controlli eseguire o ignorare, utilizzando il parametro Blocco lint{} a livello di modulo build.gradle file.

Il seguente snippet di codice mostra alcune le proprietà che puoi configurare:

Kotlin

android {
    ...
    lint {
        // Turns off checks for the issue IDs you specify.
        disable += "TypographyFractions" + "TypographyQuotes"
        // Turns on checks for the issue IDs you specify. These checks are in
        // addition to the default lint checks.
        enable += "RtlHardcoded" + "RtlCompat" + "RtlEnabled"
        // To enable checks for only a subset of issue IDs and ignore all others,
        // list the issue IDs with the 'check' property instead. This property overrides
        // any issue IDs you enable or disable using the properties above.
        checkOnly += "NewApi" + "InlinedApi"
        // If set to true, turns off analysis progress reporting by lint.
        quiet = true
        // If set to true (default), stops the build if errors are found.
        abortOnError = false
        // If set to true, lint only reports errors.
        ignoreWarnings = true
        // If set to true, lint also checks all dependencies as part of its analysis.
        // Recommended for projects consisting of an app with library dependencies.
        checkDependencies = true
    }
}
...

Alla moda

android {
    ...
    lint {
        // Turns off checks for the issue IDs you specify.
        disable 'TypographyFractions','TypographyQuotes'
        // Turns on checks for the issue IDs you specify. These checks are in
        // addition to the default lint checks.
        enable 'RtlHardcoded','RtlCompat', 'RtlEnabled'
        // To enable checks for only a subset of issue IDs and ignore all others,
        // list the issue IDs with the 'check' property instead. This property overrides
        // any issue IDs you enable or disable using the properties above.
        checkOnly 'NewApi', 'InlinedApi'
        // If set to true, turns off analysis progress reporting by lint.
        quiet true
        // If set to true (default), stops the build if errors are found.
        abortOnError false
        // If set to true, lint only reports errors.
        ignoreWarnings true
        // If set to true, lint also checks all dependencies as part of its analysis.
        // Recommended for projects consisting of an app with library dependencies.
        checkDependencies true
    }
}
...

Tutti i metodi lint che sostituiscono il livello di gravità specificato di un problema rispettano in ordine di configurazione. Ad esempio, impostare un problema come irreversibile in finalizeDsl() sostituisce la disattivazione nella DSL principale.

Crea una base di riferimento per gli avvisi

Puoi creare uno snapshot dell'insieme attuale di avvisi del tuo progetto, quindi utilizzare lo snapshot come base per le esecuzioni future di ispezioni, in modo che vengano segnalati solo i nuovi problemi. Lo snapshot di base consente di iniziare a utilizzare il lint per impedire la mancata esecuzione della build senza dover per tornare indietro e risolvere tutti i problemi esistenti.

Per creare uno snapshot di riferimento, modifica il file build.gradle del progetto come segue:

Kotlin

android {
    lint {
        baseline = file("lint-baseline.xml")
    }
}

Alla moda

android {
    lintOptions {
        baseline file("lint-baseline.xml")
    }
}

Quando aggiungi per la prima volta questa riga, viene creato il file lint-baseline.xml per stabilire il tuo valore basale. Da quel momento in poi, gli strumenti si limitano a leggere il file per determinare il valore di riferimento. Se vuoi per creare una nuova base di riferimento, elimina manualmente il file ed esegui di nuovo il lint per ricrearlo.

Quindi, esegui lint dall'IDE selezionando Codice > Ispeziona codice o dalla riga di comando come segue: L'output stampa la posizione del file lint-baseline.xml. La la posizione del file per la configurazione potrebbe essere diversa da quella mostrata qui:

$ ./gradlew lintDebug -Dlint.baselines.continue=true
...
Wrote XML report to file:///app/lint-baseline.xml
Created baseline file /app/lint-baseline.xml

L'esecuzione di lint registra tutti i problemi attuali nel file lint-baseline.xml. L'insieme dei problemi attuali chiamata baseline. Puoi controllare lint-baseline.xml al controllo della versione se vuoi condividerlo con altri.

Personalizzare la base di riferimento

Se vuoi aggiungere solo determinati tipi di problemi alla base di riferimento, specifica problemi da aggiungere modificando il file build.gradle del progetto come segue:

Kotlin

android {
    lint {
        checkOnly += "NewApi" + "HandlerLeak"
        baseline = file("lint-baseline.xml")
    }
}

Alla moda

android {
    lintOptions {
        checkOnly 'NewApi', 'HandlerLeak'
        baseline file("lint-baseline.xml")
    }
}

Se aggiungi nuovi avvisi al codebase dopo aver creato la base, elenca solo i lint i bug appena introdotti.

Avviso di riferimento

Quando è attivo un valore di riferimento, ricevi un avviso informativo che indica che uno o più dati problemi sono stati esclusi perché sono elencati nella base di riferimento. Questo ti aiuta a ricordare che hai configurato una base di riferimento e che devi risolvere tutti i problemi un certo punto.

Questo avviso informativo tiene traccia anche dei problemi che non vengono più segnalati. Queste informazioni consentono se hai effettivamente risolto i problemi, quindi puoi scegliere di ricreare la base di riferimento per evitare un messaggio di errore se ritorna inosservato.

Nota: Le basi di riferimento sono abilitate quando esegui ispezioni in modalità batch nell'IDE, ma vengono ignorate per i controlli interni all'editor che vengono eseguiti in background durante la modifica di un file. Questo perché sono destinate al caso in cui un codebase abbia un gran numero di avvisi esistenti, ma vuoi risolvere i problemi localmente mentre tocchi il codice.

Eseguire le ispezioni manualmente

Per eseguire manualmente le ispezioni del lint configurato e di altri IDE, seleziona Codice > Ispeziona il codice. I risultati dell'ispezione vengono visualizzati nella sezione Finestra Risultati ispezione.

Impostare l'ambito e il profilo di ispezione

Seleziona i file da analizzare (ambito di ispezione) e le ispezioni che vuoi eseguire (il profilo di ispezione), come segue:

  1. Nella visualizzazione Android, apri il progetto e seleziona il progetto, la cartella oppure del file che vuoi analizzare.
  2. Nella barra dei menu, seleziona Codice > Ispeziona il codice.
  3. Nella finestra di dialogo Specifica ambito dell'ispezione, esamina le impostazioni.

    Specifica l&#39;ambito dell&#39;ispezione
    Figura 3. Rivedi le impostazioni dell'ambito dell'ispezione.

    Le opzioni visualizzate nella finestra di dialogo Specifica ambito dell'ispezione variano a seconda che tu abbia selezionato un progetto, una cartella o un file:

    • Quando selezioni un progetto, un file o una directory, Specifica l'ambito dell'ispezione mostra il percorso del progetto, del file la directory che hai selezionato.
    • Quando selezioni più di un progetto, file o directory, il campo Specifica Ispezione La finestra di dialogo Ambito mostra il pulsante di opzione File selezionati.

    Per cambiare cosa ispezionare, seleziona uno degli altri pulsanti di opzione. Consulta Specifica la finestra di dialogo Ambito dell'ispezione per una descrizione di tutti della finestra di dialogo Specifica ambito dell'ispezione.

  4. In Profilo di ispezione, seleziona il profilo che vuoi utilizzare.
  5. Fai clic su OK per eseguire l'ispezione.

    La figura 4 mostra l'ispezione lint e altre ispezioni IDE risultati dell'esecuzione di Esamina codice:

    Seleziona un problema per vedere come viene risolto.
    Figura 4. Risultati dell'ispezione. Seleziona un problema per vedere la risoluzione.
  6. Nel riquadro Risultati dell'ispezione, visualizza i risultati dell'ispezione espandendo e selezionando categorie, tipi o problemi di errore.

    Il riquadro Report di ispezione mostra il report di ispezione per la categoria di errore, o problema selezionato nel riquadro Risultati ispezione e mostra il nome e posizione dell'errore. Se applicabile, il report di ispezione mostra altre informazioni, come la sinossi di un problema, per aiutarti a risolverlo.

  7. Nella visualizzazione ad albero del riquadro Risultati dell'ispezione, fai clic con il tasto destro del mouse su una categoria, un tipo o un problema per Rete Display il menu contestuale.

    A seconda del contesto, puoi:

    • Passa all'origine.
    • Escludi e includi gli elementi selezionati.
    • Elimina i problemi.
    • Modifica le impostazioni.
    • Gestisci gli avvisi di ispezione.
    • Esegui di nuovo un'ispezione.

Per descrizioni dei pulsanti della barra degli strumenti, voci del menu contestuale e ispezione campi report, consulta la sezione Finestra dello strumento Risultati controllo.

Utilizza un ambito personalizzato

Utilizza uno degli ambiti personalizzati forniti in Android Studio come segue:

  1. Nella finestra di dialogo Specifica ambito di ispezione, seleziona Ambito personalizzato.
  2. Fai clic sull'elenco Ambito personalizzato per visualizzare le opzioni disponibili:

    Scegli l&#39;ambito dell&#39;ispezione
    Figura 5. Seleziona l'ambito personalizzato che vuoi per l'utilizzo.
    • Tutti i luoghi:tutti i file.
    • File di progetto: tutti i file del progetto corrente.
    • File di origine del progetto: solo i file di origine nel progetto corrente.
    • File di produzione del progetto: solo i file di produzione nel progetto corrente.
    • File di test del progetto: solo i file di test nel progetto corrente.
    • Graffi e console: solo i file scratch e le console che hai aperto nell'app progetto attuale.
    • File visualizzati di recente: solo i file visualizzati di recente nel progetto corrente.
    • File attuale: solo il file attuale nel progetto corrente. Viene visualizzato quando: un file o una cartella selezionati.
    • Directory selezionata: solo la cartella corrente nel progetto corrente. Appare quando seleziona una cartella.
    • Gerarchia dei corsi: quando selezioni questa opzione e fai clic su OK, viene visualizzata una finestra di dialogo con tutte le classi del progetto corrente. Nella finestra di dialogo, utilizza il campo Cerca per nome filtrare e selezionare i corsi da utilizzare possono essere ispezionati. Se non filtri l'elenco dei corsi, l'ispezione del codice controlla tutti i .

    Se per il progetto è configurata una VCS, sono disponibili anche opzioni per limitare la ricerca solo ai file modificati.

  3. Fai clic su OK.

Crea un ambito personalizzato

Quando vuoi esaminare una selezione di file e directory che non è coperta da nessuna delle attualmente disponibili, puoi crearne uno personalizzato:

  1. Nella finestra di dialogo Specifica ambito di ispezione, seleziona Ambito personalizzato.
  2. Fai clic sui tre puntini dopo l'elenco Ambito personalizzato.

    Finestra di dialogo Specifica l&#39;ambito dell&#39;ispezione
    Figura 6. Finestra di dialogo Specifica l'ambito dell'ispezione.

    Viene visualizzata la finestra di dialogo Ambiti.

    Crea un ambito personalizzato
    Figura 7. Crea un ambito personalizzato.
  3. Fai clic sulla nell'angolo in alto a sinistra della finestra di dialogo per definire un nuovo ambito.
  4. Nell'elenco Add Scope (Aggiungi ambito) visualizzato, seleziona Local (Locale).

    Sia gli ambiti locale che quelli condivisi vengono utilizzati all'interno del progetto per l'ispezione del codice funzionalità. Un ambito condiviso può essere utilizzato anche con altre funzionalità di progetto che hanno un ambito . Ad esempio, quando fai clic su Modifica impostazioni per modificare impostazioni per Trova utilizzi, la finestra di dialogo risultante ha un campo Ambito in cui puoi seleziona un ambito condiviso.

    Seleziona un ambito condiviso dalla finestra di dialogo Trova utilizzi
    Figura 8. Seleziona un ambito condiviso dal Finestra di dialogo Trova utilizzi.
  5. Assegna un nome all'ambito e fai clic su OK.

    Il riquadro destro della finestra di dialogo Ambiti viene compilata con opzioni che ti consentono di definire l'ambito personalizzato.

  6. Seleziona Progetto dall'elenco.

    Viene visualizzato un elenco dei progetti disponibili.

    Nota:puoi creare un ambito personalizzato per progetti o pacchetti. La passaggi sono le stesse.

  7. Espandi le cartelle del progetto, seleziona ciò che vuoi aggiungere all'ambito personalizzato se includerlo o escluderlo.

    Definisci un ambito personalizzato
    Figura 9. Definisci un ambito personalizzato.
    • Includi: includi questa cartella e i relativi file, ma non includerne nessuno sottocartelle.
    • Includi ricorsivamente: include questa cartella e i relativi file, nonché le relative sottocartelle e i relativi file. .
    • Escludi: esclude questa cartella e i relativi file, ma non escluderne nessuno sottocartelle.
    • Escludi in modo ricorsivo: escludi questa cartella e i relativi file, nonché le relative sottocartelle e i relativi file. .

    La figura 10 mostra che è inclusa la cartella main e che la cartella java Le cartelle res vengono incluse in modo ricorsivo. Il blu indica una cartella parzialmente inclusa e il verde indica l'inclusione ricorsiva di cartelle e file.

    Pattern di esempio per un ambito personalizzato
    Figura 10. Pattern di esempio per un ambito personalizzato.
    • Se selezioni la cartella java e fai clic su Escludi in modo ricorsivo, il colore verde l'evidenziazione scompare dalla cartella java e da tutte le cartelle e i file al suo interno.
    • Se selezioni il file MainActivity.kt evidenziato in verde e fai clic su Escludi, MainActivity.kt non è più evidenziato in verde, ma tutto il resto nella cartella java rimane verde.
  8. Fai clic su OK. L'ambito personalizzato viene visualizzato in fondo all'elenco.

Rivedi e modifica i profili di ispezione

Android Studio ha una selezione di lint e altri profili di ispezione che vengono aggiornati alla Aggiornamenti di Android. Puoi usare questi profili così come sono o modificarne il nome, le descrizioni, la gravità e ambiti. Puoi anche attivare e disattivare interi gruppi di profili o singoli profili all'interno di un gruppo.

Per accedere alle impostazioni di Ispezioni:

  1. Seleziona File > Impostazioni. (su Windows) o Android Studio > Preferenze (su macOS o Linux).
  2. Seleziona Editor > Ispezioni.
  3. Il riquadro Ispezioni mostra un elenco delle ispezioni supportate e i relativi descrizioni.

    Ispezioni supportate e relative descrizioni
    Figura 11. Ispezioni supportate e relative descrizioni.
  4. Seleziona l'elenco Profilo per passare tra Predefinito (Android Studio) e Ispezioni predefinite progetto (il progetto attivo).

    Per ulteriori informazioni, consulta la documentazione Pagina Gestisci profili.

  5. Nell'elenco Ispezioni nel riquadro a sinistra, seleziona una categoria di profilo di primo livello. Espandere un gruppo e selezionare un profilo specifico.

    Quando selezioni una categoria di profilo, puoi Modificare tutte le ispezioni di quella categoria come un'unica ispezione.

  6. Seleziona l'elenco Mostra azioni schema Mostra icona Azioni schema da copiare, rinominare e aggiungere e esportare e importare le ispezioni.
  7. Quando hai terminato, fai clic su OK.