电脑连接真机时，需要开启手机的USB调试模式，开启方式不同的产品型号各不相同，可以百度对应型号的手机查看操作步骤。

1. 点击功能键

（1）控件功能

该控件用于点击手机下方导航栏中的功能键

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
Driver	输入	是	连接手机组件返回的手机对象	无
功能键	输入	是	选择列表中的一项	主页

2. 点击屏幕

（1）控件功能

用于点击屏幕上的某个点。

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
Driver	输入	是	连接手机组件返回的手机对象	无
横坐标	输入	是	要点击的点的x坐标
是否长按	输入	是		否
纵坐标	输入	是	要点击的点的Y坐标

3. 关闭手机APP

（1）控件功能

关闭指定的手机APP。

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
Driver	输入	是	连接手机组件返回的手机对象	无
APP包名	输入	是	要关闭的APP包名(获取方式见常见问题解答)

4. 断开手机

（1）控件功能

断开手机连接。

5. 连接手机

（1）控件功能

连接手机，并返回手机的对象。

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
版本号	输入	否	Android系统版本	空
名称	输入	否	设备名称	空
设备实例	输出	是	连接的手机对象
操作超时时间(ms)	输入	是	连接超时时间	3000
服务端口号	输入	是	连接手机的后台服务的端口号	4723
驱动版本	输入	是	自动化驱动的版本	uiautomator2
设备标记	输入	是	用来标记该设备	自动生成

6. 元素截图

（1）控件功能

将指定的元素截图保存在本地。

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
截图保存路径	输入	是	截图的保存路径
元素	输入	是	查找元素组件返回的结果

7. 元素点击

（1）控件功能

点击指定的元素。

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
是否长按	输入	是
元素	输入	是	查找元素组件返回的结果

8. 元素输入

（1）控件功能

在指定的元素中输入内容

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
是否追加	输入	是		否
元素	输入	是	查找元素组件返回的结果
输入内容	输入	是	待输入的内容

9. 元素位置

（1）控件功能

获取指定元素在屏幕中的坐标位置

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
高度	输入	是	元素的高度	否
宽度	输入	是	元素的宽度
左上角坐标X	输入	是
左上角坐标Y	输入	是
元素	输入	是	查找元素组件返回的结果

10. 元素滑动

（1）控件功能

滑动指定的元素

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
Driver	输入	是	手机对象	否
滑动方向	输入	是
停留时间	输入	是	滑动之后的停留时间
元素	输入	是	查找元素组件返回的结果

11. 获取元素文本

（1）控件功能

获取指定元素的文本内容

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
文本内容	输出	是	手机对象	否
元素	输入	是	查找元素组件返回的结果

12. 查找元素

（1）控件功能

根据指定的元素选择器查找界面UI元素

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
class	输入	否	class选择器
resource-id	输入	否
xpath	输入	否	以上3个属性，填写其中一个即可
元素结果	输出	是	查找结果
driver	输入	是	连接手机返回的手机对象

13. 查找元素(多个)

（1）控件功能

根据指定的元素选择器查找界面UI元素

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
class	输入	否	class选择器
resource-id	输入	否
xpath	输入	否	以上3个属性，填写其中一个即可
元素结果	输出	是	查找结果(数组)
driver	输入	是	连接手机返回的手机对象

14. 获取手机文件

（1）控件功能

获取手机中指定位置的文件并保存到本地

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
本地文件	输入	是	在本地保存的路径
手机中存储位置	输入	是	手机中文件的存储路径
driver	输入	是	连接手机返回的手机对象

15. 获取图像位置

（1）控件功能

获取指定的图像在屏幕中的位置

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
高度	输出	否	图像的高度
宽度	输出	否	图像的宽度
左上角坐标X	输出	否	元素的左上角的坐标
左上角坐标Y	输出	否
Driver	输入	是	连接手机返回的手机对象
图片位置	输入	是	要查找的图片的保存路径

16. 锁定屏幕

（1）控件功能

手机锁屏

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
Driver	输入	是	连接手机返回的手机对象

17. 打开手机APP

（1）控件功能

打开指定的手机APP

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
APP包名	输入	是
APP启动的Activity	输入	是
Driver	输入	是	连接手机返回的手机对象
是否关闭已打开的APP	输入	是		否

18. 屏幕截图

（1）控件功能

对手机屏幕进行截图并保存到本地

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
Driver	输入	是	连接手机返回的手机对象
截图保存路径	输入	是

19. 发送文件到手机

（1）控件功能

将电脑上的文件发送到手机的指定目录

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
本地文件	输入	是	在本地保存的路径
手机中存储位置	输入	是	手机中文件的存储路径
driver	输入	是	连接手机返回的手机对象

20. 滑动手机屏幕

（1）控件功能

按照指定的配置信息滑动屏幕

（2）属性列表

参数名称	参数方向	是否必填	说明	默认值
结束点X	输入	否	滑动的终点的X坐标
结束点Y	输入	否	滑动的终点的Y坐标
起始点X	输入	否	滑动的起点的X坐标
起始点Y	输入	否	滑动的起点的Y坐标
driver	输入	是	连接手机返回的手机对象
滑动方向	输入	是	滑动的方向，当设置了滑动的起点和结束点时，则无效
停留时间	输入	是	滑动结束时的停留时间