airtest-mobileauto 2.2.0.1

A robust, object-oriented, multi-process mobile app control framework based on AirTest, designed for stable and compatible debugging and automation of devices and apps. Ideal for tasks such as game automation in titles like Honor of Kings, with enhanced stability features including connection checks, automatic retries on failure, and automatic restarts for continuous operation.

AirTest Mobile Automation

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.

Features

• 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 the start_app function 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.

Modules

Device Management ( deviceOB )

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

APP Management ( appOB )

Manages the opening, stopping, and restarting of apps.

Tools ( DQWheel )

• 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.

Development Examples

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 autoansign.

For the configuration file format, see this guide.

Acknowledgements

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.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright

© 2024 cndaqiang. All rights reserved.