lint

用于验证 Gradle API 使用情况的 Lint 检查

最新更新	稳定版	发布候选版	Beta 版	Alpha 版
2025 年 5 月 20 日	-	-	-	1.0.0-alpha05

声明依赖项

要添加 Lint 的依赖项，您必须将 Google Maven 仓库添加到您的项目中。请阅读Google 的 Maven 仓库，了解更多信息。

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

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

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

有关依赖项的更多信息，请参阅添加构建依赖项。

您的反馈有助于改进 Jetpack。如果您发现新问题或有改进此库的想法，请告诉我们。在创建新问题之前，请查看此库中的现有问题。您可以通过点击星标按钮为现有问题投票。

有关更多信息，请参阅问题跟踪器文档。

此工件没有版本说明。

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 的用法，因为它们在“隔离项目”功能下不安全。

2025 年 4 月 23 日

androidx.lint:lint-gradle:1.0.0-alpha04 已发布。版本 1.0.0-alpha04 包含这些提交。

新功能

错误修复

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

2024 年 12 月 11 日

androidx.lint:lint-gradle:1.0.0-alpha03 已发布。版本 1.0.0-alpha03 包含这些提交。

新功能

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

2024 年 9 月 4 日

androidx.lint:lint-gradle:1.0.0-alpha02 已发布。版本 1.0.0-alpha02 包含这些提交。

新功能

添加了一项检查，用于查找不推荐使用的 GradleRunner.withPluginClasspath API。
添加了检查，用于标记没有调用 configureEach 的 TaskContainer.withType 调用，这些 API 对惰性配置存在问题。
- 添加了检查，用于标记对 Project.getRootProject、Project.findProject、Project.getParent、Project.findProperty、Project.getProperties、Project.hasProperty、Project.property 的调用，这些 API 对 Gradle 项目隔离存在问题。

2024 年 2 月 21 日

androidx.lint:lint-gradle:1.0.0-alpha01 已发布。版本 1.0.0-alpha01 包含这些提交。

新功能

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