GoGoGo（影梭）——Android 虚拟定位工具教程笔记

共计 1987 个字符，预计需要花费 5 分钟才能阅读完成。

无需 Root，基于 Android 调试 API 与百度地图 / 定位 SDK，内置摇杆可模拟移动。项目采用 GPL-3.0-only 许可。(GitHub)

1. 项目概览

• 仓库：ZCShou/GoGoGo（GitHub 主仓；提供 Releases APK 与源码）
• 定位：Android 8.0+ 可用；作者明确说明 HarmonyOS 也可正常运行。
• 核心特性：位置修改、摇杆模拟移动、历史记录、地点搜索、坐标直输。
• 最新版本 ：v1.12.3（2025-08-09），更新百度地图 SDK、修复历史记录白屏、坐标可输入负数等。
  参考：项目 README / Releases 说明。(GitHub)

维护者也在 README 中强调：本项目仅供学习，请勿用于校园运动类 App 或任何作弊场景；并提示某些 App（如微信）可能无效。(GitHub)

2. 快速上手（APK 安装法）

适合想直接使用而非二开的人。

1. 前往 GitHub Releases 页面，下载最新 APK 并安装。(GitHub)
2. 首次启动授予位置等必要权限，进入主界面。
3. 在地图上 单击目标位置 → 点击 启动 按钮启用模拟；可用 摇杆 在该位置附近持续移动。(GitHub)

常见现象与说明

• 若偶尔“飘回真实位置”，多由系统仍开启蜂窝 /Wi-Fi 等其它定位通道所致（调试 API 的固有限制）。可在测试时尽量降低其它定位信号干扰。(GitHub)
• 个别厂商 / 应用会主动检测或屏蔽模拟定位（例如微信系等），属对方策略限制。(GitHub)

3. 设备设置要点（可选但推荐）

以下做法可提升“稳定性 / 一致性”，减轻回跳与冲突（不同机型项名略有差异）：

• 检查 开发者选项 中“模拟位置信息应用 /Mock location app”等相关入口（不同系统名称可能不同）。(百度知道)
• 某些机型如仍受干扰，可尝试关闭 Wi-Fi/ 蓝牙 扫描 或将定位模式调成更“单一”的来源，以减少与系统真实定位源的竞争（原因见 README 对“飘回真实位置”的解释）。(GitHub)
• Android 官方 API 支持识别“是否为 Mock 位置”（Location.isMock(...)），部分 App 会据此进行风控检测，这也是不同 App 表现差异的根源之一。(Android Developers)

4. 从源码构建（Android Studio）

适合需要二次开发或安全审计的人。

1. 克隆仓库 并用 Android Studio 打开；同步 Gradle。
2. JDK/Gradle 对齐：若编译报 Java 版本错误，按 README 提示统一 Android Studio 使用的 JDK 与 JAVA_HOME。(GitHub)
3. 构建：在 Android Studio 选择 Build > Make Project 或命令行执行 ./gradlew assembleRelease 生成 APK。
4. 百度地图 / 定位 SDK：项目持续跟进 SDK 版本（见变更记录），如需替换 Key 或升级 SDK，请按你企业合规流程配置。(GitHub)

参考资料（原理层面）：Android 模拟位置典型做法通常基于 LocationManager 的测试提供者与调试接口（例如 setTestProviderLocation / AppOps 中的 android:mock_location 等），不同 Android 版本与签名策略会影响能力边界。(陈文管的博客)

5. 使用技巧

• 历史记录 & 搜索：可保存并快速回到常用坐标，也可直接输入经纬度（v1.12.3 起支持负数）。(GitHub)
• 海拔设置：较新版本新增了高度参数设置入口，便于某些对高度敏感的场景调试。(GitHub)
• 摇杆调优：版本更新对摇杆图标比例做了优化；遇到交互不顺畅可升级到较新版本。(GitHub)

6. FAQ 快扫

• 支持版本：Android 8.0+；作者实测 HarmonyOS 可运行。(GitHub)
• 为何在某些 App 无效？ 应用层风控与定位通道策略不同（如微信系），非工具缺陷。(GitHub)
• 定位“回跳”：系统仍在并行使用蜂窝 /Wi-Fi 等真实定位源所致。(GitHub)
• 编译报错（JDK）：统一 Gradle/Android Studio 的 Java 版本或 JAVA_HOME。(GitHub)

7. 合规与许可

• 许可证：GPL-3.0-only。若进行二次分发 / 改名等，请严格遵循开源协议；作者曾在 README 明确提醒。(GitHub)
• 合规声明：仅供学习 / 测试 / 开发。请遵守各平台 / 应用的服务条款及当地法律法规。(GitHub)

8. 延伸阅读

• 官方仓库（概览 / 功能 / 用法 /FAQ/ 截图）。(GitHub)
• Releases（下载 APK、查看更新日志与修复项）。(GitHub)
• HelloGitHub 项目条目（第三方概述与活跃度）。(HelloGitHub)
• Android Location 文档（Mock 检测 API 语义）。(Android Developers)
• Android 模拟定位原理与 AppOps 命令参考（进阶 / 系统层理解）。(陈文管的博客)