最新版のFlutterでAndroid端末向け開発をする際に注意すべきこと:Gradleのバージョン

投稿者: | 2025年6月1日

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/プロジェクト文書に対応した形で組み込むことで、技術デブリのコントロールと効率的なメンテナンスが可能になる。

コメントを残す