用 PyMobileDevice3 管理 iOS 设备
PyMobileDevice3 是一个用 Python 3 写的 iOS 设备控制工具库,覆盖了设备发现、文件管理、日志查看、备份恢复这些常见需求。它能跑在 Windows、Linux 和 macOS 上,适合需要直接和 iPhone、iPad 打交道的开发和测试场景。
安装
先从 PyPI 装最省事:
python3 -m pip install -U pymobiledevice3
如果你想跟着源码走,或者需要最新改动,可以直接从仓库安装:
git clone https://github.com/doronz88/pymobiledevice3
cd pymobiledevice3
python3 -m pip install -U -e .
不同平台还要补一些依赖。
- Windows:装 iTunes,主要是为了驱动支持。
- Linux:需要
usbmuxd,Ubuntu 上可以这样装:
sudo apt install usbmuxd
- 旧版 iOS 设备(iOS < 13)还会用到 OpenSSL:
- macOS:
brew install openssl - Linux:
sudo apt install openssl
- macOS:
装完后可以顺手把命令补全开起来:
pymobiledevice3 install-completions
它支持 bash、zsh 和 fish,这一步不花时间,但后面敲命令会顺手很多。
常用功能
设备发现一般先看 USB 和 Bonjour:
pymobiledevice3 usbmux list
pymobiledevice3 bonjour rsd
看系统日志时,最常用的是实时输出:
pymobiledevice3 syslog live
pymobiledevice3 syslog live -m SpringBoard
做文件操作可以直接进 AFC shell:
pymobiledevice3 afc shell
应用列表和指定应用信息也能查:
pymobiledevice3 apps list
pymobiledevice3 apps query 应用包名
典型场景
调试时,最常碰到的还是这几类命令。
- 重启设备:
pymobiledevice3 diagnostics restart - 拉崩溃报告:
pymobiledevice3 crash pull /保存路径 - 查看进程:直接看当前运行中的进程和详情
如果你关心网络流量,pcap 可以直接抓包:
pymobiledevice3 pcap
备份和恢复也在工具里:
pymobiledevice3 backup2 backup --full 备份目录
pymobiledevice3 backup2 restore 备份目录
开发者模式打开后,还能用一些更偏底层的能力,比如截图、位置模拟和性能数据查看:
- 屏幕截图:

