認証デバイス（authentication_device）を現行の Flutter でビルドできるようにする（依存の更新）

[OsscJpDevInfra]

概要

認証デバイス（authentication_device）が、現行の Flutter でビルドできない。
依存が 2021 年頃の版で固定されており、flutter build web がコンパイル エラー 10 件で失敗する。

#205（Web Push / PWA による代替）の前提として、依存とコードをまとめて更新する。

エラーはどれも Dart のコンパイル段階で出ていて、プラットフォームとは関係ない。
ネイティブ（Android）版も同じ理由でビルドできないと見られる
（Android SDK の無い環境で測ったため、flutter build apk は回していない）。

現状

測定環境: Flutter 3.41.9（stable）/ Dart 3.11.5 / Windows 11。
git の管理下にあるファイルだけを別のディレクトリに書き出して測った。

flutter pub get : 成功

pubspec.yaml の sdk: ">=2.12.0 <3.0.0" は障害にならない。
Dart 3 は、下限が 2.12 以上なら上限 <3.0.0 を <4.0.0 と読み替えるため。

→ ANALYSIS.md 6 節の「pub get の時点で解決できない可能性が高い」は、実測と異なる。

flutter build web : 失敗（コンパイル エラー 10 件）

発生箇所	件数	内容
file 6.1.2（推移的依存）	4	File.create / createSync の exclusive 引数に追随していない
firebase_core_platform_interface 4.0.1	2	削除された hashValues を使っている
firebase_core 1.2.1	1	同上
url_launcher_web 2.0.0	1	platformViewRegistry が未定義
platform 3.0.0	1	削除された Platform.packageRoot を使っている
lib/common/my_elevatedbutton.dart:19（アプリ）	1	削除された styleFrom(primary:) を使っている

アプリ側 1 件、依存側 9 件。 依存側はパッケージの版上げでしか直らない。

flutter pub outdated（直接依存）

パッケージ	現在	最新
firebase_messaging	10.0.1	16.6.0
flutter_appauth	1.0.0	12.1.0
flutter_local_notifications	6.0.0	22.3.0
http	0.13.3	1.6.0
shared_preferences	2.0.6	2.5.5
url_launcher	6.0.4	6.3.2
cupertino_icons	1.0.3	1.0.9

廃止済みのパッケージにも依存している（js / pedantic / shared_preferences_macos）。

firebase_core は lib/main.dart:8 で import しているが、pubspec.yaml の直接依存に無い（推移的依存で解決されている）。

ANALYSIS.md 6 節が指摘する破壊的変更（AndroidNotificationDetails の位置引数など）も、この更新で踏む。

対応

1. 直接依存を、まとめて最新のメジャー版へ上げる。
   部分的な版上げはしない（ANALYSIS.md 6 節・9 節）
2. 破壊的変更に追随する（styleFrom(primary:)、AndroidNotificationDetails の引数 など）
3. pubspec.yaml の SDK 制約を Dart 3 に合わせる
4. firebase_core を直接依存に加える
5. Android のビルド設定（compileSdkVersion / targetSdkVersion が 30、Gradle）を、上げた依存が要求する版に合わせる
6. ANALYSIS.md の 6・7・9 節を実測に合わせて直す

web 対応そのもの（ログインの差し替え、Service Worker、VAPID）は #205 で扱い、本件には含めない。
flutter_appauth は最新版でも web に対応していないが、本件の目的はビルドを通すことまでとする。

検証

• flutter pub get / flutter analyze / flutter build web が通ること（エラー 0。analyze の警告の件数を記録する）
• Android : flutter build apk --debug。Android SDK が必要。 無い環境で作業した場合は「未検証」と明記する
• サーバ側（MPAS）は変更しないため、MPAS のビルドと E2E は不要

利用者への影響

製品（MPAS）の動作への影響は無し。 認証デバイスはサンプル / テスト用のアプリ。

認証デバイスをビルドする開発者は、更新後は現行の Flutter が必要になる
（当時の Flutter 2.x ではビルドできなくなる見込み）。

[OsscJpDevInfra]

5ff5a31 で対応した。結果と、後から読む人への注意を残す。

検証の結果

作業環境: Flutter 3.41.9（stable）/ Dart 3.11.5 / Windows 11（Android SDK 無し）。

検証	結果
flutter pub get	成功
flutter analyze	error 0 / warning 7 / info 6
flutter build web	成功
flutter build apk --debug	未検証（Android SDK が無いため）

warning 7 件は、いずれも以前からあるコードの行（must_be_immutable / unused_field / dead_code など）。
本件では件数の記録にとどめ、直していない。

解決した主な版:
firebase_core 4.13.0 / firebase_core_web 3.10.0 / firebase_messaging 16.5.0 /
flutter_local_notifications 22.3.0 / flutter_appauth 12.1.0 / http 1.6.0 /
shared_preferences 2.5.5 / url_launcher 6.3.2

注意 1 : Android のビルドは確かめていない

Gradle の設定は、同じ Flutter 版で flutter create した雛形
（Kotlin DSL / AGP 8.11.1 / Kotlin 2.2.20 / Gradle 8.14 / Java 17）に合わせ、
各プラグインの README / build.gradle が求める設定を足したもの。

• minSdk 24（Flutter 3.41 の既定。flutter_local_notifications / flutter_appauth などの要求でもある）
• core library desugaring（desugar_jdk_libs 2.1.4。flutter_local_notifications の要求）
• com.google.gms.google-services 4.5.0

次の 2 つは、現行の Flutter / AGP では通らないことが確実なため外した。

• v1 embedding の Application.kt（io.flutter.app.FlutterApplication など、削除済みの API を使っていた）
• マニフェストの package= 属性（AGP 8 では namespace へ移す必要がある）

最初に flutter build apk --debug を通すときに、設定の調整が要る可能性がある。
なお android/app/google-services.json は本件以前からプレースホルダのままで、ビルドにも実物が要る見込み
（authentication_device/ANALYSIS.md 5 節）。

注意 2 : firebase_core_web を 3.10.x に固定している

3.11.0 は、Dart 3.12 未満（Flutter 3.44 未満）では web のコンパイルに失敗する（firebase/flutterfire#18611）。
catch (e) の Object 型の変数に、JSAny? にしか定義されていない isA<JSObject>() を呼んでいるため。

修正（firebase/flutterfire#18612）は 2026-08-26 にマージ済みだが、
2026-09-13 時点で pub.dev の最新は 3.11.0 のまま。
これに合わせて、firebase_core を 4.13.0、firebase_messaging を 16.5.0 に留めている（メジャー版は同じ）。

外す条件: 3.11.0 より新しい firebase_core_web が出た、または Flutter を 3.44 以上に上げた。

外し方（pubspec.yaml）:

1. firebase_core_web についてのコメント 4 行と、firebase_core_web: ">=3.10.0 <3.11.0" の行を消す
2. firebase_core / firebase_messaging を最新の版指定に戻す
3. flutter pub get → flutter build web が通ることを確かめる

注意 3 : Flutter が自動で削除したファイル

lib/generated_plugin_registrant.dart（旧式の web プラグイン登録。どこからも参照されていなかった）は、
flutter build web に組み込まれた移行処理（flutter_tools の ScrubGeneratedPluginRegistrant）が削除した。
同じ処理で、.gitignore の該当行も消えている。