Installationsvorbereitung¶

Dieses Dokument beschreibt die Vorbereitungen, die Sie vor der Installation treffen sollten. FIRERPA unterstützt eine Vielzahl von Gerätetypen und Architekturen. Hier werden die vorbereitenden Schritte für verschiedene gängige Geräte aufgeführt. Sie können je nach Ihrer tatsächlichen Situation entscheiden, welche Methode Sie anwenden. FIRERPA besteht aus einem Client und einem Server. Der Client umfasst hauptsächlich Python-bezogene Bibliotheken und Schnittstellen, während der Server ein Dienst ist, der auf dem Ziel-Smartphone läuft. Sie können die Python-Bibliotheken auf Ihrem Computer installieren, um das Smartphone zu steuern. Wenn Sie das Gerät über Python steuern möchten, müssen Sie ebenfalls den Android-Server auf dem Smartphone installieren und ausführen. Dies ist zwingend erforderlich.

Grundlegende Anforderungen¶

Die ideale Laufzeitumgebung für FIRERPA ist ein frisch gerootetes System (z. B. ein neu erstellter Emulator, ein ROM mit integrierten Berechtigungen, ein frisch mit Magisk gerootetes Gerät). Bitte stellen Sie sicher, dass Sie ein gerootetes Android-Gerät oder einen Emulator mit mehr als 2 GB RAM und mehr als 1 GB verfügbarem Speicherplatz haben. Wir empfehlen die Verwendung der neuesten Versionen von NoxPlayer, LDPlayer oder des AVD-Emulators. Überprüfen Sie vor dem Start unbedingt die folgenden Punkte:

• Magisk Hide deaktivieren
• frida-server deaktivieren
• Nach der Bestätigung das Gerät neu starten

Systemeinstellungen¶

Normalerweise müssen Sie auf Ihrem Smartphone auch die folgenden Einstellungen vornehmen. Diese sind nicht zwingend erforderlich, aber um einen erfolgreichen ersten Versuch sicherzustellen, wird empfohlen, die folgenden Einstellungen vorzunehmen, wenn Sie Zeit haben.

Zeitzone und Uhrzeit überprüfen¶

Öffnen Sie die Systemeinstellungen, gehen Sie zu Datum & Uhrzeit und überprüfen Sie, ob die Chinesische Standardzeit oder die Zeitzone Ihres Standorts automatisch eingestellt ist. Überprüfen Sie, ob die Uhrzeit korrekt ist oder innerhalb eines akzeptablen Fehlerbereichs liegt. Falls nicht, deaktivieren Sie bitte Zeitzone des Netzwerks verwenden und Netzwerkzeit und stellen Sie die Zeitzone und Uhrzeit manuell auf Ihre aktuelle lokale Zeitzone und Uhrzeit ein.

Bedienungshilfen deaktivieren¶

Öffnen Sie die Systemeinstellungen, finden Sie den Punkt Bedienungshilfen (unter System oder Weitere Einstellungen) und deaktivieren oder deinstallieren Sie alle Apps, die Bedienungshilfen verwenden (z. B. TalkBack, Auto.js usw.).

Netzwerkeinstellungen¶

Die Netzwerksituationen für physische Geräte, Cloud-Telefone, Emulatoren usw. sind unterschiedlich. Sie müssen die entsprechenden Einstellungen je nach Ihrer tatsächlichen Situation vornehmen, da Sie sonst nach der Installation nicht auf den Dienst zugreifen können.

Bei einem physischen Gerät müssen Sie nur sicherstellen, dass sich Computer und Smartphone im selben Netzwerk befinden. Bei Emulatoren ist ein standardmäßig erstellter Emulator normalerweise nicht mit Ihrem lokalen Netzwerk verbunden. Wenn Sie Android x86 (eine auf VMWare basierende Android-VM) verwenden, versuchen Sie, den Netzwerkmodus in den VM-Einstellungen auf den Bridge-Modus umzustellen. Bei Emulatoren wie LDPlayer und NoxPlayer müssen Sie in deren Einstellungen den Anweisungen folgen, um den Treiber zu installieren, den Bridge-Modus zu aktivieren und den Emulator anschließend neu zu starten. Für das Virtual Device von Android Studio gibt es keine entsprechenden Einstellungen. Wenn Sie eine Verbindung zu einem AVD herstellen müssen, führen Sie zuerst adb forward tcp:65000 tcp:65000 aus und verwenden Sie localhost für die Verbindung.

Weitere Einstellungen¶

WSA (Windows Subsystem for Android)¶

Wenn Sie WSA (Windows Subsystem for Android) verwenden, stellen Sie sicher, dass die WSA-Version nicht älter als 2210.40000 ist und das System gerootet ist. Öffnen Sie dann die WSA-Einstellungen -> Subsystemressourcen -> wählen Sie „Kontinuierlich“ und deaktivieren Sie „Erweitertes Netzwerk“. Wählen Sie „Entwickler“, aktivieren Sie den „Entwicklermodus“, erweitern Sie den Tab und aktivieren Sie „UI-Automatisierung für einzelne Maschinen unterstützen“. Starten Sie anschließend das WSA-Subsystem neu.

AVD (Android Studio Virtual Device)¶

Wenn Sie ein AVD (Android Studio Virtual Device) verwenden, erweitern Sie bitte zuerst den standardmäßigen Speicherplatz und die Größe des Arbeitsspeichers.

Klicken Sie im Android Studio auf den Virtual Device Manager, erstellen Sie ein neues virtuelles Gerät, suchen Sie das entsprechende Gerät und klicken Sie auf die Bearbeiten-Schaltfläche (Stiftsymbol). Klicken Sie auf „Show Advanced Settings“, suchen Sie „Storage -> Internal Storage“ und stellen Sie es auf mindestens 2 GB ein. Stellen Sie die Größe des RAM auf mindestens 4 GB ein.

Redroid (Android in Docker)¶

Wenn Sie Redroid (Android in Docker) verwenden, installieren Sie am Beispiel der offiziell empfohlenen Ubuntu 20.04-Version zunächst die relevanten linux-modules-extra-Module.

apt install linux-modules-extra-`uname -r`

Bearbeiten Sie die Datei /etc/modules, kopieren Sie die folgenden Namen und fügen Sie sie am Ende der Datei ein. Starten Sie anschließend das Host-System neu.

# redroid modules
mac80211_hwsim

binder_linux
ashmem_linux

Starten Sie den Container abschließend mit dem folgenden Befehl. Passen Sie redroid_gpu_mode und andere relevante Parameter entsprechend Ihrer tatsächlichen Situation an.

docker run -itd --rm --privileged --pull always -v /lib/modules:/lib/modules:ro -v ~/redroid:/data -p 127.0.0.1:5555:5555 -p 127.0.0.1:65001:65000 redroid/redroid:12.0.0-latest androidboot.redroid_gpu_mode=guest

Im obigen Befehl wird der Port 65000 des Containers auf den Port 65001 des lokalen Rechners gemappt, da einige Tools temporär an den Port 65000 des lokalen Rechners gebunden werden müssen. Um Konflikte zu vermeiden, verwenden wir den Port 65001.