Per iniziare
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
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.
Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsPoi usa il seguente prompt:
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 questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:
bun add @capgo/capacitor-is-rootbunx cap syncImporta
Sezione intitolata “Import”import { IsRoot } from '@capgo/capacitor-is-root';Avvio rapido
Sezione intitolata “Quick start”import { IsRoot } from '@capgo/capacitor-is-root';
const { result } = await IsRoot.isRooted();if (result) { blockSensitiveFlow();}Esempio: segnale emulatore Android
Sezione intitolata “Esempio: segnale emulatore Android”Il rilevamento dell'emulatore non è incluso di default isRooted(). Invocalo esplicitamente quando la policy lo richiede.
const { result } = await IsRoot.isRunningOnEmulator();Esempio: audit Android più approfondito
Sezione intitolata “Esempio: audit Android più approfondito”const checks = await Promise.all([ IsRoot.detectRootManagementApps(), IsRoot.checkForSuBinary(),]);Errori comuni
Sezione intitolata “Errori comuni”- Simulatore iOS: riporta sempre “non jailbroken”, testa su dispositivo.
- Falsi positivi: abbina i controlli root al risk scoring lato server, non solo ai crash forzati.
- Policy di Play: bloccare tutti gli utenti con root può entrare in conflitto con la categoria del tuo store, documenta l'UX.
Panoramica API
Sezione intitolata “Panoramica API”isRooted
Sezione intitolata “isRooted”Esegue i controlli predefiniti per il rilevamento di root/jailbreak.
Questo è il metodo consigliato per la rilevazione di base di root/jailbreak. Esegue una combinazione delle euristiche di rilevamento più affidabili per la piattaforma. Funziona sia su Android che su 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
Sezione intitolata “isRootedWithBusyBox”Estende il rilevamento predefinito con controlli specifici per BusyBox (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.isRootedWithBusyBox();console.log(result);detectRootManagementApps
Sezione intitolata “detectRootManagementApps”Rileva la presenza di note app di gestione del root (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectRootManagementApps();console.log(result);detectPotentiallyDangerousApps
Sezione intitolata “detectPotentiallyDangerousApps”Rileva app potenzialmente pericolose comuni sui dispositivi rootati (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectPotentiallyDangerousApps();console.log(result);detectTestKeys
Sezione intitolata “detectTestKeys”Rileva tag di build per debug/test (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectTestKeys();console.log(result);checkForBusyBoxBinary
Sezione intitolata “checkForBusyBoxBinary”Verifica la presenza di un binario BusyBox sul dispositivo (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkForBusyBoxBinary();console.log(result);checkForSuBinary
Sezione intitolata “checkForSuBinary”Verifica se un su binario è presente (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkForSuBinary();console.log(result);checkSuExists
Sezione intitolata “checkSuExists”Rileva se il su binario è eseguibile (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkSuExists();console.log(result);checkForRWPaths
Sezione intitolata “checkForRWPaths”Rileva percorsi di sistema scrivibili da tutti (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkForRWPaths();console.log(result);checkForDangerousProps
Sezione intitolata “checkForDangerousProps”Rileva proprietà di sistema pericolose (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkForDangerousProps();console.log(result);checkForRootNative
Sezione intitolata “checkForRootNative”Esegue i controlli nativi di RootBeer (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkForRootNative();console.log(result);detectRootCloakingApps
Sezione intitolata “detectRootCloakingApps”Rileva le app in grado di nascondere il root (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectRootCloakingApps();console.log(result);isSelinuxFlagInEnabled
Sezione intitolata “isSelinuxFlagInEnabled”Controlla lo stato di enforcement di SELinux (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.isSelinuxFlagInEnabled();console.log(result);isExistBuildTags
Sezione intitolata “isExistBuildTags”Rileva i tag di build di test nell'immagine OS (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.isExistBuildTags();console.log(result);doesSuperuserApkExist
Sezione intitolata “doesSuperuserApkExist”Rileva se sono installati APK superuser (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.doesSuperuserApkExist();console.log(result);isExistSUPath
Sezione intitolata “isExistSUPath”Controlla i percorsi noti dei su Percorsi dei binari (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.isExistSUPath();console.log(result);checkDirPermissions
Sezione intitolata “checkDirPermissions”Rileva le directory scrivibili che dovrebbero essere protette (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkDirPermissions();console.log(result);checkExecutingCommands
Sezione intitolata “checkExecutingCommands”Esegue which su comandi in stile su per rilevare il root (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkExecutingCommands();console.log(result);checkInstalledPackages
Sezione intitolata “checkInstalledPackages”Rileva pacchetti installati sospetti (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkInstalledPackages();console.log(result);checkforOverTheAirCertificates
Sezione intitolata “checkforOverTheAirCertificates”Rileva certificati OTA manomessi (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkforOverTheAirCertificates();console.log(result);isRunningOnEmulator
Sezione intitolata “isRunningOnEmulator”Rileva i fingerprint comuni degli emulatori (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.isRunningOnEmulator();console.log(result);simpleCheckEmulator
Sezione intitolata “simpleCheckEmulator”Esegue un controllo leggero dell'emulatore (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.simpleCheckEmulator();console.log(result);simpleCheckSDKBF86
Sezione intitolata “simpleCheckSDKBF86”Rileva fingerprint di emulatori x86 (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.simpleCheckSDKBF86();console.log(result);simpleCheckQRREFPH
Sezione intitolata “simpleCheckQRREFPH”Rileva build di telefoni di riferimento QC (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.simpleCheckQRREFPH();console.log(result);simpleCheckBuild
Sezione intitolata “simpleCheckBuild”Rileva anomalie nell'host di build (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.simpleCheckBuild();console.log(result);checkGenymotion
Sezione intitolata “checkGenymotion”Rileva i fingerprint dell'emulatore Genymotion (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkGenymotion();console.log(result);checkGeneric
Sezione intitolata “checkGeneric”Rileva i fingerprint degli emulatori generici (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkGeneric();console.log(result);checkGoogleSDK
Sezione intitolata “checkGoogleSDK”Rileva i fingerprint dell'emulatore Google SDK (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkGoogleSDK();console.log(result);togetDeviceInfo
Sezione intitolata “togetDeviceInfo”Restituisce le informazioni sul dispositivo raccolte durante il rilevamento.
Fornisce contesto aggiuntivo e metadati sul dispositivo raccolti durante il processo di rilevamento del root. Utile per il debug e la registrazione dei log.
import { IsRoot } from '@capgo/capacitor-is-root';
const deviceInfo = await IsRoot.togetDeviceInfo();console.log('Device info:', deviceInfo);isRootedWithEmulator
Sezione intitolata “isRootedWithEmulator”Estende il rilevamento predefinito con euristiche per emulatori (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.isRootedWithEmulator();console.log(result);isRootedWithBusyBoxWithEmulator
Sezione intitolata “isRootedWithBusyBoxWithEmulator”Estende il rilevamento BusyBox con euristiche per emulatori (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.isRootedWithBusyBoxWithEmulator();console.log(result);Riferimento ai tipi
Sezione: “Type Reference”DetectionResult
Sezione intitolata “DetectionResult”Risultato restituito dai metodi di rilevamento 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
Sezione intitolata “DeviceInfo”Informazioni sul dispositivo raccolte durante il rilevamento.
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à
Sezione intitolata “Fonte di verità”Questa pagina è generata dal src/definitions.ts. Riesegui la sync quando il API pubblico cambia upstream.
Continua da Getting Started
Sezione intitolata “Continua da Getting Started”Se stai usando Per iniziare per pianificare le operazioni della dashboard e di API, collegalo a Utilizzo di @capgo/capacitor-is-root per la funzionalità nativa in Using @capgo/capacitor-is-root, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, Chiavi API per i dettagli di implementazione in Chiavi API, e Dispositivi per i dettagli di implementazione in Dispositivi.