Accueil

Installer

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA à l'aide de la commande suivante :

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

Ensuite, utilisez la prompt suivante :

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

Si vous préférez la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à la plateforme ci-dessous :

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

Importer

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

API Vue d'ensemble

isRooted

Exécute 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. Elle exécute une combinaison des heuristiques de détection les plus fiables pour la plateforme. Elle fonctionne sur Android et 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

É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

Détermine si des applications de gestion root connues sont présentes (seulement Android).

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

await IsRoot.detectRootManagementApps();

detectPotentiallyDangerousApps

Détermine les applications potentiellement dangereuses couramment trouvées sur des appareils rootés (seulement Android).

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

await IsRoot.detectPotentiallyDangerousApps();

detectTestKeys

Détermine les balises de construction de débogage/test (seulement Android).

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

await IsRoot.detectTestKeys();

checkForBusyBoxBinary

Vérifie si un fichier exécutable BusyBox existe sur le dispositif (seulement Android).

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

await IsRoot.checkForBusyBoxBinary();

checkForSuBinary

Vérifie si un su fichier exécutable est présent (seulement Android).

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

await IsRoot.checkForSuBinary();

checkSuExists

fichier exécutable peut être exécuté (seulement Android). su Copier dans le presse-papier

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

await IsRoot.checkSuExists();

checkForRWPaths

fichier exécutable peut être exécuté (seulement Android).

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

await IsRoot.checkForRWPaths();

checkForDangerousProps

Détection de propriétés système dangereuses (seulement Android).

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

await IsRoot.checkForDangerousProps();

checkForRootNative

Exécution de vérifications natives RootBeer (seulement Android).

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

await IsRoot.checkForRootNative();

detectRootCloakingApps

Détection d'applications qui peuvent cacher la root (seulement Android).

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

await IsRoot.detectRootCloakingApps();

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

Détecte les balises de build de test sur l'image du système d'exploitation (seulement Android).

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

await IsRoot.isExistBuildTags();

doesSuperuserApkExist

Détecte si des APKs superutilisateurs sont installés (seulement Android).

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

await IsRoot.doesSuperuserApkExist();

isExistSUPath

Vérifie les emplacements de fichiers binaires connus (seulement Android). su Coller au presse-papier

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

await IsRoot.isExistSUPath();

checkDirPermissions

Détection de répertoires écriturables qui devraient être protégés (seulement Android).

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

await IsRoot.checkDirPermissions();

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

Détection de packages d'installation suspects (seulement Android).

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

await IsRoot.checkInstalledPackages();

checkforOverTheAirCertificates

Détection de certificats OTA manipulés (seulement Android).

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

await IsRoot.checkforOverTheAirCertificates();

isRunningOnEmulator

Détermine les empreintes des simulateurs courants (seulement Android).

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

await IsRoot.isRunningOnEmulator();

simpleCheckEmulator

Effectue une vérification légère du simulateur (seulement Android).

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

await IsRoot.simpleCheckEmulator();

simpleCheckSDKBF86

Détermine les empreintes des simulateurs x86 (seulement Android).

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

await IsRoot.simpleCheckSDKBF86();

simpleCheckQRREFPH

Détermine les builds de téléphone de référence QC (seulement Android).

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

await IsRoot.simpleCheckQRREFPH();

simpleCheckBuild

Détection d'anomalies de l'hôte de construction (seulement Android).

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

await IsRoot.simpleCheckBuild();

checkGenymotion

Détection des empreintes de l'émulateur Genymotion (seulement Android).

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

await IsRoot.checkGenymotion();

checkGeneric

Détection des empreintes d'émulateurs génériques (seulement Android).

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

await IsRoot.checkGeneric();

checkGoogleSDK

Détection des empreintes de l'émulateur Google SDK (seulement Android).

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

await IsRoot.checkGoogleSDK();

togetDeviceInfo

Retourne les informations sur le dispositif collectées lors de la détection.

Fournit un contexte supplémentaire et des métadonnées sur le dispositif qui ont été collectées lors du processus de détection de la 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

É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

É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

DetectionResult

Résultat retourné par les méthodes de détection 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

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é

Cette page est générée à partir du plugin’s src/definitions.tsRe-faire la synchronisation lorsque la publication API change en amont.

Continuez de la section « Commencer »

Si vous utilisez Prise en main pour planifier votre tableau de bord et les opérations API, connectez-l’à Utilisation de @capgo/capacitor-is-root pour la capacité native dans Utilisation de @capgo/capacitor-is-root, API Vue d'ensemble pour le détail d'implémentation dans API Vue d'ensemble, Introduction pour le détail d'implémentation dans Introduction, API Clés pour le détail d'implémentation dans API Clés, et Appareils pour les détails d'implémentation sur les appareils.