Android UiAutomator UiDevice API-CSDN博客

UiDevice为单例模式

1.获取设备

`static UiDevice`	`getInstance()` This method is deprecated. Should use `getInstance(Instrumentation)` instead. This version hides UiDevice's dependency on having an Instrumentation reference and is prone to misuse.
`static UiDevice`	`getInstance(Instrumentation instrumentation)` Retrieves a singleton instance of UiDevice

2.按键与keycode

`boolean`	`pressBack()` Simulates a short press on the BACK button.
`boolean`	`pressDPadCenter()` Simulates a short press on the CENTER button.
`boolean`	`pressDPadDown()` Simulates a short press on the DOWN button.
`boolean`	`pressDPadLeft()` Simulates a short press on the LEFT button.
`boolean`	`pressDPadRight()` Simulates a short press on the RIGHT button.
`boolean`	`pressDPadUp()` Simulates a short press on the UP button.
`boolean`	`pressDelete()` Simulates a short press on the DELETE key.
`boolean`	`pressEnter()` Simulates a short press on the ENTER key.
`boolean`	`pressHome()` Simulates a short press on the HOME button.
`boolean`	`pressKeyCode(int keyCode)` Simulates a short press using a key code.
`boolean`	`pressKeyCode(int keyCode, int metaState)` Simulates a short press using a key code.
`boolean`	`pressMenu()` Simulates a short press on the MENU button.
`boolean`	`pressRecentApps()` Simulates a short press on the Recent Apps button.
`boolean`	`pressSearch()` Simulates a short press on the SEARCH button.

注意：

例子：

UiDevice.getInstance(Instrumentation instrumentation).pressKeyCode(keyEvent.KEYCODE_A);//输入a

UiDevice.getInstance(Instrumentation instrumentation).pressKeyCode(keyEvent.KEYCODE_A,1);//输入A

Android KEYCODE键值对应大全： http://blog.csdn.net/u012839224/article/details/37764193

3.获取坐标与坐标点击

boolean

click(int x, int y)

Perform a click at arbitrary coordinates specified by the user

int

getDisplayHeight()

Gets the height of the display, in pixels.

int

getDisplayWidth()

Gets the width of the display, in pixels.

另可通过UiObject来获取该对象的坐标

Rect z = UiObject.getBounds();

int x0 = z.left;

int y0 = z.top;

int x1 = z.right;

int y1 = z.bottom;

4.拖拽与滑动

boolean

drag(int startX, int startY, int endX, int endY, int steps)

Performs a swipe from one coordinate to another coordinate.

`boolean`	`swipe(int startX, int startY, int endX, int endY, int steps)` Performs a swipe from one coordinate to another using the number of steps to determine smoothness and speed.
`boolean`	`swipe(Point[] segments, int segmentSteps)` Performs a swipe between points in the Point array.

Steps 越大，拖拽/滑动速度越慢

steps int: is the number of move steps sent to the system

Each step execution is throttled to 5ms per step. So for a 100 steps, the swipe will take about 1/2 second to complete.

5.旋转屏幕

`void`	`setOrientationLeft()` Simulates orienting the device to the left and also freezes rotation by disabling the sensors.
`void`	`setOrientationNatural()` Simulates orienting the device into its natural orientation and also freezes rotation by disabling the sensors.
`void`	`setOrientationRight()` Simulates orienting the device to the right and also freezes rotation by disabling the sensors.

void

freezeRotation()

Disables the sensors and freezes the device rotation at its current rotation state.

void

unfreezeRotation()

Re-enables the sensors and un-freezes the device rotation allowing its contents to rotate with the device physical rotation.

boolean

isNaturalOrientation()

Check if the device is in its natural orientation.

int

getDisplayRotation()

Returns the current rotation of the display, as defined in Surface

Surface

`int`	`ROTATION_0` Rotation constant: 0 degree rotation (natural orientation)
`int`	`ROTATION_180` Rotation constant: 180 degree rotation.
`int`	`ROTATION_270` Rotation constant: 270 degree rotation.
`int`	`ROTATION_90` Rotation constant: 90 degree rotation.

6.灭屏与唤醒屏幕

void

wakeUp()

This method simulates pressing the power button if the screen is OFF else it does nothing if the screen is already ON.

void

sleep()

This method simply presses the power button if the screen is ON else it does nothing if the screen is already OFF.

boolean

isScreenOn()

Checks the power manager if the screen is ON.

模拟点击电源键，手机灭屏与亮屏

7.截图

`boolean`	`takeScreenshot(File storePath, float scale, int quality)` Take a screenshot of current window and store it as PNG The screenshot is adjusted per screen rotation
`boolean`	`takeScreenshot(File storePath)` Take a screenshot of current window and store it as PNG Default scale of 1.0f (original size) and 90% quality is used The screenshot is adjusted per screen rotation

storePath: 存储路径，文件后缀必须为.png

scale: 1.0f 为原图大小

quality: 质量压缩，取值范围为0-100

8.等待空闲

`void`	`waitForIdle(long timeout)` Waits for the current application to idle.
`void`	`waitForIdle()` Waits for the current application to idle. //默认10s
`boolean`	`waitForWindowUpdate(String packageName, long timeout)` Waits for a window content update event to occur.

9.包名

获取当前界面包名

String

getCurrentPackageName()

Retrieves the name of the last package to report accessibility events.

获取当前页面的布局文件，保存到/data/local/tmp/下

`void`	`dumpWindowHierarchy(File dest)` Dump the current window hierarchy to a `File`.
`void`	`dumpWindowHierarchy(OutputStream out)` Dump the current window hierarchy to an `OutputStream`.