Getting Started

Installieren

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer AI-Werkzeugleiste mit folgendem Befehl hinzu:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Dann verwenden Sie folgende Anfrage:

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-root
bunx cap sync

Importieren

import { IsRoot } from '@capgo/capacitor-is-root';

API-Übersicht

isRooted

Durchführt die Standardprüfungen für Root/Jailbreak-Detektion.

Dies ist die empfohlene Methode für die grundlegende Root/Jailbreak-Detektion. Sie führt eine Combination der zuverlässigsten Detektionsheuristiken 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

Erweitert die Standardprüfungen um BusyBox-spezifische Prüfungen (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.isRootedWithBusyBox();

detectRootManagementApps

Erkennung bekannter Root-Verwaltungsanwendungen (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.detectRootManagementApps();

detectPotentiallyDangerousApps

Detectiert potenziell gefährliche Anwendungen, die häufig auf rooteten Geräten (Android nur) gefunden werden.

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.detectPotentiallyDangerousApps();

detectTestKeys

Detectiert Debug-/Test-Build-Tags (Android nur).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.detectTestKeys();

checkForBusyBoxBinary

Überprüft, ob ein BusyBox-Binary auf dem Gerät (Android nur) existiert.

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkForBusyBoxBinary();

checkForSuBinary

Überprüft, ob ein su In die Zwischenablage kopieren

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkForSuBinary();

checkSuExists

Ermittelt, ob der su Befehl ausgeführt werden kann (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkSuExists();

checkForRWPaths

Ermittelt weltzugängliche Systempfade (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkForRWPaths();

checkForDangerousProps

Ermittelt gefährliche Systemeigenschaften (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkForDangerousProps();

checkForRootNative

Ausführt RootBeer-native-Überprüfungen (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkForRootNative();

detectRootCloakingApps

Erkennung von Anwendungen, die die Root-Zugriff verbergen können (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.detectRootCloakingApps();

isSelinuxFlagInEnabled

Überprüfung des SELinux-Einsatzzustands (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.isSelinuxFlagInEnabled();

isExistBuildTags

Erkennung von Test-Build-Tags auf dem Betriebssystem-Image (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.isExistBuildTags();

doesSuperuserApkExist

Erkennung von Superuser-APKs, die installiert sind (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.doesSuperuserApkExist();

isExistSUPath

Überprüft bekannte su binary-Ortungen (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.isExistSUPath();

checkDirPermissions

Ermittelt schreibbare Verzeichnisse, die geschützt werden sollten (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkDirPermissions();

checkExecutingCommands

Ausführt which su style-Befehle, um Root zu erkennen (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkExecutingCommands();

checkInstalledPackages

Ermittelt verdächtige installierte Pakete (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkInstalledPackages();

checkforOverTheAirCertificates

Ermittelt manipulierte OTA-Zertifikate (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkforOverTheAirCertificates();

isRunningOnEmulator

Ermittelt gängige Emulator- Fingerabdrücke (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.isRunningOnEmulator();

simpleCheckEmulator

Durchführt einen leichten Emulator-Check (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.simpleCheckEmulator();

simpleCheckSDKBF86

Erkennung von x86-Emulator- Fingerabdrücken (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.simpleCheckSDKBF86();

simpleCheckQRREFPH

Erkennung von QC-Referenztelefon-Builds (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.simpleCheckQRREFPH();

simpleCheckBuild

Erkennung von Build-Host-Anomalien (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.simpleCheckBuild();

checkGenymotion

Erkennung von Genymotion-Emulator-Fingerabdrücken (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkGenymotion();

checkGeneric

Erkennung allgemeiner Emulator- Fingerabdrücke (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkGeneric();

checkGoogleSDK

Erkennung von Google SDK-Emulator-Fingerabdrücken (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.checkGoogleSDK();

togetDeviceInfo

Rückgabe von Geräteinformationen, die während der Erkennung gesammelt wurden.

Bietet zusätzliche Kontext- und Metadaten zum Gerät, das während des Root-Detektionsprozesses gesammelt wurde. 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

Ergänzung der Standarderkennung mit Emulatortechniken (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.isRootedWithEmulator();

isRootedWithBusyBoxWithEmulator

Erweitert die BusyBox-Detektion mit Emulator-Heuristiken (nur Android).

import { IsRoot } from '@capgo/capacitor-is-root';

await IsRoot.isRootedWithBusyBoxWithEmulator();

Typenreferenz

DetectionResult

Ergibt durch die root-/Jailbreak-Detektionsmethoden.

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

Geräteinformationen, die während der Detektion gesammelt werden.

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

Diese Seite wird aus dem Plugin generiert. src/definitions.tsRe-run die Synchronisierung, wenn die öffentliche API upstream geändert wird.

Weiter von Getting Started

Wenn Sie " Getting Started zum Planen von Dashboard und API-Operationen verwenden, verbinden Sie es mit Using @capgo/capacitor-is-root für die native Fähigkeit in Using @capgo/capacitor-is-root, API-Übersicht für die Implementierungsdetails in API Übersicht, Einführung für die Implementierungsdetails in Einführung, API Schlüssel für die Implementierungsdetails in API Schlüssel, und Geräte für die Implementierungsdetails in Geräte.