新工具开源！一款iOS自动化利器（附地址）

站长

2024年03月29日 11:53 · 阅读数 2

tidevice 是阿里的内部的一个小组用来做 iOS 自动化用的工具，通过逆向iOS通信协议，使用纯Python实现。目前淘宝和其他部分事业部已经全面使用了该技术，进行iOS应用的性能采集，UI自动化。

注：这里的被测应用无需做任何修改，使用不再局限于Mac上。

开源地址：

github.com/alibaba/tao…

tidevice可以帮你做什么呢？

应用安装，启动，停止，查看

启动 WDA（WebDriverAgent）（注：该操作不依赖xcodebuild，可跨平台使用）

运行UITests （跨平台使用）

性能采集（类似 PerfDog）

截图、syslog采集等等

熟悉libimobiledevice工具集的同学可能知道大部分上面提到的功能，为了方便日常的使用tidevice对libimobiledevice中已有的功能也重新实现了一遍（比如截图，看日志，应用安装），这样有tidevice你就可以完成日常所有相关的操作了。

除了这些众所周知的功能，tidevice还可以完成WDA的启动，iOS设备的性能采集。

可能有人不知道WDA为何物，这里简单的介绍一下。WDA全名WebDriverAgent是facebook推出的可以实现黑盒iOS自动化的项目。该项目作为一个App运行在iOS手机上，被测应用不需要做任何的更改（比如接入sdk），进行无侵入的测试。唯一不方便的是手机必须连接上Mac电脑，并使用Mac上才有的xcodebuild才能将WDA这个App运行起来，这也导致其推广起来比较困难。

文章中会重点介绍一下tidevice 如何完成WDA的启动。原理比较简单：tidevice通过模拟xcodebuild与手机进行通信，向手机发送特定的指令，来启动WDA，从而可以脱离Mac的限制，能够在Linux、Windows上运行起来iOS自动化，而在tidevice出现之前，这些是无法做到的。

安装

因为是Python项目，一条命令即可完成安装 pip3 install -U tidevice 安装完成后，先执行几个命令测试一下 tidevice version 查看tidevice版本 tidevice list 查看已经连接上的iPhone设备

常用命令

安装应用 tidevice install example.ipa

通过URL安装应用 (实际使用时网址要改成正确的) tidevice install example.org/demo.ipa

应用启动 tidevice launch com.apple.Preferences

截图 tidevice screenshot screenshot.jpg

查看系统日志 tidevice syslog

其他常用的命令帮助命令查看，基本上常用的命令都有了 tidevice -h

启动WebDriverAgent

目前iOS的黑盒自动化，最流行的方法是通过WDA来实现的。在tidevice出现之前，WDA只能通过xcodebuild来启动，而运行xcodebuild则必须有一台Mac才行。

tidevice没有通过xcodebuild，而是通过usbmuxd直接跟手机上的服务进行直接通信完成手机上WDA的启动。usbmux在不同的平台都有开源的实现，所以tidevice不仅能在Mac上运行，也能在Linux、Windows上运行。

新工具开源！一款iOS自动化利器（附地址）

关于usbmux通信协议这部分，苹果当然不会告诉直接告诉我们。不过因为usbmux本身就是socket套接字，所以我们可以直接截获其中的内容，然后根据开源界已有的成果，其中大部分的内容已经被破解了。先用xcodebuild完成一次WDA的启动，然后找到关键的通信内容，再用python来模拟回放一遍，就可以抛弃xcodebuild不用了。

相对于xcodebuild启动，tidevice因为通信内容更精简，所以启动速度更快（2s左右），另外也更稳定。

说了一堆理论，我们看一下怎么使用的吧

前提条件

数据线将 iPhone 手机连接到 PC 上

手机上已经有WebDriverAgent这个 App 了。这个可以通过 xcode 编译源码安装，也可以用开发者证书重签名的 WebDriverAgent.ipa 安装到手机。

Linux和Windows因为默认没有usbmux这个服务，提前安装一下就可以。可以参考这个issue：

github.com/alibaba/tao…

前提条件OK了的话，像下图这样执行命令就可以将WDA启动起来了。

新工具开源！一款iOS自动化利器（附地址）