iOSLocationSimulator-cli-18

用法简介

前置条件

1. 系统是 Windows 或 MacOS
2. iPhone 或 iPad 系统版本 >= 17（支持 iOS 17 ~ iOS 26+）
3. Windows 需要安装 iTunes（从 Microsoft Store 安装）
4. 已安装 Python 3.10+ 和 pip3
5. 重要: 只能有一台 iPhone 或 iPad 连接到电脑，否则会出问题

步骤

1. 克隆本项目到本地并进入项目目录

2. 安装依赖（建议使用虚拟环境）

   pip3 install -r requirements.txt

   如果 pip3 无法安装，请使用 pip 替代
   如果提示没有需要的版本，请尝试不使用国内源

3. 修改配置和路线文件 （见 这里 的 4、5、7 步）

4. 将设备连接到电脑，解锁，如果请求信任的提示框，请点击信任

5. Windows 以管理员身份 打开终端（cmd 或 PowerShell），先进入项目目录，然后执行以下命令

   python main.py

   MacOS 打开终端，先进入项目目录，然后执行以下命令

   sudo python3 main.py

   需要 管理员 或 root 权限是因为需要创建 TUN 设备

6. 按照提示操作，如果一直说没有设备连接，Windows请确保 iTunes 已安装（可能需要打开），重新运行程序，在第3步时请确保设备已连接，解锁并信任

7. 结束请务必使用 Ctrl + C 终止程序，否则无法恢复定位

8. 如果定位未恢复，可以重启手机解决

iOS 26 适配说明

此版本已适配 iOS 26（及 iOS 18.2+）的连接方式变更：

• 隧道协议使用 TCP（iOS 18.2+ 已移除 QUIC 协议支持）
• 依赖库升级至 pymobiledevice3 >= 9.12.0
• DVT 连接使用新的 DvtProvider / LocationSimulation 异步 API
• 完整复现原有模拟定位功能（坐标系转换、路径插值、随机扰动等）

声明

1. 此软件旨在帮助开发者等专业人士进行软件开发，游戏开发，功能调试，应用兼容性测试等位置信息相关功能的开发调试工具。

2. 用户（下称“您”）需要确保不得通过本软件以任何方式进行非法、欺诈、侵犯第三方权益、违反其他应用服务条款的行为，包括但不限于用于办公打卡、签到、网约车、校园跑、配送服务相关的行为。我们保留向监管部门举报您违法违规行为的权利。

3. 您知悉并同意本软件仅限您用于合法的软件开发、功能调试、应用兼容性测试等专业目的。并且未经我们同意，您不得基于本软件进一步对外提供服务。

4. 受限于技术能力，我们暂时无法主动识别并对已知的、易被用于非法、欺诈、侵犯第三方权益或违反其他应用服务条款的高风险应用（APP），采取技术措施进行功能作用屏蔽，您不得尝试绕过或破坏我们的屏蔽措施，否则将承担本协议第2条所述的严重违约责任。