facebook/WebDriverAgentArchived
WebDriverAgent
WebDriverAgent 是一个设备端控制代理和自动化服务器，为 iOS 设备实现了 WebDriver 协议。它作为一个桥梁，能够远程控制物理 iOS 设备和模拟器上的应用程序及操作系统，以进行自动化测试。
该项目提供了一个 UI 测试框架，能够与屏幕元素交互、捕获屏幕截图并模拟用户手势。它将远程命令转换为原生系统调用，以与 iOS 辅助功能层次结构进行交互。
该服务器涵盖了广泛的设备编排和 UI 自动化功能，包括应用程序生命周期管理、设备方向控制和主屏幕导航。它还处理系统级任务，如生物识别身份验证模拟、系统警报处理和元素属性查询。
连接通过在目标设备上运行的 REST 服务器建立，支持通过 USB 隧道或无线连接进行通信。
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.
