Getting Started

Installieren

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie die Capgo-Fähigkeiten zu Ihrer KI-Tool mithilfe der folgenden Befehl hinzu:

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

Dann verwenden Sie die 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 Plattform-spezifischen Anweisungen unten:

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 Standarderkennung mit BusyBox-spezifischen Überprüfungen (nur Android).

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

await IsRoot.isRootedWithBusyBox();

detectRootManagementApps

Ermittelt, ob bekannte Anwendungen zur Verwaltung von Root-Rechten vorhanden sind (nur Android).

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

await IsRoot.detectRootManagementApps();

detectPotentiallyDangerousApps

Ermittelt potenziell gefährliche Anwendungen, die auf Root-Geräten häufig vorkommen (nur Android).

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

await IsRoot.detectPotentiallyDangerousApps();

detectTestKeys

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

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

await IsRoot.detectTestKeys();

checkForBusyBoxBinary

Überprüft, ob ein BusyBox-Binär existiert (nur Android).

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

await IsRoot.checkForBusyBoxBinary();

checkForSuBinary

Überprüft, ob ein su Binär vorhanden ist (nur Android).

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

await IsRoot.checkForSuBinary();

checkSuExists

Ermittelt, ob das su Binär ausführbar ist (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

Warnung für gefährliche Systemeigenschaften (nur Android).

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

await IsRoot.checkForDangerousProps();

checkForRootNative

Ausführung von RootBeer-Native-Überprüfungen (nur Android).

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

await IsRoot.checkForRootNative();

detectRootCloakingApps

Anwendungen erkennen, 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, ob Superuser-APKs installiert sind (nur Android).

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

await IsRoot.doesSuperuserApkExist();

isExistSUPath

Überprüfung bekannter su Binärorte (nur Android).

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

await IsRoot.isExistSUPath();

checkDirPermissions

Während der Erkennung von schreibbaren Verzeichnissen, die geschützt werden sollten (nur Android).

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

await IsRoot.checkDirPermissions();

checkExecutingCommands

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

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

await IsRoot.checkExecutingCommands();

checkInstalledPackages

Erkennung von verdächtigen installierten Paketen (nur Android).

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

await IsRoot.checkInstalledPackages();

checkforOverTheAirCertificates

Erkennung von manipulierten OTA-Zertifikaten (nur Android).

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

await IsRoot.checkforOverTheAirCertificates();

isRunningOnEmulator

Erkennung gemeinsamer Emulatorenfingerabdrücke (nur Android).

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

await IsRoot.isRunningOnEmulator();

simpleCheckEmulator

Durchführung eines leichten Emulatorenchecks (nur Android).

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

await IsRoot.simpleCheckEmulator();

simpleCheckSDKBF86

Erkennung von x86-Emulatorenfingerabdrücken (nur Android).

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

await IsRoot.simpleCheckSDKBF86();

simpleCheckQRREFPH

Erkennung von QC-Referenztelefonbaustellen (nur Android).

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

await IsRoot.simpleCheckQRREFPH();

simpleCheckBuild

Erkennung von Anomalien des Build-Hosts (nur Android).

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

await IsRoot.simpleCheckBuild();

checkGenymotion

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

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

await IsRoot.checkGenymotion();

checkGeneric

Erkennung von generischen Emulator-Fingerabdrücken (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

Gibt Informationen über das Gerät zurück, die während der Erkennung gesammelt wurden.

Bietet zusätzlichen Kontext und Metadaten zum Gerät, die während des Root-Detektionsprozesses 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

Erweitert die Standarderkennung mit Emulatortechniken (nur Android).

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

await IsRoot.isRootedWithEmulator();

isRootedWithBusyBoxWithEmulator

Erweitert die Erkennung von BusyBox mit Emulatortechniken (nur Android).

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

await IsRoot.isRootedWithBusyBoxWithEmulator();

Typenverweis

DetectionResult

Erfolgsmeldung, die von 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

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. Wenn die öffentliche __CAPGO_KEEP_0__ upstream geändert wird, führen Sie die Synchronisation erneut durch. src/definitions.ts. Re-run the sync when the public API changes upstream.

Abschnitt mit dem Titel “Weitermachen von Getting Started”

Wenn Sie es verwenden Einstieg um das Dashboard und die API-Funktionen zu planen, verbinden Sie es mit Mit @capgo/capacitor-is-root für die native Fähigkeit in Mit @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äten.