android

SystemChrome.setPreferredOrientations で Flutter の 1 つのルートだけを横向きまたは縦向きに固定し、アプリの他の部分を壊さない方法を解説します。pushReplacement を乗り越えて pop 時に復元されるスタック方式のロック、空のリストがリセットに向かない理由、iPad のマルチタスクと Android 16 の大画面でロックが無視される理由、iPadOS 26 と iOS 27 SDK 以降の UIRequiresFullScreen の扱いを取り上げます。Flutter 3.47.8、Dart 3.13.7、Xcode 27.1 で検証しています。

依存ライブラリが、ビルドのコンパイラーより少なくともマイナーバージョン 2 つ新しい Kotlin でビルドされています。settings.gradle.kts の org.jetbrains.kotlin.android のバージョンを X マイナス 1 以降に上げるか、依存ライブラリを古いバージョンに固定してください。

ApiException: 10 は DEVELOPER_ERROR です。インストールされた APK のパッケージ名と署名証明書の SHA-1 の組み合わせを Google が認識していません。ビルドに実際に署名した鍵の SHA-1 を登録し、Web クライアント ID を serverClientId として渡してください。

Android はメモリを確保するためにバックグラウンドの Flutter アプリを終了させ、ユーザーが戻ってくると StatefulWidget はすべて初期状態から始まります。restorationScopeId、RestorationMixin、Restorable プロパティで復元を有効にし、テキストフィールド、スクロール位置、push したルートを復元し、独自の RestorableValue を書き、restartAndRestore と adb ですべてをテストする方法を解説します。Flutter 3.44.8 と Android 16 エミュレーターで検証済みです。

ビルドモード (debug、profile、release) は Flutter が Dart コードをどうコンパイルするかを決めます。flavor (dev、staging、prod) は Gradle と Xcode で定義するネイティブのビルドバリアントで、どのアプリを出荷するかを決めます。この 2 つは独立した軸であり、2 つの flavor と 3 つのモードで 6 つのビルドになります。Flutter 3.44.8 と AGP 9.0.1 で検証し、ソースは 3.47.7 で確認しています。

android_libcpp_shared ビルドフック (0.2.0 以前) が NDK を見つけられないか、minSdk が NDK の最新 API より高いことが原因です。0.2.1 以降に更新するか、minSdk をカバーする NDK をインストールしてください。

マニフェストの .MainActivity は Gradle の namespace を基準に解決されますが、その名前のクラスが APK に存在しません。namespace、Kotlin の package 行、マニフェストの三つを一致させます。

別の Gradle プロセスが ~/.gradle/caches/journal-1 を保持したまま手放せない状態です。Owner PID を特定してそのデーモンを終了し、.lock ファイルの削除は避けてください。エラーの場所が移るだけです。

google_mobile_ads の公式サンプルは onAdLoaded まで何も描画しないため、画面が表示された数秒後にコンテンツが 150 dp 跳ねます。先にアンカー型アダプティブのサイズを取得し、SizedBox で領域を確保し、高さを起動をまたいで保存してから、広告を読み込みます。Flutter 3.44.8 と google_mobile_ads 9.1.0 で計測しました。

MAUI 10.0.100 はステータスバーアイコンの色を colorPrimary から決定しますが、これは Material 3 の surface とは明るさが逆になるため、白地に白、黒地に黒になります。Microsoft.Maui.Controls を 10.0.101 以降に更新するか、MainActivity で AppearanceLightStatusBars を設定し直してください。