LocationMax

简体中文 | English below

LocationMax 是一款面向已 Root Android 设备的 Xposed/LSPosed 定位模拟模块。它支持地图选点、地点搜索、常用地点收藏、位置参数配置，并可向用户在 LSPosed 中选择的目标应用提供模拟位置。

本项目仅用于合法测试、应用调试以及设备所有者明确授权的场景。

主要功能

通过地图或地点搜索选择模拟位置。
收藏和快速切换常用地点。
向 LSPosed 中选定的目标应用提供位置数据。
支持精度、海拔、速度和随机偏移等参数。
提供系统级位置处理与 Mock Provider 备用模式。
支持可选的外部控制和远程状态配置。

运行要求

Android 11 / API 30 或更高版本。
已取得 Root 权限。
已安装并正常运行 LSPosed 或兼容的 Xposed 框架。
已向 LocationMax 授予需要的位置权限。

安装与使用

从 GitHub Releases 下载并安装最新版 LocationMax-release.apk。
打开 LSPosed 管理器并启用 LocationMax。
在模块作用域中选择需要测试的目标应用。
仅在需要系统级位置处理时选择“系统框架（android）”。
打开 LocationMax，通过地图或搜索设置位置参数。
强制停止并重新打开目标应用；仍未生效时，重启目标应用或设备后再测试。

不建议无目的地勾选全部应用。作用域越大，兼容性风险和资源占用越难排查。

下载

兼容性说明

LocationMax 当前面向 Android 11 及以上系统。不同 ROM、LSPosed 版本和目标应用版本可能存在差异。目标应用更新后，其内部位置接口可能变化，部分功能可能暂时失效。

出现闪退、目标应用无法启动或位置异常时，请先在 LSPosed 中停用 LocationMax，强制停止目标应用并重启设备，再收集日志进行排查。

常见问题

模块显示未激活

确认 LocationMax 已在 LSPosed 中启用，并且已经选择正确的作用域。随后强制停止目标应用或重启设备。

目标应用仍然读取真实位置

确认目标应用已经加入作用域，并检查系统定位、Mock Provider、网络定位以及系统级 Hook 设置。部分应用可能同时读取多种位置来源。

启用后应用闪退

先缩小作用域，只保留一个测试应用。关闭系统级 Hook 后重新测试，并在反馈时附上 LSPosed 日志和 Logcat。

问题反馈

请通过本仓库的 Issues 页面反馈问题，并尽量提供：

手机型号与 ROM 版本
Android 版本
Root 方案与版本
LSPosed 版本
LocationMax 版本
目标应用名称与版本
已选择的作用域
复现步骤
LSPosed 日志或 Logcat

网络与隐私说明

LocationMax 的地图、地点搜索以及可选的远程状态功能可能需要网络访问。远程控制地址通过构建参数注入，仓库不保存私人服务器地址、签名密钥或账号凭据。使用者应根据自己的构建配置和所使用的地图服务检查实际网络请求。

构建

构建环境：

JDK 21
Android SDK 36

.\gradlew.bat :app:assembleDebug :app:assembleRelease

Release 输出：

app/build/outputs/apk/release/app-release.apk

文档

免责声明

本项目仅供合法测试、软件调试以及设备所有者明确授权的用途。请勿将其用于违反法律法规、平台规则、服务条款或侵犯他人权益的行为。安装 Xposed/LSPosed 模块会改变应用或系统组件的运行行为，使用者应自行评估兼容性和数据风险。

License

LocationMax is distributed under the MIT License. See LICENSE and NOTICE.md.

English

LocationMax is an independently maintained Android Xposed/LSPosed location simulation module for rooted devices. It provides map-based point selection, place search, favorites, configurable location parameters, scoped handling for user-selected target apps, system-level handling, and a mock-provider fallback.

Requirements: Android 11 or newer, root access, and LSPosed or another compatible Xposed framework.

Use this project only for lawful testing, application debugging, and device-owner-authorized scenarios. Select only the scopes that are necessary for your test environment.