搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

doronz88/pymobiledevice3

开发工具

用纯 Python 命令行和 API 操作 iPhone、iPad,提供日志、文件、备份、调试等类似 adb 的设备控制能力。

3,054
436
Python
GPL-3.0
创建于 5 年前

项目介绍

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 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. google-gemini/gemini-api-cli让已有编码 Agent 或脚本通过命令行调用 Gemini 模型、生成媒体、分析文件并运行托管 Agent 的 Go CLI。Go462
  2. rorkai/App-Store-Connect-CLI面向需要自动化 iOS 发布流程的团队,用脚本调用 App Store Connect API 的命令行工具。Go8,061
  3. cli/cli在终端中管理 GitHub 拉取请求、议题和仓库的官方命令行工具。Go46,901
  4. mvanhorn/cli-printing-press把 API、规范、HAR 或网站转成适合智能体反复调用的 Go CLI 和 MCP 服务。Go4,859
  5. googlecolab/google-colab-cli在终端中创建、执行和管理 Google Colab 的 CPU、GPU、TPU 运行时Python2,055