lint

  
Lint 檢查，用於驗證 Gradle API 的使用情形
最近更新時間 穩定版 候選版 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")
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

這個構件沒有任何版本資訊。

1.0 版本

1.0.0-alpha06 版本

2026 年 4 月 8 日

發布 androidx.lint:lint-gradle:1.0.0-alpha06。1.0.0-alpha06 版包含這些修訂項目。

新功能

  • 新增對 mustRunAfter 和 shouldRunAfter 的呼叫檢查，因為 Gradle 必須重新排列工作圖，因此這些呼叫會耗費大量資源。
  • 新增檢查，確認應透過 Provider API 進行的呼叫是否傳送至 System.getenv() 和 System.getenv("key")
  • 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 的用法，因為這與「獨立專案」功能不相容。

1.0.0-alpha04 版本

2025 年 4 月 23 日

發布 androidx.lint:lint-gradle:1.0.0-alpha04。1.0.0-alpha04 版包含這些修訂項目。

新功能

  • 新增檢查項目，確認是否有誤撥 Provider<String>.toString 電話，因為這可能是錯誤。
  • 新增檢查，以擷取來自內部型別的方法、屬性和欄位用法。

修正錯誤

  • 修正 GradleProjectIsolation 檢查，允許使用 Project.isolated。
  • 修正 WithTypeWithoutConfigureEach 檢查，以偵測使用 Project.tasks.withType<Task>() 但沒有 configureEach 的情況。
  • 修正 InternalGradleApiUsage 檢查，以擷取內部 API 的完整使用情形。

1.0.0-alpha03 版本

2024 年 12 月 11 日

發布 androidx.lint:lint-gradle:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂項目。

新功能

  • 攔截對 Provider<>.toString 的呼叫，因為這麼做幾乎總是會導致錯誤。
  • 在 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 檢查。
  • 新增 API 檢查，標記未呼叫 configureEach 就呼叫 TaskContainer.withType 的情況，藉此找出延遲設定的問題。
    • 新增 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 版包含此連結所列的修訂項目。

新功能

  • Gradle 外掛程式作者可使用初始 Lint 檢查集，找出程式碼中的錯誤。這些外掛程式應適用於套用 java-gradle-plugin 的 Gradle 專案。這項規則會偵測內部 Gradle 和 Android Gradle 外掛程式 API 的使用情形，以及急切的工作設定。