スタートガイド

インストール

bun add @capgo/capacitor-mock-location-detector
bunx cap sync

インポート

import { MockLocationDetector } from '@capgo/capacitor-mock-location-detector';

クイックスタート

import { MockLocationDetector } from '@capgo/capacitor-mock-location-detector';

const result = await MockLocationDetector.getCapabilities();
console.log(result);

例: analyze

import { MockLocationDetector } from '@capgo/capacitor-mock-location-detector';

const result = await MockLocationDetector.analyze();
console.log(result);

例: runCheck

import { MockLocationDetector } from '@capgo/capacitor-mock-location-detector';

const result = await MockLocationDetector.runCheck({ check: 'system_mock_flag' });
console.log(result);

よくある落とし穴

• リスナー: 画面がアンマウントされたらハンドルを削除します。
• ネイティブ同期: 実行 bunx cap sync プラグインのアップグレード後。
• 信頼できる情報源: 信頼 src/definitions.ts GitHub リポジトリ内。

推奨フロー

const result = await MockLocationDetector.analyze({
  requestLocationSample: true,
  minDetectedChecks: 1,
});

if (result.isSimulated) {
  console.warn('Possible GPS spoofing detected', result.riskScore, result.checks);
}

単発のチェックを実行

const mockFlag = await MockLocationDetector.runCheck({
  check: 'system_mock_flag',
});

継続的に監視

await MockLocationDetector.addListener('locationIntegrityChanged', (event) => {
  console.log('Integrity changed', event.confidence, event.checks);
});

await MockLocationDetector.startMonitoring({ intervalMs: 30000 });

ユーザーを設定画面へ誘導

アプリから開発者モードやモックロケーションを自動で無効化することはできません。代わりに設定画面を開いてください：

await MockLocationDetector.openDeveloperSettings();

プラットフォームのセットアップ

• iOS: iOSの設定
• Android: Androidの設定

Source of Truth

このページはプラグインの src/definitions.tsに従います。パブリックの API が変更された場合は、アップストリームで docgen を再実行してください。