facebook/WebDriverAgentArchived
WebDriverAgent
WebDriverAgent is an on-device control agent and automation server that implements the WebDriver protocol for iOS devices. It serves as a bridge that enables the remote control of applications and the operating system on physical iOS devices and simulators for automated testing.
The project provides a UI testing framework capable of interacting with on-screen elements, capturing screenshots, and simulating user gestures. It translates remote commands into native system calls to interact with the iOS accessibility hierarchy.
The server covers a broad range of device orchestration and UI automation capabilities, including application lifecycle management, device orientation control, and home screen navigation. It also handles system-level tasks such as biometric authentication simulation, system alert handling, and element property querying.
Connectivity is established through a REST server running on the target device, supporting communication via USB tunnelling or wireless connections.
Features
- WebDriver-Based Automation Servers - Implements a WebDriver server on iOS devices to enable remote control of applications and the operating system for automated testing.
- iOS Device Management - Provides low-level control over application lifecycles and UI interactions on physical iOS devices.
- XCUITest Integration Mappings - Translates WebDriver commands into native Apple XCUITest calls to interact with the iOS accessibility hierarchy.
- Accessibility-Tree Addressing - Locates UI components by querying the system accessibility tree to enable robust interaction during automation.
- iOS UI Automation Frameworks - Provides a framework for running automated UI tests on iOS apps with native synchronization.
- WebDriver Protocol Implementations - Implements the W3C WebDriver standard to enable remote command execution on iOS devices.
- iOS - Provides an automated test execution framework specifically designed for iOS simulators and physical devices.
- UI Element Interactions - Executes native user actions such as clicking, typing, and scrolling on specific iOS interface elements.
- UI Element Locators - Implements diverse search strategies including class names and property chains to locate elements within the iOS accessibility hierarchy.
- Mobile Device Management and Utilities - Manages the lifecycle of iOS applications and system states across physical devices and simulators.
- Application Lifecycle Managers - Manages the startup and state of specific iOS applications using bundle identifiers.
- Display Screenshot Capture - Retrieves screenshots of the current device display for visual verification of the mobile interface.
- iOS USB Communication - Enables routing of remote control commands to iOS devices over a wired USB connection.
- USB-Tunnelling Device Control - Routes network traffic from a host machine to the on-device server through a wired USB physical connection.
- WebDriver Protocol Mappings - Maps standardized WebDriver request payloads to internal method calls for managing device state and application lifecycles.
- Session Lifecycle Management - Coordinates the lifecycle of remote sessions to manage device control and application states.
- Authentication Simulations - Allows simulating successful or failed biometric authentication attempts to verify application login and security flows.
- REST-Based Command Dispatch - Provides a REST-based command interface on the device to receive and dispatch remote control instructions.
- System Alert Handlers - Detects and automatically handles iOS system-level alerts to prevent test execution interruptions.
- Screenshot Buffers - Captures the current display frame buffer and encodes it as an image for remote visual verification.
- Visual Layout Verification - Ensures consistent visual layouts across different orientations by capturing screenshots and querying element properties.
- Element Property Inspection - Retrieves computed attributes of UI elements, including size, screen location, and visibility, for test verification.
- Inspectors - Listed in the “Inspectors” section of the Awesome Appium awesome list.
