logcat

唯讀

串流系統紀錄：手機上發生的一切的實況轉播。

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

語法

logcat [-v <format>]

旗標與參數

token	意義
-v <format>	選擇行格式。值得用的是 `threadtime`（日期、時間、pid、tid、等級、tag），`brief` 是較簡短的 `I/Tag( 1234):` 形式。

範例

```
logcat -v threadtime
```
欄位最齊的格式，也是檢視器應該解析的那個。
```
logcat -v brief
```
較舊的簡短形式，在別人貼上來的紀錄裡還是常看到。

輸出怎麼讀

輸出範例

07-26 13:37:01.234  1234  1250 I ActivityManager: Start proc 3062:com.example/u0a234
07-26 13:37:02.010  3062  3062 E MyApp   : java.lang.IllegalStateException: not attached

用 `threadtime` 時是日期、時間、行程 id、執行緒 id、單一字母的等級、tag，然後在一個冒號加空白之後是訊息。tag 在那個冒號之前可以含空白。不是每一行都是紀錄：`--------- beginning of main` 與空行是紀錄自己的分隔訊息，該顯示出來而不是試著解析。

輸出欄位

欄位	意義
MM-DD HH:MM:SS.mmm	裝置自己的本地時間。時區不會印出來。
pid tid	行程 id 與執行緒 id。兩個數字一樣代表主執行緒。
V D I W E F	Verbose、Debug、Info、Warn、Error、Fatal，嚴重程度依序遞增。
tag	寫紀錄的人自己選的字串。這是把紀錄縮小範圍最實用的手段。
--------- beginning of …	緩衝的邊界，不是一筆紀錄。

版本與廠商注意事項

它會一直流到有東西把它停下來，而在忙碌的手機上那是每分鐘好幾千行。消費它的東西需要一個上限，否則它會一直長到機器抗議。
很長的一行可能被傳輸切成兩半，所以讀它的東西必須跨越封包邊界保留半行，不然大約每一百行就會壞掉一行。
有哪些緩衝、這個版本認得哪些篩選式，都會變。不要假設，用 `logcat --help` 去問裝置。

這個我們有 UI

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

開啟 Android Logcat Viewer

指令	做什麼
dumpsys dropbox	平台用來存放當機、ANR 與 tombstone 的環形緩衝——這是不用 root 讀 ANR 追蹤的方法。
dumpsys activity activities	現在哪個 app 在前景，以及它背後的 task 與 stack 結構。
run-as	以某個 app 自己的 uid 執行指令——這是不用 root 讀取可除錯版本私有檔案的方法。

其他系統與紀錄指令

指令	做什麼
top	一次性的行程表：CPU 占用、記憶體、狀態與指令列。
getprop	印出系統屬性——手機自己對「這是什麼」的回答。

這些行為是在撰寫 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 執行這類指令。或者瀏覽全部指令。

語法