iOSRealRun / iOSRealRun-cli-17

(iOS 17+) 基于虚拟定位的 iOS 免越狱模拟跑步打卡,跨平台支持,在线拾取路径,可设置跑步速度,随机速度与路线
Mozilla Public License 2.0
162 stars 31 forks source link

iOSRealRun-cli-17

用法简介

前置条件

  1. 系统是 WindowsMacOS
  2. iPhone 或 iPad 系统版本大于等于 17
  3. Windows 需要安装 iTunes
  4. 已安装 Python3pip3
  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. 如果定位未恢复,可以重启手机解决