
# すべてのプロパティ

`spring_boot_starter_flutter` が読むすべてのプロパティを、プレフィックスごとにまとめています。各行には、キー、その型と指定できる値、デフォルト、働き、そしてそれを解説するページを示します。一部のキーはアプリが起動時に読み、他のキーはビルド時に `spring_core_dart_generator` が読んで、アプリや `web/` に書き込みます。「読まれる時」の列がそのどちらかを示します。

## 使う理由

スターターのほとんどは、コードではなくプロパティで設定します。このページはそのすべてを列挙した唯一の場所で、すべてのページを読まなくても、キー、そのデフォルト、その単位を確認できます。スターターのメタデータ (`lib/spring_gen/spring_metadata.json`) も同じキーを記述しているため、補完機能のあるエディターでも候補に出ます。

## 書き方

どのキーも、`lib/resources/` の `application.yml` や `application.properties`、プロファイルのファイル (`application-web.yml`、`application-release.yml`)、インポートされたファイル、または `--dart-define` で書けます。名前は緩やかです: `debug-banner`、`debugBanner`、`DEBUG_BANNER` は同じキーです。期間は `ms`、`s`、`m`、`h`、`d` を取ります (`400ms`、`5s`)。[Flutter アプリでの設定](configuration.md) を参照してください。

## 例

三つのファイルに分けた、ショップのアプリの実際的な設定です。

```yaml
# lib/resources/application.yml
spring:
  config:
    import: resources:themes/brand.yml
  flutter:
    app:
      type: material
      title: NEON Books
      description: The bookshop of the NEON district.
      debug-banner: false
      locales: en, ja
    shortcuts:
      search.open: [primary+k, slash]
      debug.open: [primary+shift+d, taps:4+hold:3s]
    lifecycle:
      pause-in-background: true
    fonts:
      auto-load: true
      exclude: [assets/pdf/**]
    splash:
      tasks:
        timeout: 5s
        share: 0.2
    theme:
      active: system
      remember: true
      seed-color: deepPurple
  datasource:
    url: sqlite:file:books.db
    sqlite:
      location: support
```

```yaml
# lib/resources/application-desktop.yml
spring:
  flutter:
    desktop:
      window:
        title: NEON Books
        title-bar: transparent
        initial-size: 1280x800
        min-size: 800x600
```

```yaml
# lib/resources/application-web.yml
spring:
  flutter:
    splash:
      yield-frames: true
      frame-budget: 8ms
      warm-up:
        text:
          enabled: true
    web:
      page:
        swipe-to-close: false
        max-pixel-ratio: 2
        translate: false
      dev-server:
        port: 5050
        proxy:
          - prefix: /api/
            target: http://localhost:8080
      seo:
        enabled: true
        site-url: https://books.example.com
        from-routes: true
```

このショップのアプリは Material のアプリです。`type: material` と `seed-color` には、依存関係に `spring_boot_starter_flutter_material` が必要です ([デザインライブラリ](design-libraries.md) を参照)。デザインのスターターがそれ一つなら、`type: material` は省けます。スターターが決めます。

## spring.flutter.app

起動時に読まれます。[アプリのウィジェット](app-widget.md) を参照してください。

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.flutter.app.type` | テキスト: `widgets`、`material`、`cupertino`、または独自のアプリファクトリーの種類 | 未設定: 唯一のデザインのスターターの種類 (`material`、`cupertino`)、なければ `widgets`。複数あるときは必須 | アプリのウィジェット: `WidgetsApp`、`MaterialApp` (`spring_boot_starter_flutter_material` が必要)、`CupertinoApp` (`spring_boot_starter_flutter_cupertino` が必要) |
| `spring.flutter.app.title` | テキスト | 空 | OS に対するアプリの名前 (タスクスイッチャー、ブラウザーのタブ)。Web のビルドは `web/index.html` と `web/manifest.json` に書き込む |
| `spring.flutter.app.description` | テキスト | なし | アプリが何であるかを一文で。Web のビルドは `web/index.html` (`<meta name="description">`) とマニフェストに書き込む |
| `spring.flutter.app.debug-banner` | bool | `true` | デバッグビルドでの Flutter の DEBUG バナー |
| `spring.flutter.app.locales` | カンマ区切りの言語タグ (`en,ja,pt_BR`) | メッセージファイルの言語 | アプリがサポートするロケール。YAML でも一つのカンマ区切りの値で書く |

`spring.flutter.app.type` は、Spring Boot がクラスパスから `spring.main.web-application-type` を推定するのと同じように推定されます。デザインのスターターが一つ (または独自の種類の `SpringAppFactory` Bean が一つ) あればアプリはその種類になり、なければ `widgets` です。複数の種類のアプリファクトリーがあるとき (たとえば二つのデザインのスターター)、起動はプロパティと種類を示して失敗し、すべてのプラットフォーム向けに、またはプロファイル (`application-ios.properties`) でプラットフォームごとに、一つを選ぶよう求めます。設定されていれば、プロパティが常に優先されます。[種類を設定しないとき](app-widget.md#種類を設定しないとき) を参照してください。

## spring.flutter (全般)

| キー | 型 | デフォルト | 読まれる時 | 意味 | ページ |
|---|---|---|---|---|---|
| `spring.flutter.scan-os-environment` | bool | `false` | 起動時、`--dart-define` からのみ | OS の環境変数をプロパティとして読む (デスクトップで便利)。設定ファイルからは設定できない | [設定](configuration.md#os-の環境) |
| `spring.flutter.shortcuts.<action>` | キー、タップのパターン、またはリスト | アクションの `@Shortcut(keys:)` | 起動時 | アクションのキーやタップ: `primary+k`、`char:?`、`taps:4+hold:3s`、`[alt+left, primary+bracket-left]` | [ショートカット](shortcuts.md) |

## spring.flutter.lifecycle と spring.devtools

| キー | 型 | デフォルト | 意味 | ページ |
|---|---|---|---|---|
| `spring.flutter.lifecycle.pause-in-background` | bool | `true` | バックグラウンドでコンテキストを一時停止し (`@Scheduled` のタスク、WebSocket の接続、その他の一時停止可能なライフサイクルの Bean が止まる)、フォアグラウンドで再開する | [アプリのライフサイクル](lifecycle.md) |
| `spring.devtools.restart.enabled` | bool | `true` | 生成コード (Bean、アノテーション、`lib/resources/`) が変わったとき、ホットリロードがコンテキストを再起動する | [ホットリロード](hot-reload.md) |

## spring.flutter.fonts

| キー | 型 | デフォルト | 意味 | ページ |
|---|---|---|---|---|
| `spring.flutter.fonts.auto-load` | bool | `true` | 最初のフレームの前に、すべての `.ttf` と `.otf` のアセットを、ファイルが示すファミリーに読み込む | [アセットとフォント](assets-and-fonts.md) |
| `spring.flutter.fonts.exclude` | glob のリスト | なし | 読み込まないフォントのアセット (`assets/pdf/**`) | [アセットとフォント](assets-and-fonts.md) |
| `spring.flutter.fonts.families.<family>.files` | アセットのリスト | なし | 名前で宣言したファミリーのファイル (ウェブでは `.woff2` も) | [アセットとフォント](assets-and-fonts.md) |
| `spring.flutter.fonts.families.<family>.languages` | 言語タグのリスト | なし | ファミリーが対象とする言語。アプリがその言語の一つを表示するときにだけ読み込まれる | [アセットとフォント](assets-and-fonts.md) |

## spring.flutter.splash

起動時に読まれます。スプラッシュの見た目はテーマの `splash` です。[スプラッシュと起動](splash.md) を参照してください。

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.flutter.splash.yield-frames` | bool | Web では `true`、それ以外では `false` | Bean の作成中に、Bean の間で Flutter にフレームを描かせ、スプラッシュが動き続けるようにする。`false` はペーサーを無効にする |
| `spring.flutter.splash.frame-budget` | 期間 | `8ms` | `yield-frames` が有効なときの、二つのフレームの間の処理 |
| `spring.flutter.splash.trace` | bool | `false` | 起動 (各ステージ、各 Bean の作成) を計測し、最後にログに出す。Web では Performance タブにも |
| `spring.flutter.splash.tasks.enabled` | bool | `true` | アプリが表示される前に `SplashTask` Bean を実行する。`false`: 何も実行されない |
| `spring.flutter.splash.tasks.timeout` | 期間 | `5s` | スプラッシュがタスクを待つ時間。まだ実行中のものはアプリの背後で続く |
| `spring.flutter.splash.tasks.share` | 0 から 1 の数値 | `0.2` | アプリにタスクがある場合に、タスクが占めるローダーの割合 |
| `spring.flutter.splash.warm-up.text.enabled` | bool | `false` | スプラッシュの表示中にアプリのテキストの文字をレイアウトし、必要なフォントを先にダウンロードする (Web で効果がある) |
| `spring.flutter.splash.warm-up.text.resources` | 場所のパターンのリスト | `resources:messages*.properties` | その文字をレイアウトするファイル |
| `spring.flutter.splash.warm-up.text.first-font` | 期間 | `400ms` | この時間内にフォントがダウンロードされなければ、何も必要ない |
| `spring.flutter.splash.warm-up.text.settle` | 期間 | `250ms` | フォントが届いた後、次が届かないままウォームアップを終えるまでの時間 |
| `spring.flutter.splash.warm-up.text.chunk` | 数値 | `200` | 一フレームでレイアウトする文字数 |

## spring.flutter.debug と spring.flutter.frame-meter

| キー | 型 | デフォルト | 読まれる時 | 意味 | ページ |
|---|---|---|---|---|---|
| `spring.flutter.debug.enabled` | bool | 未設定 | ジェネレーターが (と起動時) | `true`: デバッグパネルはすべてのビルドに含まれる。`false`: どれにも含まれない (コードなし)。未設定: デバッグとプロファイルのビルドだけ | [デバッグパネル](debug-panel.md) |
| `spring.flutter.debug.frame-meter.enabled` | bool | 未設定 | ジェネレーターが (と起動時) | フレームメーターのモジュールについて同じ。`true`: すべてのビルドに含まれる。`false`: どれにも含まれない (コードなし)。未設定: デバッグとプロファイルのビルドだけ | [デバッグパネル](debug-panel.md#モジュール) |
| `spring.flutter.debug.motion.enabled` | bool | 未設定 | ジェネレーターが (と起動時) | モーションのスイッチのモジュールについて同じ | [デバッグパネル](debug-panel.md#モジュール) |
| `spring.flutter.debug.timeline.enabled` | bool | 未設定 | ジェネレーターが (と起動時) | タイムラインのモジュールについて同じ。これがあると、各 Bean の作成が計測される | [タイムライン](timeline.md) |
| `spring.flutter.debug.timeline.position` | corner | `bottom-left` | 起動時 | タイムラインのピルの隅 | [タイムライン](timeline.md) |
| `spring.flutter.debug.isolates.enabled` | bool | 未設定 | ジェネレーターが (と起動時) | タスクマネージャーのモジュールについて同じ | [タスクマネージャー](isolates.md) |
| `spring.flutter.debug.isolates.position` | corner | `bottom-right` | 起動時 | タスクマネージャーの表の隅 | [タスクマネージャー](isolates.md) |
| `spring.flutter.debug.isolates.interval` | duration | `1s` | 起動時 | タスクマネージャーが行を読み取る間隔 | [タスクマネージャー](isolates.md) |
| `spring.flutter.debug.drag.enabled` | bool | 未設定: 決して含まれない | ジェネレーターが | `true`: デバッグオーバーレイをドラッグできる。そうでなければそのためのコードはない | [デバッグオーバーレイ](overlays.md#ドラッグ) |
| `spring.flutter.debug.overlays.layout` | `auto`、`stack`、`pages` | `auto` | 起動時 | 一つの隅のオーバーレイの組み合わせ方 | [デバッグオーバーレイ](overlays.md#レイアウト) |
| `spring.flutter.debug.overlays.max-height` | fraction | `0.4` | 起動時 | `auto` のための隅の余地 | [デバッグオーバーレイ](overlays.md#レイアウト) |
| `spring.flutter.debug.overlays.margin.top` / `bottom` / `left` / `right` | 論理ピクセル | `0` | 起動時 | セーフエリアの外側の余白 | [デバッグオーバーレイ](overlays.md#レイアウト) |
| `spring.flutter.debug.overlays.drag.snap` | `corners`、`free` | `corners` | 起動時 | ドロップしたオーバーレイの行き先 | [デバッグオーバーレイ](overlays.md#ドラッグ) |
| `spring.flutter.debug.overlays.drag.remember` | bool | `true` | 起動時 | 動かしたオーバーレイが再起動後も位置を保つかどうか | [デバッグオーバーレイ](overlays.md#ドラッグ) |
| `spring.flutter.frame-meter.enabled` | bool | `false` | 起動時 | アプリの上にフレームメーターを表示する | [フレームメーター](frame-meter.md) |
| `spring.flutter.frame-meter.position` | `top-left`、`top-right`、`bottom-left`、`bottom-right` | `top-right` | 起動時 | 表示する隅。セーフエリアの内側 | [フレームメーター](frame-meter.md) |
| `spring.flutter.markdown.placeholders` | bool | `false` | 起動時 (とジェネレーターが) | Markdown のページの `{{key}}` を、設定のそのキーの値に置き換える。値のないものは残る | [Markdown](markdown.md#設定の値) |
| `spring.flutter.frame-meter.target-rate` | 数値 | `60` | 起動時 | 画面が表示すべき毎秒のフレーム数。`1 / target-rate` 以内は良好、その 2 倍までは警告、それ以上はドロップ | [フレームメーター](frame-meter.md) |

## spring.flutter.desktop.window

起動時に、macOS、Windows、Linux でだけ読まれます。[デスクトップのウィンドウ](desktop-window.md) を参照してください。

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.flutter.desktop.window.title` | テキスト | ランナーのもの | ウィンドウのタイトル (タイトルバー、Dock、タスクバー、ウィンドウスイッチャー)。空の値はなしと同じ |
| `spring.flutter.desktop.window.title-bar` | `default`、`transparent`、`hidden` | `default` | OS のタイトルバー、コンテンツがその下に描かれる透明なもの、またはなし |
| `spring.flutter.desktop.window.initial-size` | `<width>x<height>`、論理ピクセル | ランナーのもの | ウィンドウが開くときのコンテンツのサイズ。中央に配置される |
| `spring.flutter.desktop.window.min-size` | `<width>x<height>` | なし | ユーザーがウィンドウをドラッグして縮められる最小のサイズ |
| `spring.flutter.desktop.window.max-size` | `<width>x<height>` | なし | ユーザーがウィンドウをドラッグして広げられる最大のサイズ |

## spring.flutter.web.page

ジェネレーターが読み、`web/index.html` に書き込みます。[Web](web.md#アプリを囲むページ) を参照してください。

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.flutter.web.page.swipe-to-close` | bool | `true` | `false`: アプリ内ブラウザー (メッセンジャーやソーシャルアプリのもの) で下にスワイプすると、ページを閉じる代わりにアプリをスクロールする |
| `spring.flutter.web.page.max-pixel-ratio` | 1 以上の数値 | 画面自身のもの | Flutter が描画するポイントあたりの最大のピクセル数。`2` は 3 倍のスマートフォンの画面を 2.25 分の 1 のコストで描く |
| `spring.flutter.web.page.translate` | bool | `true` | `false` は `translate="no"` と `<meta name="google" content="notranslate">` を書き込み、翻訳が提案されないようにする |
| `spring.flutter.web.page.wasm-allow-list.<engine>` | エンジンごとの bool: `blink`、`gecko`、`webkit` | 未設定: Flutter 自身のもの (Chrome と Edge だけ) | `--wasm` ビルドの WebAssembly を実行するブラウザーのエンジン。`gecko` は Firefox 147 以降、`webkit` は Safari 26.2 以降。ほかの名前や値はビルドを失敗させる |

## spring.flutter.web.dev-server

ジェネレーターが読み、`flutter run` (Flutter 3.38 以降) のために `web_dev_config.yaml` を書き出します。[Web](web.md#flutter-run-の開発サーバー) と [Web の開発サーバー](../spring-core-dart-generator/flutter/web-dev-server.md) を参照してください。

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.flutter.web.dev-server.host` | 空でないテキスト | 任意のアドレス | 開発サーバーが待ち受けるアドレス (`localhost`、`0.0.0.0`) |
| `spring.flutter.web.dev-server.port` | 0 から 65535 の整数 | 空いているポート | ポート。0 は空いているものを選ぶ。ブラウザーがブロックするポートは警告になる |
| `spring.flutter.web.dev-server.base-href` | `/` で始まり `/` で終わるパス | `/` | アプリが配信されるパス |
| `spring.flutter.web.dev-server.https.cert-path` | ファイルパス | なし (HTTP) | TLS の証明書 (PEM)。HTTPS の二つのキーは両方とも設定するか、どちらも設定しない |
| `spring.flutter.web.dev-server.https.cert-key-path` | ファイルパス | なし | 証明書の秘密鍵 (PEM) |
| `spring.flutter.web.dev-server.headers.<Name>` | テキスト | なし | すべての応答に追加されるヘッダー |
| `spring.flutter.web.dev-server.proxy[n].target` | 絶対 URL | なし | ルール `n` に一致するリクエストの転送先。必須 |
| `spring.flutter.web.dev-server.proxy[n].prefix` | パス | なし | ルール `n` は、これで始まるパスに一致する |
| `spring.flutter.web.dev-server.proxy[n].regex` | 正規表現 | なし | または、これに一致するパス。`prefix` と `regex` のちょうど一方 |
| `spring.flutter.web.dev-server.proxy[n].replace` | テキスト | パスをそのまま | 転送されるパス。グループには `$1` を使う |
| `spring.flutter.web.dev-server.content-security-policy` | テキスト | なし。spa モードでは用意されたポリシー | `Content-Security-Policy` ヘッダー |
| `spring.flutter.web.dev-server.content-security-policy-report-only` | bool | `false` | ポリシーを `Content-Security-Policy-Report-Only` として送る |
| `spring.flutter.web.dev-server.content-security-policy-connect-src` | オリジンのリスト | なし | spa モードの用意されたポリシーの `connect-src` に追加するオリジン |

## spring.flutter.web.seo

ジェネレーターが読み、ページを `web/` に書き出します。[SEO](seo.md) と [検索エンジン向けのページ](../spring-core-dart-generator/flutter/seo.md) を参照してください。

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.flutter.web.seo.enabled` | bool | `false` | ビルドがページを書き出すかどうか |
| `spring.flutter.web.seo.site-url` | URL | なし。有効にする場合は必須 | `canonical`、`og:url`、サイトマップのためのサイトのアドレス |
| `spring.flutter.web.seo.from-routes` | bool | `false` | ナビゲーションのスターターのすべての画面がページになる |
| `spring.flutter.web.seo.title` | テキスト | `{title}` | `<title>` のパターン。`{title}` はページ自身のもの |
| `spring.flutter.web.seo.description` | テキスト | なし | 説明を持たないページの説明 |
| `spring.flutter.web.seo.image` | 場所または URL | なし | 画像を持たないページのプレビュー画像 (約 1200×630) |
| `spring.flutter.web.seo.site-name` | テキスト | なし | `og:site_name` |
| `spring.flutter.web.seo.exclude` | glob のリスト | なし | すべての Markdown のフォルダーから除外するファイル (`**/contents*.md`) |
| `spring.flutter.web.seo.content[n].location` | 場所 | なし | Markdown ファイルのフォルダー。ファイルごとに一つのページ |
| `spring.flutter.web.seo.content[n].path` | パス | `/` | フォルダーのアドレス |
| `spring.flutter.web.seo.content[n].exclude` | glob のリスト | なし | そのフォルダーから除外するファイル |
| `spring.flutter.web.seo.pages[n].path` | パス | なし | 手で指定するページ、またはルートのページの上書き |
| `spring.flutter.web.seo.pages[n].title` | テキスト | なし | そのタイトル |
| `spring.flutter.web.seo.pages[n].description` | テキスト | なし | その説明 |
| `spring.flutter.web.seo.pages[n].image` | 場所または URL | なし | そのプレビュー画像 |
| `spring.flutter.web.seo.pages[n].index` | bool | `true` | `false`: `noindex`、サイトマップに含めない |
| `spring.flutter.web.seo.sitemap` | bool | `true` | `sitemap.xml` と `robots.txt` を書き出す |
| `spring.flutter.web.seo.llms` | bool | `true` | `llms.txt` と `llms-full.txt` を書き出す |
| `spring.flutter.web.seo.markdown` | bool | `true` | 各ページの Markdown をその隣 (`<path>.md`) に書き出す |
| `spring.flutter.web.seo.page-files` | `directory`、`html` | `directory` | `<path>/index.html` または `<path>.html` |

## spring.flutter.resources

起動時に読まれます。[ネットワーク上のリソース](resources.md) を参照してください。

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.flutter.resources.cache.enabled` | bool | `true` | `ResourceLoader` の `http:` / `https:` リソース (`@Value` の `Resource`、`ResourceView`、`ResourceImage`) を一度ダウンロードし、ファイルの `cache` の場所の `spring/resources/` の下に保持するかどうか |
| `spring.flutter.resources.cache.max-age` | 期間 | `7d` | 保持したリソースをそのまま使う期間。過ぎても使い続け、バックグラウンドで `If-None-Match` / `If-Modified-Since` を付けて問い合わせ直す (変わっていなければダウンロードはない) |
| `spring.flutter.resources.cache.max-entry-size` | データ量 | `50MB` | 保持する最大のリソース。これより大きいものは毎回ネットワークから読む |
| `spring.flutter.resources.cache.max-size` | データ量 (`200MB`) | なし: システムの上限だけ | 保持するリソース全体の最大バイト数。超えると、最も長く使われていないものから消える。数えるのはそのフォルダー (`spring/resources/`) だけ: ディスク上の `@Cacheable` のキャッシュ ([`spring.cache.disk.max-size`](../spring-boot-starter-cache/disk-caches.md)) には別の上限がある |
| `spring.flutter.resources.cache.locations[n].pattern` | アドレスのパターン: `**` は任意のパス、`*` は 1 つのセグメント | なし | 規則 `n` の対象のアドレス (`https://avatars.steamstatic.com/**`)。最初に一致した規則が勝つ |
| `spring.flutter.resources.cache.locations[n].max-age` | 期間 | `spring.flutter.resources.cache.max-age` | 規則に一致したリソースの期間 |
| `spring.flutter.resources.cache.locations[n].enabled` | bool | `true` | `false`: 規則に一致したリソースは保持せず、毎回ネットワークから読む |
| `spring.flutter.resources.view.fade` | 期間 | `200ms` | リソースが届いてから、`ResourceView` がそれをプレースホルダーの上にフェードインさせる時間。`0` ならすぐに表示する。システムが動きを減らすよう求めている場合も同じ |

## spring.datasource (SQLite)

アプリに `spring_boot_starter_data` と SQL のデータソースがある場合に、起動時に読まれます。[SQLite データベース](sqlite.md) を参照してください。

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.datasource.url` | URL | なし | データベースの URL。相対的な `sqlite:file:` の名前では、ファイルはアプリのディレクトリに置かれる |
| `spring.datasource.sqlite.location` | `support`、`cache`、`documents` | `support` | データベースを置くアプリのディレクトリ。それ以外の値は起動を止める |
| `spring.datasource.sqlite.base-directory` | パス | `location` のディレクトリ | スターターが最も低い優先度で設定する。独自の値が優先される |
| `spring.datasource.sqlite.isolate` | bool | `true` | スターターが設定する: 各接続が専用の isolate で動く。`false` は呼び出しを UI の isolate にとどめる |
| `spring.datasources.<name>.url` | URL | なし | 名前付きのデータソースについての同じもの |
| `spring.datasources.<name>.sqlite.location` | `support`、`cache`、`documents` | `support` | 名前付きのデータソースについての同じもの |

## spring.flutter.theme

アプリの見た目です。起動時に読まれ、型付きのキー (`context.theme`) と Web のページのローダーのためにジェネレーターも読みます。テーマには独自のリファレンスがあります。ルートと各 `themes.<name>` のキーは [テーマのプロパティ](themes/properties.md) に、Material のコンポーネントは Material のスターターの [コンポーネントのテーマ](../spring-boot-starter-flutter-material/components/index.md) に、`cupertino.*` は [Cupertino のテーマのプロパティ](../spring-boot-starter-flutter-cupertino/theme-properties.md) に列挙しています。

| キー | 型 | デフォルト | 意味 | ページ |
|---|---|---|---|---|
| `spring.flutter.theme.active` | `system` またはテーマ名 | `system` | 起動時に表示するテーマ | [テーマのプロパティ](themes/properties.md) |
| `spring.flutter.theme.system-light` | テーマ名 | `light` | デバイスのライトモードで `system` が表示するもの | [テーマのプロパティ](themes/properties.md) |
| `spring.flutter.theme.system-dark` | テーマ名 | `dark` | デバイスのダークモードで `system` が表示するもの | [テーマのプロパティ](themes/properties.md) |
| `spring.flutter.theme.remember` | bool | `true` | ユーザーが選んだテーマを実行をまたいで保持し、スプラッシュの背後で再び表示する | [テーマ](themes/index.md) |
| `spring.flutter.theme.source` | `https` の URL または `github:owner/repo/path@ref` | なし | すべてのテーマのためにダウンロードされるファイル。その値はすべてのテーマで共有される | [テーマのプロパティ](themes/properties.md#url-からのテーマ) |
| `spring.flutter.theme.source-sha256` | 64 桁の 16 進数 | なし | 別のダイジェストを持つダウンロードを拒否する | [テーマのプロパティ](themes/properties.md#url-からのテーマ) |
| `spring.flutter.theme.refresh` | 期間 | なし | キャッシュがそれより古い場合に、バックグラウンドでアドレスを再び確認する | [テーマのプロパティ](themes/properties.md#url-からのテーマ) |
| `spring.flutter.theme.themes.<name>.extends` | テーマ名 | ルート | 元にするテーマ | [テーマのプロパティ](themes/properties.md) |
| `spring.flutter.theme.themes.<name>.source`、`.source-sha256`、`.refresh` | 上と同じ | なし | URL からダウンロードされ、キャッシュされ、更新されるテーマ | [テーマのプロパティ](themes/properties.md#url-からのテーマ) |
| `brightness` | `light`、`dark` | `light` (`dark` では `dark`) | テーマがライトかダークか | [テーマのプロパティ](themes/properties.md) |
| `seed-color` | 色 | なし: Flutter のベースラインのパレット | パレットを作る元の色。デザインのスターター (Material または Cupertino) が必要で、なければ起動が失敗する | [色](themes/colors.md) |
| `scheme-variant` | `tonal-spot`、`fidelity`、`content`、`vibrant`、`expressive`、`monochrome`、`neutral`、`rainbow`、`fruit-salad` | `tonal-spot` | シードからパレットを作る方法。デザインのスターターが必要 | [色](themes/colors.md) |
| `contrast` | -1 から 1 の数値 | `0` | パレットのコントラスト。デザインのスターターが必要 | [色](themes/colors.md) |
| `colors.<role>` | 色 | シードから、なければ Flutter のベースライン | Material の 46 のロールの一つ | [色](themes/colors.md) |
| `typography.*` | マップ | Material のもの | フォントファミリー、フォールバック、15 のテキストスタイルと `code` | [タイポグラフィ](themes/typography.md) |
| `shape.<token>` | 数値 | Material 3 のもの | 角のスケール | [形状、余白、エレベーション](themes/shape-spacing-elevation.md) |
| `elevation.<level>` | 数値 | 0、1、3、6、8、12 | `level0` から `level5` | [形状、余白、エレベーション](themes/shape-spacing-elevation.md) |
| `spacing.<name>` | 数値 | `xs` 4、`s` 8、`m` 16、`l` 24、`xl` 32 | 独自のウィジェットの間隔 | [形状、余白、エレベーション](themes/shape-spacing-elevation.md) |
| `visual-density` | `adaptive`、`standard`、`comfortable`、`compact` | Flutter のもの | コンポーネントをどれだけ詰めて配置するか。`spring_boot_starter_flutter_material` が読む | [密度とインク](../spring-boot-starter-flutter-material/density-and-ink.md) |
| `tap-target-size` | `padded`、`shrink-wrap` | Flutter のもの | 最小のタップ領域。`spring_boot_starter_flutter_material` が読む | [密度とインク](../spring-boot-starter-flutter-material/density-and-ink.md) |
| `splash` | `ripple`、`sparkle`、`none`、またはマップ | Flutter のインク | タップのインクの効果 (`spring_boot_starter_flutter_material` が読む)、または (マップとして) 起動時のスプラッシュ画面 (すべてのアプリ) | [ローダーとスプラッシュ](themes/loaders.md) |
| `motion.*` | マップ | | `page-transition`、`text-change`、`content-change`、`scroll-to-top`、`wheel-scroll`、`overscroll`、`durations`、`curves`。`zoom` と `cupertino` の遷移にはそのデザインのスターターが必要 | [モーションとアニメーション](themes/motion-and-animations.md) |
| `animations.<name>.*` | マップ | なし | 名前付きのアニメーション: `duration`、`curve`、`repeat` | [モーションとアニメーション](themes/motion-and-animations.md) |
| `components.<component>.*` | マップ | Material 3 のもの | Material の 49 のコンポーネントテーマの一つ。`spring_boot_starter_flutter_material` が読む | [コンポーネントのテーマ](../spring-boot-starter-flutter-material/components/index.md) |
| `cupertino.*` | マップ | iOS のもの | `CupertinoThemeData`。`spring_boot_starter_flutter_cupertino` が読む | [Cupertino のテーマのプロパティ](../spring-boot-starter-flutter-cupertino/theme-properties.md) |
| `tokens.*` | 任意 | なし | 任意の深さの独自の値 | [トークンと参照](themes/tokens-and-references.md) |
| `styles.<name>.*` | マップ | なし | 独自のウィジェットのための状態ごとの見た目 | [スタイルと状態](themes/styles-and-states.md) |
| `styles.code.*`、`styles.heading.*`、`styles.link.color`、`styles.table.*`、`styles.callout.*` | マップ | カラースキーム | `MarkdownView` の見た目 | [MarkdownView](markdown.md) |
| `syntax.<language>.*` | マップ | なし | コードブロックの言語 | [スタイルと状態](themes/styles-and-states.md) |
| `background.*` | マップ | なし | すべての画面の背後の色、画像、オーバーレイ、アニメーション | [背景](themes/background.md) |
| `loaders.<name>.*` | マップ | なし | `ThemeLoader`、`ThemeSkeleton`、スプラッシュのためのローダー | [ローダーとスプラッシュ](themes/loaders.md) |
| `frame-meter.*` | マップ | カラースキーム | フレームメーターの見た目 | [フレームメーター](frame-meter.md) |

`brightness` 以下のキーは、`spring.flutter.theme` のルート (すべてのテーマで共有) か、`spring.flutter.theme.themes.<name>` に書きます。

デザインのプロパティ (`components`、`visual-density`、`tap-target-size`、単一の値の `splash`、`cupertino`) は、それを読むスターターのないアプリでも受け入れられます。表示されず、チェックもされず、`spring_boot_starter_flutter.SpringThemes` の INFO の行がプロパティごとに一度、そのスターターの名前を挙げます。キーは引き続きチェックされます。綴りを誤った `componets` は起動を失敗させます。

## スターターが使う他のモジュールのキー

| キー | 型 | デフォルト | 意味 | ページ |
|---|---|---|---|---|
| `spring.remote.allow-insecure` | bool | `false` | テーマがダウンロードするアドレスに `http://` (と、Web 以外では無効な証明書) を許可する。それらを列挙する警告が出る | [テーマのプロパティ](themes/properties.md) |
| `spring.messages.basename` | カンマ区切りの名前 | `messages` | メッセージファイル。アプリのロケールはそれに従う | [メッセージと言語](messages.md) |
| `spring.messages.use-code-as-default-message` | bool | `false` | 存在しないコードでコード自体を表示する | [メッセージと言語](messages.md) |
| `spring.profiles.active` | カンマ区切りのリスト | なし | 独自のプロファイル。プラットフォームとビルドのものに追加される | [設定](configuration.md) |
| `spring.config.import` | 場所 | なし | さらなる設定ファイル: `resources:`、`asset:`、`https://` | [設定](configuration.md#インポート) |
| `logging.level.<logger>` | `trace` ... `off` | `info` | ログレベル (スターターは `spring_boot_starter_flutter.*` としてログを出す) | [ロギング](../spring-core-dart/logging/index.md) |
| `spring.web.resources.cache.cachecontrol.*` | Spring Boot の `Cache-Control` のディレクティブ (`max-age`、`cache-public`...) | なし | ブラウザーと同じように設定を読むジェネレーターが使う: `web/_headers` の規則、つまりブラウザーが Web ビルドのファイルを保持する期間 | [Web ビルドのブラウザーキャッシュ](cache-headers.md) |

## 関連項目

- [Flutter アプリでの設定](configuration.md)
- [テーマのプロパティ](themes/properties.md)
- [ビルドが読むプロパティ](../spring-core-dart-generator/build-properties.md)
- [エディター用のメタデータ](../spring-core-dart-generator/metadata.md)
