AirTest Mobile Automation is an object-oriented, multi-process control framework for mobile apps based on the AirTest framework. It is designed for stability and compatibility, making it ideal for automating tasks in games like Honor of Kings.
- Enhanced Stability: This framework enhances the reliability of testing and automation by implementing rigorous connection status checks and intelligent automatic reconnection mechanisms. Instead of throwing errors upon failure, it encapsulates AirTest functions to attempt reconnections, ensuring continuous operation even in the face of transient network issues or screenshot retrieval failures. In rare cases, such as with iOS devices, it may prompt for a physical reconnect of the device to be recognized by
tidevice list. Additionally, it addresses and corrects issues with thestart_appfunction that could occur on certain Android systems, providing a smoother and more resilient automation experience. - Automated Operation: Capable of fully automated processes with unattended operation. In case of errors, it automatically restarts the app or the control endpoint, such as Docker or an Android emulator.
- Time Management: Utilizes the UTC/GMT+08:00 time zone for task scheduling aligned with Chinese game refresh cycles.
- Formatted Output: Displays information in a formatted manner, e.g.,
[MM-DD HH:MM:SS] info.
Handles device management in an object-oriented approach, supporting various clients and control endpoints.
| Clients | Control Endpoints | Management Capabilities |
|---|---|---|
| BlueStacks / LDPlayer/ MuMu | Windows | Start, stop, and restart emulators |
| Docker | Linux | Start, stop, and restart containers |
| iOS | Mac | Reconnect with tidevice, restart iOS |
| USB-connected Android phones | ALL | Reboot Android system |
| WIFI-connected phones | ALL | Hot reboot Android system |
Manages the opening, stopping, and restarting of apps.
- A utility for multi-process support based on the file system, including synchronization, broadcasting, file management, and enhanced time management.
- Utilizes files and dictionaries to store and retrieve image coordinates, reducing the time to locate element coordinates repeatedly. It also allows for selecting specific positions, such as the least proficient hero in Honor of Kings based on proficiency.
Below are some examples of development scripts that demonstrate the capabilities of the project.
- An automation script for Honor of Kings .
- Automate daily sign-ins and claim gift packages on Android with autotask_android.
The historical versions of this script, namely WZRY_AirtestIDE_XiaoMi11@cndaqiang, WZRY_AirtestIDE_emulator@cndaqiang, and WZRY@cndaqiang have also been instrumental in the development process.
This project is licensed under the MIT License - see the LICENSE file for details.
© 2024 cndaqiang. All rights reserved.