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 は入りません。
使う理由
- プロパティからの
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 のフィールドとボタン。
セットアップ
# 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.flutter.app.type: cupertinoのCupertinoAppと、独自のCupertinoApp。 - プロパティからのテーマ:
spring.flutter.theme.*からCupertinoThemeDataがどう作られるか。ライトとダーク、実行時に読み込まれるテーマ。 - テーマのプロパティ:
cupertino.*のすべてのキーと、その型、デフォルト、効果。 - シードからのパレット: 明示的なロール、または Material なしでのシードカラーの Material 3 のパレット。
- ページのトランジション: テーマからの、スワイプで戻れる iOS のスライド。
- コードでのテーマ:
CupertinoThemeCustomizer、置き換えるCupertinoThemeDataBean、CupertinoThemesBean、テスト。 - 他のスターターとともに: ナビゲーションのスターター、ログインフォームのコントロール、
MarkdownView。
Spring (Java) との対応
Spring にはアプリのテーマも、このスターターに相当するものもありません。形は Spring のものです。依存関係にあることで機能を追加するスターター、その Bean を持つ自動構成、カスタマイザーの Bean、そして Spring Boot が META-INF/spring.factories のエントリーを見つけるように、どの Bean よりも前に見つけられるファクトリーです。