ios-location-track

0 Fork 0

v1.1.0 c60e4b5cd4

v1.1.0 — 新增 Windows 支持 Stable

admin released this 2026-10-29 07:51:20 +00:00 | 5 commits to main since this release

v1.1.0 — 新增 Windows 支持 🎉

同一个代码库，macOS 与 Windows 两个平台都能构建、都实测跑通真机。

关于 macOS 包：本次没有重新构建 macOS 版本，上传的 DMG 与 v1.0.0 是同一份二进制
（SHA256 完全一致），只是按新的命名规范加了 _mac 后缀。macOS 端功能没有任何变化，
应用内显示的版本号仍是 v1.0.0。下次在 Mac 上执行 ./scripts/build_app.sh 时会产出
真正的 1.1.0。

下载哪个？

平台	文件	说明
Windows	`iOSLocationTrack-1.1.0_win-setup.exe`	安装包（推荐），中文向导
Windows	`iOSLocationTrack-1.1.0_win-portable.zip`	绿色免安装版，解压即用
macOS	`iOSLocationTrack-1.1.0_mac.dmg`	打开 DMG，把 App 拖进 `Applications`（二进制同 v1.0.0）

Windows 版

1. 建隧道不需要管理员权限

iOS 17+ 的 RSD 隧道在 Windows 上换成了 UserspaceRsdTunnel —— 纯 Python 的 PyTCP
用户态协议栈：

❌ 不需要内核虚拟网卡，❌ 不需要 Wintun 驱动，❌ 不需要管理员权限
✅ 实测建立耗时 约 0.3 秒
⚠️ 代价是设备地址只在本进程内可达，所以不能沿用 macOS 那套
「隧道助手子进程 + 解析 HOST PORT」的架构，必须把隧道返回的 RSD 对象直接注入 DVT 层

对比过 5 个同类实现（GeoPort、locwarp、fake-location-cli、iFakeLocation 及其分支、go-ios），
它们的 Windows 方案都需要管理员权限 + 内核隧道或后台 tunneld 守护进程。

2. 自动安装 Apple Mobile Device Support

Windows 上 usbmuxd 由 Apple 的驱动提供，没有它一台设备都发现不了。程序会按顺序自动降级：

启动已有服务 → 独立 AMDS MSI(38MB) → 完整 iTunes 包(193MB) → winget

3. 「环境准备」窗口

每次启动弹出自检窗口，逐项列出依赖：已就绪的显示绿色 ✓，缺失的显示红色 ✗ 且右侧
有「安装 / 下载」按钮，必需项全部就绪后「进入程序」才可点击。

检查项：Python 运行时、pymobiledevice3、Apple Mobile Device Support、RSD 隧道依赖、
开发者镜像、管理员权限、iPhone 连接（可选）、网络连通（可选）。

4. 启动即请求管理员权限

exe 清单写入 requireAdministrator，免去用户手动右键提权（只用于装驱动；
隧道本身不需要）。

5. 保活机制

Windows 用户态隧道会静默断开，设备随后偷偷恢复真实定位而界面看起来一切正常。
因此设了点但停止播放时，每 15 秒重发一次。

实测环境与结果

Windows 11 x64 · Python 3.12.14 · pymobiledevice3 11.31.0 · iPhone 11 / iOS 26.6.1

tests/selftest.py        83/83     协议、几何、播放引擎、配置、瓦片、端到端
tests/drift_sim.py       40/40     真实感模型
tests/offline_tiles.py   13/13     瓦片离线缓存
tests/win_e2e.py          7/7      真机：隧道→镜像→DVT→下发→恢复
tests/win_app_e2e.py      9/9      真机：走 App 真实装配路径

打包版 exe 实测：发现设备 → 0.3s 隧道 → DVT 会话 → 两次下发定位 → 恢复真实定位 → 干净退出。

已知限制

iOS 16 及更早不支持（经典开发者镜像需 Apple 按构建号签发，第三方镜像会被设备拒签）
同一时间只能有一个工具占用 RSD 连接，用之前请关掉爱思助手 / i4Tools / Xcode
一个进程只能有一条 userspace 隧道，请不要双开
exe 与安装包没有代码签名，会有 SmartScreen 提示 → 点「更多信息 → 仍要运行」
挂载开发者镜像需要联网（Apple TSS 在线签名）

文档

Windows 使用说明：docs/README-WINDOWS.md
移植决策与踩坑记录：docs/WINDOWS_PORT.md（第 11 节是移植后对原文的修正）

本 Release 暂未附带二进制文件（仓库当前提供的是 v1.1.1 的安装包与免安装包）；如需 v1.1.0 可从源码自行构建。

Downloads

2 Releases 2 Tags