iOSRealRun-cli-26

用法简介

前置条件

0. iOS 26系统的手机可能需要开启开发者模式
1. 系统是 Windows 或 MacOS
2. iPhone 或 iPad 系统版本为 26
3. Windows 需要安装 iTunes
4. 已安装 Python3.14 和 pip
5. 重要: 只能有一台 iPhone 或 iPad 连接到电脑，否则会出问题

步骤

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

2. 创建虚拟环境 MacOS:

   python3 -m venv .venv
   source .venv/bin/activate
   python -m pip install --upgrade pip
   pip install -r requirements.txt

   Windows PowerShell:

   py -m venv .venv
   .\.venv\Scripts\Activate.ps1
   python -m pip install --upgrade pip
   pip install -r requirements.txt

   如果你的机器上有多个 Python 版本，请明确使用 Python 3.14 来创建虚拟环境。

3. 修改配置config.yaml和路线文件route.txt，其中 distance 为目标距离，单位为km(实际距离可能略大)，v 为运动速度，单位为m/s。（见 这里 的 4、5、7 步）

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

5. Windows 以管理员身份 打开终端（cmd 或 PowerShell），先进入项目目录，然后执行以下命令激活虚拟环境并启动程序

   .\.venv\Scripts\Activate.ps1
   python main.py

   MacOS 打开终端，先进入项目目录，然后执行以下命令激活虚拟环境并启动程序

   sudo ./.venv/bin/python main.py

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

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

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

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