安卓APP投屏調試工具使用教程
- 一、準備工作
- (一)下載ADB工具
- (二)配置ADB的環境變量
- (三)檢查是否成功安裝
- (四)adb核心命令說明
- 二、無線調試流程
- (一)環境要求
- (二)連接手機與電腦
- (三)配置TCP/IP端口
- (四)激活無線連接
- (五)使用scrcpy工具投屏顯示
- 三、常見問題與解決方案
- 四、進階技巧
- 五、優勢與應用場景
一、準備工作
(一)下載ADB工具
Android Debug Bridge(ADB) 是 Android SDK 提供的客戶端-服務器工具,作為 Android 設備與電腦之間的調試橋梁。根據系統選擇對應壓縮包進行下載并解壓:
- Windows
- Mac
- Linux
(二)配置ADB的環境變量
- 將下載的壓縮包解壓至
D:\adb
- 右鍵"此電腦" → 屬性 → 高級系統設置 → 環境變量
- 編輯 Path 變量 → 新增
D:\adb
(三)檢查是否成功安裝
打開cmd窗口,輸入adb version
查看adb版本
輸入adb help
查看幫助信息
(四)adb核心命令說明
命令格式 | 作用描述 |
---|---|
adb devices | 查看已連接的設備列表 |
adb tcpip <port> | 設置無線調試端口(默認5555) |
adb connect <ip>:<port> | 通過IP和端口無線連接設備 |
adb -s <serial> ... | 指定序列號對應的目標設備(多設備場景) |
二、無線調試流程
(一)環境要求
手機與電腦需處于同一局域網(連接同一WiFi或電腦通過網線接入手機所在路由器)。
(二)連接手機與電腦
- 1.用USB數據線連接手機與電腦,手機端確認“允許USB調試”。
- 2.打開命令行(Windows用CMD/PowerShell,Mac用Terminal),輸入
adb devices
命令查看設備序列號列表。(若未檢測到設備,需安裝手機驅動或檢查USB線是否正常)
(三)配置TCP/IP端口
以設備1為例,輸入adb -s b61b9ac20404 tcpip 5555
命令設置端口(以5555為例)
- ps1:若提示權限問題,可嘗試以管理員身份運行命令行。
- ps2:若只有一個設備可以直接用
adb tcpip 5555
命令
(四)激活無線連接
-
獲取手機IP地址
- 拔掉USB線,進入手機「設置」→「WLAN」→ 點擊當前連接的WiFi名稱,查看「IP地址」(如
192.168.1.106
)。
- 拔掉USB線,進入手機「設置」→「WLAN」→ 點擊當前連接的WiFi名稱,查看「IP地址」(如
-
建立無線連接
-
在命令行輸入:
adb connect 192.168.1.106:5555
-
若連接失敗,可嘗試:
- 檢查IP地址是否正確(重啟路由器或手機WiFi后可能變更)。
- 確認端口未被占用(可更換為其他端口如8888)。
-
-
驗證連接狀態
- 輸入
adb devices
,若顯示192.168.1.106:5555 device
,表示無線連接成功。
- 輸入
(五)使用scrcpy工具投屏顯示
通過以下鏈接下載并解壓scrcpy工具:
官方下載
直接下載
點擊scrcpy.exe運行即可成功投屏
三、常見問題與解決方案
問題現象 | 可能原因 | 解決方法 |
---|---|---|
adb connect 失敗 | IP地址錯誤或端口被占用 | 重新獲取IP,更換端口(如5556) |
設備斷開后無法重連 | 手機IP變更(如WiFi重連) | 重新查看IP地址,使用新IP連接 |
adb devices 無設備顯示 | ADB服務未啟動或驅動異常 | 輸入adb kill-server +adb start-server 重啟ADB |
多設備連接時命令混淆 | 未指定設備序列號 | 在命令中添加-s <serial> 參數 |
四、進階技巧
-
自動化腳本
- 在Mac/Linux系統中,可創建Shell腳本批量配置多設備:
# wireless_debug.sh #!/bin/bash adb -s $1 tcpip $2 adb connect $3:$2
- 執行:
./wireless_debug.sh 設備序列號 端口號 IP地址
。
- 在Mac/Linux系統中,可創建Shell腳本批量配置多設備:
-
固定IP設置
- 在路由器管理頁面為手機分配靜態IP,避免因DHCP租期到期導致IP變更。
-
防火墻設置
- 若公司網絡限制,需聯系管理員開放TCP端口(如5555)的入站/出站權限。
五、優勢與應用場景
- 優勢:
- 擺脫USB線束縛,支持設備在局域網內移動調試。
- 同時連接多臺設備,提升多機型兼容性測試效率。
- 適用場景:
- 大屏設備(如平板、電視盒子)調試。
- 需模擬弱網絡環境的性能測試。
- 團隊協作開發時的多設備并行調試。
通過無線調試,開發者可更靈活地進行真機測試,尤其適合需要頻繁移動設備或同時調試多臺終端的場景。