spring_boot_starter_flutter_material
spring_boot_starter_flutter_material は、spring_boot_starter_flutter の上に作られた Flutter アプリに Material Design を追加します。Flutter のスターターはデザインライブラリを知りません。Flutter 3.50 以降、Material は SDK の一部ではなく、Flutter チームのパッケージ material_ui だからです。このスターターは両者の橋渡しです。これがあれば、アプリは MaterialApp になり (spring.flutter.app.type: material。デザインのスターターがこれ一つなら設定は不要です)、spring.flutter.theme.* のすべてのテーマが Material の ThemeData になります。
使う理由
型 widgets のアプリは、ビルドに Material を含めずに、テーマ、パレット、テキストスタイルを持ちます (デザインライブラリを参照)。Scaffold、AppBar、FilledButton などの Material のウィジェットを使うアプリにはそれ以上が必要で、それをこのスターターがもたらします。
- プロパティからの
MaterialApp。 このスターターから推定される、またはspring.flutter.app.typeで設定される種類materialで、設定のタイトル、ロケール、テーマとともに。 spring.flutter.theme.*からの Material のThemeData。 色、タイポグラフィ、形状、そしてcomponents.*の下の約 50 のコンポーネントのテーマ (card、app-bar、filled-button、input、...)。それぞれ Flutter 自身のプロパティ名で書きます。- シードカラーからのパレット。
seed-color、scheme-variant、contrastが Material 3 のパレット (ColorScheme.fromSeed) を作ります。 - プロパティが及ばないところはコードでテーマを。
ThemeCustomizerBean はすべてのThemeDataを変更し、themeまたはdarkThemeという名前のThemeDataBean は作られたものを置き換えます。 - 他のスターターのための Material。 ナビゲーションのスターターのルーターのための Material のページルート、セキュリティスターターのログインフォームのための Material のテキストフィールドとボタン、
MarkdownViewでの Material のテキストスタイルと選択。
セットアップ
# pubspec.yaml
environment:
sdk: ^3.14.0
flutter: '>=3.50.0'
dependencies:
flutter:
sdk: flutter
material_ui: ^1.11.0 # Material のウィジェット
spring_boot_starter_flutter_material: ^0.9.0
dev_dependencies:
build_runner: ^2.17.0
spring_core_dart_generator: ^0.9.0
スターターは spring_boot_starter_flutter を連れてきて再エクスポートするため、アプリは Flutter のスターターの代わりにこのパッケージを列挙します。material_ui は再エクスポートしません。アプリは使うウィジェットのためにそれを列挙し、両方をインポートします。
import 'package:material_ui/material_ui.dart';
import 'package:spring_boot_starter_flutter_material/spring_boot_starter_flutter_material.dart';
Flutter 3.50 以降 (Dart 3.14) が必要です。追加した後、dart run build_runner build を一度実行してください。ジェネレーターがスターターを見つけ、その Bean とデザインを lib/spring_gen/main.spring.dart に追加します。
例
# lib/resources/application.yml
spring:
flutter:
app:
title: Counter
theme:
seed-color: deepPurple
components:
card: { elevation: level2, shape: large }
// lib/main.dart
import 'package:material_ui/material_ui.dart';
import 'package:spring_boot_starter_flutter_material/spring_boot_starter_flutter_material.dart';
import 'spring_gen/main.spring.dart';
@SpringBootApplication()
void main() => runApp(
SpringApplicationWidget(
application: () => springApplication,
home: const CounterPage(), // MaterialApp の中
),
);
@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 Scaffold(
body: Center(child: Text('${counter.value}')),
floatingActionButton: FloatingActionButton(
onPressed: counter.increment,
child: const Icon(Icons.add),
),
);
}
}
例には spring.flutter.app.type がありません。Spring Boot がクラスパスから spring.main.web-application-type を推定するのと同じように、アプリケーションのスターターが決め、デザインのスターターがこれ一つならアプリは material の種類になります。プロパティは選ぶためのものです。二つのデザインのスターターを持つアプリは、すべてのプラットフォーム向けに、そしてプロファイルでプラットフォームごとに設定します。設定がなければ、起動はプロパティと種類を示して失敗します (Android では Material、iOS では Cupertino を参照)。widgets なら、このスターターがビルドにあっても WidgetsApp のままです。設定されていれば、常にプロパティが優先されます。
依存関係にこのスターターがなければ、spring.flutter.app.type: material は起動を失敗させ、メッセージが追加すべきパッケージを示します: "the app widget of type material is built by spring_boot_starter_flutter_material: add it to the dependencies"。
内容
- アプリのウィジェット:
spring.flutter.app.type: materialのMaterialAppと、独自のMaterialApp。 - プロパティからのテーマ:
spring.flutter.theme.*の各テーマが Material のThemeDataになる方法、Flutter のスターターから来るものとこのスターターが追加するもの、ライト、ダーク、システム、実行時に読み込まれるテーマ。 - シードからのパレット:
seed-color、九つのスキームの変種、contrast、シードの上に手で設定するロール。 - 密度とインク:
visual-density、tap-target-size、インクのsplash。 - コンポーネントのテーマ:
components.*の書き方と、49 のコンポーネントそれぞれについて、すべてのプロパティを載せたページ。 - コードでのテーマ:
ThemeCustomizer、テーマの Bean の置き換え、順序、MaterialThemesBean、テスト。 - 他のスターターとともに: ナビゲーションのスターターのためのページルート、ログインフォームのコントロール、
MarkdownView。
すべてのデザインが共有するもの (色、タイポグラフィ、形状、トークン、スタイル、モーション、背景、ローダー) は、Flutter のスターターとともに説明されています: テーマ。
Spring (Java) との対応
Spring にはアプリのテーマも、このスターターに相当するものもありません。Spring に倣っているのは形です。依存関係にあることで機能を追加するスターター、その Bean を持つ自動構成、カスタマイザーの Bean (WebServerFactoryCustomizer が Web サーバーをカスタマイズするように)、そして Spring Boot が META-INF/spring.factories のエントリーを見つけるように、どの Bean よりも前に見つけられるファクトリーです。