想在电脑前测试一个地图类应用，或者验证某个功能在不同位置的表现，最直接的办法就是拿着手机出门走一圈。有些人会真的这么做，更多的人是被反复的「出门—看结果—再出门」磨到放弃。定位相关的开发测试、路线类功能的验收、地图数据的核对，都卡在同一个地方：位置这个东西没法手动输入，系统也不提供给普通应用改的口子。

一、问题是什么

iOS 上想动定位，普通人能想到的路子大概三条。第一条是拿真实移动当测试数据，慢、不可复现、下雨天也麻烦。第二条是代理伪造 IP——但它只骗得到网络层，系统定位服务照样报告真实坐标，很多应用拿的是 GPS/系统定位而不是 IP 推断，这条路直接失效。第三条是 WLOC 一类的网络定位改写方案，原理是拦截 Apple 的 Wi-Fi/基站定位响应，需要安装并信任本地 CA 根证书，属于把流量送进中间人解密，系统一升级 TLS 校验一变就可能整体失效。

这个空档的真正需求其实是：在不越狱、不装根证书、不改公网 IP 的前提下，让 iPhone 向应用报告一个你指定的位置，并且能沿一条路线连续移动。

二、核心设计

WrapPin 走的是第四条路：iOS 的开发者位置模拟通道。它在本机生成或导入 RPPairing 配对记录，存进只有本机可访问的钥匙串；通过 LocalDevVPN 这类「本机隧道」发现并连接 iPhone 自己的远程配对服务，校验设备身份后建立加密的开发者隧道，最后连接 iOS 的 LocationSimulation 服务设置坐标。

这里的 LocalDevVPN 名字里带 VPN，但既不改公网 IP，也不提供任何出口节点——它只是让 WrapPin 能访问 iPhone 本机的开发者服务。底层是 SwiftUI 界面加一层 Rust-to-Swift 桥接，定位会话由原生引擎驱动，使用 MIT 许可的 idevice 库。停止时它会主动向系统发送清除模拟位置的指令，应用意外退出后下次打开还有恢复页面，不会留下一个「漂移的假位置」不管。

三、功能拆解

地图选点：Apple 地图搜索地点、输入经纬度、直接轻点地图，或者从收藏和历史记录里选，都是选位置的入口。

坐标模式：同一地点提供 GCJ-02 修正与 WGS84 原值两种模式，国内地点建议先试 GCJ-02，显示有偏差就切换另一种核对——这解决的是国内地图偏移的老问题。

固定位置：启动后可以直接更换坐标，不用重建整条连接。会话中换地点不需要重新配对。

路线模拟：预览 Apple 地图规划的步行或驾车路线，多条路线最多给三条供选；步行支持三档预设或 1–12 公里/小时自定义速度，驾车支持 5–240 公里/小时匀速。步行期间可以暂停、继续、原路返回，或者在保持连接的情况下更换目的地。

辅助能力：一键复制所选地点的可读地址或经纬度；Wi-Fi 和蜂窝网络分开的连接引导与诊断；保存常用地点；深浅色外观、动态字体、VoiceOver 支持。

四、适合谁、不适合谁

适合谁：开发者和测试人员——测定位上报、路线类功能、地图数据核对，把「出门走一圈」变成桌面上的一次点击；有明确测试需求的个人用户——比如验证自己的应用在特定城市的显示效果。

不适合谁：想改公网 IP、App Store 商店地区或运营商归属的，两者都做不到；打算用来欺骗他人、伪造证据、规避安全限制的——项目文档明确禁止这些用途；以及完全不想折腾侧载链路的用户——这套流程对纯小白并不友好。

五、诚实提醒

第一，安装链路长。标准版需要 iLoader + SideStore + LocalDevVPN + WrapPin 四件套，iOS 18–26 首次配对还要一台电脑生成 RPPairing 文件，iOS 27 及以上才能本机配对。这是 Apple 侧载限制决定的，不是项目偷懒。

第二，免费签名七天刷新。SideStore 免费签名受 Apple 规则限制，每七天要在手机上刷新一次，App 数量也有上限——这是 Apple 对免费账号的规定，不是订阅费。

第三，不保证所有应用都认这个位置。有的应用同时检查 IP、Wi-Fi、基站、账号地区或风控信号，这类应用不会跟着模拟位置走。先用 Apple 地图确认模拟生效，再看目标应用。

第四，稳定性有边界。官方说明两版编译、13 项离线检查和包校验通过，但长时间锁屏的效果仍待真机回测，不作稳定性保证；不同地图或地点仍可能出现位置偏移。

第五，许可与隧道限制。项目用 PolyForm Noncommercial 1.0.0 许可，源码可看、非商业可用，但它不是 OSI 认可的开源许可证；LocalDevVPN 通常不能和另一个正在接管系统 VPN 的工具同时工作；LocalDevVPN 在国区 App Store 没有，需要非国区 Apple ID。

六、项目现状

当前公开版本 1.0.22（Build 74），2026 年 11 月 12 日发布。它是 Roam Control 的非官方社区中文分支，由 suversal 维护，保留原作者署名与上游链接；最低系统 iOS/iPadOS 18.0，SwiftUI 界面。这个版本优化了后台保活和定位断线重连（1、2、4 秒间隔最多三次），重连期间保留路线进度。