Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

lint

API リファレンス
androidx.lint

Gradle API の使用状況を確認する lint チェック

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2026 年 6 月 17 日	1.0.0	-	-	-

依存関係の宣言

Lint への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

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

Kotlin

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

これらのチェックは、./gradlew :my-plugin:lint で実行できます。

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

このアーティファクトのリリースノートはありません。

Lint バージョン 1.0

バージョン 1.0.0

2026 年 6 月 17 日

androidx.lint:lint-gradle:1.0.0 がリリースされました。バージョン 1.0.0 に含まれるコミットについては、こちらをご覧ください。

1.0.0 の主な機能:

lint-gradle には、Gradle プラグインの作成者を支援する次のチェックが用意されています。

必要なときにオブジェクトを作成して構成する、Eager 構成チェック
プロジェクトの分離違反チェック
Provider.toString の呼び出しに関するバグの可能性チェック
予期せずコストのかかる API の呼び出しにフラグを設定するパフォーマンスチェック
広すぎる構成キャッシュ入力チェック
Property<File> の使用を推奨しないチェック
内部 Gradle、Android Gradle プラグイン、Kotlin Gradle プラグインの API 使用状況チェック
.configureEach なしの withType の呼び出しチェック
GradleRunner.withPluginClasspath の使用状況チェック

バージョン 1.0.0-rc01

2026 年 5 月 19 日

androidx.lint:lint-gradle:1.0.0-rc01 がリリースされました。バージョン 1.0.0-rc01 に含まれるコミットについては、こちらをご覧ください。

バージョン 1.0.0-beta01

2026 年 4 月 22 日

androidx.lint:lint-gradle:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれるコミットについては、こちらをご覧ください。

バージョン 1.0.0-alpha06

2026 年 4 月 8 日

androidx.lint:lint-gradle:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれるコミットについては、こちらをご覧ください。

新機能

Gradle がタスクグラフを再配置する必要があるため、コストのかかる mustRunAfter と shouldRunAfter の呼び出しのチェックを追加しました。
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 以降では、これらの使用により構成が Eager に実現されるため、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 チェックを修正し、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 が Eager に作成されます。
ConfigurableFileCollection.from に Configuration を渡す呼び出しをキャッチします。これにより、構成が Eager に解決されるため、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 のチェックを追加しました。
- 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 に含まれる commit については、こちらをご覧ください。

新機能

Gradle プラグインの作成者がコードの誤りを検出するのに役立つ、lint チェックの初期セット。java-gradle-plugin を適用する Gradle プロジェクトで使用されることが想定されています。内部 Gradle と Android Gradle プラグインの API の使用と、Eager タスク構成をキャッチします。