lint

  
lint 检查以验证 Gradle API 的使用情况
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2025 年 5 月 20 日 - - - 1.0.0-alpha05

声明依赖项

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

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

Groovy

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

Kotlin

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

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

反馈

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

创建新问题

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

此工件没有版本说明。

版本 1.0

版本 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 的用法，因为在使用隔离项目功能时，这并不安全。

版本 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。
  • 捕获传入 Configuration 的 ConfigurableFileCollection.from 调用，因为这会导致提示使用 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 的检查。
  • 通过标记对 TaskContainer.withType 的调用（而未调用 configureEach），针对对延迟配置有问题的 API 添加了检查。
    • 通过标记对 Project.getRootProject、Project.findProject、Project.getParent、Project.findProperty、Project.getProperties、Project.hasProperty、Project.property 的调用，添加了对 Gradle 项目隔离有问题的 API 的检查。

版本 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 的使用情况以及提前任务配置。