top

唯讀

一次性的行程表：CPU 占用、記憶體、狀態與指令列。

指令: adb shell top
指令: 系統與紀錄
風險: 唯讀

語法

top -b -n 1 [-m <rows>] [-H] [-q]

旗標與參數

token	意義
-b	批次模式：印出單純的行而不是游標控制碼。
-n 1	只跑一次就結束。沒有它它不會回來。
-m <rows>	限制行程列的數量，這也是把傳輸量壓小的方法。
-H	看執行緒而不是行程。
-q	隱藏標頭。在這裡永遠沒有用，因為標頭就是結構定義。

範例

```
top -b -n 1 -m 10
```
最忙的十個行程，跑一次。
```
top -b -n 1
```
所有行程。在新一點的手機上會有好幾百列。
```
top -b -n 1 -H -m 20
```
以執行緒為單位，適合忙在某一處的 app。

輸出怎麼讀

輸出範例

Tasks: 1003 total,   1 running, 1002 sleeping,   0 stopped,   0 zombie
  PID USER         PR  NI VIRT  RES  SHR S[%CPU] %MEM   TIME+ ARGS
 3062 u0_a234      20   0 14.2G 353M 210M S  6.2   3.0  12:04.51 com.example

先是摘要行，接著標頭，然後一行一個行程。請透過那個標頭來讀欄位：被排序的那一欄外面包著方括號——`S[%CPU] %MEM` 是兩欄而不是一欄——而不剝掉括號、直接精確比對標籤的讀法，會剛好丟掉整張表正在排序的那一欄。

輸出欄位

欄位	意義
PID / USER	行程 id 與 Android 的 uid 名稱（`u0_a234` 是一個 app）。
%CPU	取樣區間內的占用率，一位小數。
RES / VIRT / SHR	常駐、虛擬與共享記憶體，以四捨五入到三位有效數字的人類可讀位元組值表示。
RSS	以假設 4 KiB 分頁換算的 KiB 常駐記憶體——那是 toybox 自己的假設，所以在 16 KiB 分頁的裝置上會報得偏小。
S	行程狀態：S 睡眠、R 執行中、D 不可中斷、Z 僵屍。
TIME+	累計 CPU 時間，格式是分:秒.百分秒——而那是「總分鐘數」，所以兩小時的 CPU 時間會印成 120:00.00。
ARGS	指令列，含空白。永遠是最後一欄。

版本與廠商注意事項

Android 的 `top` 是 toybox 而不是 procps，旗標與欄位都和 GNU 的手冊頁不同。預設的欄位組是由程式碼而不是說明文字決定的。
`-n 1` 還是會花掉大約四分之一秒，因為 CPU 占用率需要兩次取樣。你拿到的是一次真實的短時間量測，而不是開機以來的平均。
不要從摘要行推導記憶體總量：那是把核心的計數器四捨五入後改寫的有損形式。`/proc/meminfo` 是更好的來源。

這個我們有 UI

Android System Monitor 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。

開啟 Android System Monitor

指令	做什麼
dumpsys meminfo	哪些行程最吃記憶體，量的是 PSS（按比例分攤的用量）。
am force-stop	殺掉屬於某個 app 的所有行程與服務。
dumpsys activity activities	現在哪個 app 在前景，以及它背後的 task 與 stack 結構。

其他系統與紀錄指令

指令	做什麼
getprop	印出系統屬性——手機自己對「這是什麼」的回答。
logcat	串流系統紀錄：手機上發生的一切的實況轉播。
run-as	以某個 app 自己的 uid 執行指令——這是不用 root 讀取可除錯版本私有檔案的方法。

這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。

常見問題

adb shell 指令要怎麼執行？

在手機上打開開發者選項與 USB 除錯、接上線，然後從裝了 platform-tools 的機器執行 `adb shell <指令>`——或者只執行 `adb shell` 取得互動提示字元，再直接打指令、不用前綴。如果指令會輸出二進位資料（例如截圖），請改用 `adb exec-out` 而不是 `adb shell`：單純的 shell 服務會配一個終端機，而它會改寫換行位元組並毀掉資料。

adb shell 指令需要 root 嗎？

這份參考裡的都不用。它們以 `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 執行這類指令。或者瀏覽全部指令。

語法