Getting Started

Installieren

Sie können unsere KI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer KI-Werkzeug mit 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.

Dies ist die empfohlene Methode für grundlegende Root/Jailbreak-Überprüfungen. Sie 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

Erweitert die Standardprüfung 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 weltweit schreibbare Systempfade (nur Android).

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

await IsRoot.checkForRWPaths();

checkForDangerousProps

Erkennung gefährlicher 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

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 Testbuild-Labels auf dem Betriebssystem-Image (nur Android).

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

await IsRoot.isExistBuildTags();

doesSuperuserApkExist

Erkennung von installierten Superuser-APKs (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

Erkennung von schreibgeschützten 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ührt einen leichten Emulatorenprüfungsprozess (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

Rückgabetyp: Geräteinformationen, die während der Erkennung gesammelt wurden.

Dieser Abschnitt liefert zusätzliche Kontext- und Metadaten zum Gerät, die während des Root-Detektionsprozesses gesammelt wurden. Er ist für die Fehlerbehebung und Protokollierungszwecke nützlich.

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

const deviceInfo = await IsRoot.togetDeviceInfo();
console.log('Device info:', deviceInfo);

isRootedWithEmulator

Erweitert die Standarderkennung mit Emulatortests (nur Android).

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

await IsRoot.isRootedWithEmulator();

isRootedWithBusyBoxWithEmulator

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

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

await IsRoot.isRootedWithBusyBoxWithEmulator();

Typenreferenz

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 Synchronisierung 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 Einstieg to plan dashboard and API operations, connect it with Mit @capgo/capacitor-is-root verbinden 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.