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调试”并授权连接,即可实现脚本级控制。

技术定位说明:本页面聚焦于 Python ADB Shell 在真实生产环境中的深度应用,涵盖环境部署、命令解析、脚本封装、设备群控、性能监控、安全审计等核心模块,所有示例均经实机验证,可直接用于企业级自动化平台开发。

一、环境搭建与基础配置

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 为例,需按以下步骤开启调试:

  1. 进入「设置」→「关于手机」→ 连续点击「版本号」7次,启用开发者选项;
  2. 返回「设置」→「系统和更新」→「开发人员选项」→ 开启「USB调试」;
  3. 首次连接电脑时,手机弹出授权提示,勾选「始终允许」并确认;
  4. 电脑执行 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。
企业部署建议:在 CI/CD 流水线中,应统一 ADB 版本(推荐 v34.0.5+),并在 Docker 容器中预装依赖,避免环境差异导致脚本失效。

二、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)
性能监控建议:生产环境中应设置阈值告警,如 CPU 持续 >70% 或内存占用 >85% 时触发设备重启或任务中断。

网络连接状态与 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 导致设备宕机。
企业防护建议:生产环境设备应禁用 USB 调试,或通过 MDM 系统统一管理 ADB 权限。

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 导出数据(需用户授权)。
法律提醒:未经授权读取他人应用数据可能违反《网络安全法》,仅限合法合规场景使用。