Per iniziare

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-mock-location-detector`
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/mock-location-detector/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.

Installa

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

Importa

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

Avvio rapido

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

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

Esempio: analyze

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

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

Esempio: runCheck

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

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

Errori comuni

Listener: rimuovi gli handle quando gli schermi vengono smontati.
Sync nativo: esegui bunx cap sync dopo gli aggiornamenti dei plugin.
Fonte di verità: fidati src/definitions.ts nel repo GitHub.

Workflow consigliato

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

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

Esegui un controllo

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

Monitoraggio continuo

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

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

Guida gli utenti alle impostazioni

Le app non possono disattivare automaticamente la modalità sviluppatore o la posizione fittizia. Apri le impostazioni:

await MockLocationDetector.openDeveloperSettings();

Configurazione delle piattaforme

iOS: Setup iOS
Android: Configurazione Android

Fonte di verità

Questa pagina segue la documentazione del plugin src/definitions.ts. Esegui nuovamente docgen upstream quando cambia la API pubblica.