現在哪個 app 在前景,以及它背後的 task 與 stack 結構。
dumpsys activity activitiesdumpsys activity activities | grep -E 'topResumedActivity|mResumedActivity' | head -n 12只取出前景元件。在裝置上先過濾,是把傳輸量壓小的關鍵。
dumpsys activity activities整份。在醒了一段時間的手機上大約是一百 KB。
完整的輸出會印出每個顯示器上每個 stack 裡的每個 task,所以請先過濾。有四種行都在回答「現在前面是什麼」,而它們不一定一致:優先用 `topResumedActivity`,因為那就是這個問題本身;把 `mCurrentFocus` 當成最後手段,因為它指的是「視窗」,而那可能是鍵盤或系統對話框,後面那個 app 對使用者來說才是他正在用的 app。
| 欄位 | 意義 |
|---|---|
| topResumedActivity= | 唯一處於 top-resumed 狀態的 Activity。Android 10 之後才有。 |
| mResumedActivity: / ResumedActivity: | 某個 stack 的 resumed Activity。可能出現好幾行,通常第一行是答案。 |
| mFocusedApp= | 取得焦點的 app token。實務上是對的,只差一層間接。 |
| mCurrentFocus= | 取得焦點的視窗——可能是輸入法或對話框而不是 app。 |
| u0 com.example/.MainActivity | Android 使用者 id 加元件。元件常寫成相對於套件的形式。 |
Android System Monitor 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器,不必安裝 SDK,也不會上傳任何東西。
和 dumpsys activity activities 會在同一次作業裡出現的指令。
| 指令 | 做什麼 |
|---|---|
| am start | 用元件或 intent 啟動 Activity——這是驗證 deep link 能不能被接走最快的方法。 |
| am force-stop | 殺掉屬於某個 app 的所有行程與服務。 |
| top | 一次性的行程表:CPU 占用、記憶體、狀態與指令列。 |
| 指令 | 做什麼 |
|---|---|
| dumpsys battery | 電池服務目前的狀態:電量、充電狀態、健康度、電壓與溫度。 |
| dumpsys diskstats | 每個分割區的剩餘空間、一次磁碟寫入延遲的實測,以及一份快取起來的各 app 空間用量。 |
| dumpsys thermalservice | 手機是不是正在因為溫度而降速,以及硬體層回報的每一個溫區,單位是攝氏。 |
| dumpsys sensorservice | 手機上的每一個感測器,含廠商、type、取樣率與批次能力,以及一段近期讀數的緩衝。 |
| dumpsys meminfo | 哪些行程最吃記憶體,量的是 PSS(按比例分攤的用量)。 |
| dumpsys package | 套件管理員知道的一切:版本、路徑、flags、安裝來源,以及每個使用者的狀態。 |
| dumpsys dropbox | 平台用來存放當機、ANR 與 tombstone 的環形緩衝——這是不用 root 讀 ANR 追蹤的方法。 |
這些行為是在撰寫 Web ADB 工具背後的解析程式時,對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方,這一頁會直接說明,而不是給你一個在半數手機上都是錯的數字。
在手機上打開開發者選項與 USB 除錯、接上線,然後從裝了 platform-tools 的機器執行 `adb shell <指令>`——或者只執行 `adb shell` 取得互動提示字元,再直接打指令、不用前綴。如果指令會輸出二進位資料(例如截圖),請改用 `adb exec-out` 而不是 `adb shell`:單純的 shell 服務會配一個終端機,而它會改寫換行位元組並毀掉資料。
這份參考裡的都不用。它們以 `shell` 使用者身分執行,可以針對自己的 Android 使用者管理套件、讀取大多數 `dumpsys` 服務、寫入設定提供者、注入輸入,以及讀取共用儲存空間。需要 root 的是這份參考刻意避開的事:讀取其他 app 的私有資料(除了對可除錯版本使用 `run-as`)、寫入系統分割區,或直接讀 `/data/anr`。
不是 Android 版本就是廠商。有些旗標與欄位是從特定版本才有的,那些都在各指令頁註明了。其餘是廠商改動,而受影響最深的是 `dumpsys`:一份 dump 是除錯輸出,它的文字就是那個服務的作者最後印了什麼,而廠商既會改它也會把改動往回移植。請用名稱而不是位置來讀欄位,並把沒見過的格式當成差異而不是失敗。
很多指令可以——本站的 Web ADB 工具從 Chromium 系桌面瀏覽器透過 WebUSB 和手機對話,不必安裝 SDK,也不會上傳任何東西。每一頁在有對應工具時都會連過去。有兩個限制值得知道:同一時間只有一個程式能持有 ADB 介面,所以桌面的 `adb server` 要先停掉;而 `adb forward` 與 `adb reverse` 在瀏覽器裡完全無法運作。
比較想按而不是打字?Web ADB Toolkit 會從瀏覽器透過 USB 執行這類指令。或者瀏覽全部指令。