此页面由 Cloud Translation API 翻译。

lint

API 参考文档
androidx.lint

lint 检查以验证 Gradle API 的使用情况

最近更新时间	稳定版	候选版	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")
}

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

您的反馈将帮助我们改进 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 包含这些提交内容。

新功能

bug 修复

修复了 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 的调用，因为这样做几乎总会导致 bug。
捕获对 TaskContainer 的 Kotlin 集合扩展函数的调用，因为这些调用会导致提前创建 Task。
捕获传入 Configuration 的 ConfigurableFileCollection.from 调用，因为这会导致提示使用 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 的检查。
通过标记对 TaskContainer.withType 的调用（而未调用 configureEach），针对对延迟配置有问题的 API 添加了检查。
- 通过标记对 Project.getRootProject、Project.findProject、Project.getParent、Project.findProperty、Project.getProperties、Project.hasProperty、Project.property 的调用，添加了对 Gradle 项目隔离有问题的 API 的检查。

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