lint

  
用于验证 Gradle API 使用情况的 lint 检查
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2026 年 4 月 8 日 - - - 1.0.0-alpha06

声明依赖项

如需添加 Lint 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 制品库 。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

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

Kotlin

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

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

此工件没有版本说明。

版本 1.0

版本 1.0.0-alpha06

2026 年 4 月 8 日

发布了 androidx.lint:lint-gradle:1.0.0-alpha06。版本 1.0.0-alpha06 中包含 这些提交内容。

新功能

  • 添加了对 mustRunAfter 和 shouldRunAfter 调用的检查，因为 Gradle 必须重新排列任务图，所以这些调用非常耗费资源。
  • 添加了对 System.getenv() 和 System.getenv("key") 调用的检查，这些调用应改为通过 Provider API 进行
  • 来自 josh@fueledbycaffeine.com 的外部贡献，用于添加检查以检测 Provider 的字符串串联

版本 1.0.0-alpha05

2025 年 5 月 20 日

发布了 androidx.lint:lint-gradle:1.0.0-alpha05。版本 1.0.0-alpha05 中包含 这些提交内容。

新功能

  • 添加了一项检查，用于警告 configurations.create 和 configurations.maybeCreate 的用法，因为这些用法会导致从 Gradle 8.14 开始急切实现该配置，因此应替换为 configurations.register。
  • 添加了一项检查，用于捕获内部 Kotlin Gradle 插件 API 的用法
  • 添加了一项检查，用于捕获 evaluationDependsOn 和 evaluationDependsOnChildren 的用法，因为它们在 Isolated Projects 功能中不安全。

版本 1.0.0-alpha04

2025 年 4 月 23 日

发布了 androidx.lint:lint-gradle:1.0.0-alpha04。版本 1.0.0-alpha04 中包含 这些提交内容。

新功能

  • 添加了一项检查，用于检查意外的 Provider<String>.toString 调用，因为它们很可能是 bug。
  • 添加了一项检查，用于捕获来自内部类型的方法、属性、字段的用法。

bug 修复

  • 修复了 GradleProjectIsolation 检查，以允许使用 Project.isolated。
  • 修复了 WithTypeWithoutConfigureEach 检查，以捕获不使用 configureEach 的 Project.tasks.withType<Task>() 的用法。
  • 修复了 InternalGradleApiUsage 检查，以捕获内部 API 的完全限定用法。

版本 1.0.0-alpha03

2024 年 12 月 11 日

发布了 androidx.lint:lint-gradle:1.0.0-alpha03。版本 1.0.0-alpha03 中包含 这些提交内容。

新功能

  • 捕获对 Provider<>.toString 的调用，因为这样做几乎总是 bug。
  • 捕获对 TaskContainer 的 Kotlin 集合扩展函数的调用，因为这些调用会导致急切创建 Task。
  • 捕获对 ConfigurableFileCollection.from 的调用，该调用传入了 Configuration，因为这会导致急切解析配置，建议使用 project.files(configuration) 或 configuration.incoming.artifactView {}.files。
  • 捕获 Property<File> 的用法，建议使用 RegularFileProperty 或 DirectoryProperty，因为它强制使用目录而不是文件。

版本 1.0.0-alpha02

2024 年 9 月 4 日

发布了 androidx.lint:lint-gradle:1.0.0-alpha02。版本 1.0.0-alpha02 中包含 这些提交内容。

新功能

  • 添加了对不建议使用的 GradleRunner.withPluginClasspath API 的检查。
  • 添加了对延迟配置存在问题的 API 的检查，方法是标记对不调用 configureEach 的 TaskContainer.withType 的调用。
    • 添加了对 Gradle Project Isotation 存在问题的 API 的检查，方法是标记对 Project.getRootProject、Project.findProject、Project.getParent、Project.findProperty、Project.getProperties、Project.hasProperty、Project.property 的调用。

版本 1.0.0-alpha01

2024 年 2 月 21 日

发布了 androidx.lint:lint-gradle:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

新功能

  • 一组初始 lint 检查，供 Gradle 插件作者使用，以帮助他们捕获代码中的错误。这些检查预计将用于应用 java-gradle-plugin 的 Gradle 项目。它将捕获内部 Gradle 和 Android Gradle 插件 API 的用法以及急切的任务配置。