am broadcast

會改變裝置

送出廣播 intent，這是從 shell 驅動 SystemUI demo mode 等平台接收器的方法。

指令: adb shell am broadcast
指令: 活動與 intent（am）
風險: 會改變裝置

語法

am broadcast -a <action> [-e <key> <value>] […]

旗標與參數

token	意義
-a <action>	廣播的 action。
-e <key> <value>	一個字串 extra，可以重複。

範例

```
settings put global sysui_demo_allowed 1
```
先把門打開。這個設定關著的時候，SystemUI 會忽略所有 demo 廣播，而新手機上它是關的。
```
am broadcast -a com.android.systemui.demo -e command enter
```
進入 demo mode。它必須排在其他 demo 指令之前。

am broadcast -a com.android.systemui.demo -e command notifications -e visible false

把你自己的通知圖示藏起來——這是截圖時真正有感的一項。

am broadcast -a com.android.systemui.demo -e command exit

把狀態列還給現實。

輸出怎麼讀

輸出範例

Broadcasting: Intent { act=com.android.systemui.demo (has extras) }
Broadcast completed: result=0

`Broadcast completed: result=0` 代表 intent 送達了，**不代表**有東西照做。接收器完全可以忽略這個廣播，而 demo 那道門關著、或廠商把接收器拿掉時，SystemUI 就是這樣。要確認請看手機，不要看這一行。

輸出欄位

欄位	意義
Broadcasting: Intent { … }	平台解析後的 intent。
Broadcast completed: result=0	已送達。不是「有東西回應了」的證據。
Permission Denial	這個版本不允許 shell 使用者送那個廣播。

會改變什麼，以及怎麼回頭

廣播本身不會留下永久改變，但收到它的東西會。最該點名的例子是 SystemUI demo mode：它把狀態列凍在假時間與假電量，而且會一直維持到有人送出 `exit` 為止，讓使用者以為手機壞了。exit 指令永遠要放在手邊。

版本與廠商注意事項

demo mode 被 `global sysui_demo_allowed` 擋著，而它預設是 0。先去讀那個設定，不要對著虛空發廣播。
`enter` 必須是第一個 demo 指令，沒有它其餘都會被忽略。

這個我們有 UI

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

開啟 Android ADB Toolbox

指令	做什麼
am start	用元件或 intent 啟動 Activity——這是驗證 deep link 能不能被接走最快的方法。
settings put	把值寫進設定提供者——多數開發者選項小技巧背後的機制。
screencap	擷取螢幕畫面，可以寫進手機裡的檔案，也可以把 PNG 送到標準輸出。

其他活動與 intent（am）指令

指令	做什麼
am force-stop	殺掉屬於某個 app 的所有行程與服務。

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

語法