admin/ios-location-track
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity
6 Commits 1 Branch 2 Tags
bbf8a4fac498b48915602bc6463fbbcb96407239
Commit Graph
5 Commits
Author SHA1 Message Date
jbjf6666 bbf8a4fac4 docs: 使用方法.txt 重命名为 USAGE.txt 
文件名改成英文，文件内容逐字节不变（23981 字节，UTF-8 with BOM，505 个 CRLF）。
git 识别为 rename，历史保留。

同步更新引用：
- .gitattributes 的 eol=crlf 规则（USAGE.txt 仍锁定 CRLF，记事本友好）
- README.md / README.en.md 的入口链接
- Location.spec 的打包 datas（随 Windows 包装到安装目录）

文档内的标题「iOS 虚拟定位轨迹工具 — 使用方法」保持中文不动。
 2026-10-16 12:42:34 +08:00
jbjf6666 94c152ba00 docs: 新增中英双语《使用方法.txt》 
- 纯文本、记事本友好：UTF-8 with BOM + CRLF（老版记事本也能正确显示中文）
- 中文在前（9 节：是什么/安装/首次启动/连设备/使用/功能/数据位置/常见问题/已知限制），
  英文在后，共 505 行
- 覆盖 Windows 与 macOS 两个平台，含 11 条常见问题排查
- README.md / README.en.md 顶部加入口
- .gitattributes 为该文件单独锁定 CRLF（覆盖通用 *.txt eol=lf）
- Location.spec：随 Windows 包一起装到安装目录
 2026-10-16 02:18:44 +08:00
jbjf6666 c60e4b5cd4 chore(release): v1.1.0 — 版本号 1.0.0 → 1.1.0，README 双语化，构建脚本编码自检 
版本号 1.1.0（Windows 支持是新功能）
- core/protocol.py APP_VERSION、installer/version_info.txt、installer/iosloc.iss
  MyAppVersion、Location.spec（mac BUNDLE）、tools/make_dmg.py VERSION 全部同步到 1.1.0
- 产物命名规范：Windows 用 _win、macOS 用 _mac 后缀，Release 页面一眼分清平台
  · iOSLocationTrack-1.1.0_win-setup.exe
  · iOSLocationTrack-1.1.0_win-portable.zip
  · iOSLocationTrack-1.1.0_mac.dmg

README 双语化（默认中文）
- docs/README-WINDOWS.en.md 新增（Windows 文档全文英文版）
- docs/README-WINDOWS.md 顶部加 [中文] | [English] 语言切换
- README.md / README.en.md 的下载章节改成平台表格，说明 _win / _mac 命名

构建脚本编码自检
- scripts/build.ps1 新增第 0.5 步：检查 scripts/*.ps1 是否为 UTF-8 with BOM，
  缺失则自动补回。Windows PowerShell 5.1 没有 BOM 时会按 ANSI(GBK) 解析，
  中文乱码且直接语法报错（改个注释就构建不了，本项目实际踩过两次）
- 本次修复：build.ps1 的 BOM 在编辑后被工具静默丢弃，已补回

验收（Windows 11 x64 / iPhone 11 iOS 26.6.1）
- selftest 83/83、drift_sim 40/40、offline_tiles 13/13
- 打包版 exe 清单含 requireAdministrator，FileVersion 1.1.0.0
 2026-10-16 01:51:50 +08:00
jbjf6666 4d55e2415f feat(windows): 新增 Windows 移植（免管理员隧道 + 自动装 Apple 驱动 + 环境自检） 
按 docs/WINDOWS_PORT.md 完成 Windows 移植，并修正该文档中若干与实测不符之处。
macOS 构建链完整保留，单一代码库双平台构建。

核心：iOS 17+ RSD 隧道在 Windows 上换了实现方式
- macOS 借 Apple remoted（--native，内核可路由），Windows 改走 UserspaceRsdTunnel
  （纯 Python PyTCP 用户态协议栈）
- 实测：不需要管理员权限、不需要 Wintun 驱动（pytun_pmd3 自带 wintun.dll）、
  建立耗时约 0.3 秒
- 关键坑：用户态隧道的设备地址**只在本进程可达**。拿 (host, port) 另建 RSD 会得到
  OSError [WinError 1231] 网络位置不可达。必须把 aopen() 返回的 rsd 对象本身注入
  DVT 层（RealLocationProvider 早有 rsd= 注入口），因此 Windows 不能沿用
  「隧道助手子进程 + 解析 HOST PORT」那套架构
- 修正 WINDOWS_PORT.md 的错误：类名是 UserspaceRsdTunnel 不是 UserspaceTunnel；
  remote start-tunnel 没有 --userspace；Wintun 不是必需项

新增
- core/platform.py      平台抽象层（数据目录/浏览器探测/进程管理/提权/信号）
- core/apple_driver.py  Apple Mobile Device Support 检测与自动安装
                        （服务启动 → 独立 AMDS MSI → 完整 iTunes 包 → winget 逐级降级）
                        + 开发者镜像下载
- core/setup_window.py  启动时的「环境准备」窗口：逐项列出依赖，缺失项右侧可点安装，
                        必需项全部就绪后「进入程序」才可点击
- scripts/run.ps1, build.ps1, installer/iosloc.iss, installer/version_info.txt
- tools/make_ico.py（由已有 PNG 图标集生成多尺寸 .ico）
- tools/probe_tunnel_win.py（隧道可行性诊断）
- tests/win_e2e.py（7 项）、tests/win_app_e2e.py（9 项）真机验收
- docs/README-WINDOWS.md
- .gitattributes（避免 Windows 写出 CRLF 的 .sh 把 macOS 构建搞坏）

修改
- core/tunnel.py            Windows 走进程内 userspace 隧道；macOS 路径不变
- core/server.py            TunnelManager 注入 runner；provider_for 注入 rsd 对象；
                            资源目录与数据目录分离；日志落盘
- core/location_provider.py 平台化错误提示；新增保活（隧道静默断开会让设备
                            偷偷恢复真实定位，停止播放时每 15s 重发）
- main.py                   「环境准备」窗口、Apple 驱动后台检查、
                            --check-driver / --install-driver、跨平台浏览器与信号
- Location.spec             平台分支；Windows 用 .ico + uac_admin=True（启动即请求管理员）
                            + version_info.txt；单一 spec 不分叉
- tests/drift_sim.py / offline_tiles.py  去掉硬编码 /tmp，改用 tempfile.gettempdir()

打包
- exe 清单写入 requireAdministrator（用户要求：启动时直接请求管理员权限）
- 绿色版 dist\iOSLocationTrack\iOSLocationTrack.exe
- 安装包 dist\installer\iOSLocationTrack-1.0.0-setup.exe（Inno Setup）

实测（Windows 11 x64 / Python 3.12.14 / pymobiledevice3 11.31.0 / iPhone 11 iOS 26.6.1）
- 隧道→镜像→DVT→下发定位→恢复真实定位 全链路跑通，连接 0.8s
- selftest 83/83、drift_sim 40/40、offline_tiles 13/13
- win_e2e 7/7、win_app_e2e 9/9
- 打包版 exe：发现设备 → 0.3s 隧道 → DVT → 两次下发 → 恢复真实定位 → 干净退出
 2026-10-16 01:41:59 +08:00
jbjf6666 85e9a53750 docs: 新增 Windows 移植交接文档 
docs/WINDOWS_PORT.md 覆盖：
- 逐文件可移植性审计（核心逻辑层约 90% 可直接复用）
- 核心难点：iOS 17+ 的 RSD 隧道无法在 Windows 复用（macOS 实现依赖 XPC +
  ObjC runtime 私有框架），改用 pymobiledevice3 的 userspace 隧道
- 已实测确认的命令与 API（--userspace 挂在 lockdown start-tunnel / mounter
  auto-mount 上，remote start-tunnel 不支持；类名是 UserspaceRsdTunnel）
- 窗口启动、数据目录、打包与分发（DMG → Inno Setup）、图标（.icns → .ico）
- macOS 侧踩过的坑：镜像挂载用 Python API、必须打包包元数据、不要把 distutils
  放进 excludes、AlreadyMountedError 当成功处理
- 设计约束（DVT 长连接、只能改经纬度、last_point 与 last_reported 分离等）
- 验收基线（复用现有测试套件）与建议的工作顺序
 2026-10-16 01:05:09 +08:00