FEATURE 01
合成几何路径插值
基于 Haversine 球面测距与航向角公式实现分段线性插值，内置标准 400m 几何跑道等合成测试路径。
01 / 核心功能
FEATURE 02
离线轨迹画布预览
基于 Compose Canvas 实时绘制合成路线轨迹、当前插值点与运动指标面板，适配 200% 大字号缩放。
FEATURE 03
单一 Actor 状态机
使用协程 Channel 串行处理启动、暂停、调速与停止指令，结合 generationId 代次握手防止状态竞争。
FEATURE 04
标准 Mock Location 接口
仅调用 Android 官方公开的 LocationManager 测试位置 API，不包含任何 Root、Xposed 或进程注入代码。
02 / 工作流程与界面说明
STEP 01
配置开发者选项
在系统「开发者选项」中显式指定本应用为「模拟位置信息应用」。
STEP 02
选择合成几何路线
选择内置的 400m 标准几何椭圆跑道或折返测试线段，设置回放配速与模式。
STEP 03
启动前台测试服务
启动 MockLocationService，通过系统标准 TestProvider 广播测试坐标帧。
STEP 04
停止并清理资源
停止或重置测试时自动注销系统 TestProvider 并删除本地临时进度快照。
说明：已在 Android 14 (API 34) 模拟器通过 dumpsys location 验证系统测试位置广播与服务生命周期，暂未开放公开下载。
03 / 技术实现与开发说明
ARCHITECTURE & IMPLEMENTATION
- 采用 Kotlin、Jetpack Compose 与 Material 3 构建，分为领域几何层（GeoMath / RoutePlaybackEngine）、前台服务层（MockLocationService）与系统适配层（SystemLocationAdapter）。
- AndroidManifest.xml 显式设置 allowBackup=false 且不声明 INTERNET 权限，保证零联网、零遥测与本地状态隔离。
- 通过 51 项本地单元与组件测试（覆盖退化线段、大时间步长折算、代次握手超时回滚及多尺寸 Compose 截图基准）。
| 版本号 / VERSION | v1.0.0-beta.rc2 (内部测试版) |
|---|---|
| 系统支持 / MIN SDK | Android 8.0 (API 26)+ |
| 目标系统 / TARGET SDK | Android 14 (API 34) / 15 |
| 处理器架构 / ABI | 通用架构 (Universal) |
| 更新日期 / DATE | 2026-10-13 |
04 / 源代码与许可信息
- 源码状态
- 内部测试阶段（暂未公开源码仓库与安装包）
- 许可证与权利
- 本地工程源码遵循 GNU General Public License v3.0 (GPL-3.0) 许可证，并在工程文档中对参考的 GPL-3.0 开源项目（MockLocations、TrailRun 等）进行了规范致谢。
- 关联声明
- 本项目不对接任何第三方运动或校园打卡平台；系统接受测试位置不代表任何第三方平台会采纳数据，严禁用于伪造跑步打卡、替跑或违反学校管理规定的用途。
05 / 版本信息及可用下载渠道
源代码 · 版本说明 · 下载
当前版本记录：v1.0.0-beta.rc2 (内部测试版)（开发中 · 待上线）。因处于合规核查、源代码整理或内部测试阶段，当前暂停公开 APK 下载分发，不提供秘密分享链接或未核实外部下载源。
| 版本 | 日期 | 主要变化与修复 |
|---|---|---|
| Compliance Copy Fix | 2026-10-13 | 修正页面介绍文案，移除与实际代码不符的第三方平台关联描述，如实说明零联网标准 TestProvider 几何轨迹回放定位。 |
| v1.0.0-beta.rc2 | 2026-10-13 | 完成单一 Actor 状态机与 generationId 代次握手重构，通过 51 项自动化测试与 Android 14 dumpsys location 验证。 |
| P2.0 (Internal) | 2026-10-12 | 实现 Haversine 测距、分段线性插值、单程/循环/折返算法与离线轨迹画布预览。 |
06 / 项目使用说明与边界
01
开发者选项授权
在 Android 系统「开发者选项」中将本应用设为模拟位置应用（系统标准调试安全机制要求）。
02
挑选合成几何路线
在内置合成路线库中选择几何测试路径，设置回放速度与单程/循环/折返模式。
03
启动定位回放测试
启动前台测试服务，观察系统 LocationManager 测试位置更新与界面指标变化。
04
结束测试与清理
点击停止后自动注销系统 TestProvider 并清理本地进度快照文件。
系统需求与必要权限
- 操作系统：Android 8.0 (API 26) 及更高版本（已在 Android 14 API 34 验证）
- 系统设置：需在系统「开发者选项」中开启模拟位置调试权限
- 权限说明：仅申请精确定位与定位前台服务权限，不申请 INTERNET 网络权限及其他无关权限
客观使用边界与说明
- 【功能与合规边界】本工具仅调用 Android 官方标准 LocationManager 测试位置接口回放合成几何轨迹，不包含任何针对第三方运动平台的通信、协议对接或防检测绕过代码。
- 【严禁违规使用】系统底层接收测试位置仅用于定位相关开发与算法测试，严禁将本工具用于学校体育打卡作弊、替跑或任何违反机构规章制度的行为。
- 【暂未开放下载】当前处于内部研发与合规复核阶段，不对外提供公开 APK 下载。
07 / 常见问题与反馈
Q: 这款工具会连接第三方跑步或校园打卡平台吗？
A: 不会。本应用甚至未声明 INTERNET 网络权限，内置路线全部为纯数学合成的几何图形（如 400m 标准椭圆跑道），仅调用 Android 官方标准 LocationManager 测试位置接口，严禁用于替跑或打卡作弊。
Q: 为什么目前显示暂未开放下载？
A: 项目目前处于内部工程测试与合规复核阶段，为避免定位测试工具被不当误用，暂不对外公开分发安装包。
Q: 为什么需要在系统开发者选项中开启模拟位置？
A: 这是 Android 官方标准调试安全机制，只有在系统「开发者选项」中显式选定应用，LocationManager 才允许注册 TestProvider 测试位置源。