
# spring_boot_starter_flutter_material

`spring_boot_starter_flutter_material` は、[spring_boot_starter_flutter](../spring-boot-starter-flutter/index.md) の上に作られた 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 を含めずに、テーマ、パレット、テキストスタイルを持ちます ([デザインライブラリ](../spring-boot-starter-flutter/design-libraries.md)を参照)。`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`) を作ります。
- **プロパティが及ばないところはコードでテーマを。** `ThemeCustomizer` Bean はすべての `ThemeData` を変更し、`theme` または `darkTheme` という名前の `ThemeData` Bean は作られたものを置き換えます。
- **他のスターターのための Material。** ナビゲーションのスターターのルーターのための Material のページルート、セキュリティスターターのログインフォームのための Material のテキストフィールドとボタン、`MarkdownView` での Material のテキストスタイルと選択。

## セットアップ

```yaml
# 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` は再エクスポートしません。アプリは使うウィジェットのためにそれを列挙し、両方をインポートします。

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

## 例

```yaml
# lib/resources/application.yml
spring:
  flutter:
    app:
      title: Counter
    theme:
      seed-color: deepPurple
      components:
        card: { elevation: level2, shape: large }
```

```dart
// 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](app-widget.md#android-では-materialios-では-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"。

## 内容

- [アプリのウィジェット](app-widget.md): `spring.flutter.app.type: material` の `MaterialApp` と、独自の `MaterialApp`。
- [プロパティからのテーマ](themes.md): `spring.flutter.theme.*` の各テーマが Material の `ThemeData` になる方法、Flutter のスターターから来るものとこのスターターが追加するもの、ライト、ダーク、システム、実行時に読み込まれるテーマ。
- [シードからのパレット](palette.md): `seed-color`、九つのスキームの変種、`contrast`、シードの上に手で設定するロール。
- [密度とインク](density-and-ink.md): `visual-density`、`tap-target-size`、インクの `splash`。
- [コンポーネントのテーマ](components/index.md): `components.*` の書き方と、49 のコンポーネントそれぞれについて、すべてのプロパティを載せたページ。
- [コードでのテーマ](themes-in-code.md): `ThemeCustomizer`、テーマの Bean の置き換え、順序、`MaterialThemes` Bean、テスト。
- [他のスターターとともに](other-starters.md): ナビゲーションのスターターのためのページルート、ログインフォームのコントロール、`MarkdownView`。

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

## Spring (Java) との対応

Spring にはアプリのテーマも、このスターターに相当するものもありません。Spring に倣っているのは形です。依存関係にあることで機能を追加するスターター、その Bean を持つ自動構成、カスタマイザーの Bean (`WebServerFactoryCustomizer` が Web サーバーをカスタマイズするように)、そして 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_cupertino](../spring-boot-starter-flutter-cupertino/index.md)
- [プロパティからのテーマ](themes.md)
- [コンポーネントのテーマ](components/index.md)
- [ビルドに含まれるもの](optimizations.md)
