Inizia
Copia un prompt di configurazione con le istruzioni 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.
Installa
Sezione intitolata “Installa”bun add @capgo/capacitor-is-rootbunx cap syncImporta
Sezione intitolata “Importa”import { IsRoot } from '@capgo/capacitor-is-root';API Panoramica
Sezione intitolata “API Panoramica”isRooted
Sezione intitolata “isRooted”Esegue i controlli di default per la detezione di root/jailbreak.
Questo è il metodo consigliato per la detezione di base di root/jailbreak. 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
Sezione intitolata “isRootedWithBusyBox”Estende la detezione di default con controlli specifici di BusyBox (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithBusyBox();detectRootManagementApps
Sezione intitolata “detectRootManagementApps”Detects se sono presenti applicazioni di gestione root note (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectRootManagementApps();detectPotentiallyDangerousApps
Sezione intitolata “detectPotentiallyDangerousApps”Detects applicazioni potenzialmente pericolose comunemente trovate su dispositivi rootati (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectPotentiallyDangerousApps();detectTestKeys
Sezione intitolata “detectTestKeys”Detects tag di costruzione di debug/test (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectTestKeys();checkForBusyBoxBinary
Sezione intitolata “checkForBusyBoxBinary”Verifica se esiste un binario BusyBox sul dispositivo (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForBusyBoxBinary();checkForSuBinary
Sezione intitolata “checkForSuBinary”Verifica se è presente un su binario (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForSuBinary();checkSuExists
Sezione intitolata “checkSuExists”Detects se il su binario può essere eseguito (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkSuExists();checkForRWPaths
Sezione intitolata “checkForRWPaths”Rileva percorsi di sistema scrivibili da tutti (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForRWPaths();checkForDangerousProps
Sezione intitolata “checkForDangerousProps”Rileva proprietà di sistema pericolose (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForDangerousProps();checkForRootNative
Sezione intitolata “checkForRootNative”Esegue controlli nativi di RootBeer (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForRootNative();detectRootCloakingApps
Sezione intitolata “detectRootCloakingApps”Rileva applicazioni che possono nascondere la root (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectRootCloakingApps();isSelinuxFlagInEnabled
Sezione intitolata “isSelinuxFlagInEnabled”Verifica lo stato di attivazione di SELinux (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isSelinuxFlagInEnabled();isExistBuildTags
Sezione intitolata “isExistBuildTags”Rileva le etichette di build di test sul'immagine del sistema (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isExistBuildTags();doesSuperuserApkExist
Sezione intitolata “doesSuperuserApkExist”Rileva se sono installati APK superutente (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.doesSuperuserApkExist();isExistSUPath
Sezione intitolata “isExistSUPath”Verifica la presenza di su posizioni binarie note (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isExistSUPath();checkDirPermissions
Sezione intitolata “checkDirPermissions”Detecta directory scrivibili che dovrebbero essere protette (solo per Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkDirPermissions();checkExecutingCommands
Sezione intitolata “checkExecutingCommands”Esegue which su comandi di stile per rilevare la root (solo per Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkExecutingCommands();checkInstalledPackages
Sezione intitolata “checkInstalledPackages”Detecta pacchetti installati sospetti (solo per Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkInstalledPackages();checkforOverTheAirCertificates
Sezione intitolata “checkforOverTheAirCertificates”Detecta certificati OTA manipolati (solo per Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkforOverTheAirCertificates();isRunningOnEmulator
Sezione intitolata “isRunningOnEmulator”Rileva comuni impronte di emulator (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRunningOnEmulator();simpleCheckEmulator
Sezione intitolata “simpleCheckEmulator”Esegue un controllo di emulator leggero (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckEmulator();simpleCheckSDKBF86
Sezione intitolata “simpleCheckSDKBF86”Rileva impronte di emulator x86 (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckSDKBF86();simpleCheckQRREFPH
Sezione intitolata “simpleCheckQRREFPH”Rileva costruzioni di telefono di riferimento QC (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckQRREFPH();simpleCheckBuild
Sezione intitolata “simpleCheckBuild”Detecta anomalie del host di costruzione (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckBuild();checkGenymotion
Sezione intitolata “checkGenymotion”Detecta impronte del simulatore Genymotion (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGenymotion();checkGeneric
Sezione intitolata “checkGeneric”Detecta impronte del simulatore generico (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGeneric();checkGoogleSDK
Sezione intitolata “checkGoogleSDK”Detecta impronte del simulatore Google SDK (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGoogleSDK();togetDeviceInfo
Sezione intitolata “ottenere informazioni sul dispositivo”Restituisce le informazioni sul dispositivo raccolte durante la detezione.
Fornisce contesto aggiuntivo e metadati sul dispositivo 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
Sezione intitolata “è radicato con emulatore”Estende la detezione di default con heuristici per emulatori (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithEmulator();isRootedWithBusyBoxWithEmulator
Sezione intitolata “è radicato con BusyBox con emulatore”Estende la detezione di BusyBox con heuristici per emulatori (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithBusyBoxWithEmulator();Riferimento di tipo
Sezione intitolata “Riferimento di tipo”DetectionResult
Sezione intitolata “Risultato di rilevamento”Risultato restituito dai metodi di rilevamento di 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;}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 plugin’s src/definitions.tsRiepiloga la sincronizzazione quando le informazioni pubbliche API cambiano in fase di sviluppo.