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

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

API 개요

isRooted

기본적인 Root/Jailbreak 감지 검사를 수행합니다.

이것은 기본 루트/잠금 해제 감지에 대한 권장 방법입니다. 이것은 플랫폼에 대한 가장 신뢰할 수 있는 감지 힌트의 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

__CAPGO_KEEP_0__ (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_0__

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

RootBeer 네이티브 체크를 실행합니다 (Android 전용).

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

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

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

await IsRoot.doesSuperuserApkExist();

isExistSUPath

알려진 경로가 있는지 확인합니다. su __CAPGO_KEEP_0__ (Android만 해당).

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

await IsRoot.isExistSUPath();

checkDirPermissions

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

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

await IsRoot.checkDirPermissions();

checkExecutingCommands

Android만 해당하는 root를 감지하기 위한 스타일 명령어를 실행합니다. which su __CAPGO_KEEP_1__을 클립보드에 복사합니다.

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

await IsRoot.checkExecutingCommands();

checkInstalledPackages

__CAPGO_KEEP_1__을 클립보드에 복사합니다.

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에서만 일반 에뮬레이터 지문( fingerprint )을 감지합니다.

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

await IsRoot.isRunningOnEmulator();

simpleCheckEmulator

Android에서만 가볍게 에뮬레이터를 확인합니다.

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

await IsRoot.simpleCheckEmulator();

simpleCheckSDKBF86

Android에서만 x86 에뮬레이터 지문( fingerprint )을 감지합니다.

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

await IsRoot.simpleCheckSDKBF86();

simpleCheckQRREFPH

__CAPGO_KEEP_1__

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

await IsRoot.simpleCheckQRREFPH();

simpleCheckBuild

__CAPGO_KEEP_1__

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

await IsRoot.simpleCheckBuild();

checkGenymotion

__CAPGO_KEEP_1__

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

await IsRoot.checkGenymotion();

checkGeneric

__CAPGO_KEEP_1__

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

await IsRoot.checkGeneric();

checkGoogleSDK

Google SDK SDK 감지

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

BusyBox 탐지에 에뮬레이터 힙틱스를 확장합니다 (Android only).

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

await IsRoot.isRootedWithBusyBoxWithEmulator();

__CAPGO_KEEP_1__

DetectionResult

__CAPGO_KEEP_4__

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

__CAPGO_KEEP_6__

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

__CAPGO_KEEP_7__

__CAPGO_KEEP_8__ src/definitions.ts. upstream의 API이 변경될 때 다시 싱크를 실행하세요.

Getting Started에서 계속

Capacitor를 사용 중이라면 Getting Started 대시보드와 API 연산을 계획하려면 Capacitor를 사용 중이라면 @capgo/capacitor-is-root Capacitor를 사용 중이라면 Using @capgo/capacitor-is-root API 개요 API 개요 __CAPGO_KEEP_0__ 소개 API 키 implementation 세부 사항에 대한 API 키 장치 implementation 세부 사항에 대한 장치.