시작하기

설치

플러그인을 설치하기 위해 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 { 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';

const result = await IsRoot.isRootedWithBusyBox();
console.log(result);

detectRootManagementApps

루트 관리 앱이 설치되어 있는지 확인합니다 (안드로이드 전용).

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

const result = await IsRoot.detectRootManagementApps();
console.log(result);

detectPotentiallyDangerousApps

루트된 기기에서 발견되는 일반적인 위험 앱을 감지합니다 (안드로이드 전용).

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

const result = await IsRoot.detectPotentiallyDangerousApps();
console.log(result);

detectTestKeys

디버그/테스트 빌드 태그를 감지합니다 (안드로이드 전용).

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

const result = await IsRoot.detectTestKeys();
console.log(result);

checkForBusyBoxBinary

BusyBox 바이너리가 기기에 존재하는지 확인합니다 (안드로이드 전용).

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

const result = await IsRoot.checkForBusyBoxBinary();
console.log(result);

checkForSuBinary

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

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

const result = await IsRoot.checkForSuBinary();
console.log(result);

checkSuExists

checkForRWPaths su Android에서 시스템 경로가 읽기/쓰기 가능한지 감지합니다.

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

const result = await IsRoot.checkSuExists();
console.log(result);

checkForRWPaths

Section titled “checkForSuBinary”

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

const result = await IsRoot.checkForRWPaths();
console.log(result);

checkForDangerousProps

안드로이드 전용으로 위험한 시스템 속성을 감지합니다.

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

const result = await IsRoot.checkForDangerousProps();
console.log(result);

checkForRootNative

안드로이드 전용으로 RootBeer 네이티브 확인을 실행합니다.

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

const result = await IsRoot.checkForRootNative();
console.log(result);

detectRootCloakingApps

안드로이드 전용으로 루트를 숨길 수 있는 앱을 감지합니다.

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

const result = await IsRoot.detectRootCloakingApps();
console.log(result);

isSelinuxFlagInEnabled

안드로이드 전용으로 SELinux 강제 실행 상태를 확인합니다.

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

const result = await IsRoot.isSelinuxFlagInEnabled();
console.log(result);

isExistBuildTags

Android OS 이미지를 검사하여 테스트 빌드 태그를 감지합니다.

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

const result = await IsRoot.isExistBuildTags();
console.log(result);

doesSuperuserApkExist

Android OS에서 Superuser APK가 설치되어 있는지 감지합니다.

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

const result = await IsRoot.doesSuperuserApkExist();
console.log(result);

isExistSUPath

Section titled “isExistSUPath” su Section titled “isExistSUPath”

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

const result = await IsRoot.isExistSUPath();
console.log(result);

checkDirPermissions

Android OS에서 쓰기 가능한 디렉토리를 감지하여 보호합니다.

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

const result = await IsRoot.checkDirPermissions();
console.log(result);

checkExecutingCommands

실행 which su 루트를 감지하기 위해 스타일 명령을 실행합니다 (안드로이드만).

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

const result = await IsRoot.checkExecutingCommands();
console.log(result);

checkInstalledPackages

안드로이드에서만 의심스러운 설치된 패키지를 감지합니다.

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

const result = await IsRoot.checkInstalledPackages();
console.log(result);

checkforOverTheAirCertificates

안드로이드에서만 OTA 인증서를 조작한 것을 감지합니다.

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

const result = await IsRoot.checkforOverTheAirCertificates();
console.log(result);

isRunningOnEmulator

Android 전용으로 일반 에뮬레이터 지문 (fingerprint)을 감지합니다.

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

const result = await IsRoot.isRunningOnEmulator();
console.log(result);

simpleCheckEmulator

Android 전용으로 가벼운 에뮬레이터 확인을 수행합니다.

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

const result = await IsRoot.simpleCheckEmulator();
console.log(result);

simpleCheckSDKBF86

Android 전용으로 x86 에뮬레이터 지문 (fingerprint)을 감지합니다.

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

const result = await IsRoot.simpleCheckSDKBF86();
console.log(result);

simpleCheckQRREFPH

Android 전용으로 QC 참조 전화 빌드 (build)를 감지합니다.

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

const result = await IsRoot.simpleCheckQRREFPH();
console.log(result);

simpleCheckBuild

Android에서만 빌드 호스트 이상치를 감지합니다.

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

const result = await IsRoot.simpleCheckBuild();
console.log(result);

checkGenymotion

Android에서만 Genymotion 에뮬레이터 지문들을 감지합니다.

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

const result = await IsRoot.checkGenymotion();
console.log(result);

checkGeneric

Android에서만 일반 에뮬레이터 지문들을 감지합니다.

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

const result = await IsRoot.checkGeneric();
console.log(result);

checkGoogleSDK

Android에서만 Google SDK 에뮬레이터 지문들을 감지합니다.

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

const result = await IsRoot.checkGoogleSDK();
console.log(result);

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

const result = await IsRoot.isRootedWithEmulator();
console.log(result);

isRootedWithBusyBoxWithEmulator

에뮬레이터 힌트를 사용하여 BusyBox 탐지 확장 (Android 전용)

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

const result = await IsRoot.isRootedWithBusyBoxWithEmulator();
console.log(result);

타입 참조

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공개 API이 업스트림에서 변경될 때 다시 싱크를 실행하세요.

시작부터 계속

이미 플러그인을 사용 중이라면 시작하기 계획 대시보드 및 API 작업을 계획하고 연결하세요. @capgo/capacitor-is-root 사용 @capgo/capacitor-is-root의 네이티브 기능을 사용하세요. API 개요 API 개요의 구현 세부 정보를 참조하세요. 소개 소개의 구현 세부 정보를 참조하세요. API 키 API 키의 구현 세부 정보를 참조하세요. 장치 __CAPGO_KEEP_0__의 구현 세부 정보를 참조하세요.