Guide
Comment utiliser Is Root dans Capacitor
Tester sur l'appareil
Téléchargez l'application Capgo, puis scannez le QR code.
Utiliser @capgo/capacitor-is-root
Capacitor est un plugin Is Root pour détecter les appareils rootés (Android) ou jailbreakés (iOS).
Installer
bun add @capgo/capacitor-is-root
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.
Importer
import { IsRoot } from '@capgo/capacitor-is-root';
Aperçu de API
| Méthode | Description |
|---|---|
isRooted |
Effectue les vérifications de détection de root/jailbreak par défaut. |
isRootedWithBusyBox |
Étend la détection par défaut avec des vérifications spécifiques à BusyBox (Android uniquement). |
detectRootManagementApps |
Détecte la présence d'applications de gestion du root connues (Android uniquement). |
detectPotentiallyDangerousApps |
Détecte les applications potentiellement dangereuses souvent présentes sur les appareils rootés (Android uniquement). |
detectTestKeys |
Détecte les tags de build de debug/test (Android uniquement). |
checkForBusyBoxBinary |
Vérifie si un binaire BusyBox existe sur l'appareil (Android uniquement). |
checkForSuBinary |
Vérifie si un su binaire est présent (Android uniquement). |
checkSuExists |
Détecte si le su binaire peut être exécuté (Android uniquement). |
checkForRWPaths |
Détecte les chemins système accessibles en écriture (Android uniquement). |
checkForDangerousProps |
Détecte les propriétés système dangereuses (Android uniquement). |
checkForRootNative |
Exécute les vérifications natives RootBeer (Android uniquement). |
detectRootCloakingApps |
Détecte les applications capables de masquer le root (Android uniquement). |
isSelinuxFlagInEnabled |
Vérifie l'état d'application de SELinux (Android uniquement). |
isExistBuildTags |
Détecte les tags de build de test sur l'image de l'OS (Android uniquement). |
doesSuperuserApkExist |
Détecte si des APK superuser sont installés (Android uniquement). |
isExistSUPath |
Recherche les su emplacements binaires connus (Android uniquement). |
checkDirPermissions |
Détecte les répertoires accessibles en écriture qui devraient être protégés (Android uniquement). |
checkExecutingCommands |
Exécute des which su commandes de style pour détecter le root (Android uniquement). |
checkInstalledPackages |
Détecte les packages installés suspects (Android uniquement). |
checkforOverTheAirCertificates |
Détecte les certificats OTA falsifiés (Android uniquement). |
isRunningOnEmulator |
Détecte les empreintes d'émulateurs courantes (Android uniquement). |
simpleCheckEmulator |
Effectue une vérification légère de l'émulateur (Android uniquement). |
simpleCheckSDKBF86 |
Détecte les empreintes d'émulateurs x86 (Android uniquement). |
simpleCheckQRREFPH |
Détecte les builds de téléphones de référence QC (Android uniquement). |
simpleCheckBuild |
Détecte les anomalies de l'hôte de build (Android uniquement). |
checkGenymotion |
Détecte les empreintes de l'émulateur Genymotion (Android uniquement). |
checkGeneric |
Détecte les empreintes d'émulateurs génériques (Android uniquement). |
checkGoogleSDK |
Détecte les empreintes de l'émulateur Google SDK (Android uniquement). |
togetDeviceInfo |
Renvoie les informations de l'appareil collectées lors de la détection. |
isRootedWithEmulator |
Étend la détection par défaut avec des heuristiques d'émulateur (Android uniquement). |
isRootedWithBusyBoxWithEmulator |
Étend la détection BusyBox avec des heuristiques d'émulateur (Android uniquement). |
Exemples
isRooted()
Effectue les vérifications de détection de root/jailbreak par défaut.
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()
Étend la détection par défaut avec des vérifications spécifiques à BusyBox (Android uniquement).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.isRootedWithBusyBox();
console.log(result);
detectRootManagementApps()
Détecte la présence d'applications de gestion du root connues (Android uniquement).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectRootManagementApps();
console.log(result);
detectPotentiallyDangerousApps()
Détecte les applications potentiellement dangereuses souvent présentes sur les appareils rootés (Android uniquement).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectPotentiallyDangerousApps();
console.log(result);
detectTestKeys()
Détecte les tags de build de debug/test (Android uniquement).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectTestKeys();
console.log(result);
checkForBusyBoxBinary()
Vérifie si un binaire BusyBox existe sur l'appareil (Android uniquement).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkForBusyBoxBinary();
console.log(result);
Le tableau ci-dessus liste les 31 méthodes principales. Les helpers de version et de listener, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.
Référence complète
Continuer depuis « Utiliser @capgo/capacitor-is-root »
Si vous utilisez Utiliser @capgo/capacitor-is-root pour planifier le travail sur les plugins natifs, connectez-l’à @capgo/capacitor-is-root pour les détails d'implémentation dans @capgo/capacitor-is-root, Prise en main pour les détails d'implémentation dans Getting Started Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans les plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins.