• 售前

  • 售后

热门帖子
入门百科

python UIAutomator2使用超具体教程

[复制链接]
枣强公用号 显示全部楼层 发表于 2021-10-25 19:51:16 |阅读模式 打印 上一主题 下一主题
目录


  • 一、情况要求
  • 二、先容
  • 三、库地点
  • 四、安装
  • 五、应用及利用

一、情况要求


python 3.6+
android 4.4+

二、先容


uiautomator2 是一个可以使用Python对Android装备举行UI自动化的库。其底层基于Google uiautomator,Google提供的uiautomator库可以获取屏幕上恣意一个APP的恣意一个控件属性,并对其举行恣意利用。

三、库地点


GitHub地点:
https://github.com/openatx/uiautomator2
https://github.com/openatx/uiautomator2/blob/master/README.md

四、安装

1、安装uiautomator2
  1. pip install --pre uiautomator2
  2. pip install pillow (如果需要截图,可安装这个库)
复制代码
2、装备安装atx-agent
  1. 首先设备连接到PC,并能够adb devices发现该设备。
  2. 执行下面的命令会自动安装本库所需要的设备端程序:uiautomator-server,atx-agent,openstf / minicap,openstf / minitouch
复制代码
  1. # init就是所有USB连接电脑的手机上都安装uiautomator2
  2. python -m uiautomator2 init
  3. # 指定手机安装uiautomator2, 用 --mirror
  4. python -m uiautomator2 init --mirror --serial $SERIAL
  5. # 嫌弃慢的话,可以用国内的镜像
  6. python -m uiautomator2 init --mirror
复制代码
最后提示success,代表atx-agent初始化乐成。
3、安装weditor
有了这个,方便我们快速的辨认手机上的元素,方便写代码
  1. pip install -U weditor
复制代码
安装好之后,就可以在命令行运行 weditor --help 确认是否安装乐成了。
Windows系统可以使用命令在桌面创建一个快捷方式:
  1. weditor --shortcut
复制代码
在windows cmd中实行上述命令后,会在桌面上创建一个快捷方式,如下图:

启动方法:
  1. 方法1.命令行直接输入 <strong>weditor</strong> 会自动打开浏览器,输入设备的ip或者序列号,点击Connect即可;
  2. 方法2.桌面上双击WEditor快捷方式即可;
  3. 方法3.命令行中执行 <strong>python -m weditor</strong>
复制代码
启动后如下图:


五、应用及利用

调用uiautomator2的过程
  1. 配置手机设备参数,设置具体操作的是哪一台手机
  2. 抓取手机上应用的控件,制定对应的控件来进行操作
  3. 对抓取到的控件进行操作,比如点击、填写参数等。
复制代码
装备连接方法,有两种
  1. python-uiautomator2连接手机的方式有两种,一种是通过WIFI,另外一种是通过USB。两种方法各有优缺点。
  2. WIFI最便利的地方要数可以不用连接数据线,USB则可以用在PC和手机网络不在一个网段用不了的情况。
复制代码
(1)通过WiFi,假设装备IP 192.168.0.107和您的PC在同一网络中
  1. import uiautomator2 as u2
  2. d = u2.connect('192.168.0.107')
复制代码
(2)通过USB, 假设装备序列是123456789F
  1. import uiautomator2 as u2
  2. d = u2.connect('123456789F') # USB链接设备。或者u2.connect_usb('123456f')
  3. #d = u2.connect_usb() 或者 d = u2.connect() ,当前只有一个设备时可以用这个
复制代码
在没有参数的情况下调用u2.connect(), uiautomator2将从情况变量ANDROID_DEVICE_IP获取装备IP。如果这个情况变量是空的,uiautomator将返回connect_usb,您必要确保只有一个装备连接到盘算机。
检查并维持装备端守卫进程处于运行状态:
  1. d.healthcheck()
复制代码
打开调试开关:
  1. d.debug = True
  2. d.info
复制代码
安装应用,只能从URL安装:
  1. d.app_install('http://some-domain.com/some.apk') #引号内为下载apk地址
复制代码
启动应用:
  1. d.app_start('com.eg.android.AlipayGphone') #引号内为包名称,这里为支付宝
复制代码
停止应用:
  1. #相当于'am force-stop'强制停止应用
  2. d.app_stop('com.eg.android.AlipayGphone')
  3. #相当于'pm clear' 清空App数据
  4. d.app_clear('com.eg.android.AlipayGphone')
复制代码
停止所有正在运行的应用程序:
  1. # 停止所有
  2. d.app_stop_all()
  3. # 停止所有应用程序,除了com.examples.demo
  4. d.app_stop_all(excludes=['com.examples.demo'])
复制代码
跳过弹窗,克制弹窗:
  1. d.disable_popups() # 自动跳过弹出窗口
  2. d.disable_popups(False) # 禁用自动跳过弹出窗
复制代码
获取装备信息:
  1. # 获取基本信息
  2. d.info
  3. # 获取窗口大小
  4. print(d.window_size())
  5. # 设备垂直输出示例: (1080, 1920)
  6. # 设备水平输出示例: (1920, 1080)
  7. # 获取当前应用程序信息。对于某些android设备,输出可以为空
  8. print(d.current_app())
  9. #获取设备序列号
  10. print(d.serial)
  11. #获取WIFI IP
  12. print(d.wlan_ip)
  13. #获取详细的设备信息
  14. print(d.device_info)
复制代码
获取应用信息:
  1. d.app_info("com.eg.android.AlipayGphone")
  2. # 会输出
  3. '''
  4. {
  5. "packageName": "com.eg.android.AlipayGphone",
  6. "mainActivity": "com.eg.android.AlipayGphone.AlipayLogin",
  7. "label": "支付寶",
  8. "versionName": "10.2.13.9020",
  9. "versionCode": 360,
  10. "size": 108306104
  11. }
  12. '''
  13. # 保存应用程序图标
  14. img = d.app_icon("com.eg.android.AlipayGphone")
  15. img.save("icon.png")
复制代码
推拉文件:
(1)将文件推送到装备
  1. # push文件夹
  2. d.push("foo.txt", "/sdcard/")
  3. # push和重命名
  4. d.push("foo.txt", "/sdcard/bar.txt")
  5. # push fileobj
  6. with open("foo.txt", 'rb') as f:
  7. d.push(f, "/sdcard/")
  8. # 推动和更改文件访问模式
  9. d.push("foo.sh", "/data/local/tmp/", mode=0o755)
复制代码
(2)从装备中拉出一个文件
  1. d.pull("/sdcard/tmp.txt", "tmp.txt")
  2. # 如果在设备上找不到文件,FileNotFoundError将引发
  3. d.pull("/sdcard/some-file-not-exists.txt", "tmp.txt")
复制代码
关键变乱:
(1)打开/关闭屏幕
  1. d.screen_on()#打开屏幕
  2. d.screen_off() #关闭屏幕
复制代码
(2)获取当前屏幕状态
  1. d.info.get('screenOn') # 需要 Android> = 4.4
复制代码
(3)硬键盘和软键盘利用
  1. d.press("home") # 点击home键
  2. d.press("back") # 点击back键
  3. d.press("left") # 点击左键
  4. d.press("right") # 点击右键
  5. d.press("up") # 点击上键
  6. d.press("down") # 点击下键
  7. d.press("center") # 点击选中
  8. d.press("menu") # 点击menu按键
  9. d.press("search") # 点击搜索按键
  10. d.press("enter") # 点击enter键
  11. d.press("delete") # 点击删除按键
  12. d.press("recent") # 点击近期活动按键
  13. d.press("volume_up") # 音量+
  14. d.press("volume_down") # 音量-
  15. d.press("volume_mute") # 静音
  16. d.press("camera") # 相机
  17. d.press("power") #电源键
复制代码
(4)解锁屏幕
  1. d.unlock()
  2. # 相当于
  3. # 1. 发射活动:com.github.uiautomator.ACTION_IDENTIFY
  4. # 2. 按home键
复制代码
手势与装备的交互:
  1. # 单击屏幕
  2. d.click(x,y) # x,y为点击坐标
  3. # 双击屏幕
  4. d.double_click(x,y)
  5. d.double_click(x,y,0.1) # 默认两个单击之间间隔时间为0.1秒
  6. # 长按
  7. d.long_click(x,y)
  8. d.long_click(x,y,0.5) # 长按0.5秒(默认)
  9. # 滑动
  10. d.swipe(sx, sy, ex, ey)
  11. d.swipe(sx, sy, ex, ey, 0.5) #滑动0.5s(default)
  12. #拖动
  13. d.drag(sx, sy, ex, ey)
  14. d.drag(sx, sy, ex, ey, 0.5)#拖动0.5s(default)
  15. # 滑动点 多用于九宫格解锁,提前获取到每个点的相对坐标(这里支持百分比)
  16. # 从点(x0, y0)滑到点(x1, y1)再滑到点(x2, y2)
  17. # 两点之间的滑动速度是0.2秒
  18. d.swipe((x0, y0), (x1, y1), (x2, y2), 0.2)
  19. # 注意:单击,滑动,拖动操作支持百分比位置值。例:
  20. d.long_click(0.5, 0.5) 表示长按屏幕中心
复制代码
XPath:
  1. # 检索方向
  2. d.orientation
  3. # 检索方向。输出可以是 "natural" or "left" or "right" or "upsidedown"
  4. # 设置方向
  5. d.set_orientation("l") # or "left"
  6. d.set_orientation("r") # or "right"
  7. d.set_orientation("n") # or "natural"
  8. #冻结/ 开启旋转
  9. d.freeze_rotation() # 冻结旋转
  10. d.freeze_rotation(False) # 开启旋转
  11. ########## 截图 ############
  12. # 截图并保存到电脑上的一个文件中,需要Android>=4.2。
  13. d.screenshot("home.jpg")
  14. # 得到PIL.Image格式的图像. 但你必须先安装pillow
  15. image = d.screenshot() # default format="pillow"
  16. image.save("home.jpg") # 或'home.png',目前只支持png 和 jpg格式的图像
  17. # 得到OpenCV的格式图像。当然,你需要numpy和cv2安装第一个
  18. import cv2
  19. image = d.screenshot(format='opencv')
  20. cv2.imwrite('home.jpg', image)
  21. # 获取原始JPEG数据
  22. imagebin = d.screenshot(format='raw')
  23. open("some.jpg", "wb").write(imagebin)
  24. #############################
  25. # 转储UI层次结构
  26. # get the UI hierarchy dump content (unicoded).(获取UI层次结构转储内容)
  27. d.dump_hierarchy()
  28. # 打开通知或快速设置
  29. d.open_notification() #下拉打开通知栏
  30. d.open_quick_settings() #下拉打开快速设置栏
  31. # 检查特定的UI对象是否存在
  32. d(text="Settings").exists # 返回布尔值,如果存在则为True,否则为False
  33. d.exists(text="Settings") # 另一种写法
  34. # 高级用法
  35. d(text="Settings").exists(timeout=3) # 等待'Settings'在3秒钟出现
  36. # 获取特定UI对象的信息
  37. d(text="Settings").info
  38. # 获取/设置/清除可编辑字段的文本(例如EditText小部件)
  39. d(text="Settings").get_text() #得到文本小部件
  40. d(text="Settings").set_text("My text...") #设置文本
  41. d(text="Settings").clear_text() #清除文本
  42. # 获取Widget中心点
  43. d(text="Settings").center()
  44. #d(text="Settings").center(offset=(0, 0)) # 基准位置左前
复制代码
UI对象有五种定位方式:
  1. # text、resourceId、description、className、xpath、坐标
  2. # 执行单击UI对象
  3. #text定位单击
  4. d(text="Settings").click()
  5. d(text="Settings", className="android.widget.TextView").click()
  6. #resourceId定位单击
  7. d(resourceId="com.ruguoapp.jike:id/tv_title", className="android.widget.TextView").click()
  8. #description定位单击
  9. d(description="设置").click()
  10. d(description="设置", className="android.widget.TextView").click()
  11. #className定位单击
  12. d(className="android.widget.TextView").click()
  13. #xpath定位单击
  14. d.xpath("//android.widget.FrameLayout[@index='0']/android.widget.LinearLayout[@index='0']").click()
  15. #坐标单击
  16. d.click(182, 1264)
  17. # 等待元素出现(最多10秒),出现后单击
  18. d(text="Settings").click(timeout=10)
  19. # 在10秒时点击,默认的超时0
  20. d(text='Skip').click_exists(timeout=10.0)
  21. # 单击直到元素消失,返回布尔
  22. d(text="Skip").click_gone(maxretry=10, interval=1.0) # maxretry默认值10,interval默认值1.0
  23. # 点击基准位置偏移
  24. d(text="Settings").click(offset=(0.5, 0.5)) # 点击中心位置,同d(text="Settings").click()
  25. d(text="Settings").click(offset=(0, 0)) # 点击左前位置
  26. d(text="Settings").click(offset=(1, 1)) # 点击右下
  27. # 执行双击UI对象
  28. d(text="设置").double_click() # 双击特定ui对象的中心
  29. d.double_click(x, y, 0.1) # 两次单击之间的默认持续时间为0.1秒
  30. #执行长按UI对象
  31. # 长按特定UI对象的中心
  32. d(text="Settings").long_click()
  33. d.long_click(x, y, 0.5) # 长按坐标位置0.5s默认
  34. # 将UI对象拖向另一个点或另一个UI对象
  35. # Android<4.3不能使用drag.
  36. # 在0.5秒内将UI对象拖到屏幕点(x, y)
  37. d(text="Settings").drag_to(x, y, duration=0.5)
  38. # 将UI对象拖到另一个UI对象的中心位置,时间为0.25秒
  39. d(text="Settings").drag_to(text="Clock", duration=0.25)
复制代码
常见用法:
  1. # 等待10s
  2. d.xpath("//android.widget.TextView").wait(10.0)
  3. # 找到并单击
  4. d.xpath("//*[@content-desc='分享']").click()
  5. # 检查是否存在
  6. if d.xpath("//android.widget.TextView[contains(@text, 'Se')]").exists:
  7. print("exists")
  8. # 获取所有文本视图文本、属性和中心点
  9. for elem in d.xpath("//android.widget.TextView").all():
  10. print("Text:", elem.text)
  11. #获取视图文本
  12. for elem in d.xpath("//android.widget.TextView").all():
  13. print("Attrib:", elem.attrib)
  14. #获取属性和中心点
  15. #返回: (100, 200)
  16. for elem in d.xpath("//android.widget.TextView").all():
  17. print("Position:", elem.center())
  18. # xpath常见用法:
  19. # 所有元素
  20. //*
  21. # resource-id包含login字符
  22. //*[contains(@resource-id, 'login')]
  23. # 按钮包含账号或帐号
  24. //android.widget.Button[contains(@text, '账号') or contains(@text, '帐号')]
  25. # 所有ImageView中的第二个
  26. (//android.widget.ImageView)[2]
  27. # 所有ImageView中的最后一个
  28. (//android.widget.ImageView)[last()]
  29. # className包含ImageView
  30. //*[contains(name(), "ImageView")]
复制代码
文章参考:https://vic.kim/2019/05/20/UIAutomator2%E7%9A%84%E4%BD%BF%E7%94%A8/
到此这篇关于python UIAutomator2使用超具体教程的文章就先容到这了,更多干系python UIAutomator2使用内容请搜刮草根技能分享从前的文章或继承欣赏下面的干系文章盼望各人以后多多支持草根技能分享!

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x

帖子地址: 

回复

使用道具 举报

分享
推广
火星云矿 | 预约S19Pro,享500抵1000!
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

草根技术分享(草根吧)是全球知名中文IT技术交流平台,创建于2021年,包含原创博客、精品问答、职业培训、技术社区、资源下载等产品服务,提供原创、优质、完整内容的专业IT技术开发社区。
  • 官方手机版

  • 微信公众号

  • 商务合作