
# アプリのウィジェット

依存関係にこのスターターがあれば、`SpringApplicationWidget(home: ...)` は `MaterialApp` を組み立てます。アプリの種類は `material` で、`spring.flutter.app.type` で設定されるか、プロパティが設定されていなければ、これがアプリケーションの唯一のデザインのスターターなので推定されます (Spring Boot がクラスパスから `spring.main.web-application-type` を推定するのと同じです)。アプリのウィジェットのそれ以外のすべては Flutter のスターターのものです。タイトル、デバッグバナー、ロケール、ナビゲーターのオブザーバー、`FlutterAppCustomizer` Bean は、[アプリのウィジェット](../spring-boot-starter-flutter/app-widget.md) に説明されているとおり `spring.flutter.app.*` から来ます。

## 例

```yaml
# lib/resources/application.yml
spring:
  flutter:
    app:
      type: material        # 省略可: 唯一のデザインのスターターが決める
      title: NEON Books
      debug-banner: false
      locales: en, ja
    theme:
      active: system        # デバイスに従ってライトまたはダーク
      seed-color: teal
```

```dart
@SpringBootApplication()
void main() => runApp(
  SpringApplicationWidget(
    application: () => springApplication,
    home: const BookListPage(),
  ),
);
```

## MaterialApp が受け取るもの

| `MaterialApp` の | 由来 |
|---|---|
| `theme`、`darkTheme` | `MaterialThemes` Bean: `ThemeData` としての `spring.flutter.theme.*` のテーマで、`ThemeCustomizer` Bean が変更したもの ([コードでのテーマ](themes-in-code.md) を参照) |
| `themeMode` | `spring.flutter.theme.active`: `system` (デフォルト) では、Material はデバイスに従ってライトとダークのテーマを切り替える。`ThemeSelection` Bean で選ばれたテーマや、実行時に読み込まれたテーマは即座に表示される |
| `localizationsDelegates` | Material、Cupertino、ウィジェットの翻訳、その後にアプリ独自のもの (`FlutterAppSettings.localizationsDelegates`) |
| `title`、`debugShowCheckedModeBanner`、`locale`、`supportedLocales`、`navigatorObservers`、`shortcuts`、`scrollBehavior` | `spring.flutter.app.*` と `FlutterAppCustomizer` Bean |
| `builder` | Flutter のスターターのもの (テーマの背景、モーションの設定、フレームメーター) を、Material のテキストスタイル、Material のテキスト選択、`MaterialDesignControls` を持つ `DesignScope` の中に置いたもの |
| `home` または `routerConfig` | `SpringApplicationWidget` の `home:`。それがなければ、アプリケーションの `RouterConfig<Object>` Bean ([ナビゲーションのスターター](../spring-boot-starter-flutter-navigation/index.md) のもの) の上の `MaterialApp.router` |

アプリのウィジェットは Bean `materialAppFactory` (`MaterialAppFactory`。型 `material` のための Flutter のスターターの `SpringAppFactory` を実装する) が作ります。Flutter のスターターは、プロパティが示す種類のファクトリーを、プロパティが設定されていなければ自身の `widgets` 以外の唯一のファクトリーを見つけます。

## Android では Material、iOS では Cupertino

ほとんどのプラットフォームでは Material、iPhone では Cupertino のアプリは、二つのデザインのスターターを列挙するので、種類を設定しなければなりません。すべてのプラットフォーム向けに設定し、iOS のプロファイルでもう一度設定します。

```yaml
# lib/resources/application.yml
spring.flutter.app.type: material
```

```yaml
# lib/resources/application-ios.yml
spring.flutter.app.type: cupertino
```

プロパティがなければ、二つの種類のアプリファクトリーのどちらかが優先されるのではなく、起動が失敗します。

```text
Invalid argument(s) (spring.flutter.app.type): not set, and the application has app widgets of several types: cupertino, material. Choose one, for every platform or in a profile of each (spring.flutter.app.type=cupertino in application-ios.properties)
```

[spring_boot_starter_flutter_cupertino](../spring-boot-starter-flutter-cupertino/index.md) を参照してください。

## 独自の MaterialApp

`SpringApplicationWidget(child: ...)` では、アプリは独自のアプリのウィジェットを組み立て、`spring.flutter.app.*` は使われません。テーマは `MaterialThemes` Bean から受け取り、スターター自身のウィジェット (`MarkdownView`、ログインフォーム) には `DesignScope` で Material の見た目を与えます。

```dart
class BooksApp extends SpringStatelessWidget<(MaterialThemes,)> {
  const BooksApp({super.key});

  @override
  Widget build(BuildContext context) {
    final (themes,) = beans;
    return MaterialApp(
      theme: themes.theme('light'),
      darkTheme: themes.theme('dark'),
      builder: (context, child) => DesignScope(
        textStyle: (context, style) =>
            Theme.of(context).textTheme.styleNamed(style),
        selectable: (context, child) => SelectionArea(child: child),
        controls: const MaterialDesignControls(),
        child: child!,
      ),
      home: const BookListPage(),
    );
  }
}
```

`DesignScope` がなくても、セキュリティスターターのログインフォームは Material のコントロールを見つけます (`materialDesignControls` Bean がその上の `MaterialApp` を見つけます)。その場合 `MarkdownView` は `SpringTheme` と、Flutter のスターター自身の選択ハンドルを使います。

## 関連項目

- [Flutter のスターターのアプリのウィジェット](../spring-boot-starter-flutter/app-widget.md)
- [コードでのテーマ](themes-in-code.md)
- [他のスターターとともに](other-starters.md)
- [デザインライブラリ](../spring-boot-starter-flutter/design-libraries.md)
