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
13. 复杂屏幕操作
2.等待对象显示并点击，等待最多10s：
d(text="Settings").click(timeout=10)3.当10s内对象出现就点击，默认0s：
clicked = d(text='Skip').click_exists(timeout=10.0)4.点击并轮询对象直到消失，其中maxretry为最多点击次数，默认10；interval为轮询时间间隔，默认1：
d(text="Skip").click_gone(maxretry=10, interval=1.0)5.长按指定的对象，duration为按住时间，timeout为超时时间：
d(text="Settings").long_click(duration=10,timeout=10)6.拖动指定对象到x,y位置，0.5s完成：
d(text="Settings").drag_to(x, y, duration=0.5)7.拖动指定对象到另一个对象位置，0.5s内完成：
d(text="Settings").drag_to(text="Clock", duration=0.5)8.双指从(a,b)，(c,d)滑动(a1,b1)，(c1,d1)，步长100：
d().gesture((a,b)，(c,d), a1,b1)，(c1,d1)，steps=100)9.从屏幕外侧向中心滑动，percent为左右起始位置占两边的比例：
d().pinch_out(percent=33, steps=100)
10.从屏幕中心向外侧滑动，percent为左右起始位置占两边的比例：
d().pinch_out(percent=33, steps=100)11.等待对象：
d(text='相机').wait(10)
12.等待对象消失，最多等待10s：
d(text='相机').wait_gone(timeout=10)
13.滚动：
a.向上滚动：d(scrollable=True).scroll(steps=10)
b.向下滑动：d(scrollable=True).scroll.vert.backward()
c.水平向右滚动：d(scrollable=True).scroll.horiz.forward(steps=50)
d.水平向左滚动：d(scrollable=True).scroll.horiz.backward(steps=50)
e.水平滑动到最左边：d(scrollable=True).scroll.horiz.toBeginning(steps=100, max_swipes=1000)
f.水平滑动到最右边：d(scrollable=True).scroll.horiz.toEnd(steps=100, max_swipes=1000)
g.竖直滑动到结尾：d(scrollable=True).scroll.toEnd()
h.竖直滑动到开头：d(scrollable=True).scroll.toBeginning(steps=50)
i.滑动到指定位置（测试）：d(scrollable=True).scroll.to(text ='测试')
如果运行正常，启动测试之前增加一行代码d.healthcheck（）
如果报错，可能是缺少某个设备组件没有安装，使用下面的命令重新初始化python -m uiautomator2 init --reinstall
手机python -m uiautomator2 init 之后，浏览器输入<device_ip ：7912> ，会有一个远程控制功能