
# spring_boot_starter_flutter_cupertino

`spring_boot_starter_flutter_cupertino` は、[spring_boot_starter_flutter](../spring-boot-starter-flutter/index.md) の上に作られた Flutter アプリに、iOS のデザインである Cupertino を追加します。Flutter 3.50 以降、Cupertino は SDK の一部ではなく Flutter チームのパッケージ `cupertino_ui` であり、Flutter のスターターはデザインライブラリを知りません。このスターターがあれば、アプリは `CupertinoApp` になり (`spring.flutter.app.type: cupertino`。デザインのスターターがこれ一つなら設定は不要です)、`spring.flutter.theme.*` のすべてのテーマが `CupertinoThemeData` になります。

これは `material_ui` ではなく、`cupertino_ui` と `material_color_utilities` (Material 3 の色の計算。純粋な Dart) に依存します。Cupertino のアプリのビルドには Material は入りません。

## 使う理由

- **プロパティからの `CupertinoApp`。** このスターターから推定される、または `spring.flutter.app.type` で設定される種類 `cupertino` で、設定のタイトル、ロケール、テーマとともに。
- **`CupertinoThemeData` としてのテーマ。** `spring.flutter.theme.*` のすべてのテーマを Cupertino にしたもので、独自の `cupertino.*` プロパティを持ち、アプリケーションの起動時にチェックされます。
- **シードカラーからのパレット。** `seed-color`、`scheme-variant`、`contrast` が、Material のアプリが同じプロパティから得るのと同じ Material 3 のパレットを、Material なしで作ります。
- **ナビゲーションのスターターのための iOS のページルート。** 型 `cupertino` のアプリで、または任意の種類のアプリでの `motion.page-transition: cupertino` で、スワイプで戻れるスライド。
- **スターター自身のウィジェットのための Cupertino のコントロール。** `MarkdownView` での iOS のテキスト選択ハンドル、セキュリティスターターのログインフォームでの Cupertino のフィールドとボタン。

## セットアップ

```yaml
# pubspec.yaml
environment:
  sdk: ^3.14.0
  flutter: '>=3.50.0'

dependencies:
  flutter:
    sdk: flutter
  cupertino_ui: ^1.1.6                                   # Cupertino のウィジェット
  spring_boot_starter_flutter_cupertino: ^0.9.0

dev_dependencies:
  build_runner: ^2.17.0
  spring_core_dart_generator: ^0.9.0
```

スターターは `spring_boot_starter_flutter` を連れてきて再エクスポートします。アプリはこのパッケージと、使うウィジェットのための `cupertino_ui` を列挙します。

```dart
import 'package:cupertino_ui/cupertino_ui.dart';
import 'package:spring_boot_starter_flutter_cupertino/spring_boot_starter_flutter_cupertino.dart';
```

Flutter 3.50 以降 (Dart 3.14) が必要です。その後 `dart run build_runner build` を実行します。ジェネレーターがスターターを見つけ、その Bean とデザインを `lib/spring_gen/main.spring.dart` に追加します。

## 例

```properties
# lib/resources/application.properties
spring.flutter.app.title=Counter
spring.flutter.theme.seed-color=teal
spring.flutter.theme.cupertino.bar-background-color=#F2F2F7
```

```yaml
# lib/resources/application.yml での同じ内容
spring:
  flutter:
    app:
      title: Counter
    theme:
      seed-color: teal
      cupertino:
        bar-background-color: '#F2F2F7'
```

```dart
// lib/main.dart
import 'package:cupertino_ui/cupertino_ui.dart';
import 'package:spring_boot_starter_flutter_cupertino/spring_boot_starter_flutter_cupertino.dart';

import 'spring_gen/main.spring.dart';

@SpringBootApplication()
void main() => runApp(
  SpringApplicationWidget(
    application: () => springApplication,
    home: const CounterPage(), // CupertinoApp の中
  ),
);

@ChangeNotifierComponent()
class Counter {
  int value = 0;
  void increment() => value++;
}

class CounterPage extends SpringStatelessWidget<(Counter,)> {
  const CounterPage({super.key});

  @override
  Widget build(BuildContext context) {
    final (counter,) = beans;
    return CupertinoPageScaffold(
      navigationBar: const CupertinoNavigationBar(middle: Text('Counter')),
      child: Center(
        child: CupertinoButton.filled(
          onPressed: counter.increment,
          child: Text('${counter.value}'),
        ),
      ),
    );
  }
}
```

依存関係にこのスターターがなければ、`spring.flutter.app.type: cupertino` は起動を失敗させ、メッセージが追加すべきパッケージを示します: "the app widget of type cupertino is built by spring_boot_starter_flutter_cupertino: add it to the dependencies (this application has: widgets)"。

## 種類は推定される

例には `spring.flutter.app.type` がありません。Spring Boot がクラスパスから `spring.main.web-application-type` を推定するのと同じように、アプリケーションのスターターが決め、デザインのスターターがこれ一つならアプリは `cupertino` の種類になります。設定されていれば、常にプロパティが優先されます。`widgets` なら、このスターターがビルドにあっても `WidgetsApp` のままです。

| 依存関係にあるデザインのスターター | `spring.flutter.app.type` を設定しない | 設定する |
|---|---|---|
| このスターター | `cupertino` | 設定した種類 (`cupertino` または `widgets`) |
| このスターターと [Material のスターター](../spring-boot-starter-flutter-material/index.md) | 起動は失敗する。種類を選ぶ必要がある | 設定した種類。必要ならプラットフォームごとに |
| なし | `widgets` | `cupertino` は、このスターターを示して起動を失敗させる |

## Android では Material、iOS では Cupertino

Android では Material、iOS では Cupertino のアプリは、二つのデザインのスターターと二つのウィジェットライブラリに依存し、種類を設定します。すべてのプラットフォーム向けに `application.properties` で、そしてそのプラットフォームだけが読むプラットフォームのプロファイルでもう一度設定します ([プラットフォームのプロファイル](../spring-boot-starter-flutter/configuration.md#プラットフォームのプロファイル) を参照)。

```yaml
# pubspec.yaml
dependencies:
  material_ui: ^1.11.0
  cupertino_ui: ^1.1.6
  spring_boot_starter_flutter_material: ^0.9.0
  spring_boot_starter_flutter_cupertino: ^0.9.0
```

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

```properties
# lib/resources/application-ios.properties: ... そして iPhone と iPad では Cupertino
spring.flutter.app.type=cupertino
```

YAML での同じ内容:

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

一つのテーマが両方に使えます。パレット、タイポグラフィ、トークンは共有され、`components.*` は Material のアプリが、`cupertino.*` は Cupertino のアプリが読みます。Cupertino のバーは、`cupertino.bar-background-color` が設定されていなければ `components.app-bar.background-color` も使います ([テーマのプロパティ](theme-properties.md) を参照)。

## 内容

- [アプリのウィジェット](app-widget.md): `spring.flutter.app.type: cupertino` の `CupertinoApp` と、独自の `CupertinoApp`。
- [プロパティからのテーマ](themes.md): `spring.flutter.theme.*` から `CupertinoThemeData` がどう作られるか。ライトとダーク、実行時に読み込まれるテーマ。
- [テーマのプロパティ](theme-properties.md): `cupertino.*` のすべてのキーと、その型、デフォルト、効果。
- [シードからのパレット](palette.md): 明示的なロール、または Material なしでのシードカラーの Material 3 のパレット。
- [ページのトランジション](page-transitions.md): テーマからの、スワイプで戻れる iOS のスライド。
- [コードでのテーマ](themes-in-code.md): `CupertinoThemeCustomizer`、置き換える `CupertinoThemeData` Bean、`CupertinoThemes` Bean、テスト。
- [他のスターターとともに](other-starters.md): ナビゲーションのスターター、ログインフォームのコントロール、`MarkdownView`。

## Spring (Java) との対応

Spring にはアプリのテーマも、このスターターに相当するものもありません。形は Spring のものです。依存関係にあることで機能を追加するスターター、その Bean を持つ自動構成、カスタマイザーの Bean、そして Spring Boot が `META-INF/spring.factories` のエントリーを見つけるように、どの Bean よりも前に見つけられるファクトリーです。

## 関連項目

- [spring_boot_starter_flutter](../spring-boot-starter-flutter/index.md)
- [デザインライブラリ](../spring-boot-starter-flutter/design-libraries.md)
- [0.8 への移行](../spring-boot-starter-flutter/moving-to-0-8.md)
- [spring_boot_starter_flutter_material](../spring-boot-starter-flutter-material/index.md)
- [テーマのプロパティ](theme-properties.md)
- [ビルドに含まれるもの](optimizations.md)
