Flutter 3.32.1 × Android API 36 互換性まとめ (2025年5月)
AndroidやiOSのNative開発においてツールチェーンを最新のものにするというのは今や常識である。ただしFlutterの場合、Android端末向けビルドで対応を確認できているGradleのバージョンが必ずしも最新版ではないという点に配慮しなくてはならない。
2025年5月末の情報をまとめた。
🌐 現状の最新の動作構成
Flutter 3.32.1 で Android API 36 をターゲットとしたビルドを行うための現実的な必須構成は以下のとおりである:
android/app/build.gradle
android {
namespace = "com.example.riverpod_isolate_progress"
compileSdk = flutter.compileSdkVersion
ndkVersion = flutter.ndkVersion
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
kotlinOptions {
jvmTarget = JavaVersion.VERSION_17
}
}
settings.gradle
plugins {
id "dev.flutter.flutter-plugin-loader" version "1.0.0"
id "com.android.application" version "8.3.2" apply false
id "org.jetbrains.kotlin.android" version "2.1.21" apply false
}
gradle/wrapper/gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip
Android SDK Tools
- SDK Manager で Android SDK Command-line Tools (latest) を最新にしておく
📅 Flutter × AGP × Gradle バージョン互換性 早見表 (2025年5月)
Flutter SDK | AGP バージョン | Gradle 必須バージョン | Android Studio |
---|---|---|---|
3.10.x | 8.0.x〜8.1.x | 8.0〜8.2 | Flamingo |
3.13〜3.16.x | 8.2.x | 8.2〜8.3 | Giraffe |
3.22〜3.32.x | 8.3.0〜8.3.2 | ✅ 8.4 必須 | Hedgehog〜Iguana |
master/dev | 8.4〜8.6+ | 8.5〜8.6+ | Iguana〜Koala |
⚙️ CI用 Flutter/AGP/Gradle 互換性チェッカー (Bash スクリプト)
#!/bin/bash
set -e
# 必要バージョン
REQUIRED_GRADLE_VERSION="8.4"
REQUIRED_AGP_VERSION="8.3.2"
REQUIRED_FLUTTER_VERSION="3.32.1"
# 現在のバージョンを取得
FLUTTER_VERSION=$(flutter --version | head -n 1 | awk '{print $2}')
GRADLE_VERSION=$(grep distributionUrl android/gradle/wrapper/gradle-wrapper.properties | sed 's/.*gradle-\(.*\)-all.*/\1/')
AGP_VERSION=$(grep "com.android.application" android/settings.gradle | awk '{print $5}')
# 結果表示
printf "\nFlutter: %s\n" "$FLUTTER_VERSION"
printf "AGP Plugin: %s\n" "$AGP_VERSION"
printf "Gradle: %s\n" "$GRADLE_VERSION"
# 確認
if [[ "$GRADLE_VERSION" < "$REQUIRED_GRADLE_VERSION" ]]; then
echo "❌ Gradle $GRADLE_VERSION is too old. Please upgrade to $REQUIRED_GRADLE_VERSION or higher."
exit 1
fi
if [[ "$AGP_VERSION" != "$REQUIRED_AGP_VERSION" ]]; then
echo "⚠️ AGP version is $AGP_VERSION. Expected $REQUIRED_AGP_VERSION."
fi
if [[ "$FLUTTER_VERSION" != "$REQUIRED_FLUTTER_VERSION" ]]; then
echo "⚠️ Flutter version is $FLUTTER_VERSION. Expected $REQUIRED_FLUTTER_VERSION."
fi
echo "✅ Compatibility check passed."
※ CI での使用の場合: GitHub Actions/自社CIサーバーにて flutter-sdk/ビルド前の互換性確認に組み込める。
⚡️ 最新情報の確認元
分野 | URL |
---|---|
Flutter Release Notes | https://docs.flutter.dev/release/whats-new |
Flutter GitHub | https://github.com/flutter/flutter/releases |
AGP Release Notes | https://developer.android.com/studio/releases/gradle-plugin |
Gradle Release Notes | https://docs.gradle.org/current/release-notes.html |
Kotlin Plugin Docs | https://kotlinlang.org/docs/gradle.html |
上記の内容を Notion や GitHub Wiki/プロジェクト文書に対応した形で組み込むことで、技術デブリのコントロールと効率的なメンテナンスが可能になる。