ByteScope

Web ADB Toolkit

從瀏覽器透過 USB 對 Android 說 ADB —— 裝置資訊、檔案、APK 側載、即時 logcat 與 shell。

透過 USB 在本機和你的 Android 溝通 — 不會上傳到任何伺服器。

正在檢查瀏覽器支援…

關於這個工具

Web ADB 工具箱透過 WebUSB 把你的 Android 手機接進瀏覽器,直接說 ADB 協定 —— 不用 Android SDK、不用 platform-tools,也不用安裝 adb 執行檔。它站在 ya-webadb(yume-chan,MIT)之上,也就是網頁版 scrcpy 背後的同一套引擎,再把它包成儀器風格的面板:拉出完整的裝置資訊(型號、Android 版本、序號、螢幕解析度、電量與已安裝套件數)、用 sync 協定瀏覽與傳輸檔案、把 APK 拖進來側載、用標籤/等級/正規表示式過濾即時觀察 logcat,並在真正的終端機裡執行 adb shell

USB 可以,無線不行 —— 這是誠實的答案

USB 版的 ADB 在 Chrome 與 Edge 上運作良好。無線 ADB 不行,而且沒有任何網頁能解決這件事:瀏覽器沒有原始 TCP socket,所以從網頁應用執行 adb connect 192.168.x.x:5555 根本不可能(Direct Sockets API 只保留給已安裝的 Isolated Web App)。這個工具能做的是替你把手機切到無線模式:先用 USB 接一次,按下「啟用無線除錯」,它就會在裝置上執行 adb tcpip 5555。之後你就從自己電腦上的 adb 走 Wi-Fi 連線。這個網頁扮演的是開關,不是無線用戶端。

Windows 可能要換驅動程式

在 Windows 上,WebUSB 常常抓不到手機的 ADB 介面,除非你先用 Zadig 把它的驅動程式換成 WinUSB —— 這是網頁版 ADB 在 Windows 上失敗的最大單一原因,所以工具會偵測 Windows,並在連線失敗時一步一步帶你做完。macOS、Linux 與 ChromeOS 完全不需要這一段;手邊有的話,插上就能用。這一切都在本機進行:你的手機和你的瀏覽器對話,沒有任何東西上傳到任何伺服器。

先在 APK 分析器裡分析一份 APK,再跳到這裡把它裝到真實裝置上 —— 這兩個工具構成一個循環:先檢視,再側載。

常見問題

可以從瀏覽器用 Wi-Fi 或無線方式連上 ADB 嗎?

不行 —— 而且任何聲稱做得到的網頁工具都值得懷疑。瀏覽器沒有原始 TCP socket,所以網頁無法開啟 `adb connect 192.168.x.x:5555`。這個工具只走 USB 連線。它能做的是替你啟用無線除錯:先用 USB 連一次、按下按鈕,它就會在手機上執行 `adb tcpip 5555`,接著你就能從自己電腦的 `adb` 走 Wi-Fi 連上。

要怎麼用它啟用無線 ADB?

用 USB 把手機插上,連線並在手機畫面上按同意,然後點「啟用無線除錯」。工具會執行 `adb tcpip 5555`,讓手機的 ADB 服務改成監聽 TCP 連接埠 5555。到「設定」裡找出手機的 IP,然後在你的電腦上執行 `adb connect <phone-ip>:5555`。最後這一步瀏覽器自己做不到。

哪些瀏覽器可以用?

桌面版的 Chrome 與 Edge(以及 Android 版 Chrome 148 以上),因為 WebUSB 是 Chromium 專屬的 API。Firefox 與 Safari 並未實作 WebUSB,也沒有公布任何計畫,所以它們根本無法建立 ADB 連線。頁面在那裡仍然會載入並說明原因,只是 ADB 功能無法使用。

為什麼 Windows 偵測不到我的手機?

在 Windows 上,手機的 ADB 介面通常需要 WinUSB 驅動程式,用一個叫 Zadig 的免費工具就能安裝。如果連線失敗,工具箱會顯示逐步教學:執行 Zadig、開啟 List All Devices、選到 ADB 介面,把它的驅動程式換成 WinUSB。macOS、Linux 與 ChromeOS 不需要任何驅動程式,體驗順暢得多。

我的資料或 APK 會被上傳到哪裡嗎?

不會。所有處理都在你的瀏覽器裡,並透過 USB 直接和手機對話。你側載的 APK、傳輸的檔案、logcat 與 shell 的輸出都不會離開你的電腦 —— 這條路徑上沒有伺服器。

可以鏡射並操控手機畫面(scrcpy)嗎?

有一個實驗性的畫面鏡射區塊,使用 scrcpy 協定搭配 WebCodecs 的 H.264 解碼。它是整個工具裡最吃資源的功能,也取決於你的瀏覽器是否支援硬體 H.264 解碼;不支援時面板會直接說明,而不是壞掉。核心面板 —— 裝置資訊、檔案、APK 安裝、logcat 與 shell —— 沒有它也照樣能用。