UIAutomator的API:

11.UiDevice

access and perform operations on the device on which the target app is running. You can call its methods to access device properties such as current orientation or display size. The UiDevice class also let you perform actions such as:

• Change the device rotation
• Press a D-pad button
• Press the Back, Home, or Menu buttons
• Open the notification shade
• Take a screenshot of the current window

For example, to simulate a Home button press, call the UiDevice.pressHome() method.

 

 

UI Automator APIs

The UI Automator APIs allow you to write robust tests without needing to know about the implementation details of the app that you are targeting. You can use these APIs to capture and manipulate UI components across multiple apps:

• UiCollection: Enumerates a container's UI elements for the purpose of counting, or targeting sub-elements by their visible text or content-description property.
• UiObject: Represents a UI element that is visible on the device.
• UiScrollable: Provides support for searching for items in a scrollable UI container.
• UiSelector: Represents a query for one or more target UI elements on a device.
• Configurator: Allows you to set key parameters for running UI Automator tests.

For example, the following code shows how you can write a test script that brings up the default app launcher in the device:

// Initialize UiDevice instance
mDevice =UiDevice.getInstance(getInstrumentation());

// Perform a short press on the HOME button
mDevice().pressHome();

// Bring up the default launcher by searching for
// a UI component that matches the content-description for the launcher button
UiObject allAppsButton = mDevice
        .findObject(newUiSelector().description("Apps"));

// Perform a click on the button to bring up the launcher
allAppsButton.clickAndWaitForNewWindow();

To learn more about using UI Automator, see the API reference and Testing UI for Multiple Apps training.