Lint

宣告依附元件

如要新增 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。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

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

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 的用法，因為在 Isolated Projects 功能中使用這些項目並不安全。

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 檢查，以便在沒有 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 的呼叫，因為這幾乎總是會發生錯誤。
• 在 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 進行檢查的功能。
• 新增檢查項目，針對不呼叫 configureEach 而呼叫 TaskContainer.withType 的 API 進行檢查。
  • 針對 Gradle 專案隔離作業中出現問題的 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 版包含此連結所列的修訂項目。

新功能

• 針對 Gradle 外掛程式作者提供初始的 Lint 檢查功能，協助他們找出程式碼中的錯誤。這些類別應用於套用 java-gradle-plugin 的 Gradle 專案。它會擷取內部 Gradle 和 Android Gradle 外掛程式 API 的用途，以及急迫工作設定。