spring_boot_starter_flutter_cupertino

spring_boot_starter_flutter_cupertino は、spring_boot_starter_flutter の上に作られた 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 は入りません。

使う理由

セットアップ

# 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 を列挙します。

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 に追加します。

例

# lib/resources/application.properties
spring.flutter.app.title=Counter
spring.flutter.theme.seed-color=teal
spring.flutter.theme.cupertino.bar-background-color=#F2F2F7
# lib/resources/application.yml での同じ内容
spring:
  flutter:
    app:
      title: Counter
    theme:
      seed-color: teal
      cupertino:
        bar-background-color: '#F2F2F7'
// 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 のスターター 起動は失敗する。種類を選ぶ必要がある 設定した種類。必要ならプラットフォームごとに
なし widgets cupertino は、このスターターを示して起動を失敗させる

Android では Material、iOS では Cupertino

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

# 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
# lib/resources/application.properties: どこでも Material ...
spring.flutter.app.type=material
# lib/resources/application-ios.properties: ... そして iPhone と iPad では Cupertino
spring.flutter.app.type=cupertino

YAML での同じ内容:

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

種類がなければ、起動はプロパティと種類を示して失敗します。

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 も使います (テーマのプロパティ を参照)。

内容

Spring (Java) との対応

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

関連項目