
# デバッグタブとログ

スターターは、Flutter のスターターの [デバッグパネル](../spring-boot-starter-flutter/debug-panel.md) に "State" というタブを追加します。いま存在する、追跡される状態を持つすべての Bean を、クラスごとに、メンバーを名前で列挙します。

## 使う理由

「なぜこれは再構築されたのか」や「なぜこのエフェクトはこんなに何度も実行されるのか」は、実行中のアプリについての質問です。タブは、値と回数をデバイス上で示します。

## 例

デバッグビルドでは、書くものは何もありません。タブはそこにあります。すべてのビルドに入れるには、次のようにします。

```yaml
# lib/resources/application.yml
spring:
  flutter:
    debug:
      enabled: true          # すべてのビルドにデバッグパネル
    signals:
      debug:
        enabled: true        # State タブ。未設定: デバッグビルドとプロファイルビルド
```

## 表示するもの

| メンバー | タブが示すもの |
|---|---|
| `@Signal` フィールド | その値と、何回代入されたか |
| `@Computed` の値 | いまの値 |
| 非同期の `@Computed` の値 | 読み込みがどこにあるかと、何回実行されたか |
| `@Effect` メソッド | 何回実行されたか |

メンバーは、最初に使われてから表示されます。誰も読んでいないフィールドは、まだ追跡されていません。値は、追跡せずに一秒に二回読まれます。タブは、自分が示す状態の読み手にはなりません。

## 隠す値

`@Signal(hidden: true)` は、値 (トークン、パスワード) をタブとログに出しません。何回変わったかだけが示されます。

```dart
@Signal(hidden: true)
String? token;
```

## ログ

ロガー `spring.flutter.signals` は、すべての代入とエフェクトのすべての実行を `debug` で書き出します。

```yaml
# lib/resources/application.yml
logging:
  level:
    spring.flutter.signals: debug
```

## プロパティ

| キー | 型 | デフォルト | 読まれる時 | 意味 |
|---|---|---|---|---|
| `spring.flutter.signals.debug.enabled` | `true`、`false` | 未設定 | 起動時とジェネレーターが | アプリが State タブを持つかどうか。`true` はすべてのビルド、`false` はどのビルドにもない (ビルドがそのコードを外す)、未設定はデバッグビルドとプロファイルビルドだけ |

タブは、ビルドにデバッグパネルがある場所 (`spring.flutter.debug.enabled`) に表示されます。[モジュールがアプリに含まれる時](../spring-boot-starter-flutter/debug-panel.md#モジュールがアプリに含まれる時) を参照してください。

## 関連項目

- [デバッグパネル](../spring-boot-starter-flutter/debug-panel.md)
- [エフェクト](effects.md)
- [spring_boot_starter_logging](../spring-boot-starter-logging/index.md)
