【大前端】【Android】用 Python 脚本模拟点击 Android APP —— 全面技术指南

用 Python 脚本模拟点击 Android APP —— 全面技术指南

在自动化测试、自动操作、RPA 或数据采集场景中，经常需要在 PC 上用 Python 控制 Android 设备进行点击、输入、滑动等操作。本文从零开始全面介绍几种常见方案：ADB、uiautomator2、pure-python-adb、Appium，以及控件定位、UI dump 解析、坐标适配与稳定性优化等工程实践。

📑 目录

• 背景与原理速览

• 准备工作

• 方法一：ADB 命令（最简单 & 最通用）

• 方法二：uiautomator2（更稳定的控件定位方式）

• 方法三：pure-python-adb 与 adb shell 结合

• 方法四：Appium（企业级自动化）

• 控件定位方式：坐标 / id / text / xpath / UI Dump

• 不同分辨率适配（坐标比例换算）

• 稳定性与同步策略（等待/重试/断言）

• 常见问题与排查技巧

• 安全与合规性提醒

• 完整综合示例：从控件 dump 到点击

• 总结 & 下一步建议

背景与原理速览

PC 控制 Android 的核心方法包括：

• ADB input：执行 input tap、input swipe 等命令模拟触摸事件

• uiautomator：从 Android UI 层读取控件树，按 resource-id/text 定位控件

• Appium：跨平台自动化框架，基于 WebDriver

• pure-python-adb：用 Python 原生实现 adb 协议

不同方法侧重点不同： ADB 轻量、快速，但定位基于坐标；uiautomator2 和 Appium 提供 UI 树级别的稳定定位方法。

准备工作

pip install uiautomator2
pip install pure-python-adb
pip install Appium-Python-Client

方法一：ADB 命令（最简单 & 最通用）

这是最基础也最兼容的方式。

📌 Python 调用 ADB 执行点击

import subprocess
import time

ADB = "adb"

def adb(cmd: str):
full = ADB.split() + cmd.split()
return subprocess.check_output(full).decode('utf-8')

def tap(x, y):
adb(f"shell input tap {x} {y}")

def swipe(x1, y1, x2, y2, duration=300):
adb(f"shell input swipe {x1} {y1} {x2} {y2} {duration}")

tap(200, 800)
swipe(300, 1200, 300, 400, 500)

📌 获取屏幕分辨率

adb shell wm size
# Physical size: 1080×2400

✔️ 优点

• 无需额外安装

• 非常快

• 全机型高兼容性

❌ 缺点

• 依赖坐标，UI 改动或分辨率不同都会失效

• 无法直接基于控件定位

方法二：uiautomator2（更稳定的控件定位方式）

最推荐的 Python 自动化方案，支持资源 id、text、xpath 定位控件。

📌 安装初始化

pip install –upgrade uiautomator2
python -m uiautomator2 init

📌 Python 示例

import uiautomator2 as u2
import time

d = u2.connect() # USB 或 IP 连接

# 启动 app
d.app_start("com.example.app")

# 通过 resource-id 选择控件
d(resourceId="com.example.app:id/login").click()

# 通过 text
d(text="下一步").click()

# dump 当前界面 XML
xml = d.dump_hierarchy()
print(xml[:500])

✔️ 优点

• 最易用且最稳

• 能获取控件信息

• 支持 xpath、手势、多点触控

❌ 缺点

• 设备需安装 uiautomator2 服务

• 某些深度定制系统可能不稳定

方法三：pure-python-adb 与 adb shell 结合

适合需要 programmatic adb 的场景，不用频繁创建进程。

📌 安装

pip install pure-python-adb

📌 示例代码

from ppadb.client import Client

client = Client(host="127.0.0.1", port=5037)
device = client.devices()[0]

# 点击
device.shell("input tap 200 800")

# dump UI
device.shell("uiautomator dump /sdcard/uidump.xml")
device.pull("/sdcard/uidump.xml", "uidump.xml")

方法四：Appium（企业级自动化）

适合复杂 UI 自动化 / 多设备并发 / 测试平台集成。

📌 Python 代码示例

from appium import webdriver
from selenium.webdriver.common.by import By

caps = {
"platformName": "Android",
"deviceName": "device",
"appPackage": "com.example.app",
"appActivity": ".MainActivity",
}

driver = webdriver.Remote("http://localhost:4723/wd/hub", caps)
driver.find_element(By.ID, "com.example.app:id/login").click()
driver.quit()

✔️ 强大且标准 ❌ 部署复杂，需要 Appium Server

控件定位方式：坐标 / id / text / xpath / UI Dump

🟢 推荐优先级

不同分辨率适配（坐标比例换算）

如果必须用坐标，建议做分辨率适配。

📌 坐标换算函数

def scale(x, y, base_w, base_h, w, h):
return int(x * w / base_w), int(y * h / base_h)

📌 获取分辨率

adb shell wm size

稳定性与同步策略（等待/重试/断言）

建议实践：

• 不要到处用 sleep

• 使用条件等待：exists(timeout=…)

• 加入 retry（网络波动、动画会导致不稳定）

• 操作后做断言（比如检查文本是否出现）

• 失败时保存截图 + UI dump

示例：带重试的点击

def click_retry(d, selector, tries=3):
for i in range(tries):
if d(selector).exists(timeout=2):
d(selector).click()
return True
return False

常见问题与排查技巧

安全与合规性提醒

• 请确保你对目标设备和目标应用拥有合法操作权限

• 不要用于绕过安全、刷量等非法用途

• 企业环境中操作前注意数据与隐私保护

完整综合示例：从控件 dump 到点击

import uiautomator2 as u2
import re
import time

d = u2.connect()

# 启动 app
d.app_start("com.example.app")

# 首选通过 text 点击
if d(text="确认").exists(timeout=3):
d(text="确认").click()
else:
# 备选：从 XML dump 找 bounds
xml = d.dump_hierarchy()
m = re.search(r'text="确认".*?bounds="(\\[.*?\\])"', xml)
if m:
bounds = m.group(1)
nums = list(map(int, re.findall(r"\\d+", bounds)))
l, t, r, b = nums
cx, cy = (l+r)//2, (t+b)//2
d.click(cx, cy)

总结 & 下一步建议

• 仅需简单点击时：ADB input 最快

• 想稳定可维护：uiautomator2 强烈推荐

• 需要分布式 / 测试体系：选 Appium

• 避免硬编码坐标，优先使用 resource-id、text

• 引入等待、重试、断言让脚本更稳

• 借助 UI dump、截图、日志排查错误