Python ADB Shell 控制手机|技术全景解析与实战指南
⚡Python ADB Shell 是指通过 Python 语言调用 Android Debug Bridge(ADB)提供的 shell 命令接口,实现对 Android 设备的自动化远程控制、状态监控、数据采集与行为干预。该技术广泛应用于移动应用测试、设备巡检、智能运维、安全渗透测试、智能硬件交互等领域。
相较于直接使用终端命令行,Python 封装后的控制流程具备更强的逻辑组织能力、异常处理机制、跨平台兼容性与可扩展性。开发者可基于 subprocess、adb-shell、adbutils 等库构建稳定可靠的自动化系统。
当前主流 Android 设备(包括国产定制系统如 ColorOS、MIUI、EMUI、OriginOS 等)均支持 ADB 功能,只要在开发者选项中开启“USB调试”并授权连接,即可实现脚本级控制。
一、环境搭建与基础配置
1.1 安装 ADB 工具链
ADB 是 Android SDK Platform Tools 的核心组件,需单独安装或通过完整 SDK 获取。推荐使用独立安装包以减少体积:
- Windows:下载
platform-tools-latest-windows.zip,解压后将platform-tools目录添加至系统环境变量 Path; - macOS:推荐使用 Homebrew 安装:
brew install --cask android-platform-tools; - Linux(Ubuntu/Debian):执行
sudo apt install android-tools-adb android-tools-fastboot; - 验证命令:
adb version,正常输出类似Android Debug Bridge version 1.0.41。
PS C:\> adb version Android Debug Bridge version 1.0.41 Version 34.0.5-10489308
1.2 配置设备调试权限
以华为 Mate 60 为例,需按以下步骤开启调试:
- 进入「设置」→「关于手机」→ 连续点击「版本号」7次,启用开发者选项;
- 返回「设置」→「系统和更新」→「开发人员选项」→ 开启「USB调试」;
- 首次连接电脑时,手机弹出授权提示,勾选「始终允许」并确认;
- 电脑执行
adb devices,应显示设备序列号与device状态。
PS C:\> adb devices List of devices attached MHA_AL00-7816d3b8 device
1.3 安装 Python 依赖库
推荐使用 adbutils(由 Appium 团队维护),提供面向对象 API,兼容性优于原生 subprocess 封装:
pip install adbutils -i https://pypi.tuna.tsinghua.edu.cn/simple
其他可选库:
uiautomator2:基于 ADB 的 UI 自动化框架,支持元素定位与事件模拟;airtest:图形化脚本工具,支持图像识别与 ADB 命令混合使用;adb-shell:纯 Python 实现的 ADB Shell 客户端,无需依赖原生 ADB。
二、ADB Shell 核心命令体系详解
2.1 基础设备控制命令
| 命令 | 功能说明 | 典型参数示例 | Python 调用方式 |
|---|---|---|---|
adb shell input text |
向设备输入文本 | 'Hello ADB' |
device.shell('input text "Hello ADB"') |
adb shell input keyevent |
模拟按键事件 | KEYCODE_HOME=3 |
device.shell('input keyevent 3') |
adb shell input tap |
模拟屏幕点击 | x y(坐标值) |
device.shell('input tap 540 1180') |
adb shell input swipe |
模拟滑动操作 | x1 y1 x2 y2 duration |
device.shell('input swipe 540 1000 540 300 300') |
常用按键码参考:KEYCODE_BACK=4、KEYCODE_MENU=82、KEYCODE_ENTER=66、KEYCODE_VOLUME_UP=24、KEYCODE_VOLUME_DOWN=25。
2.2 设备信息采集命令
获取设备型号、Android 版本、屏幕分辨率等基础信息:
PS C:\> adb shell getprop ro.product.model MHA-AL00 PS C:\> adb shell getprop ro.build.version.release 10
Python 封装示例:
from adbutils import AdbClient
client = AdbClient(host="127.0.0.1", port=5037)
device = client.device("MHA_AL00-7816d3b8")
model = device.shell("getprop ro.product.model").strip()
android_ver = device.shell("getprop ro.build.version.release").strip()
screen = device.shell("wm size").split()[-1] # 输出: 1080x2340
print(f"设备型号:{model} | Android:{android_ver} | 分辨率:{screen}")
实时监控 CPU、内存、电量等性能指标:
PS C:\> adb shell dumpsys cpuinfo | head -n 5 2024-06-15 14:30:22 Load: 2.1 / 1.8 / 1.6 CPU usage from 5027ms to 0ms ago: 15% 2345/com.android.systemui: 10% user + 5% kernel / faults: 1234 8% 1234/com.google.android.gms: 5% user + 3% kernel / faults: 567
内存使用分析:
PS C:\> adb shell dumpsys meminfo -s Total RAM: 3,967,488 K (free 234,567 K, cached 456,789 K, kernel 1,234,567 K) App Summary: Used RAM: 1,876,543 K (1,234,567 K native, 642,976 K dalvik, 0 K other)
网络连接状态与 IP 地址查询:
PS C:\> adb shell ip addr show wlan0
3: wlan0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500
inet 192.168.1.105/24 brd 192.168.1.255 scope global wlan0
Wi-Fi 强度检测(需 Root 权限):
PS C:\> adb shell cat /proc/net/wireless
wlan0: 0000 2400 2437 2460 2484 2512
24-24= -42=-42= -45=-45= -48=-48= -50=-50=
2.3 文件与应用管理命令
设备文件操作与应用生命周期控制:
# 推送文件至设备 PS C:\> adb push local_file.txt /sdcard/Download/ # 从设备拉取文件 PS C:\> adb pull /sdcard/Download/local_file.txt # 卸载应用 PS C:\> adb shell pm uninstall -k --user 0 com.example.app # 清除应用数据 PS C:\> adb shell pm clear com.example.app
Python 示例:批量卸载测试应用:
packages_to_uninstall = [
"com.test.app1",
"com.test.app2"
]
for pkg in packages_to_uninstall:
try:
device.shell(f"pm uninstall -k --user 0 {pkg}")
print(f"✅ 已卸载:{pkg}")
except Exception as e:
print(f"❌ 卸载失败 {pkg}:{e}")
三、Python 脚本开发实战
3.1 基础控制脚本示例
实现“解锁→打开浏览器→搜索关键词”的完整流程:
#!/usr/bin/env python
# -*- coding: utf-8 -*-
from adbutils import AdbClient
import time
def unlock_and_search(keyword="Python ADB"):
client = AdbClient(host="127.0.0.1", port=5037)
device = client.device()
# 解锁屏幕
device.shell("input keyevent 26") # 电源键
device.shell("input swipe 540 1800 540 300 200") # 上滑解锁
time.sleep(0.5)
# 打开 Chrome
device.shell("am start -n com.android.chrome/com.google.android.apps.chrome.Main")
time.sleep(3)
# 点击地址栏
device.shell("input tap 540 150")
time.sleep(0.3)
# 输入关键词
device.shell(f'input text "{keyword}"')
time.sleep(0.5)
# 回车搜索
device.shell("input keyevent 66")
print("✅ 搜索流程完成")
if __name__ == "__main__":
unlock_and_search()
3.2 事件监听与响应机制
使用 adbutils 的事件监听功能捕获屏幕点击事件:
from adbutils import AdbClient
import threading
def monitor_clicks():
client = AdbClient(host="127.0.0.1", port=5037)
device = client.device()
# 开启触摸事件监控
stream = device.shell("getevent -l", return_stdout=False)
def read_stream():
for line in stream:
if "EV_KEY" in line and "BTN_TOUCH" in line and "DOWN" in line:
# 提取坐标
parts = line.split()
x = int(parts[4], 16)
y = int(parts[5], 16)
print(f"📍 屏幕点击:({x//100}, {y//100})")
threading.Thread(target=read_stream, daemon=True).start()
input("按 Enter 停止监控...\n")
monitor_clicks()
3.3 多设备并行控制架构
采用线程池实现批量设备控制,避免单设备阻塞:
#!/usr/bin/env python
# -*- coding: utf-8 -*-
from adbutils import AdbClient
from concurrent.futures import ThreadPoolExecutor
import time
def run_task_on_device(device_serial):
try:
device = client.device(device_serial)
# 示例任务:循环点击屏幕中心
for i in range(5):
device.shell("input tap 540 1180")
time.sleep(1)
print(f"✅ 设备 {device_serial} 任务完成")
except Exception as e:
print(f"❌ 设备 {device_serial} 出错:{e}")
if __name__ == "__main__":
client = AdbClient(host="127.0.0.1", port=5037)
devices = client.devices() # 获取所有连接设备
with ThreadPoolExecutor(max_workers=4) as executor:
futures = [executor.submit(run_task_on_device, d.serial) for d in devices]
for f in futures:
f.result()
print("🎉 所有设备任务执行完毕!")
device 实例,避免多线程共享导致 ADB 连接冲突。
四、企业级设备群控系统构建
4.1 群控系统架构设计
典型企业级群控系统包含三层架构:
- 控制层:Python 脚本或 Web 管理后台;
- 传输层:USB Hub + ADB over TCP/IP(无线控制);
- 设备层:Android 手机集群(支持 128+ 台)。
推荐使用 ADB over TCP/IP 实现无线控制:
PS C:\> adb tcpip 5555 restarting in TCP mode port: 5555 PS C:\> adb connect 192.168.1.100:5555 connected to 192.168.1.100:5555
注意:每台设备需独立配置 IP 和端口,避免冲突。
4.2 设备健康监控方案
定期执行 adb shell dumpsys battery 检查电量、温度、充电状态。
device.shell("dumpsys battery | grep -E 'level|temperature|status'")
设置定时任务,每 12 小时执行 adb reboot 防止内存泄漏。
连续 3 次 adb shell echo hello 无响应,则标记为离线设备并告警。
4.3 实时性能数据可视化
通过 matplotlib 实时绘制 CPU 使用率曲线:
import matplotlib.pyplot as plt
import matplotlib.animation as animation
from adbutils import AdbClient
import time
fig, ax = plt.subplots()
x_data, y_data = [], []
client = AdbClient()
device = client.device()
def update(frame):
cpu_usage = device.shell("dumpsys cpuinfo | head -n 1 | awk '{print $1}'").strip().replace("%", "")
if cpu_usage:
x_data.append(time.time())
y_data.append(float(cpu_usage))
ax.clear()
ax.plot(x_data, y_data, color="#037ef3")
ax.set_title("设备 CPU 使用率监控")
ax.set_ylabel("CPU %")
ax.set_xlabel("时间")
plt.xticks(rotation=45)
plt.tight_layout()
ani = animation.FuncAnimation(fig, update, interval=1000)
plt.show()
五、安全测试与渗透实践
5.1 ADB 安全风险识别
ADB 开启后可能引入以下安全问题:
- 权限提升:攻击者可通过 ADB 安装恶意应用;
- 数据泄露:可读取任意应用沙盒数据(需 root);
- 拒绝服务:频繁执行
adb reboot导致设备宕机。
5.2 检测设备是否开启 ADB
通过检查系统属性判断:
def is_adb_enabled():
try:
device = client.device()
debug_mode = device.shell("getprop ro.adb.secure").strip()
return debug_mode != "1" # 1 表示启用安全 ADB
except:
return False
5.3 应用数据备份与恢复测试
使用 adb backup 进行安全审计:
PS C:\> adb backup -f backup.ab -nosystem com.example.app # 提示用户输入密码(可选) # 操作完成后生成 backup.ab
使用 android-backup-extractor 解析备份文件:
java -jar abe.jar unpack backup.ab backup.tar tar -xvf backup.tar
检查是否包含敏感数据(如 token、设备 ID),评估数据泄露风险。
六、常见故障诊断手册
6.1 设备无法识别
- 检查设备管理器中是否显示为“Android ADB Interface”;
- 更新驱动:右键设备 → 更新驱动程序 → 手动选择 → 从磁盘安装;
- 使用原装数据线,避免 USB 集线器供电不足。
错误信息:more than one device and emulator
- 指定设备序列号:
adb -s MHA_AL00-xxx shell; - 关闭所有模拟器;
- 重启 ADB 服务:
adb kill-server && adb start-server。
错误信息:device not found
- 检查 USB 调试是否启用;
- 重新授权连接(手机弹窗);
- 尝试 ADB over TCP/IP:
adb connect 192.168.x.x:5555。
6.2 命令执行超时
在 adbutils 中设置超时参数:
device.shell("ls /data", timeout=5.0) # 默认超时 30 秒
对耗时操作(如大文件传输)应分块处理:
with device._get_file_reader("/data/data/com.app/cache/bigfile.db") as reader:
with open("local.db", "wb") as f:
while True:
chunk = reader.read(1024 * 1024) # 1MB 分块
if not chunk:
break
f.write(chunk)
七、高频问题解答(FAQ)
Q1:Python ADB Shell 是否支持非 USB 连接?
A:支持!通过 Wi-Fi 连接:
PS C:\> adb tcpip 5555 PS C:\> adb connect 192.168.1.100:5555
注意:设备与电脑需在同一局域网,且部分厂商(如小米)限制 Wi-Fi ADB,需先 USB 连接授权。
Q2:如何获取屏幕点击坐标?
A:方法一:使用 adb shell getevent -l 实时监听;
方法二:在设备安装 显示指针位置 开发者选项;
方法三:通过 Python 获取屏幕分辨率后计算百分比坐标:
size = device.shell("wm size").split()[-1] # "1080x2340"
w, h = map(int, size.split("x"))
x, y = int(w * 0.5), int(h * 0.5) # 屏幕中心
Q3:如何实现无 root 权限读取其他应用数据?
A:标准 Android 安全机制禁止跨应用数据访问。但可通过以下方式间接获取:
- 使用无障碍服务(Accessibility Service)读取屏幕内容;
- 通过
adb shell dumpsys activity services获取运行中服务信息; - 对测试应用使用
adb backup导出数据(需用户授权)。