
# ビルドに含まれるもの

`spring_boot_starter_flutter` を使うアプリケーションのビルドに何が含まれ、どんなときに何が含まれないか。キーで決まるモジュールは、`build_runner` の実行時に、プロファイルなしの `application.yml` または `application.properties` からそのキーを読みます ([ビルドから外されるモジュール](../spring-core-dart-generator/optimizations/build-conditions.md) を参照)。依存するパッケージのモジュールは一緒に入ります。`spring_boot_dart` については [自動構成](../spring-boot-dart/auto-configuration.md) を参照してください。

## 常に含まれるもの

`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` だけがモジュールを外します。

## ジェネレーターがこのスターターのために書くもの

ジェネレーターのパート ([スターターのパート](../spring-core-dart-generator/how-it-works.md#スターターのパート) を参照) は、アプリケーションがそのパッケージに届くときだけ動きます。

| パートまたはビルダー | 行うこと |
|---|---|
| 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 パート。 |

## 知っておくこと

- デバッグオーバーレイのドックは、それを持つ機能 (フレームメーター、タイムライン、タスクマネージャー) の最初のモジュールが作るので、そのような機能があるときだけビルドに含まれます。
- デバッグパネルのシーンとシグナルのタブは、それぞれのスターターの独立したモジュールで、パネルがビルドにある場所に表示されます。

## 関連項目

- [ビルドから外されるモジュール](../spring-core-dart-generator/optimizations/build-conditions.md)
- [生成の仕組み: スターターのパート](../spring-core-dart-generator/how-it-works.md#スターターのパート)
- [ビルダー](../spring-core-dart-generator/builders.md)
- [デバッグパネル](debug-panel.md)
- [フレームメーター](frame-meter.md)
- [タイムライン](timeline.md)
- [タスクマネージャー](isolates.md)
- [Web ビルドのブラウザーキャッシュ](cache-headers.md)
- [SEO](seo.md)
