시작하기

설치

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

수입

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

API 개요

isRooted

기본 루트/잠금 해제 검사 체크를 수행합니다.

루트/잠금 해제 검사를 위한 기본적인 방법입니다. 이 메서드는 플랫폼의 가장 신뢰할 수 있는 검사 지침의 combination을 실행합니다. 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

BusyBox를 위한 특정 체크를 추가로 수행합니다 (Android 전용).

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 전용으로 디버그/테스트 빌드 태그를 감지합니다.

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

await IsRoot.detectTestKeys();

checkForBusyBoxBinary

Android 기기에서 BusyBox 바이너리가 존재하는지 확인합니다.

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

await IsRoot.checkForBusyBoxBinary();

checkForSuBinary

Android 기기에서 su 바이너리가 존재하는지 확인합니다.

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

await IsRoot.checkForSuBinary();

checkSuExists

Android 기기에서 su 바이너리가 실행될 수 있는지 감지합니다.

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

await IsRoot.checkSuExists();

checkForRWPaths

Android 기기에서 세계적으로 읽기/쓰기 가능한 시스템 경로를 감지합니다.

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

await IsRoot.checkForRWPaths();

checkForDangerousProps

__CAPGO_KEEP_2__

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

await IsRoot.checkForDangerousProps();

checkForRootNative

__CAPGO_KEEP_4__

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

await IsRoot.checkForRootNative();

detectRootCloakingApps

__CAPGO_KEEP_6__

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

await IsRoot.detectRootCloakingApps();

isSelinuxFlagInEnabled

__CAPGO_KEEP_8__

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

await IsRoot.isSelinuxFlagInEnabled();

isExistBuildTags

OS 이미지 (Android만)에서 테스트 빌드 태그를 감지합니다.

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

await IsRoot.isExistBuildTags();

doesSuperuserApkExist

Android (만)에서 슈퍼유저 APK가 설치되어 있는지 감지합니다.

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

await IsRoot.doesSuperuserApkExist();

isExistSUPath

Android (만)에서 알려진 su 바이너리 위치를 확인합니다.

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

await IsRoot.isExistSUPath();

checkDirPermissions

Android에서 보호해야 하는 writable 디렉토리를 감지합니다.

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

await IsRoot.checkDirPermissions();

checkExecutingCommands

실행 which su 루트 탐지 (Android only)용 스타일 명령을 실행합니다.

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

await IsRoot.checkExecutingCommands();

checkInstalledPackages

Android에서 의심스러운 설치된 패키지를 감지합니다.

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

await IsRoot.checkInstalledPackages();

checkforOverTheAirCertificates

Android에서 OTA 인증서를 조작한 것을 감지합니다.

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

await IsRoot.checkforOverTheAirCertificates();

isRunningOnEmulator

__CAPGO_KEEP_1__

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

await IsRoot.isRunningOnEmulator();

simpleCheckEmulator

__CAPGO_KEEP_4__

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

await IsRoot.simpleCheckEmulator();

simpleCheckSDKBF86

__CAPGO_KEEP_7__

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

await IsRoot.simpleCheckSDKBF86();

simpleCheckQRREFPH

__CAPGO_KEEP_10__

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

await IsRoot.simpleCheckQRREFPH();

simpleCheckBuild

Android에서만 빌드 호스트 이상치를 감지하는 기능입니다.

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

await IsRoot.simpleCheckBuild();

checkGenymotion

Android에서만 Genymotion 에뮬레이터 지문( fingerprint )을 감지하는 기능입니다.

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

await IsRoot.checkGenymotion();

checkGeneric

Android에서만 일반 에뮬레이터 지문( fingerprint )을 감지하는 기능입니다.

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

await IsRoot.checkGeneric();

checkGoogleSDK

Android에서만 Google SDK 에뮬레이터 지문( fingerprint )을 감지하는 기능입니다.

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

안드로이드 전용으로 에뮬레이터 힐리스트릭스를 확장합니다.

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

await IsRoot.isRootedWithEmulator();

isRootedWithBusyBoxWithEmulator

BusyBox 감지에 에뮬레이터 힐리스트릭스를 확장합니다. (안드로이드 전용)

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

await IsRoot.isRootedWithBusyBoxWithEmulator();

Type Reference

DetectionResult

루트/자이클럽 감지 방법으로 반환되는 결과.

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. Re-run the sync when the public API changes upstream.