此文章来源于项目官方公众号：“AirtestProject”
版权声明：允许转载，但转载必须保留原链接；请勿用作商业或者非法用途

1. 前言

本次更新为 Airtest 库更新，版本提升至 1.3.0.1 版本，主要新增了一些 iOS 设备相关的装包等接口，以及封装了一些 tidevice 常用接口。更多更新详情，详见我们下文的描述。

2. 新增 iOS 设备接口

1）iOS 安装接口：install、install_app

对于 本地 USB 连接的 iOS 设备 ，新版本支持装包功能：

# 可以直接使用install接口，支持通过本地.ipa文件安装APP，也支持通过下载链接安装APP
install(r"D:\demo\test.ipa") 
install("http://www.example.com/test.ipa") 

# 也可以先获取当前设备，用device().install_app的方式装包
dev = device()

dev.install_app(r"D:\demo\test.ipa")
dev.install_app("http://www.example.com/test.ipa") 

2）iOS 卸载接口：uninstall、uninstall_app

对于 本地 USB 连接的 iOS 设备 ，新版本支持卸载功能：

# 可以直接使用uninstall接口卸载包体
uninstall("com.netease.cloudmusic")

# 也可以先获取当前设备，用device().uninstall_app的方式卸载包体
dev = device()

dev.uninstall_app("com.netease.godlike")

3）列出 iOS 设备所有 APP 的接口：list_app

对于 本地 USB 连接的 iOS 设备 ，新版本支持列出 APP 列表的功能：

在 list_app("user") 里传入要列出的 app 类型，我们可以得到相应的 app 列表。
参数可选 user/system/all， 分别表示列出用户安装的 app/系统 app/全部 app。
返回值示例：[('com.apple.mobilesafari', 'Safari', '8.0'), ...] 。

dev = device()

#列出并打印全部APP
all_app = dev.list_app("all")
print(all_app)

#打印系统APP
print(dev.list_app("system"))

#列出并打印用户安装的APP
user_app = dev.list_app("user")
print(user_app)

4）iOS 剪切板功能：get_clipboard、set_clipboard

对于 iOS 设备（本地、远程均可），新版本支持剪切板功能：

#获取剪切板内容
text = get_clipboard()
print(text)

#设置剪贴板内容
set_clipboard("content")

注意：当 iOS 设备为 远程设备 、或者 安装了不止一个 wda 时，需要指定具体的 wda_bundle_id 才能使用：

#获取剪切板内容
text = get_clipboard(wda_bundle_id="com.WebDriverAgentRunner.xctrunner")

#设置剪贴板内容
set_clipboard("content", wda_bundle_id="com.WebDriverAgentRunner.xctrunner")

3. 新增 tidevice 相关接口

针对本地 USB 接入的 iOS 设备，Airtest 结合 tidevice 的能力，封装了一个 TIDevice 对象，提供了几个常用接口如下：

• devices ：列出 USB 连接的所有设备的 UDID 列表
• list_app ： 列出手机上安装的应用列表，支持对类型进行筛选，包括 user/system/all
• list_wda ： 列出手机上安装的所有 WDA 的 bundleID
• device_info ：获取手机信息
• install_app ：安装 ipa 包，支持本地路径或 URL
• uninstall_app：卸载 bundle_id 对应的包体
• start_app ：启动 bundle_id 对应的包体
• stop_app ：停止 bundle_id 对应的包体
• ps ： 获取当前的进程列表
• ps_wda ： 获取当前启动中的 WDA 列表
• xctest：启动 WDA

可以参考：https://github.com/AirtestProject/Airtest/blob/master/tests/test_tidevice.py 。

代码执行效果示例：

>>> from airtest.core.ios.ios import TIDevice
>>> devices = TIDevice.devices()
>>> print(devices)
['10da21b9091f799891557004e4105ebab3416cb9']
>>> udid = devices[0]

>>> print(TIDevice.list_app(udid))
[ ('com.230316modified.WebDriverAgentRunner.xctrunner', 'wda-Runner', '1.0'),]

>>> print(TIDevice.list_app(udid, "system"))
[('com.apple.calculator', 'Calculator', '1.0.0'),]

>>> print(TIDevice.list_wda(udid))
['com.test.WebDriverAgentRunner.xctrunner']

>>> print(TIDevice.device_info(udid))
{'productVersion': '12.4.8', 'productType': 'iPhone7,2', 'modelNumber': 'MG472', 'serialNumber': 'DNPNW6EJG5MN', 'timeZone': 'Asia/Shanghai', 'uniqueDeviceID': '10da21b9091f799891557004e4105ebab3416cb9', 'marketName': 'iPhone 6'}

>>> TIDevice.start_app(udid, "com.apple.mobilesafari")

>>> TIDevice.stop_app(udid, "com.apple.mobilesafari")

>>> print(TIDevice.ps(udid))
[ {'pid': 215, 'name': 'MobileMail', 'bundle_id': 'com.apple.mobilemail', 'display_name': 'MobileMail'}]

>>> print(TIDevice.ps_wda(udid))
['com.test.WebDriverAgentRunner.xctrunner']

另外，TIDevice.xctest 接口的执行示例如下：

import threading
wda_bundle_id = TIDevice.list_wda(udid)[0]
# 创建一个线程，执行xctest
t = threading.Thread(target=TIDevice.xctest, args=(udid, wda_bundle_id), daemon=True)
t.start()
time.sleep(5)
ps_wda = TIDevice.ps_wda(udid)
print(ps_wda)
time.sleep(5)
# 终止线程
t.join(timeout=3)

4. 新增错误类型 NoDeviceError

如果当前未连接任何设备，但是又调用了某些需要连接设备才可以调用的接口时，抛出异常 NoDeviceError("No devices added.") ：

5. using 接口的改动

using 接口的作用是，支持在脚本中引用另外一个脚本，同时还能够让 Airtest 正确地读取到其他脚本中的图片路径。

假设目录结构如下：

demo/
    foo/
        bar.air
    baz.air
    main.py

如果我们希望在 main.py 中引用 foo/bar.air 和 baz.air，可以将项目根路径设置到 ST.PROJECT_ROOT ，或者确保项目根路径是当前工作目录：

# main.py
from airtest.core.api import *
ST.PROJECT_ROOT = r"D:\demo"  # This line can be ignored if it is the current working directory
using("foo/bar.air")
using("baz.air")

如果我们希望在 foo/bar.air 中引用 baz.air ，可以这样写：

# foo/bar.air
from airtest.core.api import *
using("../baz.air")

6. 其它优化与改动

• 当 Airtest 脚本引发了 assert 异常时，退出码为 20 ，以便和其他报错区分
• 更新了 Yosemite.apk ，修复了一些稳定性问题
• windows 平台新增接口 set_focus ，与原先的 set_foreground 功能相同

7. 如何更新

因本次更新仅更新了 Airtest 库，所以同学们目前只能在自己本地 python 环境中，将 Airtest 更新到最新版本：

pip install -U airtest

对于使用 AirtestIDE 的同学，可以等我们发布 1.2.16 版本的 IDE，或者在旧版本 AirtestIDE 中设置使用本地 python 环境，然后将本地 python 环境的 Airtest 库升级到最新版本即可。

8. 更新常见问题

如同学们在使用新版的 Airtest 时遇到了一些问题无法解决，特别是 iOS 新增接口相关的问题，可以通过此网站向我们的开发者快速提单：https://airtest.netease.com/issue_create 。

可以在标题中加入 “Airtest1.3.0.1” 之类的字眼，方便我们快速筛选和排查。

Airtest 官网：https://airtest.netease.com/
Airtest 教程官网：https://airtest.doc.io.netease.com/
搭建企业私有云服务：https://airlab.163.com/b2b

官方答疑 Q 群：117973773

呀~这么认真都看到这里啦，帮忙点击左下角的爱心，给我点个赞支持一下把，灰常感谢~