手机自动化控制：Python+uiautomator2教程

vyuvyucd2026-01-10 11:13

好的！以下是一个使用Python和uiautomator2进行手机自动化控制的简明教程：

一、环境准备

安装Python（推荐3.7+版本）
安装库：
bash 复制代码
```
pip install uiautomator2 weditor
```
手机开启USB调试模式（设置 > 开发者选项）

二、初始化设备连接

通过USB连接手机后执行：

python 复制代码

import uiautomator2 as u2

# 方式1：通过设备ID连接（adb devices获取）
d = u2.connect("设备ID")

# 方式2：通过WiFi连接（需先USB初始化一次）
d = u2.connect("192.168.x.x")

三、基础操作示例

python 复制代码

# 点击操作
d.click(100, 200)       # 坐标点击
d(text="设置").click()  # 文本点击

# 输入文本
d(focused=True).set_text("HelloWorld")

# 滑动屏幕
d.swipe(500, 1500, 500, 500)  # 从下往上滑动

四、元素定位方法

python 复制代码

# 通过资源ID
d(resourceId="com.android.settings:id/title").click()

# 通过文本+类名
d(className="android.widget.TextView", text="Wi-Fi").click()

# 通过描述（content-desc）
d(description="返回").click()

五、高级功能

监控界面变化 ：

python 复制代码

d.watch("跳过", lambda el: el.click())

截图保存 ：
python 复制代码
```
d.screenshot("home.jpg")
```

六、可视化定位工具

启动UI查看器：

bash 复制代码

python -m weditor

浏览器访问 http://localhost:17310 可实时查看元素结构。

七、常见问题

连接失败：检查adb devices是否识别设备
点击无效：尝试d.delay(2)添加延迟
元素找不到：使用weditor确认元素属性

通过上述步骤，你可以快速实现APP自动化测试、批量操作等任务。完整文档参考：uiautomator2 GitHub