タスクマネージャー
タスクマネージャーは、アプリの中で動いているものと、それぞれがどれだけ働いているかを列挙します。アプリ自身の isolate、そのために描画とデコードを行うエンジンのスレッド、そしてアプリが重い処理のために起動するすべての isolate です。アプリの上の小さな表が要点を示し、デバッグパネルにはすべての数値があります。
使う理由
Flutter アプリで「アプリがカクつく」には四つの異なる原因があり、それぞれに直し方があります。
- Dart のコードが忙しい (
mainの行が遅れている): タスクエグゼキューター で、処理を isolate に移します。 - 描画に時間がかかりすぎる (
rasterの行が忙しい): レイヤーを減らす、画像を小さくする、画像をキャッシュします。 - プラットフォームの応答が遅い (
platformの行): プラグインがプラットフォームのスレッドで処理をしすぎています。 - 画像のデコードが遅い (
ioの行): 一度に多すぎるか、大きすぎます。
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 でブラウザー自身の開発者ツールのショートカットでもあります。そこではアクションに別のキーを割り当てるか、タップを使ってください。