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.
Capgo의 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-rootbunx cap syncimport { IsRoot } from '@capgo/capacitor-is-root';API 개요
API 개요isRooted
__CAPGO_KEEP_0____CAPGO_KEEP_0__
__CAPGO_KEEP_0__
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____CAPGO_KEEP_0__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithBusyBox();detectRootManagementApps
__CAPGO_KEEP_1____CAPGO_KEEP_2__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectRootManagementApps();detectPotentiallyDangerousApps
__CAPGO_KEEP_3____CAPGO_KEEP_4__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectPotentiallyDangerousApps();detectTestKeys
__CAPGO_KEEP_5____CAPGO_KEEP_0__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.detectTestKeys();checkForBusyBoxBinary
__CAPGO_KEEP_0____CAPGO_KEEP_7__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForBusyBoxBinary();checkForSuBinary
checkForSuBinary 섹션Android에서만 존재하는 su 바이너리가 존재하는지 확인합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForSuBinary();checkSuExists
checkSuExists 섹션Android에서만 존재하는 su 바이너리가 실행될 수 있는지 감지합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkSuExists();checkForRWPaths
checkForRWPaths 섹션Android에서만 존재하는
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForRWPaths();checkForDangerousProps
checkForDangerousProps안드로이드 전용으로 시스템 속성을 감지합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkForDangerousProps();checkForRootNative
checkForRootNative안드로이드 전용으로 RootBeer 네이티브 체크를 실행합니다.
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
__CAPGO_KEEP_0____CAPGO_KEEP_1__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isExistBuildTags();doesSuperuserApkExist
__CAPGO_KEEP_3____CAPGO_KEEP_4__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.doesSuperuserApkExist();isExistSUPath
__CAPGO_KEEP_6____CAPGO_KEEP_7__ su __CAPGO_KEEP_8__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isExistSUPath();checkDirPermissions
__CAPGO_KEEP_10____CAPGO_KEEP_11__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkDirPermissions();checkExecutingCommands
__CAPGO_KEEP_1____CAPGO_KEEP_2__ which su __CAPGO_KEEP_3__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkExecutingCommands();checkInstalledPackages
__CAPGO_KEEP_5____CAPGO_KEEP_6__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkInstalledPackages();checkforOverTheAirCertificates
__CAPGO_KEEP_8____CAPGO_KEEP_9__
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkforOverTheAirCertificates();isRunningOnEmulator
__CAPGO_KEEP_11____CAPGO_KEEP_0__ (Android 전용)
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRunningOnEmulator();simpleCheckEmulator
simpleCheckEmulator 섹션__CAPGO_KEEP_2__ (Android 전용)
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckEmulator();simpleCheckSDKBF86
simpleCheckSDKBF86 섹션__CAPGO_KEEP_0__ (Android 전용)
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckSDKBF86();simpleCheckQRREFPH
simpleCheckQRREFPH 섹션__CAPGO_KEEP_0__ (Android 전용)
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckQRREFPH();simpleCheckBuild
simpleCheckBuild 섹션Android에서만 빌드 호스트 이상치를 감지합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.simpleCheckBuild();checkGenymotion
checkGenymotion 섹션Android에서만 Genymotion 에뮬레이터 지문( fingerprint )을 감지합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGenymotion();checkGeneric
checkGeneric 섹션Android에서만 일반 에뮬레이터 지문( fingerprint )을 감지합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGeneric();checkGoogleSDK
checkGoogleSDK 섹션Android에서만 Google SDK 에뮬레이터 지문( fingerprint )을 감지합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.checkGoogleSDK();togetDeviceInfo
getDeviceInfo 섹션장치 정보를 감지 중인 동안 수집된 장치 정보를 반환합니다.
디바이스 감지 프로세스의 루트 감지 과정에서 수집된 장치에 대한 추가 정보와 메타데이터를 제공합니다. 디버깅 및 로깅 목적으로 유용합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
const deviceInfo = await IsRoot.togetDeviceInfo();console.log('Device info:', deviceInfo);isRootedWithEmulator
‘isRootedWithEmulator’라는 제목의 섹션안드로이드 전용으로 에뮬레이터 힙틱스를 확장하여 기본 감지를 확장합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithEmulator();isRootedWithBusyBoxWithEmulator
‘isRootedWithBusyBoxWithEmulator’라는 제목의 섹션안드로이드 전용으로 에뮬레이터 힙틱스를 확장하여 BusyBox 감지를 확장합니다.
import { IsRoot } from '@capgo/capacitor-is-root';
await IsRoot.isRootedWithBusyBoxWithEmulator();타입 참조
‘타입 참조’라는 제목의 섹션DetectionResult
‘감지 결과’라는 제목의 섹션__CAPGO_KEEP_0__ 변경 사항이 업스트림에서 변경될 때마다 다시 싱크를 실행하세요.
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
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에서 계속하기
Getting Started에서 계속하기 섹션__CAPGO_KEEP_0__ 변경 사항이 업스트림에서 변경될 때마다 다시 싱크를 실행하세요. 시작하기 API 대시보드와 API 운영을 계획하고 연결하는 방법입니다. @capgo/capacitor-is-root를 사용하여 @capgo/capacitor-is-root를 사용하여 native 기능을 구현하는 방법입니다. API 개요 API 개요에서 구현 세부 정보를 확인하세요. 소개 소개에서 구현 세부 정보를 확인하세요. API 키 API 키에서 구현 세부 정보를 확인하세요. 장치 장치에서 구현 세부 정보를 확인하세요.