ビルドに含まれるもの
spring_boot_starter_flutter を使うアプリケーションのビルドに何が含まれ、どんなときに何が含まれないか。キーで決まるモジュールは、build_runner の実行時に、プロファイルなしの application.yml または application.properties からそのキーを読みます (ビルドから外されるモジュール を参照)。依存するパッケージのモジュールは一緒に入ります。spring_boot_dart については 自動構成 を参照してください。
常に含まれるもの
build: も platform: もありません。スターターに依存するアプリケーションのすべてのビルドに含まれます。
| モジュール | 含むもの |
|---|---|
springBootStarterFlutterAutoConfiguration |
asset: ロケーションのサポート、@NotifyListeners と @ChangeNotifierComponent の Bean のためのアドバイスと、Spring ウィジェットに build が読んだ Bean を知らせるアドバイス、テーマ (SpringThemes、ThemeSelection、URL からのテーマのローダー)、アプリのファイル (FileStore、FileTemplate)、キーボードショートカット、ユーザーが選んだテーマの実行間での保持、spring.flutter.splash.warm-up.text.enabled のときのスプラッシュのテキストのウォームアップ。 |
キーで決まるもの
build: AutoConfigurationBuild(key): true はモジュールをすべてのビルドに含め、false はコードごと外し、キーが未設定のときは「未設定」の列が決めます。
| モジュール | キー | 未設定 | 含むもの |
|---|---|---|---|
springBootStarterFlutterDebugAutoConfiguration |
spring.flutter.debug.enabled |
デバッグとプロファイルのビルドだけ | デバッグパネル (debugPanel) とそのセクション (ログ、フレーム、設定、Bean、テーマ、開始)、パネルをアプリの上に置くカスタマイザー。 |
springBootStarterFlutterDebugFrameMeterAutoConfiguration |
spring.flutter.debug.frame-meter.enabled |
デバッグとプロファイルのビルドだけ | アプリの上のフレームメーター (debugFrameMeter)。パネルとは別なので、リリースにメーターだけを入れることもできます。 |
springBootStarterFlutterDebugMotionAutoConfiguration |
spring.flutter.debug.motion.enabled |
デバッグとプロファイルのビルドだけ | アプリのすべてのアニメーションのスイッチ (debugMotion)。 |
springBootStarterFlutterDebugTimelineAutoConfiguration |
spring.flutter.debug.timeline.enabled |
デバッグとプロファイルのビルドだけ | 開始とオブザベーションのタイムライン (debugTimeline) とその timelineObservations ハンドラー。これがあると、各 Bean の作成も計測されます。 |
springBootStarterFlutterDebugIsolatesAutoConfiguration |
spring.flutter.debug.isolates.enabled |
デバッグとプロファイルのビルドだけ | アプリのアイソレートとエンジンのスレッドのタスクマネージャー (debugIsolates、flutterEngineLoads)。 |
springBootStarterFlutterDebugDragAutoConfiguration |
spring.flutter.debug.drag.enabled |
どのビルドにも含まれない | デバッグオーバーレイのドラッグ (debugOverlayDrag)。true がなければ、ドラッグするコードはありません。 |
notInRelease に任せたモジュールは、Flutter のリリースビルドと dart compile exe では外されます。dart run と dart compile js / wasm は dart.vm.product を定義しないので、そこではキーが未設定ならモジュールは残り、false だけがモジュールを外します。
ジェネレーターがこのスターターのために書くもの
ジェネレーターのパート (スターターのパート を参照) は、アプリケーションがそのパッケージに届くときだけ動きます。
| パートまたはビルダー | 行うこと |
|---|---|
Flutter パート (spring_boot_starter_flutter) |
Spring ウィジェットと @ThemeLoaderKind クラスをスキャンします。SpringWidgetBindings Bean を書き、ローダーの種類を登録し、extension SpringBeans on BuildContext (@BuildContextAccess のゲッター) を書きます。@Value('asset:...') を pubspec.yaml と照合し、spring_metadata.json に loaderKinds とテーマのスキーマを加えます。 |
ChangeNotifier パート (spring_boot_starter_flutter) |
ChangeNotifier ではない @ChangeNotifierComponent のプロキシに ChangeNotifier をミックスインします。クラスが書かれたとおりに動けないときは、ビルドが失敗します。 |
ビルダー spring_flutter_keys |
lib/spring_gen/theme.spring.keys.dart と messages.spring.keys.dart (context.theme、context.messages)。パッケージにテーマのプロパティかメッセージファイルがあるときだけです。 |
ビルダー spring_flutter_page_loader |
web/index.html のページローダーのブロックと web/_headers のブラウザーキャッシュ。web/index.html があるときだけです。 |
ビルダー spring_flutter_web |
Web での flutter run のための web_dev_config.yaml。spring.flutter.web.dev-server.* または spring.flutter.security.web.mode が設定されているときだけです。 |
ビルダー spring_flutter_seo |
web/ の検索エンジン向けのページ、sitemap.xml、robots.txt、llms.txt。spring.flutter.web.seo.enabled が true で web/index.html があるときだけです。 |
| 依存関係を通して | スターターが spring_web_dart に依存するため、Web パート。 |
知っておくこと
- デバッグオーバーレイのドックは、それを持つ機能 (フレームメーター、タイムライン、タスクマネージャー) の最初のモジュールが作るので、そのような機能があるときだけビルドに含まれます。
- デバッグパネルのシーンとシグナルのタブは、それぞれのスターターの独立したモジュールで、パネルがビルドにある場所に表示されます。