タグ: gradle

kotlin-android を適用している AGP 8 の Flutter アプリから、Flutter 3.47 上で android.builtInKotlin=true を有効にした AGP 9.1 までの全手順です。すべてのステップを実際にビルドして計測しました。省略できそうに見えて実は必須の 2 つの編集も含みます。KGP 2.2 以降では kotlinOptions がコンパイルエラーになり、settings.gradle.kts の KGP の行は残す必要があります。

リリース APK に libapp.so が含まれていません。Flutter 3.44.0 から 3.44.4 はこれを落とすことがありました。3.44.5 以降に更新し、結合された subprojects ブロックを分割してください。

JDK 24 以降で出る JEP 472 の警告は無害で、一度だけ表示されます。gradle.properties にフラグを貼り付けるのではなく、JDK と対応する Gradle バージョンを揃えて解決します。

Gradle は JRE でコンパイルしています。マシン全体を探すのではなく、起動時に渡された JVM をそのまま使います。flutter config --jdk-dir を本物の JDK に向けるか、org.gradle.java.home を削除してください。

SDK Manager が .downloadIntermediates にキャッシュした壊れたアーカイブを展開し直しています。そのフォルダーと展開途中の ndk/<version> ディレクトリを削除して、ビルドし直してください。

64 ビットの .so に 4 KB の ELF セグメントが残っているため Play がバンドルを却下します。該当ライブラリを特定し NDK r28 以降で再ビルドし zipalign -P 16 で確認します。

この行はラッパーであってエラーではありません。flutter run --verbose または ./gradlew assembleDebug --stacktrace で実行し直し、Gradle の本当の失敗を読んで、それを修正してください。

30 秒で直す: android/gradle.properties に android.useAndroidX=true と android.enableJetifier=true を設定し、古い support library をまだ使っているプラグインを見つけてアップグレードするか置き換えます。

30 秒で済む修正: android/app/build.gradle で minSdkVersion を 21 以上にしてください。background_fetch は API 21 から登場した Android の JobScheduler の上に作られています。

10 回のうち 9 回、本当の Gradle エラーは MSBuild ログのもっと上に埋もれています。JDK 17 のパス、maui-android ワークロードの欠落、Windows のロングパスが典型的な根本原因です。