am start

唯讀

用元件或 intent 啟動 Activity——這是驗證 deep link 能不能被接走最快的方法。

指令: adb shell am start
指令: 活動與 intent（am）
風險: 唯讀

語法

am start [-W] [-a <action>] [-d <data URI>] [-n <package>/<activity>] [<extras>]

旗標與參數

token	意義
-W	等啟動完成，並印出狀態與耗時。
-a <action>	intent 的 action，例如 `android.intent.action.VIEW`。
-d <uri>	intent 的 data URI。scheme 是必要的：沒有 scheme 就沒有東西可以和 intent filter 對上。
-n <pkg>/<activity>	直接啟動一個確切元件，跳過 intent 解析。

範例

am start -W -a android.intent.action.VIEW -d 'myapp://item/42'

測一條 deep link，看是哪個 Activity 接走的。

am start -W -a android.intent.action.VIEW -d 'https://example.com/item/42'

測 App Link，也能看出是不是瀏覽器贏了而不是你的 app。

```
am start -n com.example/.MainActivity
```
直接啟動一個 Activity，完全不經過 intent filter。

輸出怎麼讀

輸出範例

Starting: Intent { act=android.intent.action.VIEW dat=https://example.com/ flg=0x10000000 }
Status: ok
LaunchState: COLD
Activity: com.example/.MainActivity
TotalTime: 245
WaitTime: 262
Complete

加了 `-W` 會先看到平台解析後的 intent，再看到結果。真正有意思的失敗根本不是狀態行：`Error: Activity not started, unable to resolve Intent { … }` 是「沒人認領這個 scheme」的樣子，而 `Warning: Activity not started, its current task has been brought to the front` 是帶保留的成功——app 本來就開著，所以沒有冷啟動，也不會印出時間。

輸出欄位

欄位	意義
Status: ok	有 Activity 被啟動了。
LaunchState	COLD、WARM 或 HOT——app 原本活著多少。
Activity	贏得這個 intent 的元件。
TotalTime	到 Activity 畫出來的毫秒數。什麼都沒啟動時不會出現。
WaitTime	包含呼叫方被擋住的時間的毫秒數。
Error: … unable to resolve Intent	手機上沒有人認領這個 intent。這常常正是你想測的答案。

版本與廠商注意事項

URI 要用單引號包起來。網址裡本來就會有 `&`，而沒有引號的 `&` 會把指令丟到背景並默默丟掉查詢字串的其餘部分——這是手打 deep link 測試「看起來沒反應」最經典的原因。
沒有 scheme 的 `-d` 什麼都不會啟動：intent 的 data 組不出來，也就沒有任何 filter 能對上。
只有真的啟動才會印出耗時，所以它的缺席是關於這次啟動的事實，而不是 0 毫秒。

這個我們有 UI

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

開啟 Android ADB Toolbox

指令	做什麼
am broadcast	送出廣播 intent，這是從 shell 驅動 SystemUI demo mode 等平台接收器的方法。
am force-stop	殺掉屬於某個 app 的所有行程與服務。
dumpsys activity activities	現在哪個 app 在前景，以及它背後的 task 與 stack 結構。

常見問題

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 執行這類指令。或者瀏覽全部指令。

語法