
# すべてのプロパティ

`spring_boot_starter_flutter_navigation` が `spring.flutter.navigation` の下で読むすべてのプロパティです。一部はアプリの起動時に読まれます。ディープリンクのキーはビルド時に `spring_core_dart_generator` が読み、それらからプラットフォームのファイルを書き出します。

## 使う理由

ナビゲーションのほとんどはコード (画面とシェル) ですが、アプリが始まる場所、ガードが人を送る場所、言語、ディープリンクは設定です。これらはプラットフォーム、ビルド、顧客ごとに異なります。このページはそれらを一か所に列挙します。スターターのメタデータは、エディターのために同じキーを記述しています。

## 例

```yaml
# lib/resources/application.yml
spring:
  flutter:
    navigation:
      initial: /catalog
      login: /login
      redirects:
        "[/home]": /catalog
      languages: [en, ja]
      web:
        url-strategy: path
      deep-links:
        scheme: neonbooks
        domains: [books.example.com]
        exclude: [/checkout, /admin/**]
```

```properties
# lib/resources/application.properties: 同じ内容
spring.flutter.navigation.initial=/catalog
spring.flutter.navigation.login=/login
spring.flutter.navigation.redirects[/home]=/catalog
spring.flutter.navigation.languages=en,ja
spring.flutter.navigation.web.url-strategy=path
spring.flutter.navigation.deep-links.scheme=neonbooks
spring.flutter.navigation.deep-links.domains[0]=books.example.com
spring.flutter.navigation.deep-links.exclude[0]=/checkout
spring.flutter.navigation.deep-links.exclude[1]=/admin/**
```

`redirects` のキーはパスなので、角括弧で囲んで書きます: `[/home]` (YAML ではさらに引用符で囲みます)。

## spring.flutter.navigation

| キー | 型 | デフォルト | 読まれる時 | 意味 | ページ |
|---|---|---|---|---|---|
| `spring.flutter.navigation.initial` | パス | なし | 起動時 | プラットフォームが `/` を与える場合 (ディープリンクなし、サイトのルート) にアプリが始まる場所。`/catalog` など | [画面](screens.md#アプリが始まる場所) |
| `spring.flutter.navigation.login` | パス | なし | 起動時 | ガード付きの画面が、ログインしていない人を送る場所。アプリはログイン後に戻る。なければ、そうしたナビゲーションはエラー画面を表示する | [ガード](filters-and-guards.md#ガード付きの画面) |
| `spring.flutter.navigation.redirects.<from>` | パス | なし | 起動時 | 別のアドレスに導くアドレス (`"[/]": /catalog`)。同じパスのルート自身のリダイレクトが優先される | [画面](screens.md#アプリが始まる場所) |
| `spring.flutter.navigation.languages` | 言語タグのリスト | なし (一つの言語、プレフィックスなし) | 起動時とジェネレーターが | 独自のアドレスを持つ言語。最初のものがデフォルトでプレフィックスなし、他は `/<language>` の下。ビルドはそれぞれの言語で検索エンジンのためのページを書き出す | [言語](languages.md) |
| `spring.flutter.navigation.web.url-strategy` | `path`、`hash` | `path` | 起動時 | `/catalog/books/1`、または Flutter の `/#/catalog/books/1` | [Web](web-and-deep-links.md#ブラウザーのアドレス) |

## spring.flutter.navigation.deep-links

| キー | 型 | デフォルト | 読まれる時 | 意味 |
|---|---|---|---|---|
| `spring.flutter.navigation.deep-links.enabled` | bool | `true` | ジェネレーターが | ディープリンクを書き出すかどうか。プラットフォームのプロファイルで `false` にすると、そこで無効になる |
| `spring.flutter.navigation.deep-links.scheme` | URL スキーム | なし | ジェネレーターが | アプリ独自のスキーム。検証されないため、別のアプリが主張することがある |
| `spring.flutter.navigation.deep-links.domains` | ホスト名のリスト | なし | ジェネレーターが | `https` のリンクでアプリを開くドメイン (Universal Links、App Links) |
| `spring.flutter.navigation.deep-links.exclude` | パスパターンのリスト (Spring の構文) | なし | 起動時とジェネレーターが | リンクで開かないアドレス。代わりにアプリは最初の画面を開く |
| `spring.flutter.navigation.deep-links.app-id` | `TEAMID.bundle.id` | Xcode のプロジェクトから | ジェネレーターが | `apple-app-site-association` の iOS アプリ ID |
| `spring.flutter.navigation.deep-links.package` | Android のパッケージ | Gradle ファイルの `applicationId` | ジェネレーターが | `assetlinks.json` のパッケージ |
| `spring.flutter.navigation.deep-links.sha256-cert-fingerprints` | リスト | なし | ジェネレーターが | Android の署名鍵の SHA-256 フィンガープリント。なければ `assetlinks.json` は書き出されない |

書き出されるファイルについては [Web とディープリンク](web-and-deep-links.md) を参照してください。

## ナビゲーションが従う他のスターターのキー

| キー | スターター | 意味 |
|---|---|---|
| `spring.flutter.app.type` | Flutter | `MaterialApp.router` (`spring_boot_starter_flutter_material` とともに)、`CupertinoApp.router` (`spring_boot_starter_flutter_cupertino` とともに)、`WidgetsApp.router` |
| `spring.flutter.theme.motion.page-transition` | Flutter | すべての画面のトランジション ([トランジション](transitions.md) を参照) |
| `spring.flutter.theme.motion.scroll-to-top`、`motion.content-change` | Flutter | `RouteContentView` がページを切り替える方法 ([Markdown の画面](markdown-screens.md) を参照) |
| `spring.flutter.web.seo.from-routes` | Flutter | 検索エンジンのためのルートごとのページ ([SEO](../spring-boot-starter-flutter/seo.md) を参照) |

## 関連項目

- [概要](index.md)
- [spring_boot_starter_flutter のすべてのプロパティ](../spring-boot-starter-flutter/properties.md)
- [ビルドが読むプロパティ](../spring-core-dart-generator/build-properties.md)
