시작하기

설치

플러그인을 설치하기 위해 AI-Assisted Setup을 사용할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

다음 명령어를 사용하여 다음 프롬프트를 사용하세요:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-is-root` plugin in my project.

만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래 플랫폼별 지침을 따르세요:

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

Import

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

API 개요

isRooted

기본 루트/자이클백 검사 체크를 수행합니다.

기본 루트/자이클백 검사에 대한 권장 방법입니다. 이 메서드는 안드로이드와 iOS両방에서 가장 신뢰할 수 있는 검사 지침을 combination하여 실행합니다.

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

Android에서만 BusyBox에 특정한 체크를 확장합니다.

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

await IsRoot.isRootedWithBusyBox();

detectRootManagementApps

Android에서만 알려진 루트 관리 앱이 존재하는지 감지합니다.

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

await IsRoot.detectRootManagementApps();

detectPotentiallyDangerousApps

루트 디바이스에서 흔히 발견되는 위험한 앱을 감지합니다.

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

await IsRoot.detectPotentiallyDangerousApps();

detectTestKeys

Android에서만 디버그/테스트 빌드 태그를 감지합니다.

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

await IsRoot.detectTestKeys();

checkForBusyBoxBinary

__CAPGO_KEEP_0__ (Android 전용)

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

await IsRoot.checkForBusyBoxBinary();

checkForSuBinary

__CAPGO_KEEP_0__ (Android 전용) su __CAPGO_KEEP_0__ 복사

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

await IsRoot.checkForSuBinary();

checkSuExists

__CAPGO_KEEP_0__ 복사 su __CAPGO_KEEP_3__

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

await IsRoot.checkSuExists();

checkForRWPaths

__CAPGO_KEEP_0__

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

OS 이미지를 검사하여 테스트 빌드 태그를 감지합니다 (안드로이드 전용).

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

await IsRoot.isExistBuildTags();

doesSuperuserApkExist

안드로이드 전용으로 superuser APK가 설치되어 있는지 감지합니다.

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

await IsRoot.doesSuperuserApkExist();

isExistSUPath

알려진 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에서만 스타일 명령어를 실행하여 루트를 감지합니다.

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

Android 에뮬레이터의 흔한 지문 (Android only) 을 감지합니다.

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

await IsRoot.isRunningOnEmulator();

simpleCheckEmulator

클립보드에 복사

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

await IsRoot.simpleCheckEmulator();

simpleCheckSDKBF86

QC 참조 전화 빌드 (Android only) 감지

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

await IsRoot.simpleCheckSDKBF86();

simpleCheckQRREFPH

Android 에뮬레이터의 흔한 지문 (Android only) 을 감지합니다.

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

__CAPGO_KEEP_1__

__CAPGO_KEEP_2__

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

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

isRootedWithEmulator

__CAPGO_KEEP_5__

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

await IsRoot.isRootedWithEmulator();

isRootedWithBusyBoxWithEmulator

Extends the BusyBox detection with emulator heuristics (Android only).

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

await IsRoot.isRootedWithBusyBoxWithEmulator();

__CAPGO_KEEP_8__

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 계획 대시보드와 API 연산을 계획하고 싶다면 Using @capgo/capacitor-is-root Using @capgo/capacitor-is-root API 개요 API 구현 세부 사항 __CAPGO_KEEP_0__ 구현 세부 사항 __CAPGO_KEEP_0__ 키 API 구현 세부 사항 for the implementation detail in API Keys, and Getting Started __CAPGO_KEEP_0__