安装 uiautomator2 库
通过 pip 安装 uiautomator2 库,确保 Python 环境已配置。
pip install uiautomator2初始化设备连接
使用设备的 IP 地址或序列号连接手机,确保手机已开启 USB 调试模式。
import uiautomator2 as u2 d = u2.connect("192.168.1.100") # 替换为设备 IP 或序列号基本操作示例
点击屏幕上的元素,通过resourceId或text定位。
d(resourceId="com.android.settings:id/title").click() d(text="Wi-Fi").click()输入文本
在输入框中输入文本,使用set_text方法。
d(resourceId="com.android.settings:id/search").set_text("蓝牙")滑动操作
模拟上下滑动屏幕,支持定向滑动(up、down、left、right)。
d.swipe("up") # 向上滑动 d.swipe("left", steps=20) # 快速左滑https://www.zhihu.com/zvideo/1994901276425733593/
https://www.zhihu.com/zvideo/1994901272667656981/
https://www.zhihu.com/zvideo/1994901272294355097/
https://www.zhihu.com/zvideo/1994901272449553144/
https://www.zhihu.com/zvideo/1994901271505823296/
https://www.zhihu.com/zvideo/1994901271170289832/
https://www.zhihu.com/zvideo/1994901270696310273/
https://www.zhihu.com/zvideo/1994901267991003190/
https://www.zhihu.com/zvideo/1994901267244413927/
https://www.zhihu.com/zvideo/1994901266325845257/
https://www.zhihu.com/zvideo/1994901264136427136/
https://www.zhihu.com/zvideo/1994901263368884466/
https://www.zhihu.com/zvideo/1994901263087837333/
https://www.zhihu.com/zvideo/1994901261800207831/
https://www.zhihu.com/zvideo/1994901261288509918/
https://www.zhihu.com/zvideo/1994901259057133461/
https://www.zhihu.com/zvideo/1994901258402812280/
https://www.zhihu.com/zvideo/1994901258105017584/
https://www.zhihu.com/zvideo/1994901257698157195/
https://www.zhihu.com/zvideo/1994901256540534523/
https://www.zhihu.com/zvideo/1994901256720896600/
https://www.zhihu.com/zvideo/1994901255747817781/
https://www.zhihu.com/zvideo/1994901254095249788/
https://www.zhihu.com/zvideo/1994901253625516062/
https://www.zhihu.com/zvideo/1994901249846445257/
https://www.zhihu.com/zvideo/1994901247489241467/
https://www.zhihu.com/zvideo/1994901246071559193/
https://www.zhihu.com/zvideo/1994901246633603891/
https://www.zhihu.com/zvideo/1994901243513020475/
https://www.zhihu.com/zvideo/1994901239079646854/
https://www.zhihu.com/zvideo/1994901238165304480/
https://www.zhihu.com/zvideo/1994901237922014150/
https://www.zhihu.com/zvideo/1994901237645206228/
https://www.zhihu.com/zvideo/1994901234583372248/
https://www.zhihu.com/zvideo/1994901234210071846/
https://www.zhihu.com/zvideo/1994901232909841565/
https://www.zhihu.com/zvideo/1994901230158374146/
https://www.zhihu.com/zvideo/1994901230095454954/
https://www.zhihu.com/zvideo/1994901230061900185/
截图与保存
截取当前屏幕并保存到本地文件。
d.screenshot("screen.png")处理弹窗
监控并关闭意外弹窗,结合watcher使用。
d.watcher("ALERT").when(text="确定").click() d.watcher.start() # 启动监控进阶:XPath 定位
使用 XPath 语法定位复杂元素,需开启xpath支持。
d.xpath("//*[@text='设置']").click()常见问题排查
检查设备是否连接成功,若失败需重新授权 USB 调试或重启adb服务。
adb devices # 确认设备列表性能优化建议
减少不必要的截图和频繁操作,适当增加操作间隔以提升稳定性。
import time time.sleep(1) # 操作间隔