【更新公告】AirtestIDE更新至1.2.16版本

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

1. 前言

本次更新为AirtestIDE、Airtest、Poco更新。

AirtestIDE更新至1.2.16版本,Airtest更新为1.3.1版本,Poco更新为1.0.92版本,主要为iOS内容更新、新增Android剪切板功能、poco问题修复等。更多更新内容详见下文。

2. 更新内容

1)AirtestIDE更新至1.2.16版本

新版IDE主要是新增了一个iOS直连面板,方便我们快速连接iOS设备;以及更新了内置python环境的airtest、poco库,将其提升到上述的最新版本。

iOS直连面板的使用步骤如下:

  1. iOS设备先预装好wda,确保wda正确安装且可正常启动使用即可,安装详情可以参照我们官方文档
  2. 使用usb数据线连接设备,window系统用户记得下载并打开iTunes

    注意:

    • 如果iOS系统在15.0以上的设备,打开iTunes后需要点击以下弹窗的继续:

    • 如果iOS系统低于15.0的设备,打开iTunes后会跳出升级iOS系统的弹窗,需要点击取消(我们目前暂时还无法适配iOS17,故谨慎升级):

  3. 点击iOS设备连接窗口的刷新设备按钮,记得点击设备上信任弹窗
  4. 点击connect,进行连接;当设备装有多个wda时,点击switch wda下拉列表,也可以切换不同的wda启用

在点击刷新设备后,connect按钮置灰有两种原因:

  1. iOS设备没有任何可用的wda,IDE无法进行连接使用
  2. iOS设备所安装的wda启动中,暂不可用,稍等一会即可恢复

相比于1.2.15版本,airtest直接从1.2.10提升至了1.3.1:

Poco也是从1.0.89提升至了1.0.92:

2)Poco更新至1.0.92版本

该版本主要有以下更新内容:

  • 新增 poco.dump() 接口,效果等同于之前的poco.agent.hierarchy.dump()接口,让调用更简单
  • 新增 poco.double_click() 双击接口
  • 在android poco主动调用 stop_running 时,释放申请的端口号
  • 更新了PocoService.apk,对一些机型兼容性更好

3)Airtest更新至1.3.1版本

该版本主要是更新了几个小功能以及做了一些修复:

  • ① Airtest报告中现在将会显示connect_device接口连接的设备

  • ② iOS和Android设备在连接时,支持传入name 参数,用于指定它的 udid(ios)serial number(android)
# iOS设备 
ios:///http://10.240.145.171:20092?name=83282c400efc9122e3bcba60c803cf318a6b3822

# 安卓远程设备 
android://127.0.0.1:5037/10.227.71.86:20029?name=serialno
  • ③ 支持指定ADB:现在将会优先使用当前的ADB进程,或者是系统变量设置了 ANDROID_HOME 中的ADB,如果都找不到,才会使用airtest里的ADB。同时也支持直接指定 adb_path ,例如:
from airtest.core.android.android import Android, ADB

adb = ADB(adb_path=r"D:\adb\adb.exe")

# 或者可以初始化一个指定了adb_path的Android设备对象
dev = Android(serialno="5TSSMVBYUSEQNRY5", adb_path=r"D:\test\adb41\adb.exe")
  • ④ 新增了Android 剪切板功能
text = "test_clipboard"
set_clipboard(text) # 设置剪切板内容

get_text = get_clipboard() # 获得剪切板内容
print(get_text)  # -> test_clipboard

# 剪切板粘贴接口
paste()  # => text(get_clipboard())
  • ⑤ 如果遇到了手机画面只有一半的情况,重新连接画面即可恢复

3. 如何更新

1)覆盖更新

打开AirtestIDE时,如收到下述的更新提示,可以直接选择点击左下角的【更新】按钮来完成覆盖更新:

特别注意:更新过程切勿中断,如覆盖更新时因为某些异常中断,可能导致覆盖更新失败,无法正常打开AirtestIDE。

此时我们可以卸载掉更新失败的AirtestIDE,然后到官网上下载最新版。

另外覆盖更新之前,请检查是否将脚本保存到了AirtestIDE的文件路径内,如有请备份脚本后再进行覆盖更新,否则进行 覆盖更新操作后也会覆盖掉保存在AirtestIDE路径下的脚本

2)到官网上下载最新版本

官网下载地址:https://airtest.netease.com/index.html

3)本地Python环境库更新

如需把本地Python环境的库更新至与1.2.16一样的环境,可以使用如下命令:

# airtest最新版为1.3.1
pip install -U airtest

# pocoui最新版为1.0.92
pip install -U pocoui

4. 其它问题

1)覆盖更新失败

如果同学们在覆盖更新的时候,不能正确更新的话,可以删掉这个目录下的所有内容,再重新检查更新并执行更新操作:

C:\Users\xxx\AppData\Local\AirtestIDE\AirtestIDE

或者 直接到我们官网上下载一个最新的版本

2)旧版没问题,更新后出现xxx问题

如果同学们遇到,旧版使用没问题,但更新后出现xxx问题的情况,请务必给出详细的信息向我们提问:

  • 旧版本信息(IDE版本,是否使用本地python环境,若使用本地安装的airtest和pocoui版本如何)
  • 新版本信息(IDE版本,是否使用本地python环境,若使用本地安装的airtest和pocoui版本如何)
  • 进行了怎么样的操作/运行了怎么样的代码
  • 旧版表现如何,新版表现如何(如出现报错,请提供完整的报错信息)

如无法提供上述详细信息,开发者将可能很难帮助同学们查到问题所在。

3)向开发组提单

其他关于新版使用过程的任何问题/建议,都可以向我们的开发组提单:https://airtest.netease.com/issue_create 。(提单时标题备注1.2.16版本IDE可以让开发者快速定位)


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

官方答疑 Q 群:117973773

热门相关:神武觉醒   我邻居的老婆   我家影后超甜的   星界游民   试婚老公,用点力!