基于 Portal 的二次开发版本，用于 Android 定位检测技术研究。
本项目是对 Portal 进行的深度二次开发。原项目通过 Hook 系统服务实现虚拟定位，本分支在此基础上系统性地清除了所有静态与直接可探测指纹，以便于研究更细粒度的 Android 定位检测技术，并为后续添加测试挡位功能预留了扩展空间。
任何 App 通过常规手段（包名枚举、字符串扫描、反编译、sendExtraCommand 探测、系统属性遍历、logcat 检索等）都无法确认本模块的存在，检测难度被推高到设备特征与时序分析层级。
本项目仅用于开发者调试定位相关程序，以及学习和研究 Android 定位机制。
这类指纹可被任意 App 以极低成本主动探测。
| 项目 | 原始值 | 变更后 |
|---|---|---|
| 虚拟 Provider 名称 | "portal" |
"fused_ext" |
sendExtraCommand 通信命令名 |
"portal" |
"fused_ext" |
isProviderEnabled 探测判断 |
provider == "portal" |
provider == "fused_ext" |
| 系统属性注入标志 key | "portal.injected_${pkg}" |
"_lp.${hex(pkg.hashCode())}" |
| 随机会话 key 前缀 | "portal_" + Random |
纯 hex 随机数，无前缀 |
影响：原版任何 App 只需调用 LocationManager.sendExtraCommand("portal", ...) 或遍历 System.getProperties() 查找 portal.* 前缀即可确认模块存在。清除后这两条探测路径均失效。
这类指纹在 APK 扫描、包管理器枚举、反编译等场景下可被识别。
| 项目 | 原始值 | 变更后 |
|---|---|---|
applicationId / 包名 |
moe.fuqiuluo.portal |
com.system.location.service |
| Xposed 模块包名 | moe.fuqiuluo.xposed |
com.system.location.service.hook |
| JNI/Dobby 包名 | moe.fuqiuluo.dobby |
com.system.location.service.jni |
Xposed 入口类 (xposed_init) |
moe.fuqiuluo.xposed.FakeLocation |
com.system.location.service.hook.FakeLocation |
| Xposed 模块描述 | 基于 Xposed 实现 虚拟位置定位服务 |
Location Service Extension |
| 原生库名 | libportal.so |
liblocationext.so |
| 原生库运行时路径 | /data/local/portal-lib/libportal.so |
/data/local/ext-lib/liblocationext.so |
| CMake 项目名 | Portal |
LocationExt |
| JNI 导出函数符号 | Java_moe_fuqiuluo_dobby_Dobby_setStatus |
Java_com_system_location_service_jni_Dobby_setStatus |
| 构建输出 APK 名 | Portal-v*.apk |
LocationService-v*.apk |
| Application 类名 | Portal |
LocationServiceApp |
| 日志标签 | [Portal]（Xposed/Kotlin/C++ 三层） |
[LocationService] |
| 颜色资源名 | portal_*（colors/layouts/themes） |
lse_* |
| Style/Theme 名 | Portal.* / Theme.Portal |
LocationService.* / Theme.LocationService |
| 通知渠道名 | Portal Location |
LocationService |
| C++ 头文件宏 | PORTAL_*_H |
LOCATIONEXT_*_H |
| 运行时库加载方法 | loadPortalLibrary() |
loadLocationLibrary() |
所有 .kt、.java、.xml、.cpp、.kts 等源码与资源文件均已批量同步更新，磁盘目录结构与包名完全一致，无遗漏。
这类指纹需要调用方具备一定分析能力才可发现，但并不复杂。
| 项目 | 原始行为 | 变更后 |
|---|---|---|
Location.extras 写入 "portal.enable" |
非 hide 模式下写入 Bundle，直接暴露模块标识 | 完全移除，任何模式下均不写入 |
Location.extras 写入 "is_mock" |
非 hide 模式下写入 Bundle | 完全移除，通过 location.isMock 标准字段表达 |
| Binder 接口描述符 | moe.fuqiuluo.portal.service.${from}Helper |
android.location.service.${from}Provider |
| BinderUtils 包名白名单过滤 | 硬编码 moe.fuqiuluo.portal |
同步更新为新包名 |
LocationService/
├── app/ # 主应用（用户界面、配置管理、地图交互）
│ └── com.system.location.service
├── xposed/ # Xposed 模块（系统服务 Hook）
│ ├── com.system.location.service.hook
│ └── com.system.location.service.jni (Dobby 原生传感器 Hook)
├── nmea/ # NMEA 句子解析与注入
│ └── moe.microbios.nmea
└── system-api/ # 编译用系统 API 桩
└── com.system.location.service.api
通信机制：App 通过 LocationManager.sendExtraCommand("fused_ext", sessionKey, bundle) 与 system_server 进程内的 Hook 进行 IPC 通信，会话 key 在每次启动时随机生成，防止第三方枚举探测。
- 任意场景下强制替换 GPS / 网络 / 融合定位坐标
- Hook GNSS 卫星数据（颗数、信噪比、NMEA 句子）
- Hook 基站 / 电话信息（TelephonyRegistry、PhoneInterfaceManager）
- Hook Wi-Fi 扫描结果与连接信息
- Hook 三方定位 SDK（高德、百度、腾讯）
- 支持路线录制与回放
- 摇杆实时移动位置
- 可配置速度、高度、精度、航向
- 传感器 Hook（Dobby 原生库，需 root）
- 隐藏
isMock标志（Android 12+） - 测试挡位模式（规划中，将支持逐层开启各类 Hook）
- Android 8.0 (API 26) 及以上
- 已安装 LSPosed 框架
- Root 权限（传感器 Hook 功能需要）
- 在 LSPosed 中激活模块，作用域选择
android、com.android.phone及目标应用
本项目工具链保持最新稳定版本，持续跟进 Android 生态演进。
| 组件 | 版本 | 说明 |
|---|---|---|
| JDK | 17+（推荐 21 / 25） | CI 使用 JDK 21 |
| Gradle | 9.7.0 | wrapper 已锁定 |
| AGP | 9.3.1 | 内置 Kotlin，无需单独应用 kotlin-android 插件 |
| Kotlin | 2.4.10 | 含 serialization 插件 / kotlin-reflect |
| compileSdk | 37 | targetSdk 36 |
| Build Tools | 36.0.0 | AGP 9.3 要求 |
| NDK | 28.2.13676358 | sdkmanager "ndk;28.2.13676358" |
| CMake | 3.31.6 | sdkmanager "cmake;3.31.6" |
主要依赖（均保持最新稳定版）：androidx.core-ktx 1.19.0、appcompat 1.8.0、material 1.14.0、constraintlayout 2.2.2、lifecycle 2.11.0、navigation 2.9.8、fastjson2 2.0.64、GeographicLib-Java 2.1、Bugly 4.1.9.3、Xposed API 82、Dobby 1.2。
JDK 24+ 注意：使用 JDK 24/25 构建时（例如 Android Studio 自带的 JBR 25），需设置环境变量
JAVA_TOOL_OPTIONS=--enable-native-access=ALL-UNNAMED，否则 AGP 的 prefab 原生构建任务 会把 JVM 的 restricted-method 警告误判为错误导致构建失败。CI 工作流已包含该设置。
原版 Portal 存在以下几条低成本探测路径，本分支已对其进行清除：
// 原版：直接探测 portal provider（已清除）
val bundle = Bundle()
val exists = locationManager.sendExtraCommand("portal", "exchange_key", bundle)
// 原版：枚举系统属性（已清除）
val isInjected = System.getProperties().keys.any {
it.toString().startsWith("portal.")
}
// 原版：读取 Location extras（已清除）
val isMocked = location.extras?.getBoolean("portal.enable") == true清除以上路径后，检测难度进入下一层级（设备特征、时序分析、卫星数据一致性等），这也是本二次开发的研究目标所在。
- 本项目基于 Apache 2.0 许可证开放，可用于任何符合法律的目的，包括商业和非商业用途，特别鼓励用于学习和研究。
- 使用者须遵守当地相关法律法规，因使用本软件导致的任何后果由使用者自行承担，与本项目开发者无关。
- 如发现任何人利用本项目进行违法活动，请收集证据并向有关部门举报。
- 根据 Apache 2.0，再分发时需保留原始版权声明、NOTICE 文件、许可证副本，并说明所做的重大修改。