1、UiDevice代表设备状态。如屏幕的大小、旋转方向、按压各种按键等。
2、UiDevice为单例模式,可有2种方式获取其实例。
(1)UiDevice.getInstance();--->推荐
(2)getUiDevice.pressHome();---->在类A中封装方法,方法被类B调用的时候会出现空指针异常
(1)获取设备信息:屏幕分辨率、选装状态、亮灭屏......
(2)操作:按键、坐标操作、滑动、拖拽、截图......
(3)监听器功能
二、按键与KEYCODE使用
1、点击按键 相关API
UiDevice实例调用以下方法即可实现点击按键操作。
返回值 | 方法名 | 描述 |
boolean | pressBack() | 模拟短按返回back键 |
boolean | pressDPadCenter() | 模拟按轨迹球中点按键 |
boolean | pressDPadDown() | 模拟轨迹球向下按键 |
boolean | pressDPadLeft() | 模拟轨迹球向左按键 |
boolean | pressDPadRight() | 模拟轨迹球向右按键 |
boolean | pressDPadUp() | 模拟轨迹球向上按键 |
boolean | pressDelete() | 模拟短按删除delete按键 |
boolean | pressEnter() | 模拟短按回车键 |
boolean | pressHome() | 模拟短按HOME键 |
boolean | pressKeyCode(int keyCode, int metaState) | 模拟短按键盘代码keycode |
boolean | pressKeyCode(int keyCode) | 模拟短按键盘代码keycode |
boolean | pressMenu() | 模拟短按menu键 |
boolean | pressRecentApps() | 模拟短按最近使用程序 |
boolean | pressSearch() | 模拟短按搜索键 |
2、KEYCODE 键盘映射码
(1)KeyEvent:按键事件,每个键盘映射码都保存在keyEvent的常量中。(2)META Key
<1>辅助功能键: ALT、SHIFT、CAPS_LOCK
<2>辅助功能键的状态
激活状态 | metaState | |
base | META_key未被激活 | 0 |
caps | SHIFT或CAPS_LOCK被激活时 | 1 |
fn | ALT被激活 | 2 |
caps_fn | ALT,SHIFT或CAPS_LOCK同时被激活时 | 3 |
<3>示例
UiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_A);//点击输入小写字母aUiDevice.getInstance().pressKeyCode(KeyEvent.KEYCODE_A,1);//点击输入大写字母A
三、获取坐标与坐标点击
1、坐标相关知识
(1)手机屏幕坐标:从左上角(0,0)开始到右下角(X,Y)(2)dp:设备独立像素,例如,320像素显示到640像素上要拉伸一倍
(3)Point:代表一个点(x,y)
2、坐标相关API
UiDevice实例调用以下方法即可实现获取坐标和点击操作。返回值 | 方法名 | 描述 |
boolean | click(int x, int y) | 使用坐标点击屏幕 |
int | getDisplayHeight() | 获取屏幕高度 |
Point | getDisplaySizeDp() | 获取显示尺寸返回显示大小(设备独立像素);屏幕旋转返回的显示大小调整 |
int | getDisplayWidth() | 获得屏幕宽度 |
3、Uiautomator Viewer
(1)功能:获取屏幕快照,并通过快照获取到控件的属性。(2)启用方式
方式一、启动路径:adt/sdk/tools/UiautomatorViewer
方式二、Eclipse/DDMS/Devices/UiautomatorViewer
通过UiautomatorViewer获取屏幕快照,选中目标控件,通过Node Detail / bounds[左上角顶点坐标][右下角顶点坐标] 可获取到控件的位置。
4、示例
(1)
UiDevice.getInstance().click(399,355);//点击[399,355]坐标点
(2)int h = UiDevice.getInstance().getDisplayHeight();
int w = UiDevice.getInstance().getDisplayWidth();
UiDevice.getInstance().click(w/2,h/2); //点击屏幕的中心点
(3)
UiObject object = new UiObject(new UiSelector.resoutceId("com.andr....控件Id"));//根据ID获取控件
Rect r = object.getBounds();//获取控件对应的矩形区域相关属性r.left; //矩形左上角顶点X坐标
r.top; //矩形左上角顶点Y坐标
r.right; //矩形右下角顶点X坐标
r.bottom; //矩形右下角顶点Y坐标
r.centerX(); //矩形的中心点X坐标
r.centerY(); //矩形的中心点Y坐标
四、拖拽与滑动
1、相关概念
(1)拖拽:将一个组件从一个坐标移动到另一个坐标处。
(2)滑动:手指从一个坐标点移动到另一个坐标点。
(3)步长:从一点滑动到另一点使用的时间,步长越短说明移动越快。
2、拖拽与滑动相关API
返回值 | 方法名 | 描述 |
boolean | drag(int startX, int startY, int endX, int endY, int steps) | 拖动对象从一个坐标拖动到另一个坐标,step表示拖拽过程使用的时间(ms) |
boolean | swipe(Point[] segments, int segmentSteps) | 在点阵列中滑动,5ms一步 |
boolean | swipe(int startX, int startY, int endX, int endY, int steps) | 通过坐标滑动屏幕 |
3、示例:按照一个矩形的路径滑动
Point p1 = new Point();
Point p2 = new Point();
Point p3 = new Point();
Point p4 = new Point();
p1.x =277;
p1.y =318;
...... //设置四个顶点的横纵坐标
Point[] pp = {p1,p2,p3,p4};
UiDevice.getInstance().swipe(pp,50); //每50毫秒走一步(从一个点滑动到下一个点)
五、旋转屏幕
1 、旋转屏幕相关知识
(1)旋转方向:4个方向,分别为 0度,90度,180度,270度
(2)重力感应器
(3)固定位置与物理旋转
固定位置:屏幕的方向固定在0、90、180、270度;
物理旋转:与重力感应器连接,关闭了物理旋转就是关闭了重力感应器。
2、屏幕旋转相关API
返回值 | 方法名 | 描述 |
void | setOrientationLeft() | 通过禁用传感器,然后模拟设备向左转,并且固定位置 |
void | setOrientationNatural() | 通过禁用传感器,然后模拟设备转到其自然默认的方向,并且固定位置 |
void | setOrientationRight() | 通过禁用传感器,然后模拟设备向右转,并且固定位置 |
void | unfreezeRotation() | 重新启用传感器和允许物理旋转 |
boolean | isNaturalOrientation() | 检测设置是否处于默认旋转状态 |
int | getDisplayRotation() | 返回当前的显示旋转,0度,90度,180度,270度值分别为:0(Surface.ROTATION_0)、1(Surface.ROTATION_90)、2(类推)、3(类推) |
void | freezeRotation() | 禁用传感器和冻结装置物理旋转在其当前旋转状态 |
六、灭屏与唤醒
灭屏与唤醒相关API
返回值 | 方法名 | 描述 |
void | wakeUp() | 模拟按电源键,如果屏幕是唤醒的没有任何作用 |
void | sleep() | 模拟按电源键,如果屏幕已经是关闭的则没有任何作用 |
boolean | isScreenOn() | 检查屏幕是否亮屏 |
七、截图与等待空闲
(1)图片缩放比例:如缩小1/2,即将100*100px的图片长宽都缩小为原来的1/2,50*50px。
(2)图片质量:一般是指图片的大小,质量越高图片越大。
(3)File 类:文件或者文件夹。
(4)图片格式 :截图的格式都是PNG。
(5)空闲状态:窗口没有更新或界面无动作。
(6)窗口更新事件。
2、截图相关API
返回值 | 方法名 | 描述 |
boolean | takeScreenshot(File storePath) | 把当前窗口截图并将其存储为png默认1.0f的规模(原尺寸)和90%质量,参数为file类的文件路径。 |
boolean | takeScreenshot(File storePath, float scale, int quality) | 把当前窗口截图为png格式图片,可以自定义缩放比例与图片质量。 |
storePath:存储路径,必须为png格式。
scale:缩放比例,1.0为原图。
quality:图片压缩质量,范围为0-100。
3、等待空闲相关API
返回值 | 方法名 | 描述 |
void | waitForIdle(long timeout) | 自定义超时等待当前应用处于空闲状态 |
void | waitForIdle() | 等待当前应用处于空闲状态,默认等待10s;即10s后还不处于空闲状态则报错,程序在该句代码处中断;10s内程序处于空闲状态,则该句代码执行完毕。 |
boolean | waitForWindowUpdate(String packageName, long timeout) | 等待窗口内容更新事件的发生 |
八、获取包名&开启通知栏&快速设置&获取布局文件
包名:应用的唯一标识。
通知栏:从手机顶部下滑,出现的下拉界面即通知栏。
快速设置:即通知栏中的快速设置控件,快速设置界面可设置网络、屏幕亮度、飞行模式等。
2、相关API
返回值 | 方法名 | 描述 |
void | getCurrentPackageName() | 获取当前界面的包名,即目前处于手机前台的应用的包名 |
void | dumpWindowHierarchy(String fileName) | 获取当前界面的布局文件,fileName给布局文件命名如“layout.xml”,保存在/data/local/tmp/目录下 |
boolean | openNotification() | 打开通知栏 |
boolean | openQuickSettings() | 打开快速设置 |