タスクマネージャー

タスクマネージャーは、アプリの中で動いているものと、それぞれがどれだけ働いているかを列挙します。アプリ自身の isolate、そのために描画とデコードを行うエンジンのスレッド、そしてアプリが重い処理のために起動するすべての isolate です。アプリの上の小さな表が要点を示し、デバッグパネルにはすべての数値があります。

使う理由

Flutter アプリで「アプリがカクつく」には四つの異なる原因があり、それぞれに直し方があります。

Flutter の DevTools は、これを開発者のマシンで表示します。タスクマネージャーは、実行中のアプリの中で、どのデバイスでも、問い合わせる VM サービスのないリリースビルドでも表示します。

例

spring:
  flutter:
    debug:
      isolates:
        enabled: true          # すべてのビルド。未設定: デバッグとプロファイルのみ
        position: bottom-right

アプリを実行して ⌘⇧I (Ctrl+Shift+I) を押すか、スマートフォンでは素早く 7 回タップして 8 回目を押し続けます。表がその隅に表示され、行ごとに 1 行です。名前、どれだけ忙しいか、どれだけ遅れているかを示します。

main      ▂  3%   0.4 ms
raster    ▅ 31%
platform         1.2 ms
io               0.8 ms
task-1    █ 96%

行

行 何か 計測するもの
main アプリの isolate: 自分の Dart コードと、Flutter のビルドとレイアウト。エンジンの UI スレッド イベントループがどれだけ遅れて動いているか (lag) と、そこから求めた忙しさ。フレームのビルド時間 (平均と最悪)。プロセスのメモリ
raster フレームを描画するエンジンのスレッド 描画に使った時間の割合 (busy)、フレームのラスター時間、レイヤーキャッシュと画像キャッシュのサイズ
platform プラットフォームのメインスレッド: プラグイン、キーボード、システムのビュー エンジンのチャンネルへの無害な呼び出しの往復時間。2 秒ごと
io 画像をデコードするエンジンのスレッド 1 ピクセルの画像をデコードする往復時間。2 秒ごと
task-1、… タスクエグゼキューター の isolate。存在している間 タスクに使った時間の割合、完了したタスクの数、待っているタスクの数
自分で付けた名前 アプリが自分で起動する isolate。IsolateLoads.track で表示する 動いていること

行が持つのは、そのソースが計測できる数値だけです。main は二つのソースからなる一つの行です。フレームワークのサンプラーが遅れを出し、エンジンのフレーム時間がそこに加わります。

ブラウザーでは、プラットフォームと IO のスレッドがありません。行は main と raster です。メモリは JavaScript のヒープで、ブラウザーがそれを知らせる場合 (Chromium) に表示されます。

エンジンがプラットフォームのスレッドで Dart を実行する場合 (macOS デスクトップのエンベッダーはデフォルトでそうします)、platform は main と同じだけ待ちます。そこでは二つは一つのスレッドだからです。

アプリが Isolate.run や compute で起動する isolate は、自動では見つかりません。コンパイルされたアプリは、自分の isolate を列挙できないためです。処理をタスクエグゼキューターを通して起動するか、一回の呼び出しで表示します。

final report = await isolateLoads.track('report', Isolate.run(buildReport));

見ている間だけ計測する

表が隠れていて、パネルのタブが閉じている間は、何も計測されません。最初に見たときにタイマーが始まり (最初の 1 秒はまだ数値がありません)、最後に見てから 30 秒たつと自動で止まります。そのため、この機能を含むリリースビルドがコストを払うのは、誰かがそれを開いたときだけです。

表は interval (1 秒) ごとに読み取ります。main の遅れは、100 ms ごとに予定されたタイマーがどれだけ遅れて発火するかです。二つのタイマーの間に終わる処理は現れないので、busy が 3 % というのは、isolate が追いついているという意味であり、プロセッサーの 3 % を使ったという意味ではありません。

デバッグパネル

デバッグパネル には Isolates タブがあり、完全な表を持ちます。すべての行について、種類、busy の割合、遅れ、最長の遅れ、取り組んでいるもの、メモリ、詳細 (フレーム時間、キャッシュのサイズ、完了したタスクの数) を表示します。Copy JSON は、行をクリップボードに入れます。バグ報告のためです。

表は、フレームメーターやタイムラインとともに デバッグオーバーレイのドック の中にあります。同じ隅では、ノート PC では積み重なり、スマートフォンではスワイプするページになります。

ビルドに含めるかどうか

他のデバッグ機能と同じく、タスクマネージャーは独自のモジュールで、spring.flutter.debug.isolates.enabled で決まります。

値 アプリ
true すべてのビルドに含まれる。リリースも含む
false そのコードを一切持たない
未設定 デバッグとプロファイルのビルドに含まれる。リリースではコンパイル時に取り除かれる

含まれていなければ、アプリにはエンジンのスレッドを計測するコードがありません。isolateLoads Bean はそれでもあり、持っていてもコストのかからない行 (main、タスクエグゼキューターの isolate) を持ちます。独自の画面からそれを読めます。

独自の行

IsolateLoadSource を実装する Bean は、行を追加します。タスクマネージャーはすべてのソースに問い合わせます。

@Component()
class SyncLoad implements IsolateLoadSource {
  SyncLoad(this.sync);
  final SyncService sync;

  @override
  List<IsolateLoad> loads() => [
    IsolateLoad(
      name: 'sync',
      kind: 'own',
      active: sync.pending,
      details: {'uploaded': sync.uploaded},
    ),
  ];
}

isolate の負荷 を参照してください。

プロパティ

キー 型 デフォルト 意味
spring.flutter.debug.isolates.enabled bool 未設定 ビルドにタスクマネージャーを含めるかどうか (上を参照)
spring.flutter.debug.isolates.position 隅 bottom-right その表の隅
spring.flutter.debug.isolates.interval duration 1s 表とタブが行を読み取る間隔

アクションは debug.isolates で、キーは spring.flutter.shortcuts.debug.isolates で変更します (キーボードショートカットとタップ を参照)。Web では、Ctrl+Shift+I は Windows と Linux でブラウザー自身の開発者ツールのショートカットでもあります。そこではアクションに別のキーを割り当てるか、タップを使ってください。

関連項目