Files
OpenLoc/README.md
T
LZX 7b0d5b802d
Release OpenLoc APKs / Build & Publish Release (push) Canceled after 0s
release: v1.2.2 - add about screen, migrate update server to VPS, and optimize UI
2026-11-08 15:23:10 +08:00

71 lines
4.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<p align="center">
<img src="assets/logo.png" width="128" height="128" alt="OpenLoc Logo" />
</p>
<h1 align="center">OpenLoc</h1>
<p align="center">
专为 Android 平台设计的现代地理位置模拟与隐私辅助工具
</p>
<p align="center">
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Platform" />
<img src="https://img.shields.io/badge/Language-Kotlin-7F52FF?style=flat-square&logo=kotlin&logoColor=white" alt="Language" />
<img src="https://img.shields.io/badge/UI-Jetpack%20Compose%20%2F%20Material%203-4285F4?style=flat-square&logo=jetpackcompose&logoColor=white" alt="UI" />
<br>
<img src="https://img.shields.io/badge/Privacy-Local%20Only-00C853?style=flat-square" alt="Privacy" />
<img src="https://img.shields.io/badge/License-GPL--3.0-007AFF?style=flat-square" alt="License" />
</p>
<p align="center">
<b>简体中文</b> | <a href="README_EN.md">English</a>
</p>
---
OpenLoc 旨在为开发者、测试人员以及关注个人数字隐私的用户提供安全、可控且纯净的位置环境模拟服务。基于 Xposed / LSPosed 运行时注入与现代 Android 架构设计,提供高拟真、无残留的多维环境模拟能力。
---
## 核心实现架构
### 1. 底层 Hook 与多维定位拦截
- **系统层级深度劫持**:通过 Xposed 框架深度挂钩 Android 系统底层 `LocationManagerService`、网络定位提供者及第三方 NLP 接口,接管全球卫星导航、网络基站与 Wi-Fi 扫描结果。
- **内存级模拟脱敏**:在内存对象层实时抹除 `isMock` 与 `mIsFromMockProvider` 标志,从源头消除底层定位模拟特征。
- **模块包名自隐匿**:针对受控目标应用动态隐藏 OpenLoc 自身的安装包信息,有效防御应用通过 `PackageManager` 扫描安装列表以识别模块存在的行为。
### 2. 多维拟真与防检测矩阵
- **自然位置微漂移**:采用高斯平滑滤波与布朗运动随机游走模型,动态生成拟真经纬度微小漂移,防止因坐标绝对静止触发服务端风控策略。
- **全星座卫星信号仿真**:支持 GPS、北斗(BeiDou)、GLONASS、Galileo 等主流卫星星座的物理载噪比与伪距仿真,动态生成合规的全量 NMEA GSV/GSA 报文流。
- **生物手持生理拟真**:向设备传感器层注入微弱的生理微颤信号,模拟手持设备日常轻微晃动,规避步态与姿态静止监测。
- **基站小区与 Wi-Fi 防反查**:针对周围蜂窝基站(Cell Tower)与 Wi-Fi 接入点(BSSID)进行脱敏混淆,杜绝目标应用上传网络指纹至云端数据库反查真实物理位置。
### 3. 应用作用域精细化管控
- **多维度生效策略**:
- **全局模式**:整机所有应用统一接收模拟位置。
- **黑名单模式**:黑名单内的特定应用保持真实物理定位,其余应用接收模拟位置。
- **白名单模式**:仅白名单指定的应用接收模拟位置,其余应用保持真实定位。
- **高效应用检索**:内置快速搜索、分类筛选(系统应用/用户应用)以及全选/全不选批处理能力。
### 4. 交互式地图与地点管理
- **现代化地图选点**:集成 OpenStreetMap 地图引擎,提供流畅的手势选点、缩放与精准坐标拾取体验。
- **多引擎智能检索**:支持高德地图、百度地图、Photon、Nominatim 等多元化位置搜索引擎与经纬度坐标直达。
- **常用地点收藏夹**:支持收藏自定义命名地点,提供即时选定、拖拽排序与离线存储管理。
### 5. 纯净体验与全站国际化
- **Jetpack Compose & Material 3**:采用现代声明式 UI 体系构建,深度支持 Material You 壁纸动态取色与多套质感主题色切换。
- **全站国际化(i18n)**:UI 界面文字完全解耦,支持简体中文与英文多语言环境,严格禁止硬编码。
- **本地纯净运行**:无任何非必要的后台常驻常驻驻留进程,隐私数据完全保留于设备本地。
---
## 免责声明
本软件仅供合法的软件开发调试、学术研究、定位功能测试及个人隐私保护使用,请勿用于任何违反法律法规或破坏第三方服务协议的用途。
---
## 开源协议
本项目基于 **GNU General Public License v3.0 (GPL-3.0)** 协议开源。详细条款请参阅 [LICENSE](LICENSE) 文件。