官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

Airtest ·

跨平台的UI自动化框架，适用于游戏和App

快速开始

• 各种运行： Airtest提供了跨平台的API，包括安装应用、模拟输入、断言等。 基于图像识别技术定位UI元素，你无需嵌入任何代码即可进行自动化。

• 扩展性： Airtest提供了命令行和python接口，可以很容易地在大规模设备集群上运行。自动生成的HTML报告，包含详细步骤和录屏，让你迅速定位失败点。

• AirtestIDE： 是一个强大的GUI工具，可以帮助你录制和调试自动化脚本。 AirtestIDE支持了完整的自动化流程：录制脚本->真机回放->生成报告。

• Poco： Poco 框架可以直接访问UI控件，支持主流平台和游戏引擎。通过Python API操作UI控件，可以实现更强大的自动化控制。

从官网开始上手吧

跨平台支持

安装

使用 pip 安装Airtest框架

pip install -U airtest

在Mac/Linux系统下，需要手动赋予adb可执行权限

# mac系统
cd {your_python_path}/site-packages/airtest/core/android/static/adb/mac
# linux系统
# cd {your_python_path}/site-packages/airtest/core/android/static/adb/linux
chmod +x adb

如果你需要使用GUI工具，请从 官网 下载AirtestIDE。

文档

完整的Airtest文档请看 readthedocs。

例子

Airtest希望提供平台无关的API，让你的自动化代码可以运行在不同平台的应用上。

1. 使用 connect_device 来连接任意Android设备或者Windows窗口。
2. 使用 模拟操作 的API来自动化你的游戏或者App。
3. 不要 忘记 声明断言 来验证结果。

from airtest.core.api import *

# 通过ADB连接本地Android设备
init_device("Android")
# 或者使用connect_device函数
# connect_device("Android:///")
connect_device("Android:///")
install("path/to/your/apk")
start_app("package_name_of_your_apk")
touch(Template("image_of_a_button.png"))
swipe(Template("slide_start.png"), Template("slide_end.png"))
assert_exists(Template("success.png"))
keyevent("BACK")
home()
uninstall("package_name_of_your_apk")

更详细的说明请看 Airtest Python API 文档 或者直接看 API代码 。

用命令行运行 .air 脚本

使用AirtestIDE你可以非常轻松地录制一个自动化脚本并保存为 .air 目录结构。 Airtest命令行则让你能够脱离IDE，在不同宿主机器和被测设备上运行自动化脚本。

# 在本地ADB连接的安卓手机上运行脚本
airtest run "path to your air dir" --device Android:///

# 在Windows应用上运行脚本
airtest run "path to your air dir" --device "Windows:///?title_re=Unity.*"

# 生成HTML报告
airtest report "path to your air dir"

# 也可以用python -m的方式使用命令行
python -m airtest run "path to your air dir" --device Android:///

试试样例airtest/playground/test_blackjack.air，更多用法看命令行用法。

贡献代码

欢迎大家fork和提pull requests。

致谢

感谢以下仓库让Airtest变得更好：

• stf
• atx
• pywinauto

关于我们

访问我们的官网获得更多信息，同时欢迎大家扫描下方二维码关注我们的微信公众号：AirtestProject