Démarrage
Copiez une commande de configuration avec les étapes d'installation et la guide markdown complète pour ce 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.
Configuration
Sous-titre : "Installer"bun add @capgo/capacitor-is-rootbunx cap syncImporter
Section intitulée « Importer »import { IsRoot } from '@capgo/capacitor-is-root';API Vue d'ensemble
Section intitulée « API Vue d'ensemble »isRooted
Section intitulée « isRooted »Effectue les vérifications de détection de root/jailbreak par défaut.
Cette méthode est recommandée pour la détection de base de root/jailbreak.
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
Elle fonctionne sur les deux Android et iOS.Étend la détection par défaut avec des vérifications spécifiques à BusyBox (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithBusyBox();detectRootManagementApps
Section intitulée “détecter les applications de gestion de root”Détermine si des applications de gestion de root connues sont présentes (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectRootManagementApps();detectPotentiallyDangerousApps
Section intitulée “détecter les applications potentiellement dangereuses”Détermine les applications potentiellement dangereuses couramment trouvées sur les appareils rootés (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectPotentiallyDangerousApps();detectTestKeys
Section intitulée “détecter les clés de test”Détermine les balises de construction de test (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectTestKeys();checkForBusyBoxBinary
Section intitulée “vérifier l'existence du fichier exécutable BusyBox”Vérifie si un fichier BusyBox existe sur le dispositif (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForBusyBoxBinary();checkForSuBinary
Section intitulée “checkForSuBinary”Vérifie si un su fichier est présent (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForSuBinary();checkSuExists
Détermine si lefichier peut être exécuté (seulement Android). su Copier dans le presse-papiers
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkSuExists();checkForRWPaths
Détermine si leschemins système sont mondialement accessibles (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForRWPaths();checkForDangerousProps
Section intitulée “checkForDangerousProps”Détection de propriétés système dangereuses (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForDangerousProps();checkForRootNative
Section intitulée “checkForRootNative”Exécution de vérifications natives RootBeer (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForRootNative();detectRootCloakingApps
Section intitulée “detectRootCloakingApps”Détection d'applications pouvant cacher la root (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectRootCloakingApps();isSelinuxFlagInEnabled
Section intitulée “isSelinuxFlagInEnabled”Vérification de l'état de mise en œuvre de SELinux (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isSelinuxFlagInEnabled();isExistBuildTags
Section intitulée “isExistBuildTags”Détermine les balises de build test sur l'image du système d'exploitation (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isExistBuildTags();doesSuperuserApkExist
Section intitulée “doesSuperuserApkExist”Détermine si les APKs superutilisateurs sont installés (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.doesSuperuserApkExist();isExistSUPath
Section intitulée “isExistSUPath”Vérifie les emplacements de fichiers binaires connus (seulement Android). su Copier dans le presse-papier
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isExistSUPath();checkDirPermissions
Copier dans le presse-papierDétection de répertoires écritures qui doivent être protégés (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkDirPermissions();checkExecutingCommands
Section intitulée « checkExecutingCommands »Exécute which su commandes de style pour détecter la racine (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkExecutingCommands();checkInstalledPackages
Section intitulée « checkInstalledPackages »Détection de packages installés suspects (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkInstalledPackages();checkforOverTheAirCertificates
Section intitulée « checkforOverTheAirCertificates »Détection de certificats OTA altérés (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkforOverTheAirCertificates();isRunningOnEmulator
Section intitulée “isRunningOnEmulator”Détection des empreintes de simulateurs courants (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRunningOnEmulator();simpleCheckEmulator
Section intitulée “simpleCheckEmulator”Effectue une vérification de simulateur légère (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckEmulator();simpleCheckSDKBF86
Section intitulée “simpleCheckSDKBF86”Détection des empreintes de simulateurs x86 (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckSDKBF86();simpleCheckQRREFPH
Section intitulée “simpleCheckQRREFPH”Détection des builds de téléphone de référence QC (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckQRREFPH();simpleCheckBuild
Section intitulée “simpleCheckBuild”Détection d'anomalies de l'hôte de construction (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckBuild();checkGenymotion
Section intitulée “checkGenymotion”Détection des empreintes de l'émulateur Genymotion (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGenymotion();checkGeneric
Section intitulée “checkGeneric”Détection des empreintes d'émulateurs génériques (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGeneric();checkGoogleSDK
Section intitulée “checkGoogleSDK”Détection des empreintes de l'émulateur Google SDK (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGoogleSDK();togetDeviceInfo
Section intitulée “getDeviceInfo”Renvoie les informations de l'appareil collectées lors de la détection.
Fournit un contexte supplémentaire et des métadonnées sur l'appareil qui ont été collectées lors du processus de détection racine. Utile pour les besoins de débogage et de journalisation.
import { IsRoot } from '@capgo/capacitor-is-root';
const deviceInfo = await IsRoot.togetDeviceInfo();console.log('Device info:', deviceInfo);isRootedWithEmulator
Section intitulée “isRootedWithEmulator”Étend la détection par défaut avec des heuristiques d'émulateur (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithEmulator();isRootedWithBusyBoxWithEmulator
Section intitulée “isRootedWithBusyBoxWithEmulator”Étend la détection de BusyBox avec des heuristiques d'émulateur (seulement Android).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithBusyBoxWithEmulator();Référence de type
Section intitulée “Référence de type”DetectionResult
Section intitulée « Résultat de détection »Résultat retourné par les méthodes de détection racine/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;}Informations sur le dispositif collectées pendant la détection.
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;}Source De Vérité
Section intitulée « Source De Vérité »Cette page est générée à partir du plugin, à partir de la source __CAPGO_KEEP_0__. src/definitions.tsRe-run la synchronisation lorsque les modifications publiques API changent en amont.