uiautomator2

原文：https://github.com/openatx/uiautomator2

1、安装：

pip install --pre uiautomator2
＃或者你可以直接从github上源码安装
git clone https://github.com/openatx/uiautomator2
pip install -e uiautomator2

pip install pillow  #截屏工具

2、初始化手机，需要的环境SDK

python -m uiautomator2 init

这个只有初始化后才可以用

pip install --pre --upgrade weditor#安装自动化UI定位
python -m weditor#启动

自动安装本库所需的设备端程序：uiautomator-server ，atx-agent ，openstf / minicap ，openstf / minitouch  可单独下载安装

配置工作完成

3、打开手机端口：adb forward tcp：7912 tcp：7912 

     连接手机：device_ip = 127.0.0.1 

    这个不知道干嘛的忘记了好像是是自行安装atx-agent的时候用的

4、常用命令：

1、安装apk：python -m uiautomator2 install $ device_ip https://example.org/some.apk
2、清缓存：python -m uiautomator2
3、停止所有应用程序：python -m uiautomator2 app-stop-all $ device_ip
4、截图：python -m uiautomator2截图$ device_ip screenshot.jpg
5、检查守护线程：d.healthcheck（）
6、打开调试：d.debug = true
7、获取连接信息：d.info
8、shell命令：d.adb_shell（'pwd'）
9、分辨率：d.window_size（）
10、查看当前应用信息：d.current_app（）
11、查看序列号：d.serial

5、快速开始：

import uiautomator2 as u2
＃通过WIFI
d = u2.connect（'10 .0.0.1'）＃u2.connect_wifi（'10 .0.0.1'）的＃别名 
＃通过usb获取设备
d = u2.connect（'123456f'）＃u2.connect_usb（'123456f'）的＃别名

6、系统操作：

1、安装，只指出url：d.app_install（'http://some-domain.com/some.apk'）

2、启动：d.app_start（“com.example.hello_world”）＃以包名称开头

3、停止应用：d.app_stop（“com.example.hello_world”）

            d.app_clear（'com.example.hello_world'）

        停止所有应用：d.app_stop_all（）

5、推送一个文件到手机：d.push（“foo.txt的”，“/ SD卡/”）

6、推和重命名：d.push（“foo.txt的”，“/sdcard/bar.txt”）

7、推送并更改文件模式：d.push（“foo.sh”，“/ data / local / tmp /”，mode = 0o755）

8、从设备中拉取文件：d.pull（“/ sdcard / tmp.txt”，“tmp.txt”）＃如果文件在设备上找不到，FileNotFoundError将会出现 

    d.pull（“/ sdcard / some-file-not-exist.txt”，“tmp.txt”）

7，应用连接会话：

1、启动应用：sess = d.session（“com.netease.cloudmusic”
2、会话连接运行中的程序：sess = d.session（“com.netease.cloudmusic”
3、检测应否崩溃：SESS（文字= “音乐”）点击（）
    检查会话是否正常：sess.running（）

8，手机硬件操作

1、d.screen_on（）＃打开屏幕d.screen_off（）＃关闭屏幕
2、获取当前屏幕状态：d.info.get（'screenOn'）＃android 4.4
3、按软/硬件
d、press（“home”）＃按home键，用键名 
d、press（“back”）＃按返回键，与主要的名称 
d、press（0x07，0x02）＃按下键码0×07（“0”）与META ALT（0x02）
d、unlock（）解锁屏幕                                                                                                                 

这些目前支持：
home                    back                  left                  right
up                        down
center                   menu                 search             enter
delete ( or del)          recent (recent apps)        volume_up           
volume_down         volume_mute           camera    power

9、事件：

支持百分比d.long_click（0.5，0.5）

1、点击屏幕：d.click（X，Y）

2、长按屏幕：d.long_click（X，Y）或d.long_click（X，Y，0.5）＃长按0.5秒（默认）

3、拖动：d.drag（SX，SY，EX，EY）或d.drag（SX，SY，EX，EY，0.5）＃刷新0.5秒（默认）

4、刷卡：d.swipe（sx，sy，ex，ey）或d.swipe（sx，sy，ex，ey，0.5）＃刷新0.5秒（默认）

5、滑动：＃由点划动（X0，Y0）到点（X1，Y1），然后到点（X2，Y2） 

     ＃时间将加速0.2秒bwtween两点 

     d.swipe（（X0，Y0），（X1，Y1），（X2，Y2），0.2）

10，屏幕相关：

1、获取方向：d.orientation

2、设置方向：d.set_orientation（ 'L'） 

      值：natural或者n

       left或者l

       right或者r

        upsidedown或者u（不能设置）

3、不能选择/解冻：d.freeze_rotation（）＃冻结旋转d.freeze_rotation（False）

4、截屏：image = d.screenshot（）＃支持png和jpg

        image.save（ “home.jpg”） 

5、截屏： 

         import cv2

         image = d.screenshot（format ='opencv'）

         cv2.imwrite（'home.jpg'，image）

6、屏幕UI转xml：xml = d.dump_hierarchy（）

7、打开通知或快速设置：d.open_notification（）d.open_quick_settings（）

11、选择器：识别屏幕对象，请参阅UiSelector Java doc。

支持的参数：

• text，textContains，textMatches，textStartsWith
• className， classNameMatches
• description，descriptionContains，descriptionMatches，descriptionStartsWith
• checkable，checked，clickable，longClickable
• scrollable，enabled，focusable，focused，selected
• packageName， packageNameMatches
• resourceId， resourceIdMatches

• index， instance 

• 1、选择：d（text ='Clock'，className ='android.widget.TextView'）

  2、获取孩子或孙子：d（className =“android.widget.ListView”）.child（text =“Bluetooth”）

  3、兄弟姐妹：d（文本= “谷歌”）兄弟（类名= “android.widget.ImageView”）。

  4、获取子节点根据文本：d（className =“android.widget.ListView”，resourceId =“android：id / list”）\

    .child_by_text（“Bluetooth”，className =“android.widget.LinearLayout”）

  5、获取子节点根据文本允许滚动搜素：d（className =“android.widget.ListView”，resourceId =“android：id / list”）\

    .child_by_text（ “蓝牙”，allow_scroll_search =真，类名= “android.widget.LinearLayout”）

  6、支持多级：d（className =“android.widget.ListView”，resourceId =“android：id / list”）\ 

     .child_by_text（“Wi-Fi”，className =“android.widget.LinearLayout”）\ 

     .child（className =“android .widget.Switch”）\ .click（）

  7、支持相对定位：

   •d（A）.left（B），在A的左侧选择B.

   •d（A）。右（B），在A的右侧选择B.

   •D（A）.up（B），在A之上选择B.

   •d（A）.down（B），在A下选择B.

   d（文= “无线网络连接”）。右（的className = “android.widget.Switch”）。点击（）

  8、第一个文本带有“Add new”的实例：d（text =“Add new”，instance = 0）

  9、在屏幕上查找：d（text =“Add new”）。count

   d（text =“添加新的”）[0]＃第一个

   d（text =“添加新的”）[1]＃第二个

  10、显示控件信息：view.info 

  11、检查控件是否存在：d（text =“Settings”）.exists或者d.exists（text =“Settings”）

  12、检查控件信息：d（text =“设置”）.info

  13、文本控件操作：

   d（text =“Settings”）.get_text（）＃获取小部件文本 

   d（text =“Settings”）.set_text（“My text ...”）＃设置文本 

   d（text =“Settings”）.clear_text）＃清除文字

  14、点击：

   d（text =“设置”）.click（）

   ＃等待元素出现最多10秒钟，然后点击 

   d（text =“设置”）.click（超时时间= 10）

   ＃点击的别名 

   d（text=“设置”）.tap（）

  15、长按：d（text =“设置”）.long_click（）

  16、拖动元素到另一个位子：

   d（text =“Settings”）.drag_to（x，y，duration = 0.5）

   d（text =“Settings”）.drag_to（text =“Clock”，duration = 0.25）#clock的中心点

  17、从一点到另一点的两点手势

   d（text =“Settings”）.gesture（（sx1，sy1），（sx2，sy2），（ex1，ey1），（ex2，ey2））

  18、特定UI对象上的两点手势

   •从边缘到中心

   •从中心到边缘

   ＃从边缘到中心。这里是“以”不“在” 

   d（text =“Settings”）。pinch_in（percent = 100，steps = 10）

   ＃从中心到边缘 

   d（text= “设置”）pinch_out。（）

  19、等待用户界面出现或消失

   d（text =“Settings”）。wait（timeout = 3.0）＃return bool

   d（text= “设置”）。wait_gone（超时= 1.0）

  20、＃设置默认元素等待超时（秒） 

   d.wait_timeout = 30.0 

  21、控件不知道控件的情况下

   d.set_fastinput_ime（真）＃切换成FastInputIME输入法 

   d.send_keys（“你好123abcEFG”）＃adb广播输入 

   d.clear_text（）＃清除输入框所有内容（需要android-uiautomator.apk版本> = 1.0.7） 

   d.set_fastinput_ime（假）＃切换成正常的输入法

  22，显示：吐司

   d.make_toast（“Hello world”）

   d.make_toast（“Hello world”，1.5）＃显示1.5秒

child_by_description 就是找到孙子有特定描述的儿童，其他参数与之相似child_by_text 。

child_by_instance 就是要找到在其子层次结构中指定实例的任何位置具有子UI 元素的子元素。在它滚动没有可见的视图上执行。

详细信息请参阅下面的链接： • UiScrollable ，getChildByDescription ，getChildByText ，getChildByInstance

12、常见的问题：

    如图1所示，发现SDK的某些功能或手机的不能用：直接打开uiautomator 的应用程序（INIT 成功后，就会安装上的），点击关闭UIAutomator  或者d.service （“uiautomator” ）.stop （） 

    2502错误：

控制台：adb shell am instrument -w -r -e debug false -e class com.github.uiautomator.stub.Stub \
  com.github.uiautomator.test / android.support.test.runner.AndroidJUnitRunner  

     如果运行正常，启动测试之前增加一行代码 d.healthcheck（）

   如果报错，可能是缺少某个设备组件没有安装，使用下面的命令重新初始化python -m uiautomator2 init --reinstall 

 手机python -m uiautomator2 init 之后，浏览器输入<device_ip ：7912> ，会发现一个远程控制功能，延迟非常低噢。