doronz88/pymobiledevice3
开发工具用纯 Python 命令行和 API 操作 iPhone、iPad,提供日志、文件、备份、调试等类似 adb 的设备控制能力。
项目介绍
pymobiledevice3 用纯 Python 3 实现与 iOS 设备通信的协议,支持 Windows、Linux 和 macOS,同时提供命令行工具和 Python API,可以理解为 iOS 平台上的 adb (1)。
它覆盖日常设备操作:列出已连接设备、查看应用、实时读取 syslog、读取崩溃报告、浏览设备文件和制作备份。不装 Xcode 也能使用部分开发者服务,例如截图、模拟定位和挂载 DDI;在 iOS 17+ 上,命令会自动建立 no-root 隧道。更进阶的功能包括浏览器或 VNC 客户端里的屏幕镜像与触控、键盘输入,按进程抓包并导入 Wireshark,类似 strace 的实时系统调用跟踪,以及为 Safari 和 WebView 提供 JavaScript shell 和 CDP 桥接 (16) (17) (18) (19)。
适合需要在 Xcode 之外脚本化操作 iOS 设备的开发者、测试人员和研究人员,也适合把设备操作集成进自有 Python 工具链的团队。
安装与首次使用
Windows 和 Linux 要先装平台依赖:Windows 装 iTunes,Linux 装 usbmuxd (24)。然后用 uv 安装命令行工具,它会自动获取合适的 Python 版本:
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# 在新终端中执行
uv tool install --managed-python pymobiledevice3
用 USB 连接设备并解锁,确认连通性:
pymobiledevice3 usbmux list # 列出已连接设备
pymobiledevice3 apps list # 第一条设备命令;如有提示请在设备上点“信任”
pymobiledevice3 syslog live # 实时输出设备日志;Ctrl+C 停止
如果要改用 Python API,在项目虚拟环境里执行 pip install pymobiledevice3 (23)。命令行工具之后可用 uv tool upgrade pymobiledevice3 升级,也可以不安装直接运行:uvx --managed-python pymobiledevice3 usbmux list。
使用约束
PyPI 是唯一的官方分发渠道,AUR 等第三方打包不由项目维护,可能落后于最新版本。Windows 和 Linux 必须先有 iTunes 或 usbmuxd,设备需解锁并完成信任配对。iOS 17+ 的开发者服务依赖命令内置的隧道处理。项目使用 GPL-3.0 许可证,如要放进闭源应用发布,需要先查看项目 FAQ (46)。平台说明、CLI 示例和隧道支持矩阵见完整文档。
HotRepo 点评
仓库已有三千多 Star,项目围绕完整的协议实现构建,而不是对现成工具的薄封装;文档覆盖安装、CLI 示例、Python API 和协议内部实现。其设计取舍与这种范围一致:纯 Python、跨三大桌面平台,同时覆盖交互式设备操作和脚本化自动化。HotRepo 没有记录该项目的榜单名次或增长历史,因此这里的观察基于仓库自述的能力、文档和许可证,而不是趋势数据。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- google-gemini/gemini-api-cli让已有编码 Agent 或脚本通过命令行调用 Gemini 模型、生成媒体、分析文件并运行托管 Agent 的 Go CLI。
- rorkai/App-Store-Connect-CLI面向需要自动化 iOS 发布流程的团队,用脚本调用 App Store Connect API 的命令行工具。
- cli/cli在终端中管理 GitHub 拉取请求、议题和仓库的官方命令行工具。
- mvanhorn/cli-printing-press把 API、规范、HAR 或网站转成适合智能体反复调用的 Go CLI 和 MCP 服务。
- googlecolab/google-colab-cli在终端中创建、执行和管理 Google Colab 的 CPU、GPU、TPU 运行时