Anleitung
Is Root in Capacitor nutzen
Mit @capgo/capacitor-is-root
Capacitor ist das Is Root Plugin zum Erkennen von gerooteten (Android) oder gejailbreakten (iOS) Geräten.
Installieren
bun add @capgo/capacitor-is-root
bunx cap sync
bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.
Importieren
import { IsRoot } from '@capgo/capacitor-is-root';
API auf einen Blick
| Methode | Beschreibung |
|---|---|
isRooted |
Führt die Standard-Checks zur Root-/Jailbreak-Erkennung durch. |
isRootedWithBusyBox |
Erweitert die Standard-Erkennung um BusyBox-spezifische Checks (nur Android). |
detectRootManagementApps |
Erkennt, ob bekannte Root-Management-Apps installiert sind (nur Android). |
detectPotentiallyDangerousApps |
Erkennt potenziell gefährliche Apps, die häufig auf gerooteten Geräten vorkommen (nur Android). |
detectTestKeys |
Erkennt Debug-/Test-Build-Tags (nur Android). |
checkForBusyBoxBinary |
Prüft, ob eine BusyBox-Binary auf dem Gerät existiert (nur Android). |
checkForSuBinary |
Prüft, ob eine su Binary vorhanden ist (nur Android). |
checkSuExists |
Erkennt, ob die su Binary ausgeführt werden kann (nur Android). |
checkForRWPaths |
Erkennt systemweite beschreibbare Pfade (nur Android). |
checkForDangerousProps |
Erkennt gefährliche Systemeigenschaften (nur Android). |
checkForRootNative |
Führt RootBeer native Checks aus (nur Android). |
detectRootCloakingApps |
Erkennt Apps, die Root verbergen können (nur Android). |
isSelinuxFlagInEnabled |
Prüft den SELinux Enforcement-Status (nur Android). |
isExistBuildTags |
Erkennt Test-Build-Tags auf dem OS-Image (nur Android). |
doesSuperuserApkExist |
Erkennt installierte Superuser-APKs (nur Android). |
isExistSUPath |
Prüft auf bekannte su Binary-Locations (nur Android). |
checkDirPermissions |
Erkennt beschreibbare Verzeichnisse, die geschützt sein sollten (nur Android). |
checkExecutingCommands |
Führt which su Shell-Commands zur Root-Erkennung aus (nur Android). |
checkInstalledPackages |
Erkennt verdächtige installierte Pakete (nur Android). |
checkforOverTheAirCertificates |
Erkennt manipulierte OTA-Zertifikate (nur Android). |
isRunningOnEmulator |
Erkennt gängige Emulator-Fingerprints (nur Android). |
simpleCheckEmulator |
Führt einen leichtgewichtigen Emulator-Check durch (nur Android). |
simpleCheckSDKBF86 |
Erkennt x86-Emulator-Fingerprints (nur Android). |
simpleCheckQRREFPH |
Erkennt QC-Referenz-Phone-Builds (nur Android). |
simpleCheckBuild |
Erkennt Anomalien beim Build-Host (nur Android). |
checkGenymotion |
Erkennt Genymotion-Emulator-Fingerprints (nur Android). |
checkGeneric |
Erkennt generische Emulator-Fingerprints (nur Android). |
checkGoogleSDK |
Erkennt Google SDK Emulator-Fingerprints (nur Android). |
togetDeviceInfo |
Gibt die während der Erkennung gesammelten Geräteinfos zurück. |
isRootedWithEmulator |
Erweitert die Standard-Erkennung um Emulator-Heuristiken (nur Android). |
isRootedWithBusyBoxWithEmulator |
Erweitert die BusyBox-Erkennung um Emulator-Heuristiken (nur Android). |
Beispiele
isRooted()
Führt die Standard-Checks zur Root-/Jailbreak-Erkennung durch.
import { IsRoot } from '@capgo/capacitor-is-root';
const { result } = await IsRoot.isRooted();
if (result) {
console.log('Device is rooted/jailbroken');
} else {
console.log('Device is not rooted/jailbroken');
}
isRootedWithBusyBox()
Erweitert die Standard-Erkennung um BusyBox-spezifische Checks (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.isRootedWithBusyBox();
console.log(result);
detectRootManagementApps()
Erkennt, ob bekannte Root-Management-Apps installiert sind (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectRootManagementApps();
console.log(result);
detectPotentiallyDangerousApps()
Erkennt potenziell gefährliche Apps, die häufig auf gerooteten Geräten vorkommen (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectPotentiallyDangerousApps();
console.log(result);
detectTestKeys()
Erkennt Debug-/Test-Build-Tags (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectTestKeys();
console.log(result);
checkForBusyBoxBinary()
Prüft, ob eine BusyBox-Binary auf dem Gerät existiert (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkForBusyBoxBinary();
console.log(result);
Die obige Tabelle listet die 31 Core-Methoden auf. Listener- und Version-Helper sowie der vollständige Contract jeder Methode sind in der GitHub Repository.
Vollständige Referenz
Weiter mit der Nutzung von @capgo/capacitor-is-root
Wenn du es nutzt Nutzung von @capgo/capacitor-is-root Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-is-root für die Implementierungsdetails in @capgo/capacitor-is-root, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.