openatx/uiautomator2
Uiautomator2
uiautomator2 is an Android device automation tool and UI testing library. It functions as a framework for automating user interface interactions and managing device states via a remote client.
The project provides a remote management interface for controlling Android applications, simulating user gestures, and managing system settings. It enables the analysis of XML UI hierarchies to locate interface elements and verify application behavior.
The tool covers broad capability areas including application lifecycle management, device connectivity, and file system operations. It also includes system interface controls for the clipboard and notification panels, as well as display management for orientation and screen captures.
The framework utilizes a client-server agent architecture and HTTP-based remote procedure calls to execute commands on target devices.
Features
- Android Automation Frameworks - Implements a full framework for automating user interactions and interface responses on Android devices.
- Android Remote Control Interfaces - Provides a comprehensive interface for remote Android device interaction and system-level operation execution.
- UI Hierarchy Parsing - Parses the Android screen structure into an XML tree to identify and locate interface elements.
- Hierarchy Analysis - Exports the current screen structure to XML format to identify and analyze the arrangement of interface elements.
- Android Application Management - Provides control over Android system settings, application management, and filesystem access.
- UI Testing Libraries - Provides a comprehensive library for locating interface elements and verifying application behavior on Android.
- Android Instrumentation - Utilizes the native Android instrumentation framework to inject events and inspect application state.
- Android UI Testing - Verifies application behavior on Android devices by simulating user inputs and inspecting the UI hierarchy.
- UI Element Selectors - Finds specific interface objects using selectors or path queries to target them for automated actions.
- Coordinate-Based Interactions - Translates high-level interaction requests into raw X and Y screen coordinates for precise touch injection.
- Mobile End-to-End Testing - Executes end-to-end test scripts that interact with the Android OS and third party apps.
- UI Element Interactions - Performs direct actions on specific interface objects, including clicking, dragging, pinching, and scrolling.
- Application Lifecycle Management - Provides utilities for managing the installation, startup, and shutdown of Android applications.
- Device File Transfers - Supports moving files between a host machine and a target Android device via push and pull operations.
- Display State Controllers - Manages screen power states, adjusts device orientation, and captures screenshots of the display.
- Key Sequence Simulators - Triggers hardware and software key presses to simulate user navigation or lock the screen.
- Text Input Managers - Manages text entry into input fields via the system keyboard and provides capabilities to clear content.
