环境安装通过 pip 安装库本身pip install -U uiautomator2首次连接设备时通常需要运行初始化命令将必要的守护进程推送到手机python -m uiautomator2 init连接设备确保手机开启“开发者选项”和“USB调试”。连接后用以下代码验证import uiautomator2 as u2 d u2.connect() # 自动连接 print(d.info) # 打印设备信息成功则显示分辨率、SDK版本等uiautomator2的核心是定位元素推荐优先使用text或resourceId因为它们最直观且稳定-3-11。常用定位方式-10-11文本定位d(text精选).click()资源 ID 定位d(resourceIdcom.example:id/button).click()描述定位d(description更多选项).click()组合定位d(classNameandroid.widget.TextView, text好友动态)进阶定位——XPath当元素属性不明显或需要复杂层级关系时XPath 非常灵活-7。# 查找包含特定文本的元素 d.xpath(//*[contains(text, 登录)]).click() # 简写规则 代表 resourceId d.xpath(com.example:id/title)d(text我的).click() # 点击 d(textViews).long_click(2) # 长按 2 秒 d(classNameEditText).send_keys(hello) # 输入文本 d.swipe_ext(up, scale0.8) # 向上滑动屏幕等待与同步显式等待比sleep更稳定能有效避免因网络或动画导致的失败d(text加载完成).wait(timeout10.0) # 等待元素出现最多 10 秒 d(text弹窗).wait_gone(timeout5.0) # 等待元素消失弹窗监控自动处理常见的系统权限弹窗避免测试中断d.watcher.when(允许).click() # 当出现“允许”按钮时自动点击 d.watcher.start() # 启动监控强烈推荐使用 UIAutoDev 工具它能在浏览器中实时查看界面元素树帮你快速生成定位代码极大提升效率确保电脑已安装 Python建议 3.8 以上然后执行pip install -U uiautodev如果需要连接鸿蒙设备可以改用pip install uiautodev[harmony]cmd命令uiauto.devATX可以授权悬浮窗。