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 のウィジェットを使うアプリにはそれ以上が必要で、それをこのスターターがもたらします。

セットアップ

# 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"。

内容

すべてのデザインが共有するもの (色、タイポグラフィ、形状、トークン、スタイル、モーション、背景、ローダー) は、Flutter のスターターとともに説明されています: テーマ。

Spring (Java) との対応

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

関連項目