@capgo/capacitor-is-root の使用
Capacitor は、root化されたAndroidデバイスや脱獄されたiOSデバイスを検出するIs Rootプラグインです。
インストール
bun add @capgo/capacitor-is-root
bunx cap sync
bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。
インポート
import { IsRoot } from '@capgo/capacitor-is-root';
API の概要
| メソッド | 説明 |
|---|---|
isRooted |
デフォルトのルート/脱獄検知チェックを実行します。 |
isRootedWithBusyBox |
デフォルトの検知をBusyBox固有のチェックで拡張します(Androidのみ)。 |
detectRootManagementApps |
既知のルート管理アプリが存在するか検出します(Android のみ)。 |
detectPotentiallyDangerousApps |
ルート済みデバイスに存在する可能性のある危険なアプリを検出します(Android のみ)。 |
detectTestKeys |
デバッグ/テストビルドタグを検出します(Android のみ)。 |
checkForBusyBoxBinary |
デバイスに BusyBox バイナリが存在するか確認します(Android のみ)。 |
checkForSuBinary |
が su バイナリが存在するか確認します(Android のみ)。 |
checkSuExists |
が su バイナリが実行可能かどうかを確認します(Android のみ)。 |
checkForRWPaths |
全ユーザーが書き込み可能なシステムパスを検出します(Android のみ)。 |
checkForDangerousProps |
危険なシステムプロパティを検出します(Android のみ)。 |
checkForRootNative |
RootBeer のネイティブチェックを実行します(Android のみ)。 |
detectRootCloakingApps |
root を隠蔽できるアプリを検出します(Android のみ)。 |
isSelinuxFlagInEnabled |
SELinux の強制状態を確認します(Android のみ)。 |
isExistBuildTags |
OS イメージのテストビルドタグを検出します(Android のみ)。 |
doesSuperuserApkExist |
スーパーユーザー APK がインストールされているか検出します(Android のみ)。 |
isExistSUPath |
既知の su バイナリの配置場所を確認します(Android のみ)。 |
checkDirPermissions |
保護対象の書き込み可能ディレクトリを検出します(Android のみ)。 |
checkExecutingCommands |
実行します which su style コマンドで root 化を検知します(Android のみ)。 |
checkInstalledPackages |
不審なインストール済みパッケージを検知します(Android のみ)。 |
checkforOverTheAirCertificates |
改ざんされた OTA 証明書を検知します(Android のみ)。 |
isRunningOnEmulator |
一般的なエミュレータのフィンガープリントを検知します(Android のみ)。 |
simpleCheckEmulator |
軽量なエミュレータチェックを実行します(Androidのみ)。 |
simpleCheckSDKBF86 |
x86エミュレータのフィンガープリントを検出します(Androidのみ)。 |
simpleCheckQRREFPH |
QCリファレンス端末のビルドを検出します(Androidのみ)。 |
simpleCheckBuild |
ビルドホストの異常を検出します(Androidのみ)。 |
checkGenymotion |
Genymotion エミュレータのフィンガープリントを検出します(Android のみ)。 |
checkGeneric |
一般的なエミュレータのフィンガープリントを検出します(Android のみ)。 |
checkGoogleSDK |
Google SDK エミュレータのフィンガープリントを検出します(Android のみ)。 |
togetDeviceInfo |
検出時に収集されたデバイス情報を返します。 |
isRootedWithEmulator |
エミュレータのヒューリスティックでデフォルトの検知を拡張します(Androidのみ)。 |
isRootedWithBusyBoxWithEmulator |
BusyBox検知をエミュレータのヒューリスティックで拡張します(Androidのみ)。 |
例
isRooted()
デフォルトのルート/脱獄検知チェックを実行します。
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()
既知のルート管理アプリが存在するか検出します(Android のみ)。
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectRootManagementApps();
console.log(result);
detectPotentiallyDangerousApps()
ルート化されたデバイスでよく見られる、危険な可能性があるアプリを検出します(Android のみ)。
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectPotentiallyDangerousApps();
console.log(result);
detectTestKeys()
デバッグ/テストビルドタグを検出します(Android のみ)。
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.detectTestKeys();
console.log(result);
checkForBusyBoxBinary()
デバイス上に BusyBox バイナリが存在するか確認します(Android のみ)。
import { IsRoot } from '@capgo/capacitor-is-root';
const result = await IsRoot.checkForBusyBoxBinary();
console.log(result);
上記の表には 31 個のコアメソッドが記載されています。リスナーとバージョンヘルパー、各メソッドの完全な仕様については、 GitHub リポジトリ.
完全なリファレンス
「@capgo/capacitor-is-root の使用」から続ける
使用している場合 @capgo/capacitor-is-root の使用 ネイティブプラグインの作業を計画するには、次と連携してください: @capgo/capacitor-is-root @capgo/capacitor-is-root の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor Plugins の実装詳細、および プラグインの追加または更新 プラグインの追加または更新に関する実装詳細についてはこちら。