Getting Started
Eine Einrichtungshinweis mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin kopieren.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-is-root`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/is-root/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Installieren
Abschnitt mit dem Titel „Installieren“Sie können unsere KI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihre KI-Tool mithilfe der folgenden Befehl hinzu:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsVerwenden Sie dann den folgenden Prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-is-root` plugin in my project.Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und folgen Sie den unten angegebenen Plattform-spezifischen Anweisungen:
bun add @capgo/capacitor-is-rootbunx cap syncimport { IsRoot } from '@capgo/capacitor-is-root';API Übersicht
Abschnitt mit dem Titel „API Übersicht“Durchführt die Standardprüfungen für Root/Jailbreak.
Dies ist die empfohlene Methode für grundlegende Root/Jailbreak-Überprüfungen. Es führt eine Combination der zuverlässigsten Erkennungsheuristiken für die Plattform aus. Funktioniert auf beiden Android und iOS.
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
Abschnitt mit dem Titel „isRootedWithBusyBox“Erweitert die Standardprüfungen um BusyBox-spezifische Prüfungen (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithBusyBox();detectRootManagementApps
Abschnitt mit dem Titel “detectRootManagementApps”Erkennung bekannter Root-Management-Anwendungen (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectRootManagementApps();detectPotentiallyDangerousApps
Abschnitt mit dem Titel “detectPotentiallyDangerousApps”Erkennung gefährlicher Anwendungen, die auf Root-Geräten häufig vorkommen (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectPotentiallyDangerousApps();detectTestKeys
Abschnitt mit dem Titel “detectTestKeys”Erkennung von Debug-/Test-Build-Tags (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectTestKeys();checkForBusyBoxBinary
Abschnitt mit dem Titel “checkForBusyBoxBinary”Überprüfung, ob ein BusyBox-Binär existiert (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForBusyBoxBinary();checkForSuBinary
Abschnitt mit dem Titel “checkForSuBinary”Überprüft, ob ein su Binärprogramm vorhanden ist (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForSuBinary();checkSuExists
Abschnitt mit dem Titel “checkSuExists”Erkennung, ob das su Binärprogramm ausgeführt werden kann (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkSuExists();checkForRWPaths
Abschnitt mit dem Titel “checkForRWPaths”Ermittelt weltweit schreibbare Systempfade (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForRWPaths();checkForDangerousProps
Abschnitt mit dem Titel “checkForDangerousProps”Durchsucht gefährliche Systemeigenschaften (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForDangerousProps();checkForRootNative
Abschnitt mit dem Titel “checkForRootNative”Ausführt RootBeer-native-Überprüfungen (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForRootNative();detectRootCloakingApps
Abschnitt mit dem Titel “detectRootCloakingApps”Durchsucht Anwendungen, die Root verbergen können (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectRootCloakingApps();isSelinuxFlagInEnabled
Abschnitt mit dem Titel “isSelinuxFlagInEnabled”Überprüft den SELinux-Einsatzzustand (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isSelinuxFlagInEnabled();isExistBuildTags
Abschnitt mit dem Titel “isExistBuildTags”Erkennen Sie Test-Build-Tags auf dem Betriebssystem-Image (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isExistBuildTags();doesSuperuserApkExist
Abschnitt mit dem Titel “doesSuperuserApkExist”Ermitteln Sie, ob Superuser-APKs installiert sind (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.doesSuperuserApkExist();isExistSUPath
Abschnitt mit dem Titel “isExistSUPath”Überprüfen Sie bekannte su binary-Ortungen (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isExistSUPath();checkDirPermissions
Abschnitt mit dem Titel “checkDirPermissions”Ermitteln Sie schreibbare Verzeichnisse, die geschützt werden sollten (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkDirPermissions();checkExecutingCommands
Abschnitt mit dem Titel “checkExecutingCommands”Ausführt which su Stil-Befehle zum Erkennen von Root (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkExecutingCommands();checkInstalledPackages
Abschnitt mit dem Titel “checkInstalledPackages”Macht verdächtige installierte Pakete (nur Android) aus.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkInstalledPackages();checkforOverTheAirCertificates
Abschnitt mit dem Titel “checkforOverTheAirCertificates”Macht verdächtige OTA-Zertifikate (nur Android) aus.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkforOverTheAirCertificates();isRunningOnEmulator
Abschnitt mit dem Titel “isRunningOnEmulator”Detectiert gängige Emulatorfingerabdrücke (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRunningOnEmulator();simpleCheckEmulator
Abschnitt mit dem Titel „simpleCheckEmulator“Durchführt eine leichte Emulatorprüfung (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckEmulator();simpleCheckSDKBF86
Abschnitt mit dem Titel „simpleCheckSDKBF86“Detectiert x86-Emulatorfingerabdrücke (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckSDKBF86();simpleCheckQRREFPH
Abschnitt mit dem Titel „simpleCheckQRREFPH“Detectiert QC-Referenzhandys (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckQRREFPH();simpleCheckBuild
Abschnitt mit dem Titel „simpleCheckBuild“Detectiert Anomalien des Build-Hosts (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckBuild();checkGenymotion
Abschnitt mit dem Titel “checkGenymotion”Detectiert Fingerabdrücke von Genymotion-Emulatoren (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGenymotion();checkGeneric
Abschnitt mit dem Titel “checkGeneric”Detectiert generische Emulatorfingerabdrücke (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGeneric();checkGoogleSDK
Abschnitt mit dem Titel “checkGoogleSDK”Detectiert Google SDK-Emulatorenfingerabdrücke (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGoogleSDK();togetDeviceInfo
Abschnitt mit dem Titel “getDeviceInfo”Gibt Geräteinformationen zurück, die während der Erkennung gesammelt wurden.
Bietet zusätzliche Kontext- und Metadateninformationen über das Gerät an, die während des Root-Erkennungsprozesses gesammelt wurden. Nützlich für Debugging- und Protokollierungszwecke.
import { IsRoot } from '@capgo/capacitor-is-root';
const deviceInfo = await IsRoot.togetDeviceInfo();console.log('Device info:', deviceInfo);isRootedWithEmulator
Abschnitt mit dem Titel “isRootedWithEmulator”Erweitert die Standarderkennung mit Emulatortechniken (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithEmulator();isRootedWithBusyBoxWithEmulator
Abschnitt mit dem Titel “isRootedWithBusyBoxWithEmulator”Erweitert die Erkennung von BusyBox mit Emulatortechniken (nur Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithBusyBoxWithEmulator();Typenverweis
Abschnitt mit dem Titel “Typenverweis”DetectionResult
Abschnitt mit dem Titel “DetectionResult”Erfolg, der durch root/Jailbreak-Detektionsmethoden zurückgegeben wird.
export interface DetectionResult { /** * `true` when the associated heuristic detects root/jailbreak artifacts. * `false` when no root/jailbreak indicators are found. * * @since 1.0.0 */ result: boolean;}DeviceInfo
Abschnitt mit dem Titel „DeviceInfo“Geräteinformationen, die während der Detektion gesammelt wurden.
export interface DeviceInfo { /** * Arbitrary key/value device metadata populated by the native implementation. * Contents vary by platform and detection methods used. * * @since 1.0.0 */ [key: string]: any;}Quelle der Wahrheit
Abschnitt mit dem Titel „Quelle der Wahrheit“Diese Seite wurde aus dem Plugin generiert. src/definitions.tsRe-run die Synchronisierung, wenn die öffentliche API upstream geändert wird.
Fortsetzen von Getting Started
Abschnitt mit dem Titel „Fortsetzen von Getting Started“Wenn Sie diese verwenden Zu Beginn um das Dashboard und die API-Operationen zu planen und es mit Mit @capgo/capacitor-is-root zu verwenden zur nativen Fähigkeit in Mit @capgo/capacitor-is-root API-Übersicht zur Implementierungsdetails in API-Übersicht Einführung zur Implementierungsdetails in Einführung API-Schlüssel zur Implementierungsdetails in API-Schlüssel und Geräte zur Implementierungsdetails in Geräte.