エンジンのログ

flutter_scene は、伝えることを Flutter の debugPrint で書き出します。アプリのログの横に出る、素の行です。スターターはそれらを、ロガー flutter_scene のもとでアプリケーションのログに取り込みます。

使う理由

素の行には時刻もレベルもなく、絞ることもできず、アプリのログが出る場所にも届きません。ロガーのレコードになれば、エンジンのメッセージは時刻とレベルを持ち、アプリのログと同じ場所に出て (デバッグパネルの Logs タブにも)、他のロガーと同じように設定できます。

例

2026-11-13T19:35:55.592+02:00  INFO 48654 --- [main] flutter_scene : Unpacking glTF (nodes: 1, meshes: 1, materials: 1, skins: 0, animations: 0)
2026-11-13T19:35:55.933+02:00  WARN 48654 --- [main] flutter_scene : pipeline build took 66ms mid-frame. Draw this material once during a load screen...
# lib/resources/application.yml
logging:
  level:
    flutter_scene: warn    # うまくいかなかったことだけ

レベル

問題を伝えるメッセージ (失敗した、飛ばされた、見つからない、フレームの途中でビルドされたプログラム) は警告です。残りは info です。

どのメッセージがエンジンのものか

debugPrint は Flutter 全体で一つの関数なので、エンジンのメッセージは次のように見分けられます。

それ以外はすべて、これまでどおり debugPrint に進みます。捕まえられないもの: エンジンが print で書き出す少数の行。

プロパティ

キー 型 デフォルト 意味
spring.flutter.scene.engine-log bool true エンジンのメッセージをアプリケーションのログのレコードにするかどうか。false は debugPrint に手を付けない
logging.level.flutter_scene ログレベル ルートの値 エンジンのロガーのレベル。他のロガーと同じ

Bean は sceneEngineLog (SceneEngineLog) です。シーンがオンで、engine-log が false でないときに存在し、アプリケーションが閉じるときに debugPrint を元に戻します。

関連項目