tidevice一款控制iphone库

Posted on Views:

tidevice 简介

  • 全称：taobao iDevice（阿里巴巴开源）

  • 定位：Python 实现的 iOS 设备控制工具，类似 libimobiledevice，但功能更丰富，特别是配合 WebDriverAgent (WDA) 做自动化测试。

  • 主要用途：

    • iOS 设备 连接管理
    • 应用安装、卸载、启动、停止
    • 查看设备信息
    • 真机调试
    • 自动化测试（WDA、Appium）

GitHub 地址：👉 alibaba/tidevice

功能图
c9a3a464432f9a812aa4b1eb6e5d60fb.png

1.安装方式

1
pip install -U tidevice

2.tidevice命令

2.1. 设备管理

1
2
tidevice list              # 列出已连接的设备 (USB / WiFi)
tidevice info              # 查看当前设备信息（UDID、型号、iOS版本等）

2.2. App 管理

1
2
3
4
tidevice install demo.ipa  # 安装应用
tidevice uninstall com.demo.app   # 卸载应用
tidevice launch com.demo.app      # 启动应用
tidevice kill com.demo.app        # 杀掉应用

2.3. 日志查看

1
tidevice syslog            # 查看系统日志 (类似 idevicesyslog)

2.4. WDA 相关

1
tidevice xctest -B com.facebook.WebDriverAgentRunner.xctrunner

运行 XCTest（通常是 WDA Runner），配合 wdaproxy 使用。

1
tidevice wdaproxy -B com.facebook.WebDriverAgentRunner.xctrunner --port 8100

把手机上的 WDA 映射到本机 8100 端口，供 Appium 或 http API 访问。

2.5. 截图 / 录屏

1
2
tidevice screenshot shot.png     # 截图
tidevice record out.mp4          # 录屏（Ctrl+C 结束）

2.6. 性能数据

1
2
tidevice ps             # 查看进程列表
tidevice perf           # 获取 CPU / 内存 / FPS / 网络 流量

3.典型场景

  1. iphone自动化测试 (Appium)
    tidevice 用来启动 WDA，把手机和电脑打通。
  2. 持续集成 CI/CD
    在 Jenkins / GitLab CI 环境中做 iOS 自动化测试，替代 Xcode + USB 配置。
  3. 远程真机调试
    结合 wdaproxy + usbmuxd，通过 USB 映射 iPhone 的服务到本地。
  4. 快速工具
    用来截图、录屏、安装包，代替 Xcode 工具链。