945
stars
139
forks
6
watchers
26
prs
25
issues
23
releases
README
WrapPin
在一张地图上选择、测试并移动 iPhone 向系统报告的位置。
简体中文 · English
当前版本:1.0.22(Build 74) · 最低系统:iOS/iPadOS 18.0
下载最新版 ·
使用手册 ·
在 X 联系 @suversal
WrapPin 是 Sean Howarth 原项目 Roam Control 的非官方社区中文分支,由 suversal 维护。上游提供设备配对、固定位置、模拟步行和真实位置恢复等核心能力;WrapPin 在此基础上完成简体中文界面与地图标签本地化、首次使用和连接引导、地址与坐标复制、连接诊断、坐标模式选择、路线预览和版本更新提醒。项目保留原作者署名和上游链接,不代表上游官方中文版。
如果这个项目帮到了你,欢迎点一个 Star;如果你发现界面、文案、兼容性或连接流程还有改进空间,也欢迎提交 Issue 或 Pull Request。贡献前请先阅读 CONTRIBUTING.md。
项目面向开发、质量测试和个人负责任测试,支持固定位置、步行与驾车路线、收藏与历史记录,并通过配对记录和兼容的设备隧道建立安全的开发者定位会话。默认使用 LocalDevVPN;也可在设置中选择 Shadowrocket、Surge、Loon、Stash、Egern、Quantumult X 或 sing-box,它们需要按各自的配置说明启用 10.7.0.1 设备通道,普通代理配置不能提供所需的设备连接。
请只在你拥有并控制的设备上使用。不要用于欺骗他人、伪造证据、规避安全限制,或违反第三方服务规则。
1.0.22(Build 74)优化后台保活和定位断线重连,重连期间保留路线进度;主动停止后不会自动重启。两版编译、离线回归和包校验通过,长时间锁屏效果待真机回测。见更新说明。
1.0.21 将最低系统扩展到 iOS/iPadOS 18.0。标准版 iOS 26.5 和 iPad iOS 26 已收到首轮成功反馈;Build 71 的完整真机回归,以及 iOS 18、隧道版和其他系统版本仍待分别验收。iOS 18–26 的首次配对步骤见电脑配对说明。
Build 71 优化 iPad 面板交互:横向宽窗口侧栏可收起、恢复,竖向与窄窗口的卡片贴底;iPad 默认显示紧凑卡片,固定定位和路线收起后保留主要操作。已生成 Build 71 两版未签名 IPA,见构建记录;用户已反馈 iPad iOS 26 可定位、可横屏,新包仍需真机回归,见 iPad 布局说明。
当前进展
- 当前公开版本为 1.0.22(Build 74),同一个 Release 提供标准版和隧道版两个 IPA;下载以 GitHub Releases 为准。
- 标准版(WrapPin-Standard-…)供 SideStore 等自签方式安装,使用 LocalDevVPN 等外部隧道。隧道版(WrapPin-Tunnel-…)内置设备隧道,主 App 和扩展都需要带 Packet Tunnel 权限的签名配置,免费账号无法签名;它使用独立 App ID,不替换标准版。
- 已完成完整简体中文界面、地图标签本地化、配对与连接引导、中文安装文档和使用手册。
- 已完善地址与坐标复制、连接检测、诊断信息复制、异常会话恢复和真实位置恢复流程。
- 配对和定位启动不再依赖可能受 SideStore 重签 Bundle ID 影响的 BGTaskScheduler,并优先使用 LocalDevVPN 端点。
- 已使用正式 Xcode Release Archive 流程生成并校验可供 SideStore 签名的未签名 IPA。
- 已验证前台固定位置、模拟步行和停止恢复流程;长时间锁屏保持仍需更多机型和系统版本测试。
- 可选择设备隧道跳转应用;蜂窝网络下优先使用 LocalDevVPN,其他应用建议连接 Wi-Fi。不同地图或地点仍可能出现位置偏移,可在两种坐标模式间切换;不能保证所有地点都准确。
界面预览
模拟固定位置 · 模拟步行与驾车路线
以上为早期版本截图,仅供了解功能;当前界面、文案和路线卡片布局请以实际安装的版本为准。
主要功能
- 使用 Apple 地图搜索地点、输入经纬度,或直接轻点地图选点。
- 固定位置可切换 GCJ-02 修正与 WGS84 原值。地区建议仅作起点;如果显示位置有偏差,可切换另一种方式再核对。
- 一键复制所选地点的可读地址或经纬度坐标。
- 启动固定位置后直接更换坐标,无需重新建立整条连接。
- 预览 Apple 地图步行或驾车路线,有多条路线时最多提供三条供选择;步行支持三档预设或 1–12 公里/小时自定义速度,驾车支持 5–240 公里/小时。
- 在步行期间暂停、继续、原路返回或更换目的地。
- 保存常用地点,快速访问最近使用的位置。
- 会话结束时主动清除模拟坐标并恢复真实位置。
- 为 Wi-Fi 和蜂窝网络提供分开的连接引导与诊断。
- 在设置中选择 LocalDevVPN、Shadowrocket、Surge、Loon、Stash、Egern、Quantumult X 或 sing-box 作为连接不可用时的跳转应用。Shadowrocket、Surge 和 Loon 需要分别按 Shadowrocket 配置、Surge iOS 配置、Loon 配置 启用 10.7.0.1 设备通道。
- 打开 App 时检查最新公开版本,有更新时提醒;也可在设置中手动检查、反馈问题或联系维护者。
- 支持深浅色外观、不同地图样式、动态字体、VoiceOver 和“减弱动态效果”。
实现原理
WrapPin 走的是 iOS 的开发者位置模拟通道,不是通过代理伪造 IP,也不是修改 Apple 账号或 App Store 地区。
mermaid
flowchart TD
A[在 WrapPin 中选择坐标或路线] -- B[读取保存在本机钥匙串中的 RPPairing 记录]
B -- C[通过兼容的设备隧道发现同一台 iPhone 的远程配对服务]
C -- D[校验设备身份并建立加密开发者隧道]
D -- E[连接 iOS LocationSimulation 服务]
E -- F[设置或持续更新模拟坐标]
F -- G[停止时清除模拟坐标并恢复真实位置]
具体过程如下:
1. WrapPin 在当前 iPhone 上生成或导入 RPPairing 配对记录,并保存到仅本机可访问的钥匙串。
2. LocalDevVPN 暴露 iPhone 自己的远程配对服务,WrapPin 通过本地服务发现找到它。这里的“VPN”用于本机设备通信,不会提供出口节点,也不会改变公网 IP。
3. 原生引擎校验广播中的设备身份,完成远程配对验证,再建立加密的开发者隧道。
4. WrapPin 通过 iOS 的 LocationSimulation 服务设置坐标。固定位置会定期Top issues
#42[建议] 能否可以支持ios27打卡~8 comments · 2026-10-26#46[建议]1 comments · 2026-11-05#43[Bug] Location session fails at pairVerification despite Ready/Reachable connection1 comments · 2026-10-28#51[建议]0 comments · 2026-11-15#49[问题] ios27配对时app不显示配对码0 comments · 2026-11-11#47Add Location Spoofing for Specific Apps0 comments · 2026-11-07#45Offline Custom Walking Routes Without Apple Maps0 comments · 2026-10-30
Latest release
WrapPin 1.0.22 v1.0.22 2026-11-12优化定位维持和断线后的恢复: - 前台开始定位时提前启动后台保活,回到前台后检查长时间未收到回调的请求。 - 运行中的定位遇到可重试连接错误时,以 1、2、4 秒间隔最多连续重连三次,沿用最新坐标。 - 重连期间冻结路线进度,恢复后保留原有暂停状态。 - 主动停止、重置和恢复真实位置会取消重连;认证错误及上次启动留下的未确认会话仍需手动处理。 安装包选择 - Standard 标准版:SideStore 等自签安装,配合 LocalDevVPN 等外部设备隧道。 - Tunnel 隧道版:内置设备隧道,需匹配主 App 和扩展的 Packet Tunnel 签名权限;免费账号请选择标准版。 支持 iOS/iPadOS 18.0+。均为未签名 IPA,沿用原签名身份升级同一版本通常无需重新配对。 两版 Debug/Release 编译、13 项离线检查和包校验通过。Build 74 真机安装及长时间锁屏/后台效果仍待回测,尚不能保证所有定位失效问题均已解决。 SHA-256: - Standard:868eead7328847473c7e2b7ff3f11c9bdeb84132ebef0e417c83db5c6c35e735 - Tunnel:e2c47e3886dd197c9b91eb32924081844f61d4a6d042226ec5d3a34ef00c8551