开始入门

安装

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

导入

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

API概述

isRooted

检测是否越狱的基本方法。 它会运行一个组合的最可靠的检测指标。 适用于Android和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

复制到剪贴板

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

await IsRoot.isRootedWithBusyBox();

detectRootManagementApps

检测是否存在已知的根管理应用（仅限Android）。

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

await IsRoot.detectRootManagementApps();

detectPotentiallyDangerousApps

检测常见于根设备（仅限Android）的危险应用

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

await IsRoot.detectPotentiallyDangerousApps();

detectTestKeys

检测Android设备上的debug/test构建标签

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

await IsRoot.detectTestKeys();

checkForBusyBoxBinary

检查设备上是否存在BusyBox二进制文件（仅限Android）

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

await IsRoot.checkForBusyBoxBinary();

checkForSuBinary

检查是否存在 su __CAPGO_KEEP_0__ (仅限 Android).

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

await IsRoot.checkForSuBinary();

checkSuExists

检测是否可以执行 su __CAPGO_KEEP_0__ (仅限 Android).

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

await IsRoot.checkSuExists();

checkForRWPaths

检测世界可写的系统路径 (仅限 Android).

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

await IsRoot.checkForRWPaths();

checkForDangerousProps

检测危险的系统属性 (仅限 Android).

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

await IsRoot.checkForDangerousProps();

checkForRootNative

仅限 Android 执行 RootBeer 原生检查。

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

await IsRoot.checkForRootNative();

detectRootCloakingApps

仅限 Android 检测可以隐藏根设备的应用。

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

await IsRoot.detectRootCloakingApps();

isSelinuxFlagInEnabled

仅限 Android 检查 SELinux 强制执行状态。

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

await IsRoot.isSelinuxFlagInEnabled();

isExistBuildTags

仅限 Android 检测 OS 镜像中的测试构建标签。

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

await IsRoot.isExistBuildTags();

doesSuperuserApkExist

检测是否安装了超级用户APK（仅限Android）。

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

await IsRoot.doesSuperuserApkExist();

isExistSUPath

检查已知的二进制位置（仅限Android）。 su 复制到剪贴板

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

await IsRoot.isExistSUPath();

checkDirPermissions

复制到剪贴板

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

await IsRoot.checkDirPermissions();

checkExecutingCommands

执行 which su 复制到剪贴板

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

await IsRoot.checkExecutingCommands();

checkInstalledPackages

复制到剪贴板

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

await IsRoot.checkInstalledPackages();

checkforOverTheAirCertificates

复制到剪贴板

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

await IsRoot.checkforOverTheAirCertificates();

isRunningOnEmulator

复制到剪贴板

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

await IsRoot.isRunningOnEmulator();

simpleCheckEmulator

轻量级模拟器检查（仅限 Android）

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

await IsRoot.simpleCheckEmulator();

simpleCheckSDKBF86

检测 x86 模拟器指纹（仅限 Android）

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

await IsRoot.simpleCheckSDKBF86();

simpleCheckQRREFPH

检测 QC 参考手机构建（仅限 Android）

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

await IsRoot.simpleCheckQRREFPH();

simpleCheckBuild

检测构建主机异常（仅限 Android）

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

await IsRoot.simpleCheckBuild();

checkGenymotion

检测Genymotion模拟器指纹（仅限Android）

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

await IsRoot.checkGenymotion();

checkGeneric

检测通用模拟器指纹（仅限Android）

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

await IsRoot.checkGeneric();

checkGoogleSDK

检测GoogleSDK模拟器指纹（仅限Android）

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

await IsRoot.checkGoogleSDK();

togetDeviceInfo

获取设备信息

获取设备信息的相关上下文和元数据，用于调试和日志目的。有助于解决问题和记录日志。

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

const deviceInfo = await IsRoot.togetDeviceInfo();
console.log('Device info:', deviceInfo);

isRootedWithEmulator

仅在 Android 上扩展默认检测，使用模拟器策略。

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

await IsRoot.isRootedWithEmulator();

isRootedWithBusyBoxWithEmulator

仅在 Android 上扩展 BusyBox 检测，使用模拟器策略。

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

await IsRoot.isRootedWithBusyBoxWithEmulator();

类型参考

DetectionResult

由 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

设备信息在检测期间收集。

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;
}

真实来源

本页面由插件生成。 src/definitions.ts当公共 API 上游更改时，重新运行同步。

从 Getting Started 继续

如果您正在使用 Getting Started 规划仪表板和 API 操作，连接它。 使用 @capgo/capacitor-is-root 为 @capgo/capacitor-is-root 原生能力 API 概述 为 API 概述实现细节 介绍 为 介绍实现细节 API 密钥 为 API 密钥实现细节 设备 为 设备实现细节