ByteScope

input keyevent

會改變裝置

按下實體或虛擬按鍵——Home、Back、電源、音量、Enter。

指令
adb shell input keyevent
指令
輸入與觸控
風險
會改變裝置

語法

input keyevent <code or name>

旗標與參數

token意義
<code>按鍵代碼的數字。新版也接受名稱,但數字到哪裡都通。

範例

輸出怎麼讀

什麼都沒有。手機會反應或不反應,兩種都沒有確認訊息。

輸出欄位

欄位意義
(no output)按鍵事件已注入。

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

單獨看都無害,但有些代碼是有後果的:26 是電源鍵,所以它會鎖住或喚醒螢幕;送進錯誤 app 的按鍵就是一次你沒打算做的點擊。這裡沒有破壞性的東西,也沒有需要還原的東西。

版本與廠商注意事項

這個我們有 UI

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

開啟 Android ADB Toolbox

相關指令

和 input keyevent 會在同一次作業裡出現的指令。

指令做什麼
input text把一段字串打進目前取得焦點的輸入欄位。
getevent直接從核心串流原始輸入事件,或列出每個輸入裝置能回報什麼。
screencap擷取螢幕畫面,可以寫進手機裡的檔案,也可以把 PNG 送到標準輸出。

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