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 使用者送那個廣播。 |
需要什麼權限
只要一條授權過的 `adb` 連線——不用 root、不用 `adb root`、不用 `su`，除了 USB 偵錯本身之外也沒有開發人員選項要開。`am` 是一支五行的 shell script（AOSP `cmds/am/am.sh`），除了 `instrument` 之外全部交給 `cmd activity "$@"`，所以 intent 是以 `shell` 使用者的身分送出的。這個身分做不到的，是送出「受保護的」廣播：`ActivityManagerService` 只把 `ROOT_UID`、`SYSTEM_UID`、`PHONE_UID`、`BLUETOOTH_UID`、`NFC_UID`、`SE_UID` 與 `NETWORK_STACK_UID` 當成系統呼叫方，shell 一個都不是，而任何被某個套件用 `<protected-broadcast>` 宣告過的 action 都會在送達之前被拒絕。`com.android.systemui.demo` 不在那份名單上，這是 demo mode 能從纜線這一端運作的唯一原因——而 demo 那道門是另一回事，它是你用 `settings put` 寫的一個 Global 設定，不是誰授予你的能力。要把這件事寫成腳本之前，還有兩件關於身分的事值得知道。這個呼叫會擋住：不加 `--async` 時，`runSendBroadcast` 會在它的結果接收器裡進行沒有逾時的 `wait()`，所以一個永遠不完成的接收器會讓 shell 就這樣掛著，而不是回你一個錯誤。還有，有意思的行分散在兩條串流上——下面那個拒絕走標準錯誤，子指令打錯卻走標準輸出——所以請用 `2>&1` 收，並在相信一次「看起來很乾淨」的執行之前先讀第一行。
失敗訊息對照
| 訊息 | 意義 |
|---|---|
| Permission Denial: not allowed to send broadcast android.intent.action.BOOT_COMPLETED from pid=4821, uid=2000 | `ActivityManagerService` 在任何接收器看到這個 intent 之前就丟出的 `SecurityException`，因為這個 action 出現在某個套件的 `<protected-broadcast>` 名單裡，而 shell 使用者不是系統呼叫方。沒有任何旗標解得開——`--receiver-permission` 不行、`--user` 不行，在可偵錯版本上 root 也不行。`dumpsys package protected-broadcasts` 會印出整份名單，所以先去那裡看，再考慮是不是自己把 action 打錯了。 |
| Exception occurred while executing 'broadcast': | `BasicShellCommandHandler.exec` 抓到 `Throwable`，把一行空白、這個橫幅與堆疊追蹤寫到標準錯誤。下一行才是原因。`java.lang.IllegalArgumentException: Unknown option: --async` 代表這個版本不認識這個旗標——`--async` 在 tag android-11.0.0_r1 的 `ActivityManagerShellCommand` 裡不存在，從 android-12.0.0_r1 起才有。`No intent supplied` 則是 `-a` 那個 action 整個沒給。 |
| Unknown command: brodcast | `handleDefaultCommands` 不認得這個子指令。一行裡兩個陷阱：它印在**標準輸出**而不是標準錯誤，所以只盯著標準錯誤的腳本會記成一次乾淨的執行；而回傳值是 -1，實際上什麼都沒送出去。你正要從手機畫面得出的任何結論，講的都是上一個狀態。 |
| cmd: Can't find service: activity | `cmd` 找不到 `activity` 這個服務可以把子指令交出去，所以廣播從來沒有進到佇列。裝置還在開機、`system_server` 還沒註冊它時本來就會這樣——等開機完成再送一次，不要當成裝置壞了。 |
會改變什麼，以及怎麼回頭
廣播本身不會留下永久改變，但收到它的東西會。最該點名的例子是 SystemUI demo mode：它把狀態列凍在假時間與假電量，而且會一直維持到有人送出 `exit` 為止，讓使用者以為手機壞了。exit 指令永遠要放在手邊。
版本與廠商注意事項
- demo mode 被 `global sysui_demo_allowed` 擋著，而它預設是 0。先去讀那個設定，不要對著虛空發廣播。
- `enter` 必須是第一個 demo 指令，沒有它其餘都會被忽略。
這個我們有 UI
Android ADB Toolbox 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。
相關指令
和 am broadcast 會在同一次作業裡出現的指令。
| 指令 | 做什麼 |
|---|---|
| am start | 用元件或 intent 啟動 Activity——這是驗證 deep link 能不能被接走最快的方法。 |
| settings put | 把值寫進設定提供者——多數開發者選項小技巧背後的機制。 |
| screencap | 擷取螢幕畫面，可以寫進手機裡的檔案，也可以把 PNG 送到標準輸出。 |
其他活動與 intent（am）指令
| 指令 | 做什麼 |
|---|---|
| am force-stop | 殺掉屬於某個 app 的所有行程與服務。 |
這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。