Dynaevangelical2652/android-agent

Was macht android-agent?

Steuern Sie Android-Geräte über ADB mit diesem Python-Automatisierungs-Framework für Aufgabenausführung und Skalierung von Telefon-Farmen.

Funktionen

• ADB-basierte Steuerung: Führen Sie Shell-Befehle aus, tippen Sie auf Elemente und wischen Sie über den Bildschirm.
• Aufgabenausführung: Automatisieren Sie wiederkehrende Aufgaben wie App-Installation, Datenextraktion und Bildschirmaufzeichnung.
• Phone-Farm-Skalierung: Verwalten Sie mehrere Geräte gleichzeitig und verteilen Sie Aufgaben auf eine gesamte Farm.
• Python-API: Einfach zu integrierende, modulare API für benutzerdefinierte Workflows.

Erste Schritte

1. Stellen Sie sicher, dass Python 3.8+ installiert ist.

2. Klonen Sie das Repository:

   git clone https://github.com/Dynaevangelical2652/android-agent.git
   cd android-agent
   

3. Installieren Sie die Abhängigkeiten:

   pip install -r requirements.txt
   

4. Verbinden Sie Ihr Android-Gerät per USB oder über TCP/IP.

5. Führen Sie ein Beispielskript aus:

   python example.py
   

Verwendung

Einzelnes Gerät

from android_agent import Device

device = Device('device_serial')
device.shell('input tap 500 1000')
print(device.screenshot('screen.png'))

Mehrere Geräte

from android_agent import Farm

farm = Farm()
farm.discover_devices()
farm.run_on_all('input keyevent 26')  # Sperrbildschirm umschalten

Konfiguration

Umgebungsvariablen:

• ANDROID_HOME: Pfad zum Android SDK (optional, standardmäßig ~/Android/Sdk).
• ADB_PATH: Benutzerdefinierter Pfad zur ADB-Binärdatei.

Fehlerbehebung

• Gerät nicht erkannt: Stellen Sie sicher, dass ADB installiert ist und das Gerät autorisiert ist (adb devices).
• Berechtigungsfehler: Führen Sie das Skript mit sudo aus oder konfigurieren Sie udev-Regeln.

Lizenz

MIT