Skip to content

Latest commit

 

History

History
114 lines (68 loc) · 3.39 KB

README_zh.rst

File metadata and controls

114 lines (68 loc) · 3.39 KB
Raw

Airtest

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

demo.gif

快速开始

Airtest是一个跨平台的UI自动化测试框架，适用于游戏和App。目前支持Windows和Android平台，iOS支持正在开发中。

Airtest提供了跨平台的API，包括安装应用、模拟输入、断言等。 基于图像识别技术定位UI元素，你无需嵌入任何代码即可进行自动化测试。 测试脚本运行后可以自动生成详细的HTML测试报告，让你迅速定位失败的测试点。

AirtestIDE 是一个强大的GUI工具，可以帮助你录制和调试测试脚本。 AirtestIDE给QA人员提供了完整的工作流程支持：录制脚本->真机回放->生成报告

从官网开始上手吧

安装

使用 pip 安装Airtest框架.

pip install airtest

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

文档

完整的Airtest框架文档请看 readthedocs。

例子

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

  1. 使用 connect_device 来连接任意Android设备或者Windows窗口。
  2. 使用 模拟操作 的API来测试你的游戏或者App。
  3. 千万 不要 忘记 声明断言 来验证测试结果。
from airtest.core.api import *

# 通过ADB连接本地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，在不同宿主机器和被测设备上运行测试脚本。

python -m airtest run <path to your air dir> --device Android:///
python -m airtest run <path to your air dir> --device Windows:///?title_re=Unity.*

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

贡献代码

欢迎大家fork和提pull requests。

致谢

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