UI Automation Framework for Games and Apps

License: Apache-2.0

Language: Python

Keywords: android, automated-testing, automation, game, ios, test-automation, test-framework, unity3d, windows

Airtest · Build status

Cross-Platform UI Automation Framework for Games and Apps




  • Write Once, Run Anywhere: 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 games and apps without injecting any code.

  • Fully Scalable: Airtest cases can be easily run on large device farms, using commandline or python API. HTML reports with detailed info and screen recording allow you to quickly locate failure points. NetEase builds Airlab on top of the Airtest Project.

  • AirtestIDE: AirtestIDE is an out of the box GUI tool that helps to create and run cases in a user-friendly way. AirtestIDE supports a complete automation workflow: create -> run -> report.

  • Poco: Poco adds the ability to directly access object(UI widget) hierarchy across the major platforms and game engines. It allows writing instructions in Python, to achieve more advanced automation.

Get started from airtest homepage

Supported Platforms

Android Emulator iOS Windows Unity Cocos2dx Egret WeChat


Use pip to install the Airtest python library.

pip install -U airtest

On MacOS/Linux platform, you need to grant adb execute permission.

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

Download 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 automated cases once and run it on multiple devices and platforms.

  1. Using connect_device API you can connect to any android/iOS device or windows application.
  2. Then perform simulated input to automate your game or app.
  3. DO NOT forget to make assertions of the expected result.
from airtest.core.api import *

# connect an android phone with adb
# or use connect_device api
# connect_device("Android:///")

swipe(Template("slide_start.png"), Template("slide_end.png"))

For more detailed info, please refer to Airtest Python API reference or take a look at API code

Running .air cases from CLI

Using AirtestIDE, you can easily create automated cases as .air directories. Airtest CLI provides the possibility to execute cases on different host machines and target device platforms without using AirtestIDE itself.

# run cases targeting on Android phone connected to your host machine via ADB
airtest run "path to your .air dir" --device Android:///

# run cases targeting on Windows application whose title matches Unity.*
airtest run "path to your .air dir" --device "Windows:///?title_re=Unity.*"

# generate HTML report after running cases
airtest report "path to your .air dir"

# or use as a python module
python -m airtest run "path to your .air dir" --device Android:///

Try running provided example case: airtest/playground/test_blackjack.air and see Usage of CLI. Here is a multi-device runner sample.


Pull requests are very welcome. Help needed here


Thanks for all these great works that make this project better.

Project Statistics

Sourcerank 11
Repository Size 76.5 MB
Stars 3,995
Forks 682
Watchers 198
Open issues 187
Dependencies 10
Contributors 31
Tags 7
Last updated
Last pushed

Top Contributors See all

yimelia Era Chen rockywhisper zzldjkzxf dinghongyi Meteorix adolli suyuchen suyuchen Howarden34 Brant Xiong Felix Yan Q-QI. Christian Clauss TreHack vchen30 ycwpub lijiawei matthewdy jiangxu0603

Packages Referencing this Repo

UI Test Automation Framework for Games and Apps on Android/iOS/Windows/Linux
Latest release 1.1.4 - Updated - 4K stars

Recent Tags See all

v1.1.4 July 06, 2020
v1.1.3 January 21, 2020
v1.1.2 January 17, 2020
v1.1.1 September 29, 2019
v1.1.0 September 10, 2019
v1.0.27 April 23, 2019
v1.0.26 February 21, 2019

Interesting Forks See all

UI Test Automation Framework for Games and Apps
Python - Apache-2.0 - Updated - 1 stars
UI Test Automation Framework for Games and Apps
Python - Apache-2.0 - Updated - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2020-07-06 04:54:33 UTC

Login to resync this repository