来源：AirPython

作者：星安果

1. 前言

大家好，我是安果！

最近，阿里内部开源了一个 iOS 端由 Python 编写的自动化工具，即：tidevice

它是一款跨平台的自动化开源工具，不依赖 Xcode 就可以启动 WebDriverAgent（ WDA ），这也就意味着 Windows 可以直接运行 iOS 自动化脚本

2. 准备

进入到虚拟环境，先安装 tidevice 的依赖包

# 安装依赖包
pip3 install -U "tidevice[openssl]"
# 查看tidevice版本，检查是否安装成功
tidevice version

3. 常见功能

将 iPhone 设备连接到电脑上，就可以使用 tidevice 提供的功能了

3-1.查看设备列表

# 二选一
tidevice list
# json数据显示
tidevice list --json

3-2.安装、卸载应用

安装对应的关键字为：「 install 」

tidevice 同时支持安装本地 ipa 包和远链下的 ipa 应用包

另外，tidevice 可以使用「 --udid 」参数将应用安装到某一台设备中

# 安装本地应用
tidevice install example.ipa
# 根据udid参数，指定设备安装应用
tidevice --udid $UDID install
https://example.org/example.ipa
tidevice install https://.....ipa

卸载对应的关键字为：「 uninstall 」

通过应用包名可以卸载设备上的某一个应用

# 卸载应用（通过包名）
# 比如：知识星球App包名为：com.unnoo.quan
tidevice uninstall com.unnoo.quan

3-3.启动、关闭应用

启动应用对应的关键字为：「 launch 」

关闭应用对应的关键字为：「 kill 」

# 打开应用
tidevice launch com.unnoo.quan
# 停止杀死应用
tidevice kill com.unnoo.quan

3-4.已安装应用及名称、版本

使用「 tidevice applist 」命令，可以查看设备上已经安装的应用、应用名称、应用版本号

# 查看设备应用信息列表
localhost:tidevice_demo xingag$ tidevice applist
com.tencent.xin WeChat 8.0.2
com.ss.iphone.ugc.Aweme 抖音 13.4.0
com.tencent.mttlite QQ浏览器 10.8.3
com.panasonic.jp.imageapp Image App 1.10.17
com.unnoo.quan 知识星球 4.20.2
co.visualsupply.cam VSCO 189

com.ucweb.iphone.lowversion UC浏览器 13.1.5

com.niksoftware.snapseedforipad Snapseed 2.19.5
com.autonavi.amap 高德地图 10.76.0
com.lagou.education 拉勾教育 1.4.9
com.xunmeng.pinduoduo 拼多多 5.37.0
com.tencent.QQMusic QQ音樂 10.5.5
io.ideamp.feelcab Feelca B 1.6.0

com.chinaunicom.mobilebusiness 手机营业厅 8.00.01
com.feiyu-tech.vico Vicool 1.2.26

com.ss.iphone.article.News 今日头条 7.9.3
com.sogou.sogouinput 搜狗输入法 10.18.1
org.geekbang.GeekTime 极客时间 2.9.2
com.burbn.hyperlapse Hyperlapse 1.3.4
com.apple.itunesu iTunes U 3.8

3-5.设备信息

利用「 tidevice info 」可以查看设备信息，比如：设备序列号、系统版本、CPU、本机号码、时间戳、蓝牙地址、MAC 地址等信息

# 查看设备信息
localhost:~ xingag$ tidevice info
MarketName: iPhone SE (1st generation)
DeviceName: xingag
ProductVersion: 14.4
ProductType: iPhone8,4
ModelNumber: MP892
SerialNumber: ...
CPUArchitecture: arm64
ProductName: iPhone OS
ProtocolVersion: 2
RegionInfo: ZP/A
TimeIntervalSince1970: 1616979424.235399
TimeZone: Asia/Shanghai
WiFiAddress: 58:e2:8f:68:4c:b0
BluetoothAddress: 58:e2:8f:68:4c:b1
BasebandVersion: 10.40.01
...

如果要查看设备的电池信息，可以使用关键字 「 --domain + 应用包名 」来获取

# 查看设备电池信息
localhost:~ xingag$ tidevice info --domain com.apple.mobile.battery --json
{
"BatteryCurrentCapacity": 54,
"BatteryIsCharging": true,
"ExternalChargeCapable": true,
"ExternalConnected": true,
"FullyCharged": false,
"GasGaugeCapability": true,
"HasBattery": true
}

3-6.重启及截图

重启对应的关键字为：「 reboot 」

截图对应的关键字为：「 screenshot 」

# 重启设备
tidevice reboot
# 截图并保存到文件 screenshot.jpg 中
tidevice screenshot screenshot.jpg

3-7.系统日志及更多帮助

查看系统日志的命令为：「 tidevice syslog 」，当然也可以配置 grep 参数进行过滤

# 查看系统日志
tidevice syslog
# 更多帮助
tidevice -h

4. 自动化步骤

要完成 iOS 端的自动化，我们还需要做一些准备工作

4-1.安装 WDA

我们需要将 WebDriverAgent 安装到 iOS 设备上，通过它驱动手机进行一系列自动化操作

PS：由于 Facebook WDA 很长时间没有更新了，这里建议直接使用 Appium WDA

https://github.com/appium/WebDriverAgent

下载项目后，使用 Xcode 打开，Scheme 选择 WebDriverAgentRunner，设备选择真机

然后配置开发者证书，可以参考下面链接进行配置

https://testerhome.com/topics/7220

最后，Xcode 选择 Project 下的 Test 将项目运行到真机设备上

注意：第一次运行 WDA 可能运行失败，需要手动在设置中对证书添加信任

4-2.运行 WDA

真机设备安装完 WDA 后，就可以脱离 Mac，使用 Windows 进行自动化操作了

使用「 tidevice wdaproxy 」命令可以运行 WDA 和端口转发

# 运行 WDA
# 端口转发到8100
# 应用包名：
com.facebook.WebDriverAgentRunner.xingag23.xctrunner
idevice wdaproxy -B
com.facebook.WebDriverAgentRunner.xingag23.xctrunner --port 8100

PS：由于 Xcode 设置证书的时候，更改过 bundle_id，所以这里的包名是一个变量

4-3.编写自动化脚本

接下来，就可以使用 Appium 或 facebook-wda 编写脚本并运行到 iOS 设备上了

以 facebook-wda 为例

首先，我们安装对应的依赖

# 安装facebook-wda依赖
pip3 install -U facebook-wda

接着，编写自动化脚本并运行测试

import wda
import time
# 连接设备
c1 = wda.USBClient()
# c1 = wda.Client("http://10.3.209.175:8100")
print(c.info)
# 极客时间
bundle_id = 'org.geekbang.GeekTime'
# 通过app的bundleId启动App
s = c1.session(bundle_id)
# 休眠5s
s.sleep(5)
# 截图保存到本地
c1.screenshot('sc.png')
# 回到桌面
s.home()

5. 最后

阿里这款 iOS 端自动化工具的主要优点是启动速度快，内存占用低；更重要的是，它是跨平台，稳定性相对较高