Getting Started

설치

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

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

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

await IsRoot.isRootedWithBusyBox();

detectRootManagementApps

__CAPGO_KEEP_0__

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

await IsRoot.detectRootManagementApps();

detectPotentiallyDangerousApps

관리 앱을 감지합니다.

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

await IsRoot.detectPotentiallyDangerousApps();

detectTestKeys

__CAPGO_KEEP_0__

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

클립보드에 복사 su checkForRWPaths

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

await IsRoot.checkSuExists();

checkForRWPaths

Section titled “checkForSuBinary”

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

await IsRoot.checkForRWPaths();

checkForDangerousProps

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

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

await IsRoot.checkForDangerousProps();

checkForRootNative

안드로이드 전용으로 RootBeer 네이티브 체크를 실행합니다.

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

await IsRoot.checkForRootNative();

detectRootCloakingApps

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

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

await IsRoot.detectRootCloakingApps();

isSelinuxFlagInEnabled

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

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 전용으로 superuser 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에서만 스타일 명령어를 실행하여 루트를 감지합니다.

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 에서만 사용할 수 있는 일반 에뮬레이터 지문들을 감지합니다.

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

await IsRoot.isRunningOnEmulator();

simpleCheckEmulator

클립보드에 복사

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

await IsRoot.simpleCheckEmulator();

simpleCheckSDKBF86

Android 에서만 사용할 수 있는 QC 참조 전화 빌드를 감지하는 섹션

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

await IsRoot.simpleCheckSDKBF86();

simpleCheckQRREFPH

Android 에서만 사용할 수 있는 일반 에뮬레이터 지문들을 감지하는 방법

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

에뮬레이터 힐로그 (Android only)를 사용하여 기본 탐지 기능을 확장합니다.

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

await IsRoot.isRootedWithEmulator();

isRootedWithBusyBoxWithEmulator

에뮬레이터 힐로그 (Android only)를 사용하여 BusyBox 탐지 기능을 확장합니다.

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

await IsRoot.isRootedWithBusyBoxWithEmulator();

타입 참조

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

Source Of Truth

공개 __CAPGO_KEEP_0__이 업스트림에서 변경될 때마다 다시 싱크를 실행하십시오. src/definitions.ts. Re-run the sync when the public API changes upstream.

Getting Started에서 계속

만약에 당신이 사용 중이라면 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 Devices __CAPGO_KEEP_0__ 구현 세부 사항은 장치에서 제공됩니다.