欢迎使用 HA4T 文档!
HA4T (Hybrid App For Testing Tool) 是一个跨平台的 UI 自动化测试框架，支持 Android、iOS 和 HarmonyOS NEXT，同时擅长处理混合型 App 中的 WebView。它提供面向对象的简洁 API，让您能够快速编写并执行自动化测试脚本。
主要特性:
跨平台支持：Android、iOS、HarmonyOS NEXT 以及 WebView
多种定位方式：OCR 文字识别、图像/模板匹配、原生控件属性、XPath、WebView(CDP) 定位
面向对象 API：
connect()返回Device实例，统一封装点击、滑动、输入、断言等操作内置 OCR 文字识别（飞桨 PaddleOCR，懒加载）
多设备并行：每个
Device持有独立配置，天然支持多线程并行测试用例步骤复用：
include()在同一进程内复用其他用例文件丰富的辅助功能：截图、文件传输、日志记录等
快速开始
安装 HA4T:
pip install ha4t
核心 API
设备驱动
- ha4t.drivers package
- Submodules
- Module contents
BaseDriverBaseDriver.connect()BaseDriver.get_device_info()BaseDriver.screen_size()BaseDriver.screenshot()BaseDriver.tap()BaseDriver.swipe()BaseDriver.press()BaseDriver.find()BaseDriver.find_xpath()BaseDriver.app_start()BaseDriver.app_stop()BaseDriver.app_current()BaseDriver.app_clear()BaseDriver.push_file()BaseDriver.pull_file()BaseDriver.delete_file()
AndroidDriverAndroidDriver.connect()AndroidDriver.get_device_info()AndroidDriver.screen_size()AndroidDriver.screenshot()AndroidDriver.tap()AndroidDriver.swipe()AndroidDriver.press()AndroidDriver.find()AndroidDriver.find_xpath()AndroidDriver.get_element_center()AndroidDriver.app_start()AndroidDriver.app_stop()AndroidDriver.app_current()AndroidDriver.app_clear()AndroidDriver.push_file()AndroidDriver.pull_file()AndroidDriver.delete_file()AndroidDriver.adb_device
IOSDriverIOSDriver.connect()IOSDriver.get_device_info()IOSDriver.screen_size()IOSDriver.screenshot()IOSDriver.tap()IOSDriver.swipe()IOSDriver.press()IOSDriver.find()IOSDriver.find_xpath()IOSDriver.get_element_center()IOSDriver.app_start()IOSDriver.app_stop()IOSDriver.app_current()IOSDriver.push_file()IOSDriver.pull_file()IOSDriver.delete_file()IOSDriver.mkdir()
HarmonyDriverHarmonyDriver.connect()HarmonyDriver.get_device_info()HarmonyDriver.screen_size()HarmonyDriver.screenshot()HarmonyDriver.tap()HarmonyDriver.swipe()HarmonyDriver.press()HarmonyDriver.find()HarmonyDriver.find_xpath()HarmonyDriver.get_element_center()HarmonyDriver.app_start()HarmonyDriver.app_stop()HarmonyDriver.app_current()
Webview 操作
所有模块