Getting Started

Installazione

Puoi utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo abilità al tuo strumento di AI utilizzando il seguente comando:

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

Poi utilizza la seguente richiesta:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-is-root` plugin in my project.

Se preferisci la configurazione Manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo platform sotto:

bun add @capgo/capacitor-is-root
bunx cap sync

Importa

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

API Panoramica

isRooted

Esegue i controlli di default per la detezione di root/jailbreak.

Questo è il metodo consigliato per la detezione di root/jailbreak base. Esegue una combinazione delle heuristici di detezione più affidabili per la piattaforma. Funziona su entrambi Android e 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

Estende i controlli di detezione con controlli specifici di BusyBox (solo Android).

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

await IsRoot.isRootedWithBusyBox();

detectRootManagementApps

Rileva la presenza di applicazioni di gestione root note (solo per Android).

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

await IsRoot.detectRootManagementApps();

detectPotentiallyDangerousApps

Rileva applicazioni potenzialmente pericolose comunemente trovate su dispositivi rootati (solo per Android).

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

await IsRoot.detectPotentiallyDangerousApps();

detectTestKeys

Rileva tag di costruzione di debug/test (solo per Android).

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

await IsRoot.detectTestKeys();

checkForBusyBoxBinary

Verifica se esiste un binario BusyBox sul dispositivo (solo per Android).

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

await IsRoot.checkForBusyBoxBinary();

checkForSuBinary

Verifica se è presente un su binario (solo per Android).

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

await IsRoot.checkForSuBinary();

checkSuExists

Detecta se il su binario può essere eseguito (solo per Android).

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

await IsRoot.checkSuExists();

checkForRWPaths

Detecta percorsi di sistema scrivibili da tutti (solo per Android).

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

await IsRoot.checkForRWPaths();

checkForDangerousProps

Rileva proprietà di sistema pericolose (solo Android).

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

await IsRoot.checkForDangerousProps();

checkForRootNative

Esegue controlli nativi di RootBeer (solo Android).

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

await IsRoot.checkForRootNative();

detectRootCloakingApps

Rileva applicazioni che possono nascondere la root (solo Android).

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

await IsRoot.detectRootCloakingApps();

isSelinuxFlagInEnabled

Verifica lo stato di attivazione di SELinux (solo Android).

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

await IsRoot.isSelinuxFlagInEnabled();

isExistBuildTags

Detecta le etichette di build di test sul'immagine del sistema (solo Android).

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

await IsRoot.isExistBuildTags();

doesSuperuserApkExist

Detecta se sono installati APK superutente (solo Android).

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

await IsRoot.doesSuperuserApkExist();

isExistSUPath

Verifica le posizioni note su di esecuzione binarie (solo Android).

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

await IsRoot.isExistSUPath();

checkDirPermissions

Detecta i directory scrivibili che dovrebbero essere protetti (solo Android).

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

await IsRoot.checkDirPermissions();

checkExecutingCommands

Esegue which su comandi di stile per rilevare la root (solo Android).

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

await IsRoot.checkExecutingCommands();

checkInstalledPackages

Rileva pacchetti installati sospetti (solo Android).

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

await IsRoot.checkInstalledPackages();

checkforOverTheAirCertificates

Rileva certificati OTA alterati (solo Android).

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

await IsRoot.checkforOverTheAirCertificates();

isRunningOnEmulator

Rileva le impronte dei dispositivi emulator (solo Android).

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

await IsRoot.isRunningOnEmulator();

simpleCheckEmulator

Esegue un controllo leggero dell'emulatore (solo Android).

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

await IsRoot.simpleCheckEmulator();

simpleCheckSDKBF86

Rileva le impronte dei dispositivi emulator x86 (solo Android).

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

await IsRoot.simpleCheckSDKBF86();

simpleCheckQRREFPH

Rileva le build di riferimento del telefono QC (solo Android).

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

await IsRoot.simpleCheckQRREFPH();

simpleCheckBuild

Detecta anomalie del host di costruzione (solo Android).

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

await IsRoot.simpleCheckBuild();

checkGenymotion

Detecta impronte dei fingerprint dell'emulatore Genymotion (solo Android).

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

await IsRoot.checkGenymotion();

checkGeneric

Detecta impronte dei fingerprint dell'emulatore generico (solo Android).

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

await IsRoot.checkGeneric();

checkGoogleSDK

Detecta impronte dei fingerprint dell'emulatore Google SDK (solo Android).

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

await IsRoot.checkGoogleSDK();

togetDeviceInfo

Restituisce informazioni sul dispositivo raccolte durante la detezione.

Fornisce contesto aggiuntivo e metadati sul dispositivo che sono stati raccolti durante il processo di detezione radice. Utile per scopi di debug e registrazione.

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

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

isRootedWithEmulator

Estende la detezione di default con heuristici per emulatori (solo Android).

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

await IsRoot.isRootedWithEmulator();

isRootedWithBusyBoxWithEmulator

Estende la detezione di BusyBox con heuristici per emulatori (solo Android).

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

await IsRoot.isRootedWithBusyBoxWithEmulator();

Tipo di Riferimento

DetectionResult

Risultato restituito dai metodi di detezione root/jailbreak.

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

Informazioni sul dispositivo raccolte durante la detezione.

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;
}

Fonte di Verità

Questa pagina è generata dal plugin’s src/definitions.tsRiepilogo quando il pubblico API cambia in modo upstream.

Continua da Iniziare

Se stai utilizzando Inizia per pianificare il dashboard e le API operazioni, connettilo con Utilizza @capgo/capacitor-is-root per la capacità nativa in Utilizza @capgo/capacitor-is-root API Panoramica per la dettaglio di implementazione in API Panoramica Introduzione per la dettaglio di implementazione in Introduzione API Chiavi per la dettaglio di implementazione in API Chiavi, e Dispositivi per la dettaglio di implementazione in Dispositivi