Usando @capgo/capacitor-is-root
Capacitor es el plugin Is Root 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 root/jailbreak por defecto. |
isRootedWithBusyBox |
Extiende la detección con checks específicos de BusyBox (solo Android). |
detectRootManagementApps |
Detecta si hay apps de gestión de root conocidas (solo Android). |
detectPotentiallyDangerousApps |
Detecta apps potencialmente peligrosas en dispositivos con root (solo Android). |
detectTestKeys |
Detecta tags de build de debug/test (solo Android). |
checkForBusyBoxBinary |
Comprueba si existe un binario de BusyBox en el dispositivo (solo Android). |
checkForSuBinary |
Comprueba si un su binario está presente (solo Android). |
checkSuExists |
Detecta si el su binario se puede ejecutar (solo Android). |
checkForRWPaths |
Detecta rutas del sistema con permisos de escritura global (solo Android). |
checkForDangerousProps |
Detecta propiedades del sistema peligrosas (solo Android). |
checkForRootNative |
Ejecuta comprobaciones nativas de RootBeer (solo Android). |
detectRootCloakingApps |
Detecta aplicaciones que pueden ocultar el root (solo Android). |
isSelinuxFlagInEnabled |
Comprueba el estado de SELinux enforcement (solo Android). |
isExistBuildTags |
Detecta etiquetas de build de prueba en la imagen del OS (solo Android). |
doesSuperuserApkExist |
Detecta si hay APKs de superusuario instalados (solo Android). |
isExistSUPath |
Busca ubicaciones de su binarios conocidos (solo Android). |
checkDirPermissions |
Detecta directorios con permisos de escritura que deberían estar protegidos (solo Android). |
checkExecutingCommands |
Ejecuta which su comandos de shell 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 de emuladores Genymotion (solo Android). |
checkGeneric |
Detecta huellas de emuladores genéricos (solo Android). |
checkGoogleSDK |
Detecta huellas de emuladores Google SDK (solo Android). |
togetDeviceInfo |
Devuelve la info del dispositivo recogida al detectar. |
isRootedWithEmulator |
Extiende la detección por defecto con heurística de emuladores (solo Android). |
isRootedWithBusyBoxWithEmulator |
Extiende la detección de BusyBox con heurística de emuladores (solo Android). |
Ejemplos
isRooted()
Realiza las comprobaciones 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 con checks específicos 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 apps potencialmente peligrosas comunes en dispositivos con root (solo Android).
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectPotentiallyDangerousApps();
console.log(result);
detectTestKeys()
Detecta tags 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 lista los 31 métodos principales. Los helpers de Listener y versión, y el contrato completo de cada método, están documentados en la repositorio GitHub.
Referencia completa
Continuar desde Uso de @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 los detalles de 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.