lint

  
Controlli Lint per verificare l'utilizzo delle API Gradle
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
17 giugno 2026 1.0.0 - - -

Dichiara le dipendenze

Per aggiungere una dipendenza da Lint, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

Groovy

plugins {
    id("com.android.lint")
}
dependencies {
    lintChecks "androidx.lint:lint-gradle:1.0.0"
}

Kotlin

plugins {
    id("com.android.lint")
}
dependencies {
    lintChecks("androidx.lint:lint-gradle:1.0.0")
}

A questo punto puoi eseguire questi controlli con ./gradlew :my-plugin:lint.

Per saperne di più sulle dipendenze, consulta Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Non sono disponibili note di rilascio per questo artefatto.

Lint versione 1.0

Versione 1.0.0

17 giugno 2026

androidx.lint:lint-gradle:1.0.0 è stato rilasciato. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0:

lint-gradle include i seguenti controlli per aiutare gli autori di plug-in Gradle:

  • Controllo della configurazione eager per posticipare la creazione e la configurazione degli oggetti fino a quando non sono necessari
  • Controllo delle violazioni dell'isolamento del progetto
  • Controllo di bug probabili per le chiamate Provider.toString
  • Controllo delle prestazioni che segnala le chiamate alle API che sono inaspettatamente costose
  • Controllo degli input della cache di configurazione eccessivamente generici
  • Controlla per scoraggiare l'utilizzo di Property<File>
  • Controllo dell'utilizzo delle API interne di Gradle, del plug-in Android per Gradle e del plug-in Kotlin per Gradle
  • Chiamata a withType senza controllo .configureEach
  • Controllo dell'utilizzo di GradleRunner.withPluginClasspath

Versione 1.0.0-rc01

19 maggio 2026

androidx.lint:lint-gradle:1.0.0-rc01 è stato rilasciato. La versione 1.0.0-rc01 contiene questi commit.

Versione 1.0.0-beta01

22 aprile 2026

androidx.lint:lint-gradle:1.0.0-beta01 è stato rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Versione 1.0.0-alpha06

8 aprile 2026

androidx.lint:lint-gradle:1.0.0-alpha06 è stato rilasciato. La versione 1.0.0-alpha06 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto un controllo per le chiamate a mustRunAfter e shouldRunAfter, che sono costose perché Gradle deve riorganizzare i grafici delle attività.
  • È stato aggiunto un controllo per le chiamate a System.getenv() e System.getenv("key") che devono passare invece tramite l'API Provider
  • Contributo esterno di josh@fueledbycaffeine.com per aggiungere un controllo per rilevare la concatenazione di stringhe del provider

Versione 1.0.0-alpha05

20 maggio 2025

androidx.lint:lint-gradle:1.0.0-alpha05 è stato rilasciato. La versione 1.0.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Aggiungi un controllo per avvisare dell'utilizzo di configurations.create e configurations.maybeCreate, in quanto causano la realizzazione immediata di questa configurazione a partire da Gradle 8.14 e pertanto devono essere sostituiti con configurations.register.
  • Aggiungi un controllo per rilevare gli utilizzi delle API del plug-in Gradle Kotlin interno
  • Aggiungi un controllo per rilevare gli utilizzi di evaluationDependsOn e evaluationDependsOnChildren, in quanto non è sicuro con la funzionalità Progetti isolati.

Versione 1.0.0-alpha04

23 aprile 2025

androidx.lint:lint-gradle:1.0.0-alpha04 è stato rilasciato. La versione 1.0.0-alpha04 contiene questi commit.

Nuove funzionalità

  • Aggiungi un controllo per le chiamate accidentali a Provider<String>.toString, in quanto si tratta probabilmente di bug.
  • Aggiungi un controllo per rilevare l'utilizzo di metodi, proprietà e campi provenienti da tipi interni.

Correzioni di bug

  • Correggi il controllo GradleProjectIsolation per consentire l'utilizzo di Project.isolated.
  • Correzione del controllo WithTypeWithoutConfigureEach per rilevare gli utilizzi di Project.tasks.withType<Task>() senza configureEach.
  • Correzione del controllo InternalGradleApiUsage per rilevare gli utilizzi completamente qualificati delle API interne.

Versione 1.0.0-alpha03

11 dicembre 2024

androidx.lint:lint-gradle:1.0.0-alpha03 è stato rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

  • Intercetta le chiamate a Provider<>.toString, in quanto è quasi sempre un bug.
  • Rileva le chiamate delle funzioni di estensione della raccolta Kotlin su TaskContainer, in quanto causano la creazione di Task eager.
  • Intercetta le chiamate a ConfigurableFileCollection.from che passano in un Configuration, in quanto ciò causa la risoluzione anticipata della configurazione, suggerendo di utilizzare project.files(configuration) o configuration.incoming.artifactView {}.files.
  • Rileva gli utilizzi di Property<File> che suggeriscono di utilizzare RegularFileProperty o DirectoryProperty, in quanto impongono l'utilizzo della directory anziché del file.

Versione 1.0.0-alpha02

4 settembre 2024

androidx.lint:lint-gradle:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto un controllo per l'API GradleRunner.withPluginClasspath sconsigliata.
  • Sono stati aggiunti controlli per le API problematiche per la configurazione lazy contrassegnando le chiamate a TaskContainer.withType senza chiamare configureEach.
    • Sono stati aggiunti controlli per le API problematiche per l'isolamento del progetto Gradle segnalando le chiamate a Project.getRootProject, Project.findProject, Project.getParent, Project.findProperty, Project.getProperties, Project.hasProperty, Project.property.

Versione 1.0.0-alpha01

21 febbraio 2024

androidx.lint:lint-gradle:1.0.0-alpha01 è stato rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Un insieme iniziale di controlli lint per gli autori di plug-in Gradle per aiutarli a individuare gli errori nel codice. Devono essere utilizzati nei progetti Gradle che applicano java-gradle-plugin. Rileva l'utilizzo delle API interne di Gradle e del plug-in Android Gradle e la configurazione eager delle attività.