
# アプリのウィジェット

依存関係にこのスターターがあれば、`SpringApplicationWidget(home: ...)` は `CupertinoApp` を組み立てます。アプリの種類は `cupertino` で、`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: cupertino       # 省略可: 唯一のデザインのスターターが決める
      title: NEON Books
      locales: en, ja
```

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

## CupertinoApp が受け取るもの

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

アプリのウィジェットは Bean `cupertinoAppFactory` (`CupertinoAppFactory`。型 `cupertino` のための Flutter のスターターの `SpringAppFactory`) が作ります。

## iOS でだけ Cupertino

```yaml
# lib/resources/application.yml: どこでも Material ...
spring.flutter.app.type: material
```

```yaml
# lib/resources/application-ios.yml: ... そして iPhone では Cupertino
spring.flutter.app.type: cupertino
```

このようなアプリは、二つのデザインのスターターと、`material_ui` と `cupertino_ui` の両方を列挙します。デザインのスターターが二つあると種類は推定できません。`spring.flutter.app.type` がなければ、一方を優先するのではなく、起動が失敗します。

```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)
```


## 独自の CupertinoApp

`SpringApplicationWidget(child: ...)` では、アプリは独自のアプリのウィジェットを組み立て、`spring.flutter.app.*` は使われません。テーマは `CupertinoThemes` Bean から受け取り、スターター自身のウィジェットには `DesignScope` で Cupertino のコントロールを与えます。

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

  @override
  Widget build(BuildContext context) {
    final (themes,) = beans;
    return CupertinoApp(
      theme: themes.theme('light'),
      builder: (context, child) => DesignScope(
        controls: const CupertinoDesignControls(),
        textStyle: (context, style) => null,       // SpringTheme のスタイル
        selectable: (context, child) => child,
        child: child!,
      ),
      home: const LoginPage(),
    );
  }
}
```

`DesignScope` がなくても、ログインフォームは Cupertino のコントロールを見つけます。`cupertinoDesignControls` Bean がその上の `CupertinoApp` を見つけます。

## 関連項目

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