Uso de @capgo/capacitor-is-root
El plugin Capacitor Is Root sirve para detectar dispositivos con root (Android) o jailbreak (iOS).
Instalar
bun add @capgo/capacitor-is-root
bunx cap sync
bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.
Importar
import { IsRoot } from '@capgo/capacitor-is-root';
API de un vistazo
| Método | Descripción |
|---|---|
isRooted |
Realiza las comprobaciones de detección de root/jailbreak por defecto. |
isRootedWithBusyBox |
Extiende la detección por defecto con comprobaciones específicas de BusyBox (solo Android). |
detectRootManagementApps |
Detecta si hay aplicaciones de gestión de root conocidas (solo Android). |
detectPotentiallyDangerousApps |
Detecta aplicaciones potencialmente peligrosas habituales en dispositivos con root (solo Android). |
detectTestKeys |
Detecta etiquetas de build de debug/test (solo Android). |
checkForBusyBoxBinary |
Comprueba si existe un binario de BusyBox en el dispositivo (solo Android). |
checkForSuBinary |
Comprueba si existe un su el binario está presente (solo Android). |
checkSuExists |
Detecta si el su binario se puede ejecutar (solo Android). |
checkForRWPaths |
Detects world writable system paths (Android only). |
checkForDangerousProps |
Detecta propiedades peligrosas del sistema (solo Android). |
checkForRootNative |
Ejecuta comprobaciones nativas de RootBeer (solo Android). |
detectRootCloakingApps |
Detecta aplicaciones que pueden ocultar el root (solo Android). |
isSelinuxFlagInEnabled |
Comprueba si SELinux está en modo enforcing (solo Android). |
isExistBuildTags |
Detecta etiquetas de build de prueba en la imagen del SO (solo Android). |
doesSuperuserApkExist |
Detecta si hay APKs de superusuario instaladas (solo Android). |
isExistSUPath |
Busca ubicaciones de su binarios conocidos (solo Android). |
checkDirPermissions |
Detecta directorios escribibles que deberían protegerse (solo Android). |
checkExecutingCommands |
Ejecuta which su Comandos de estilo para detectar root (solo Android). |
checkInstalledPackages |
Detecta paquetes instalados sospechosos (solo Android). |
checkforOverTheAirCertificates |
Detecta certificados OTA manipulados (solo Android). |
isRunningOnEmulator |
Detecta huellas de emuladores comunes (solo Android). |
simpleCheckEmulator |
Realiza un chequeo ligero de emuladores (solo Android). |
simpleCheckSDKBF86 |
Detecta huellas de emuladores x86 (solo Android). |
simpleCheckQRREFPH |
Detecta builds de teléfonos de referencia QC (solo Android). |
simpleCheckBuild |
Detecta anomalías en el host de build (solo Android). |
checkGenymotion |
Detecta huellas del emulador Genymotion (solo Android). |
checkGeneric |
Detecta huellas de emuladores genéricos (solo Android). |
checkGoogleSDK |
Detecta huellas del emulador de Google SDK (solo Android). |
togetDeviceInfo |
Devuelve la información del dispositivo recopilada durante la detección. |
isRootedWithEmulator |
Extiende la detección por defecto con heurísticas de emuladores (solo Android). |
isRootedWithBusyBoxWithEmulator |
Extiende la detección de BusyBox con heurísticas de emuladores (solo Android). |
Ejemplos
isRooted()
Realiza las comprobaciones de detección de root/jailbreak por defecto.
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()
Extiende la detección por defecto con comprobaciones específicas de BusyBox (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.isRootedWithBusyBox();
console.log(result);
detectRootManagementApps()
Detecta si hay aplicaciones de gestión de root conocidas (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectRootManagementApps();
console.log(result);
detectPotentiallyDangerousApps()
Detecta aplicaciones potencialmente peligrosas habituales en dispositivos con root (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectPotentiallyDangerousApps();
console.log(result);
detectTestKeys()
Detecta etiquetas de build de debug/test (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectTestKeys();
console.log(result);
checkForBusyBoxBinary()
Comprueba si existe un binario de BusyBox en el dispositivo (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkForBusyBoxBinary();
console.log(result);
La tabla anterior recoge los 31 métodos principales. Los helpers de listener y de versión, y el contrato completo de cada método, están documentados en la repositorio GitHub.
Referencia completa
Continuar desde Usando @capgo/capacitor-is-root
Si estás usando Uso de @capgo/capacitor-is-root para planificar el trabajo con plugins nativos, conéctalo con @capgo/capacitor-is-root para el detalle de la implementación en @capgo/capacitor-is-root, Primeros pasos para los detalles de implementación en Primeros pasos, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Capacitor Plugins de Capgo, y Añadir o actualizar plugins para los detalles de implementación al añadir o actualizar plugins.