Kotlin Gradleプラグインのバージョン更新エラー

問題

FlutterプロジェクトでNull Safety対応後に、Android Studioから「新しいバージョンのKotlin Gradleプラグインが必要です」というエラーが発生します。

BUILD FAILED in 8s
[!] Your project requires a newer version of the Kotlin Gradle plugin.
    Find the latest version on https://kotlinlang.org/docs/gradle.html#plugin-and-versions, then update project/android/build.gradle:
    ext.kotlin_version = '<latest-version>'
Exception: Gradle task assembleDebug failed with exit code 1

このエラーは、古いバージョンのKotlin Gradleプラグインが使用されている場合に発生します。FlutterのアップデートやNull Safetyへの移行後に頻繁に見られる問題です。

原因

このエラーの主な原因は以下の通りです：

1. 古いKotlinバージョン: プロジェクトで指定されているKotlinのバージョンが古い
2. ビルドスクリプトの不一致: GradleプラグインとKotlinのバージョンに互換性がない
3. キャッシュ問題: 古いビルドキャッシュが残っている

解決方法

方法1: Kotlinバージョンの更新（推奨）

最新のFlutterプロジェクトでは、Kotlinのバージョンは android/settings.gradle ファイルで設定されています。

android/settings.gradle

pluginManagement {
    // ... 既存の設定 ...
    
    plugins {
        id "dev.flutter.flutter-plugin-loader" version "1.0.0"
        id "com.android.application" version "8.1.0" apply false
        id "org.jetbrains.kotlin.android" version "2.0.0" apply false  // このバージョンを更新
    }
}

最新のKotlinバージョンは公式リリースページで確認できます。

方法2: 従来の設定ファイルの更新

古いFlutterプロジェクトでは、android/build.gradle ファイルを更新する必要があります。

android/build.gradle

buildscript {
    ext.kotlin_version = '1.9.24'  // 最新バージョンに更新
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:7.3.0'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

方法3: Gradle設定の更新

android/gradle/wrapper/gradle-wrapper.properties ファイルも併せて更新します。

gradle-wrapper.properties

distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip

完全な手順

以下に問題解決のための完全な手順を示します：

1. 最新のKotlinバージョンを確認

   • Kotlin公式サイトで最新バージョンを確認

2. 設定ファイルを更新

   • android/settings.gradle または android/build.gradle を編集

3. キャッシュをクリア

   flutter clean

4. 依存関係を再取得

   flutter pub get

5. プロジェクトを再ビルド

   flutter run

WARNING

Windows環境では、OpenJDKプロセスが古いAPKファイルをロックしている場合があります。その場合はタスクマネージャーでOpenJDK Platform binaryプロセスを終了させてから再ビルドしてください。

トラブルシューティング

エラーが解消しない場合

1. キャッシュを完全にクリーン

   rm -rf android/.gradle
   rm -rf ~/.gradle/caches

2. すべてのGradleバージョンを更新

   • Android StudioのGradleプラグイン
   • Kotlinプラグイン
   • Gradle Wrapper

3. 新規プロジェクトを作成して比較

   flutter create temp_project
   # 新規プロジェクトの設定を参考に既存プロジェクトを更新

バージョン対応表

Flutterバージョン	推奨Kotlinバージョン	推奨Gradleバージョン
3.19以降	2.0.0+	8.4+
3.10-3.18	1.9.0+	7.6+
3.0-3.9	1.7.20+	7.5+

まとめ

Kotlin Gradleプラグインのバージョン更新エラーは、適切なバージョン指定とキャッシュクリーンで解決できます。最新のFlutterプロジェクトでは settings.gradle、古いプロジェクトでは build.gradle を更新してください。定期的にKotlinとGradleのバージョンを更新することで、互換性問題を予防できます。