跳转至正文
@capgo/capacitor-mock-location-detector 身份验证与安全 开源

模拟位置检测器 Capacitor 插件

检测模拟 GPS 位置及用于应用欺骗的开发者工具

安装

bun add @capgo/capacitor-mock-location-detector bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-mock-location-detector
  • pnpm add @capgo/capacitor-mock-location-detector
  • yarn add @capgo/capacitor-mock-location-detector

指南

如何在 Capacitor 中使用 Mock Location Detector

使用 @capgo/capacitor-mock-location-detector

通过 iOS 和 Android 上多层且符合 App Store 安全规范的检测,识别模拟的 GPS 位置。

安装

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

插件暴露的内容

  • analyze - 运行所有可用检查并返回评分后的综合结果。
  • runCheck - 执行指定的检测层。
  • getCapabilities - 发现当前平台支持的检查项。
  • startMonitoring / stopMonitoring - 通过事件进行定期分析。
  • openDeveloperSettings - 引导用户禁用开发者工具或模拟工具。

用法示例

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);
}

await MockLocationDetector.openDeveloperSettings();

完整参考

常见问题

Mock Location Detector 插件常见问题

如何在 Capacitor 应用中安装 Mock Location Detector 插件?

运行 "bun add @capgo/capacitor-mock-location-detector"(或 "npm install @capgo/capacitor-mock-location-detector"),然后运行 "bunx cap sync",使 iOS 和 Android 项目同步 native code。最后在你的应用 code 中从 "@capgo/capacitor-mock-location-detector" 导入即可。

@capgo/capacitor-mock-location-detector 是否支持 React、Vue 和 Angular?

支持。Mock Location Detector 是一个 Capacitor 包,因此它支持任何在 Capacitor 中运行的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 以及原生 JavaScript。

@capgo/capacitor-mock-location-detector 支持哪个版本的 Capacitor?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-mock-location-detector 是免费开源的吗?

是的。code 的源码已在 GitHub 公开,地址为 https://github.com/Cap-go/capacitor-mock-location-detector/,并且可以通过 npm 免费安装。欢迎提交 Bug 报告和 Pull Request。

我可以在不经过 App Store 审核的情况下,更新使用了 Mock Location Detector 的 code 吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待 App Store 审核,即可快速发布 Mock Location Detector 的更新

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo