Démarrage

Installer

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil d'IA en utilisant 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 au plateforme ci-dessous :

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

Importer

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

API Aperçu

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. Elle exécute une combinaison des heuristiques de détection les plus fiables pour la plateforme. 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 de racine 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 les appareils rootés (seulement Android).

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

await IsRoot.detectPotentiallyDangerousApps();

detectTestKeys

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

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

await IsRoot.detectTestKeys();

checkForBusyBoxBinary

Vérifie si un fichier BusyBox existe sur l’appareil (seulement Android).

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

await IsRoot.checkForBusyBoxBinary();

checkForSuBinary

Vérifie si un su binaire est présent (seulement sur Android).

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

await IsRoot.checkForSuBinary();

checkSuExists

Détermine si le su binaire peut être exécuté (seulement sur Android).

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

await IsRoot.checkSuExists();

checkForRWPaths

Détermine les chemins système mondiaux écrits (seulement sur 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 de RootBeer (seulement Android).

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

await IsRoot.checkForRootNative();

detectRootCloakingApps

Détection d'applications pouvant 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étermine 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étermine si les 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 Copier dans le presse-papier

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

await IsRoot.isExistSUPath();

checkDirPermissions

__CAPGO_KEEP_0__

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

await IsRoot.checkDirPermissions();

checkExecutingCommands

Exécute which su des commandes de style pour détecter la racine (seulement Android).

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

await IsRoot.checkExecutingCommands();

checkInstalledPackages

Détermine les packages d'installation suspects (seulement Android).

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

await IsRoot.checkInstalledPackages();

checkforOverTheAirCertificates

Détermine les certificats OTA altérés (seulement Android).

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

await IsRoot.checkforOverTheAirCertificates();

isRunningOnEmulator

Détection des empreintes de simulateurs courants (seulement Android).

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

await IsRoot.isRunningOnEmulator();

simpleCheckEmulator

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

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

await IsRoot.simpleCheckEmulator();

simpleCheckSDKBF86

Détection des empreintes de simulateurs x86 (seulement Android).

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

await IsRoot.simpleCheckSDKBF86();

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

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

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

É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 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 de 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-run la synchronisation lorsque les données publiques API changent en amont.

Continuez de Getting Started

Si vous utilisez Pour commencer pour planifier le tableau de bord et les opérations API, connectez-le à En utilisant @capgo/capacitor-est-root pour la capacité native dans En utilisant @capgo/capacitor-est-root, Présentation de API pour le détail d'implémentation dans Présentation de API, Introduction pour le détail d'implémentation dans Introduction, Les clés de API pour le détail d'implémentation dans Les clés de API, et Les appareils pour le détail d'implémentation dans Les appareils.