UI Test Automation Framework for Games and Apps
跨平台的UI自动化测试框架，适用于游戏和App （中文版点这里）
Airtest is a cross-platform automated testing framework with main focus on games, which can also be used for native apps. Currently, Windows and Android are well supported. Support for iOS comes in near future.
Airtest provides cross-platform APIs, including app installation, simulated input, assertion and so forth. Airtest uses image recognition technology to locate UI elements, so that you can automate test on games without injecting any code. After running the test, an HTML report will be generated automatically, that allows you to quickly locate failed test points.
AirtestIDE is an out of the box GUI tool that helps to create and
record test cases in the user-friendly way. AirtestIDE provides QA with
a complate production workflow: record -> replay -> report
Get Started from Airtest Project Homepage
Use pip to install Airtest python library.
pip install airtestDownload AirtestIDE from our homepage if you need to use the GUI tool.
You can find the complete airtest documentation on readthedocs.
Airtest aims at providing platform independent api, so that you can write test once and run test on different devices.
- Using connect_device API you can connect to any android device or windows application.
- Then perform simulated input to test your game or app.
- And do not forget to make assertions of the expected test result.
from airtest.core.api import *
# connect an android phone with adb
connect_device("Android:///")
install("path/to/your/apk")
start_app("package_name_of_your_apk")
touch("image_of_a_button.png")
swipe("slide_start.png", "slide_end.png")
assert_exists("success.png")
keyevent("BACK")
home()
uninstall("package_name_of_your_apk")For more detailed info, please refer to Airtest Python API reference or take a look at API code
Using AirtestIDE, you can easily create and author automated tests as .air directories.
Airtest CLI provides the possibility to execute tests on different host machine and target device platforms without using AirtestIDE itself.
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.*Try running provided test case: airtest/playground/test_blackjack.air and see Usage of CLI.
Pull requests are very welcome.
Thanks for all these great works that make this project better.