Getting Started
이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함하여 설정 지시문을 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-is-root`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/is-root/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
설치
설치AI-Assisted 설치를 사용하여 플러그인을 설치할 수 있습니다. Capgo 스킬을 AI 도구에 추가하려면 다음 명령어를 사용하세요:
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-rootbunx cap syncImport
‘Import’ 섹션import { IsRoot } from '@capgo/capacitor-is-root';API 개요
API 개요isRooted
__CAPGO_KEEP_0__기본 루트/잠금 해제 검사 체크를 수행합니다.
기본 루트/잠금 해제 검사 방법을 추천합니다. 이 방법은 플랫폼에서 가장 신뢰할 수 있는 검사 체크를 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
__CAPGO_KEEP_0__BusyBox 특정 체크를 확장하여 루트/잠금 해제 검사를 수행합니다 (Android만).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithBusyBox();detectRootManagementApps
__CAPGO_KEEP_0__루트 관리 앱이 있는지 감지합니다 (Android만).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectRootManagementApps();detectPotentiallyDangerousApps
__CAPGO_KEEP_0____CAPGO_KEEP_0__ (Android만 지원합니다.)
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectPotentiallyDangerousApps();detectTestKeys
__CAPGO_KEEP_2____CAPGO_KEEP_0__ (Android만 지원합니다.)
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectTestKeys();checkForBusyBoxBinary
__CAPGO_KEEP_2____CAPGO_KEEP_0__ (Android만 지원합니다.)
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForBusyBoxBinary();checkForSuBinary
__CAPGO_KEEP_2____CAPGO_KEEP_0__ (Android만 지원합니다.) su __CAPGO_KEEP_1__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForSuBinary();checkSuExists
__CAPGO_KEEP_0____CAPGO_KEEP_1__ Android에서만 실행할 수 있는 바이너리인지 감지합니다. su __CAPGO_KEEP_2__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkSuExists();checkForRWPaths
__CAPGO_KEEP_4__ Android에서만 시스템 경로가 world writable인지 감지합니다.__CAPGO_KEEP_5__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForRWPaths();checkForDangerousProps
__CAPGO_KEEP_7__ Android에서만 시스템 속성이 위험한지 감지합니다.__CAPGO_KEEP_8__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForDangerousProps();checkForRootNative
__CAPGO_KEEP_10____CAPGO_KEEP_11__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForRootNative();detectRootCloakingApps
‘detectRootCloakingApps’ 섹션루트를 숨길 수 있는 앱을 감지합니다 (안드로이드 전용).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectRootCloakingApps();isSelinuxFlagInEnabled
‘isSelinuxFlagInEnabled’ 섹션SELinux 강제 실행 상태를 확인합니다 (안드로이드 전용).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isSelinuxFlagInEnabled();isExistBuildTags
‘isExistBuildTags’ 섹션OS 이미지를 위한 테스트 빌드 태그를 감지합니다 (안드로이드 전용).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isExistBuildTags();doesSuperuserApkExist
‘doesSuperuserApkExist’ 섹션슈퍼유저 APK가 설치되어 있는지 감지합니다 (안드로이드 전용).
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.doesSuperuserApkExist();isExistSUPath
__CAPGO_KEEP_1____CAPGO_KEEP_2__ su __CAPGO_KEEP_3__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isExistSUPath();checkDirPermissions
__CAPGO_KEEP_1____CAPGO_KEEP_4__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkDirPermissions();checkExecutingCommands
__CAPGO_KEEP_1____CAPGO_KEEP_5__ which su __CAPGO_KEEP_0__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkExecutingCommands();checkInstalledPackages
설치된 패키지 확인안드로이드 전용으로 의심스러운 설치된 패키지를 감지합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkInstalledPackages();checkforOverTheAirCertificates
OTA 인증서 확인안드로이드 전용으로 조작된 OTA 인증서를 감지합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkforOverTheAirCertificates();isRunningOnEmulator
안드로이드 전용으로 일반 에뮬레이터 지문 감지를 수행합니다.클립보드에 복사
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRunningOnEmulator();simpleCheckEmulator
클립보드에 복사설정
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckEmulator();simpleCheckSDKBF86
__CAPGO_KEEP_0__x86 에뮬레이터 지문 (Android only) 감지
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckSDKBF86();simpleCheckQRREFPH
QC 참조 전화 빌드 (Android only) 감지__CAPGO_KEEP_2__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckQRREFPH();simpleCheckBuild
__CAPGO_KEEP_4____CAPGO_KEEP_5__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckBuild();checkGenymotion
__CAPGO_KEEP_7____CAPGO_KEEP_8__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGenymotion();checkGeneric
Section titled “checkGeneric”Android 전용으로 일반 에뮬레이터 지문( fingerprint )을 감지합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGeneric();checkGoogleSDK
Section titled “checkGoogleSDK”Android 전용으로 Google SDK 에뮬레이터 지문( fingerprint )을 감지합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGoogleSDK();togetDeviceInfo
Section titled “getDeviceInfo”디바이스 정보를 반환합니다.
디바이스에 대한 추가 정보와 메타데이터를 제공합니다. 디바이스에 대한 정보를 수집한 루트 감지 프로세스의 추가 정보입니다. 디버깅 및 로깅 목적으로 유용합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
const deviceInfo = await IsRoot.togetDeviceInfo();console.log('Device info:', deviceInfo);isRootedWithEmulator
Section titled “isRootedWithEmulator”Android 전용으로 에뮬레이터 지문( fingerprint )을 감지하는 기본 감지 기능을 확장합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithEmulator();isRootedWithBusyBoxWithEmulator
__CAPGO_KEEP_1____CAPGO_KEEP_2__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithBusyBoxWithEmulator();__CAPGO_KEEP_3__
__CAPGO_KEEP_1__DetectionResult
__CAPGO_KEEP_4____CAPGO_KEEP_5__
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_0____CAPGO_KEEP_7__
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 작업을 계획하려면 Using @capgo/capacitor-is-root Using @capgo/capacitor-is-root API 개요 API 개요에 대한 구현 세부 정보를 위해 소개 __CAPGO_KEEP_0__ 키에 대한 구현 세부 정보를 위해 API 키 API 키에 대한 구현 세부 정보를 위해 장치 __CAPGO_KEEP_0__에 대한 구현 세부 정보를 위해