WeChat Location Bridge 是一个无界面的微信定位兼容桥接模块：它读取已安装的 XposedFakeLocation 通过 Android Location getter 提供的当前坐标，并将其适配到微信的原生定位回调与腾讯定位结果 getter。
XposedFakeLocation 仍是唯一的坐标与播放来源。本模块不保存坐标、不提供地图或播放控制，也不发送位置。
边界非常明确：静态作用域只有 com.tencent.mm，仅运行在微信 App 进程；不包含 system_server、Wi‑Fi/BSSID、设备身份处理、模拟位置检测绕过或其他非微信 hook。
已验证：微信 8.0.72 的发送位置与朋友圈签到定位。小程序适配目前标记为实验性，在完成公开、可复现的验证前不宣称已验证支持。
flowchart LR
XFL[XposedFakeLocation<br/>唯一坐标与播放来源]
GET[Android Location getter]
BRIDGE[WeChatLocationBridge<br/>仅 com.tencent.mm App 进程]
WX[微信进程<br/>原生定位回调 / 腾讯定位 getter]
XFL --> GET --> BRIDGE --> WX
- 安装 GitHub Release 中的签名 APK。
- 在 Modern Xposed 管理器中启用模块，并确认作用域只有
com.tencent.mm。 - 确认 XposedFakeLocation 已安装、已启用并正在播放有效坐标。
- 强制停止并重新打开微信。
本模块无独立设置界面，也不会替代 XposedFakeLocation 的配置。
- 作用域固定为
com.tencent.mm，不需要也不应添加其他包。 - 关闭本模块后强制停止并重启微信，微信恢复原始定位回调与结果。
- 停止 XposedFakeLocation 或没有有效坐标时，本模块透传原始值。
- 发现异常时，先关闭本模块并重启微信；不要通过扩大作用域来排查。
| 场景 | 版本 | 状态 | 说明 |
|---|---|---|---|
| 微信发送位置 | 8.0.72（Google Play 构建） | 已验证 | 原生地图回调 |
| 微信朋友圈签到定位 | 8.0.72（Google Play 构建） | 已验证 | 朋友圈签到回调 |
| 微信小程序定位 | 8.0.72（Google Play 构建） | 实验性 | 仅保留适配代码；公开可复现验收完成前不视为支持 |
新的微信渠道或版本必须经过精确 APK 分析和新的设备验收，不能把单一构建中观察到的类名推广成包范围 hook。
设备验收应在 GkAndroidLab 进行：包括设备预检、Vector 命令、回退快照、截图/日志和兼容矩阵。本仓库只维护可复用的回调适配器和单元测试。
验证原生微信定位界面与一个小程序时，只打开定位界面并观察结果，不发送位置；私有日志、数据库、截图和 APK 备份不得进入本仓库。
需要 JDK 21 与 Android SDK API 36。签名配置只保留在本机 .local-signing/，不要提交 keystore、密码或 APK。
.\gradlew.bat test assembleRelease输出 APK 位于 app/build/outputs/apk/release/app-release.apk。依赖 XposedFakeLocation 提供坐标来源，以及 Modern Xposed API 提供模块接口；本项目不复制它们的代码。
- MarsGao/WeChatLocationBridge 是唯一源码上游：代码、测试、构建和签名发布准备均在这里完成。
- Xposed-Modules-Repo/io.github.marsgao.wechatlocationbridge 是官方模块分发与索引仓库：用于
SUMMARY、SCOPE、双语说明和 Release APK，不是第二个源码项目。
后续版本必须先在源码上游完成测试、签名、APK 元数据和 SHA-256 校验，再将同一份 APK 与有意同步的元数据发布到官方仓库。两个仓库的版本号、Release 标签和校验值应保持可核对一致。
请先阅读 AGENTS.md。贡献应保持回调兼容性、单元测试和现有边界；不要加入 system/system_server、Wi‑Fi/BSSID、设备身份、检测绕过或非微信 hook。
提交 Bug 时请使用 Issue 表单，只提供脱敏日志、版本和可复现步骤。严禁提交真实坐标、聊天内容、设备序列号、数据库快照、完整设备日志或密钥材料。
本项目面向自有或获授权设备上的隐私、地图验证和应用开发工作。它不是反检测、风控绕过或位置身份伪造项目。坐标和播放状态由 XposedFakeLocation 管理，本模块不建立远程配置、不上传数据、不发送位置。
1.0.0 已创建官方模块分发仓库并提交 Release；模块站点完成机器人构建和索引前，状态仍是“待官方收录”，不要宣称已上架。
本项目采用 MIT License。