Lint: basi, analizzatore statico per progetti Android

Cos'è Lint — un analizzatore statico di codice?

Android Lint è uno strumento di analisi statica incluso nell'SDK Android e in Android Studio. Lint scansiona il codice sorgente dell'applicazione senza eseguirlo e trova problemi che il compilatore ignora: risorse inutilizzate, localizzazione errata, potenziali perdite di memoria, incompatibilità API con minSdkVersion e violazioni delle raccomandazioni sulle prestazioni di Google.

L'analisi statica è un metodo di verifica del software che non richiede l'esecuzione effettiva del codice. A differenza del compilatore, che controlla solo sintassi e tipi, un analizzatore statico cerca errori logici, anti-pattern e deviazioni dalle migliori pratiche. Lint esegue oltre 200 controlli integrati per categorie: correttezza, prestazioni, sicurezza, accessibilità, usabilità e I18N.

Lint funziona a più livelli: Analisi XML controlla layout, risorse (strings, colors, dimens), il manifest e i file di configurazione. Analisi Java/Kotlin esamina il codice sorgente per chiamate API obsolete, problemi di threading e perdite di contesto. Analisi Gradle controlla la configurazione di build per la compatibilità delle versioni.

Come Lint controlla il codice dei progetti Android

Il controllo Lint viene avviato tramite Android Studio (Analyze > Inspect Code) o dal comando Gradle: ./gradlew lint. Il risultato è un report HTML nella cartella build/reports/lint-results.html e un report XML per i sistemi CI. Lint analizza ogni file indipendentemente, applicando un insieme di regole (Issues), ciascuna con un ID univoco, descrizione, categoria e livello di gravità.

Livelli di gravità di Lint: Error (blocca la build), Warning (influisce sulla qualità), Informational (per riferimento), Ignore (ignorato per impostazione predefinita). I livelli sono configurati in lint.xml. Gli errori di Lint possono essere configurati per far fallire la build Gradle quando presenti tramite lintOptions.abortOnError true.

android {
    lintOptions {
        abortOnError true
        checkAllWarnings true
        baselineFile file("lint-baseline.xml")
        htmlReport true
        xmlReport true
        lintConfig file("lint.xml")
    }
}

Lint baseline — un file che segna gli avvisi correnti come accettabili. Creato con il comando lint --baseline baseline.xml. Dopo aver aggiunto una baseline al progetto, Lint segnala solo i nuovi problemi. Questo è comodo per introdurre Lint in un progetto vecchio con centinaia di avvisi — il team corregge gli errori gradualmente.

Configurazione delle regole Lint nei file di configurazione

lint.xml — un file di configurazione nella radice del progetto per personalizzare le regole Lint. Specifica le regole ignorate, i livelli di gravità e le eccezioni per file o directory specifici. Il file viene creato manualmente e applicato globalmente a tutti i moduli del progetto. Senza lint.xml, tutte le regole funzionano con le impostazioni predefinite.

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- Disabilita controllo risorse inutilizzate -->
    <issue id="UnusedResources" severity="ignore" />

    <!-- Aumenta gravità perdita di contesto -->
    <issue id="StaticFieldLeak" severity="error" />

    <!-- Ignora nei file generati -->
    <issue id="MissingTranslation" severity="ignore">
        <ignore path="build/generated" />
    </issue>
</lint>

@SuppressLint — un'annotazione per disabilitare Lint a livello di metodo o classe in Java/Kotlin. Esempio: @SuppressLint("SetTextI18n") per un metodo in cui il testo viene impostato dinamicamente in una TextView. L'annotazione @RequiresApi specifica il livello API minimo per un metodo — Lint non emetterà un avviso se minSdk supera il valore specificato.

Esecuzione del controllo Lint in una pipeline CI/CD

L'integrazione CI di Lint è una pratica standard nello sviluppo Android. Il comando ./gradlew lint esegue l'analisi su tutti i moduli e genera report. Nelle configurazioni CI/CD (Jenkins, GitLab CI, GitHub Actions), Lint viene eseguito su ogni pull request. Se vengono trovati errori, la build fallisce e lo sviluppatore riceve una notifica con il report HTML di Lint.

lint-check:
  script:
    - ./gradlew lint
  artifacts:
    paths:
      - app/build/reports/lint-results.html
    when: always

Il report HTML di Lint contiene una tabella di tutti i problemi trovati con categoria, ID regola, file, riga e descrizione. Il report è disponibile sul server CI o pubblicato come artefatto di build. Il report XML (lint-results.xml) viene utilizzato per l'integrazione con sistemi di analisi del codice (SonarQube, CodeClimate) e la creazione automatica di attività nei tracker (Jira, YouTrack).

Lint nelle pull request — configura GitHub Actions o GitLab CI in modo che Lint venga eseguito automaticamente quando viene creato un MR/PR. Se Lint trova errori, CI restituisce uno stato di fallimento e l'unione viene bloccata. Questo impedisce al codice problematico di entrare nel ramo principale e mantiene la qualità della base di codice.

Categorie principali delle regole Lint in Android

Le categorie Lint coprono tutti gli aspetti dello sviluppo Android. Google divide le regole in 12 categorie, ciascuna responsabile di un tipo specifico di problema. Le categorie più importanti sono Correctness, Performance, Security e Accessibility. Gli sviluppatori devono conoscere i controlli chiave di ogni categoria per lavorare efficacemente con Lint.

Le regole sulle prestazioni sono le più utili nella pratica. UnusedResources trova risorse dichiarate in XML ma non utilizzate nel codice. ViewHolder verifica che il pattern ViewHolder sia utilizzato negli adapter RecyclerView. DrawAllocation avverte sulla creazione di oggetti nel metodo onDraw. Correggere questi problemi riduce la dimensione dell'APK e accelera l'applicazione.

Le regole di sicurezza sono obbligatorie per le applicazioni pubblicate. ExportedContentProvider controlla se un ContentProvider è esportato senza protezione. WorldReadableFiles avverte sulla creazione di file accessibili a tutte le applicazioni. AllowBackup controlla il flag allowBackup nel manifest — si consiglia di disabilitarlo per la sicurezza dei dati.