# @capgo/capacitor-mock-location-detector 中文文档

规范地址：https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/

版本：8\.0\.10
npm 元数据更新时间：2026-10-15T01:46:55.355Z
中文译文更新时间：2026-11-09T03:31:38.832Z
软件包许可：MPL-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40capgo/capacitor-mock-location-detector
原文对照：https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/?lang=original
项目主页：https://capgo.app/docs/plugins/mock-location-detector/
源码仓库：https://github.com/Cap-go/capacitor-mock-location-detector

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：145 kB，27 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@capacitor/core \>=8\.0\.0
- 首次发布：2026-06-25T13:51:06.261Z
- 最新版本发布：2026-10-15T01:46:55.035Z
- 近 30 天下载量：47261（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

用于检测模拟GPS位置的电容插件,以及开发者能够对应用软件进行偷窥的工具化.

## 安装

```sh
npm install @capgo/capacitor-mock-location-detector
```

也可以使用：`pnpm add @capgo/capacitor-mock-location-detector`、`yarn add @capgo/capacitor-mock-location-detector`、`bun add @capgo/capacitor-mock-location-detector`

## README

# @ capgo/ 电容- 位置- 检测器

检测假的GPS 和位置 在你的Capacitor app中 与分层,App Store 安全检查iOS和Android。 保护报到、送货和地点奖励.

[![Capgo - Build Capacitor apps with AI, ship updates instantly](https://capgo.app/readme-banner.svg?repo=Cap-go/capacitor-mock-location-detector)](https://capgo.app/?ref=plugin_mock_location_detector)

**队长**:在几分钟内将修正推给您的 Capacitor 用户,在没有Mac的情况下构建已签名的iOS和Android apps,并在一击中回滚.

## [\*免费开始\*](https://capgo.app/register/?ref=plugin_mock_location_detector)

14天无限自由审判. 不需要信用卡

> 🤖 **建筑与AI编码代理?** 安装 [Capgo 技能](https://capgo.app/skills/?ref=plugin_mock_location_detector) 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 `@capgo/capacitor-mock-location-detector` 在您的电容应用程序中: `npx skills add Cap-go/capgo-skills`。然后问你的经纪人: _添加@capgo/capor-mock-location-detector到我的Capacitor应用软件上并把它接上"_ [代理设置指南](https://capgo.app/agents/?ref=plugin_mock_location_detector) • 妇女 [主机磁共振](https://capgo.app/docs/ai/mcp/?ref=plugin_mock_location_detector)

![@capgo/capacitor-mock-location-detector for Capacitor apps](https://raw.githubusercontent.com/Cap-go/capacitor-mock-location-detector/main/assets/github-social-preview.png)

## 主要特点

-   **全面分析**数字 : `analyze()` 返回时 `isSimulated`,一个信任水平,一个 `riskScore` 和触发的检查.
-   **单次检查**数字 : `runCheck()` 对于模拟旗,模拟位置应用程序,开发者选项,亚行,模拟器,位置异常和运动相关性.
-   **监测**数字 : `startMonitoring()` 编辑 `locationIntegrityChanged` 当判决改变时.
-   **能力**数字 : `getCapabilities()` 列出平台支持的检查.
-   **开发者设置**数字 : `openDeveloperSettings()` 安卓号.
-   **平台**: iOS和Android. 互联网档案馆的存檔,存档日期2013-12-21. 在网上不可用.

## 抓图

-   **插件名称 :** `@capgo/capacitor-mock-location-detector`
-   **一行数值 :** Capacitor apps的多层 GPS 扫描和开发工具检测
-   **维护者 :** 队长
-   **状态 :** β 语录

## 问题范围( S)

### 此插件为何存在

Pokeep和iMyFone AnyTo等工具可以对设备定位进行搜索. iOS等一面旗帜 `isSimulatedBySoftware` 不可靠 与每一种欺骗方法。 这个插件结合了多个独立信号,因此您的应用可以做出更好的预防欺诈的决定.

### 它会做什么

-   运行分层检查:系统模拟旗帜、开发者选项、已知的模拟应用程序、运动热度和运动相关性
-   返回已记分 `LocationIntegrityResult` 详细情况
-   支持与 `locationIntegrityChanged` 事件
-   打开最佳设置屏幕, 让用户可以禁用开发者/ 模拟工具

### 它不会做的

-   无法在程序上禁用开发者模式或模拟位置设置( iOS/ Android 不允许)
-   无法保证100%检测到每个未来的偷窥工具
-   在 iOS 上, Apple 没有公开的 API 读取直接切换的开发者模式

## 兼容性

| 插件版本 | 电容兼容性 | 维护 |
| --- | --- | --- |
| 联合国 | 联合国 | ✅ |
| 页:1 | 页:1 | 应要求 |
| 页:1 | 页:1 | 应要求 |

## 安装

```bash
npm install @capgo/capacitor-mock-location-detector
npx cap sync
```

## 设置

### iOS系统

在您的应用程序中添加位置使用描述 `Info.plist`数字 :

```xml
<key>NSLocationWhenInUseUsageDescription</key>
<string>We verify your location has not been spoofed.</string>
```

可选: 为您想要检测的 company spoof apps 声明 URL 方案 :

```xml
<key>LSApplicationQueriesSchemes</key>
<array>
  <string>anyto</string>
  <string>fakegps</string>
</array>
```

### 机器人

确保您的应用程序请求运行时间位置权限 。 插件在其显示的合并中声明粗细/精细位置权限 .

## 使用量

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

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

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

// Guide the user, apps cannot disable developer mode automatically
await MockLocationDetector.openDeveloperSettings();
```

运行一个检查层 :

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

开始监视 :

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

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

## 检查层

| 检查身份 | iOS系统 | 机器人 | 说明 |
| --- | --- | --- | --- |
| `system_mock_flag` | ✅ | ✅ | 目前位置固定上的OS模拟/模拟旗帜 |
| `developer_options` | \- 说吧 | ✅ | Android 开发者选项已启用 |
| `developer_mode_indicators` | ✅ | ✅ | 间接开发者/ 调试者构建时速 |
| `mock_location_app` | ✅ | ✅ | 已知的 spoof 应用软件包/ URL 方案 |
| `adb_enabled` | \- 说吧 | ✅ | 启用 USB 调试 |
| `mock_provider_settings` | \- 说吧 | ✅ | 准予模拟地点许可的申请 |
| `location_anomaly` | ✅ | ✅ | 无法移动速度/ 远程端口热力 |
| `motion_correlation` | ✅ | \- 说吧 | GPS 移动不匹配加速计活动 |
| `simulator` | ✅ | ✅ | 模拟/模拟环境 |

## Capgo 链接

-   **插件文件 URL :** `https://capgo.app/docs/plugins/mock-location-detector/`
-   **网站/文件重播:** `https://github.com/Cap-go/website`

-   [`getCapabilities()`](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-getcapabilities)
-   [`analyze(...)`](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-analyze)
-   [`runCheck(...)`](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-runcheck)
-   [`openDeveloperSettings()`](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-opendevelopersettings)
-   [`startMonitoring(...)`](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-startmonitoring)
-   [`stopMonitoring()`](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-stopmonitoring)
-   [`addListener('locationIntegrityChanged', ...)`](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-addlistenerlocationintegritychanged-)
-   [`getPluginVersion()`](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-getpluginversion)
-   [接口](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-interfaces)
-   [类型异名](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-type-aliases)

探测到模拟GPS位置和开发者工具,这些工具通常可以对应用软件进行扫描.

这个插件结合了多个独立检查,因为没有单一的OS旗是可靠的对抗 工具如 Pokeep 或 iMyFone AnyTo。 在iOS上,苹果公司不提供公共API来读取该版本 开发者模式直接切换;插件则使用App Store-safe Heuristics取而代之.

Apps 无法在程序上禁用开发者模式或模拟位置设置 。 使用 QQLink MocLocation DetectionorPlugin. open DevelopersSettings } 引导用户进入相关设置.

### 获取能力( )

```typescript
getCapabilities() => Promise<MockLocationDetectorCapabilities>
```

**回返情况:** `Promise<[MockLocationDetectorCapabilities](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-mocklocationdetectorcapabilities)>`

* * *

### 分析(...)

```typescript
analyze(options?: AnalyzeOptions | undefined) => Promise<LocationIntegrityResult>
```

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[AnalyzeOptions](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-analyzeoptions)` |

**回返情况:** `Promise<[LocationIntegrityResult](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-locationintegrityresult)>`

* * *

### 运行检查(...)

```typescript
runCheck(options: RunCheckOptions) => Promise<LocationCheckResult>
```

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[RunCheckOptions](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-runcheckoptions)` |

**回返情况:** `Promise<[LocationCheckResult](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-locationcheckresult)>`

* * *

### 打开开发者设置( C)

```typescript
openDeveloperSettings() => Promise<void>
```

* * *

### 启动监测(...)

```typescript
startMonitoring(options?: MonitoringOptions | undefined) => Promise<void>
```

启动本土平台背景完整性监控.

与 QQlink MockLocation 探测器Plugin.add listener 的对等以接收 `locationIntegrityChanged` 应用程序处于前景时的事件.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[MonitoringOptions](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-monitoringoptions)` |

* * *

### 停止监视 ()

```typescript
stopMonitoring() => Promise<void>
```

停止监控并释放本地位置的听众.

* * *

### 添加倾听器( “ 位置变化 ” ,...)

```typescript
addListener(eventName: 'locationIntegrityChanged', listenerFunc: (event: LocationIntegrityChangedEvent) => void) => Promise<PluginListenerHandle>
```

在 QQlink MockLocation DetectionorPlugin. startMonitoring 活动时聆听完整性更新 .

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| **`eventName`** | `'locationIntegrityChanged'` | 一定是这样 `'locationIntegrityChanged'`。 。 。 . |
| **`listenerFunc`** | `(event: [LocationIntegrityChangedEvent](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-locationintegritychangedevent)) => void` |  |

**回返情况:** `Promise<[PluginListenerHandle](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-pluginlistenerhandle)>`

* * *

### 获取 PluginVersion ()

```typescript
getPluginVersion() => Promise<PluginVersionResult>
```

**回返情况:** `Promise<[PluginVersionResult](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-pluginversionresult)>`

* * *

### 接口

#### 模拟探测器能力

| Prop | 类型 |
| --- | --- |
| **`platform`** | `[LocationIntegrityPlatform](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-locationintegrityplatform)` |
| **`availableChecks`** | `LocationCheckId[]` |
| **`supportsMonitoring`** | `boolean` |
| **`canOpenDeveloperSettings`** | `boolean` |

#### 集成结果

| Prop | 类型 |
| --- | --- |
| **`isSimulated`** | `boolean` |
| **`confidence`** | `[LocationIntegrityConfidence](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-locationintegrityconfidence)` |
| **`riskScore`** | `number` |
| **`platform`** | `[LocationIntegrityPlatform](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-locationintegrityplatform)` |
| **`checks`** | `LocationCheckResult[]` |
| **`developerMode`** | `[DeveloperModeResult](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-developermoderesult)` |
| **`locationSample`** | `[LocationSample](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-locationsample) | null` |
| **`recommendation`** | `string` |

#### 位置检查结果

| Prop | 类型 |
| --- | --- |
| **`id`** | `[LocationCheckId](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-locationcheckid)` |
| **`name`** | `string` |
| **`platform`** | `[LocationIntegrityPlatform](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-locationintegrityplatform)` |
| **`available`** | `boolean` |
| **`detected`** | `boolean` |
| **`message`** | `string` |
| **`metadata`** | `{ [key: string]: unknown; }` |

#### 开发者ModeResult

| Prop | 类型 |
| --- | --- |
| **`detected`** | `boolean` |
| **`canDetectDeveloperMode`** | `boolean` |
| **`checks`** | `LocationCheckResult[]` |

#### 地点样本

| Prop | 类型 |
| --- | --- |
| **`latitude`** | `number` |
| **`longitude`** | `number` |
| **`accuracy`** | `number` |
| **`altitude`** | `number` |
| **`speed`** | `number` |
| **`timestamp`** | `number` |

#### 分析选项

| Prop | 类型 |
| --- | --- |
| **`checks`** | `LocationCheckId[]` |
| **`requestLocationSample`** | `boolean` |
| **`locationTimeoutMs`** | `number` |
| **`minDetectedChecks`** | `number` |
| **`additionalMockAppPackages`** | `string[]` |
| **`additionalMockAppUrlSchemes`** | `string[]` |

#### 运行检查选项

| Prop | 类型 |
| --- | --- |
| **`check`** | `[LocationCheckId](https://npmcn.com/package/%40capgo/capacitor-mock-location-detector/#readme-locationcheckid)` |

#### 监测备选方案

| Prop | 类型 | 说明 | 默认 |
| --- | --- | --- | --- |
| **`intervalMs`** | `number` | 在监测活动期间,如何频繁地进行重新检查。 最小的5000毫秒(英语: 默认为30000. | `30000` |
| **`emitOnlyOnChange`** | `boolean` | 何时 `true`, (中文(简体) ), `locationIntegrityChanged` 仅在 `isSimulated`, (中文(简体) ), `confidence`, (中文(简体) ), `riskScore`,或触发检查ID更改。 总是会起火. | `true` |

#### 插件听筒

| Prop | 类型 |
| --- | --- |
| **`remove`** | `() => Promise<void>` |

#### 位置完整性 更改事件

当监测发现时, 由 QQlink MockLocation 探测器Plugin.add listener 所排放的有效载荷 一个新的诚信快照.

在拨打 QQlink MockLocation DetectionorPlugin. startMonitoring 之前, 登记听众 :

| Prop | 类型 | 说明 |
| --- | --- | --- |
| **`reason`** | `'interval' | 'location_update' | 'manual'` | 为什么这个快照被发布 `manual` 监控开始后的第一个快照 `interval` 定期重新检查(`intervalMs`) - (英语) `location_update` ——设备位置在监测时被改变(仅内部) |

#### 插件变压器

| Prop | 类型 |
| --- | --- |
| **`version`** | `string` |

### 类型异名

#### 位置 集成格式

`'ios' | 'android' | 'web'`

#### 位置检查

插件曝光的个人完整性检查 .

`'system_mock_flag' | 'developer_options' | 'developer_mode_indicators' | 'mock_location_app' | 'adb_enabled' | 'mock_provider_settings' | 'location_anomaly' | 'motion_correlation' | 'simulator'`

#### 地点 完整性

`'none' | 'low' | 'medium' | 'high'`

## 常见问题

### @capgo/capacitor-mock-location-detector 是什么？

用于检测模拟GPS位置的电容插件,以及开发者能够对应用软件进行偷窥的工具化\.

### 如何安装 @capgo/capacitor-mock-location-detector？

在项目目录运行 npm install @capgo/capacitor-mock-location-detector，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @capgo/capacitor-mock-location-detector 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @capgo/capacitor-mock-location-detector 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @capgo/capacitor-mock-location-detector 可以商用吗？

@capgo/capacitor-mock-location-detector 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。

### @capgo/capacitor-mock-location-detector 的下载量有多少？

根据 npm 官方下载统计，@capgo/capacitor-mock-location-detector 在 2026/10/09 – 2026/11/07 这 30 天内被下载 47,261 次，日均约 1,575 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @capgo/capacitor-mock-location-detector 还在维护吗？

最新版本 8\.0\.10 发布于 2026/10/15（25 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/06/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。