dumpsys activity activities
読み取りのみいまどのアプリが前面にいるか、そしてその背後のタスクとスタックの構造。
- コマンド
- adb shell dumpsys activity activities
- コマンド
- システムサービス（dumpsys）
- リスク
- 読み取りのみ
構文
dumpsys activity activities使用例
dumpsys activity activities | grep -E 'topResumedActivity|mResumedActivity' | head -n 12前面のコンポーネントだけを取り出します。端末側で絞ることが転送量を小さく保つ鍵です。
dumpsys activity activities丸ごと。しばらく起きていた端末なら 100 キロバイトほどになります。
出力の読み方
完全なダンプはすべてのディスプレイのすべてのスタックのすべてのタスクを印字するので、絞り込んでください。「いま前にいるのは何か」に答える行が 4 種類あり、必ず一致するとは限りません。まさにその問いである `topResumedActivity` を優先し、`mCurrentFocus` は最後の手段と考えます。それは「ウィンドウ」の名前で、キーボードやシステムのダイアログであっても、その後ろのアプリが使う人にとってのアプリであり続けます。
出力フィールド
| フィールド | 意味 |
|---|---|
| topResumedActivity= | top-resumed 状態を持つ唯一のアクティビティ。Android 10 以降。 |
| mResumedActivity: / ResumedActivity: | あるスタックの resumed なアクティビティ。複数出得ますが、通常は最初が答えです。 |
| mFocusedApp= | フォーカスされたアプリのトークン。実用上は正しく、問いから 1 段だけ離れています。 |
| mCurrentFocus= | フォーカスされたウィンドウ。アプリではなく IME やダイアログの可能性があります。 |
| u0 com.example/.MainActivity | Android ユーザー id とコンポーネント。パッケージからの相対表記が多いです。 |
必要な権限
`ActivityManagerService.doDump` は `ActivityManager` というタグで `DumpUtils.checkDumpAndUsageStatsPermission` から始まるので、`android.permission.DUMP` と `android.permission.PACKAGE_USAGE_STATS` の両方が要ります。どちらも Shell パッケージが宣言していて、app-op のチェックは `SHELL_UID` で短絡します。要件はそれだけです。root も `adb root` もユーザー補助サービスも、設定の「使用状況へのアクセス」も不要で、だから前面アプリの読み取りは、何も解錠せずにケーブルからできる数少ない「特権っぽいこと」の 1 つになっています。shell が手に入れられないのは、これを安くする方法です。`grep` に流しても、`system_server` がダンプ全体を組み立て終わってから絞られるので、端末側の仕事量はどちらでも同じで、節約できるのは転送だけです。もう 1 つ、どんな権限でも守ってくれない引数解析の挙動があります。`activity` の次の語が既知の節でないとき、ダンプはまずそれを実行中のアクティビティと照合し、それも外れると **引数リストごとアクティビティマネージャのシェルコマンド解釈系に渡して実行します**。つまり `dumpsys activity <何か>` は読み取りである保証がありません。`activities` という綴りをそのまま保つか、絞り込んだ読み取りの形しか送らない Android System Monitor を使ってください。
エラーメッセージの読み解き
| メッセージ | 意味 |
|---|---|
| Bad activity command, or no activities match: activites | 標準出力に出て、後ろに `Use -h for help.` が続きます。ここに至るまでに 3 つのことが試されています。既知の節ではなかった、実行中のどのアクティビティにも一致しなかった、そしてアクティビティマネージャのシェルコマンドとして実行され失敗した。打ち間違いがここで無害なのは、シェルコマンドとしても失敗したからにすぎません。たまたま実在のサブコマンドを綴ってしまった打ち間違いは、打ち間違いではなくコマンドです。 |
| Unknown argument: --activities; use -h for help | オプションはダッシュで始まるもので、`activities` はオプションではなくコマンドです。ダッシュを付けて書くとオプションのループに落ちます。パッケージマネージャ側の同じ行と違って、アクティビティのダンプはこれを出して **即座に返る** ので、既定のダンプではなくこの行だけが手元に残ります。間違いが分かりやすいという点だけは救いです。 |
| Permission Denial: can't dump ActivityManager from from pid=4821, uid=10231 due to missing android.permission.DUMP permission | `DumpUtils` が出す行で、AOSP のテキストそのままの `from from` の重複を持ち、**標準出力** にダンプの代わりに書かれます。`topResumedActivity` を探す `grep` に流すと音もなく消え、結果は画面が消えている端末と見分けがつきません。前面アプリの問い合わせが何も返さないときは、絞り込む前の最初の 1 行を確認してください。 |
| *** SERVICE 'activity' DUMP TIMEOUT (10000ms) EXPIRED *** | 切り捨てが効くのは、ここでは他の多くのダンプより深刻です。resumed なアクティビティの行は出力の先頭にはないので、10 秒で切れたダンプはタスクとスタックのテキストをたっぷり含んだまま `topResumedActivity` を失い得ます。それは部分的な答えではなく「前面には何もない」と読めてしまいます。`mCurrentFocus` のような弱い行に落ちる前に、`-t` で待ち時間を伸ばしてください。 |
バージョンとメーカーに関する注意
- ここのフィールド名は 2 度改名され、他のサービスにも写されているので、1 つの綴りではなく綴りの集合で照合してください。
- binder の仕事は絞っても絞らなくても端末側で起きます。絞って節約できるのは転送で、ケーブル越しではそこがダンプの大きさに比例します。
これには UI があります
Android System Monitor はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。
関連コマンド
dumpsys activity activities と同じ作業で出てくるコマンド。
| コマンド | 何をするか |
|---|---|
| am start | コンポーネント指定または intent 指定でアクティビティを起動します。ディープリンクの解決を確かめる最短経路です。 |
| am force-stop | あるアプリのプロセスとサービスをすべて終了させます。 |
| top | 1 回分のプロセス表：CPU 使用率、メモリ、状態、コマンドライン。 |
他のシステムサービス（dumpsys）コマンド
| コマンド | 何をするか |
|---|---|
| dumpsys battery | バッテリーサービスの現在の状態：残量、充電状態、健康度、電圧、温度。 |
| dumpsys diskstats | パーティションごとの空き容量、ディスク書き込み遅延の実測、そしてキャッシュされたアプリ別の使用量内訳。 |
| dumpsys thermalservice | 端末が発熱で性能を絞っているか、そしてハードウェア層が報告する各温度ゾーンを摂氏で表示します。 |
| dumpsys sensorservice | 端末にあるすべてのセンサーとそのベンダー、type、レート、バッチング。加えて直近の測定値のバッファ。 |
| dumpsys meminfo | どのプロセスがメモリを最も使っているかを、PSS（比例配分したサイズ）で表示します。 |
| dumpsys package | パッケージマネージャが知っているすべて：バージョン、パス、flags、インストール元、ユーザーごとの状態。 |
| dumpsys dropbox | クラッシュ、ANR、tombstone を保持するプラットフォームのリングバッファ。root なしで ANR トレースを読む方法です。 |
Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。