Airtest

AirTest ·

Marco de automatización de interfaz de usuario multiplataforma para juegos y aplicaciones

跨平台的 ui 自动化框架 ， 适用于游戏和 aplicación （中文版点这里）

Características

• Escriba una vez, ejecute en cualquier lugar: AirTest proporciona API multiplataforma, incluida la instalación de la aplicación, entrada simulada, afirmación, etc. AirTest utiliza la tecnología de reconocimiento de imágenes para localizar elementos de interfaz de usuario para que pueda automatizar juegos y aplicaciones sin inyectar ningún código.

• Totalmente escalable: las cajas de avión se pueden ejecutar fácilmente en granjas de dispositivos grandes, utilizando Commandline o Python API. Los informes HTML con información detallada y grabación de pantalla le permiten localizar rápidamente los puntos de falla. NetEase construye Airlab en la parte superior del proyecto AirTest.

• AirTestide: AirTestide es una herramienta de GUI fuera de la caja que ayuda a crear y ejecutar casos de manera fácil de usar. AirTestide admite un flujo de trabajo de automatización completo: create -> run -> report .

• POCO: POCO agrega la capacidad de acceder directamente a la jerarquía de objetos (widget de la interfaz de usuario) en las principales plataformas y motores de juego. Permite escribir instrucciones en Python, para lograr una automatización más avanzada.

Comience desde la página de inicio de AirTest

Plataformas compatibles

Instalación

Use pip para instalar la biblioteca AirTest Python.

pip install -U airtest

En la plataforma MacOS/Linux, debe otorgar el permiso de ejecución de ADB.

 # 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

Descargue AirTestide desde nuestra página de inicio si necesita usar la herramienta GUI.

Documentación

Puede encontrar la documentación completa de AirTest en ReadThedocs.

Ejemplos

AirTest tiene como objetivo proporcionar una API independiente de la plataforma para que pueda escribir casos automatizados una vez y ejecutarlo en múltiples dispositivos y plataformas.

1. Usando la API Connect_Device, puede conectarse a cualquier dispositivo Android/iOS o aplicación Windows.
2. Luego realice una entrada simulada para automatizar su juego o aplicación.
3. No olvide hacer afirmaciones del resultado esperado.

 from airtest . core . api import *

# connect an android phone with adb
init_device ( "Android" )
# or use connect_device api
# 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" )

Para obtener información más detallada, consulte la referencia de la API de Python AirTest o eche un vistazo al código API

Correr .air

Usando AirTestide, puede crear fácilmente casos automatizados como directorios .air . AirTest CLI proporciona la posibilidad de ejecutar casos en diferentes máquinas host y plataformas de dispositivos de destino sin usar AirTestide en sí.

 # 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:///

Intente ejecutar un caso de ejemplo proporcionado: airtest/playground/test_blackjack.air y ver el uso de CLI. Aquí hay una muestra de corredor de múltiples dispositivos.

Contribución

Las solicitudes de extracción son muy bienvenidas.

Gracias

Gracias por todas estas grandes obras que mejoran este proyecto.

• STF
• ATX
• pywinauto