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.
Project description
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 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.
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 autotask_android.
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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file airtest_mobileauto-2.0.13.tar.gz.
File metadata
- Download URL: airtest_mobileauto-2.0.13.tar.gz
- Upload date:
- Size: 29.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0c5ba942b75f5400140b6b6ec6fbc2725e10320de18c16e339999221cce8f52a |
|
| MD5 | 70ad5ae4f922b8fd08673ae3fb725814 |
|
| BLAKE2b-256 | 21247a47b6ce912d2c900023523f5d33860c520a2626d03b2d7553b15b15e5ee |
