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

本期我们又给同学们整理了答疑 Q 群中 15 个最常问的问题,包含 如何处理设备状态异常如何选择备选的连接参数 、如何进行 多图查找 或者 多元素查找 等等,后续我们还会持续整理更多常见问题帮助大家避坑哒~

27.如何清空输入框的文本

Airtest 的方式:

for i in range(10):
    keyevent("67")

# 或者
for i in range(10):
    keyevent("KEYCODE_DEL")

Poco 的方式:

# 将输入框内容设置为空字符串,poco("xxx")为输入框的元素定位语句
poco("xxx").set_text("")

28.设备的 3 种状态:device、unauthorized、offline

1)device:设备在线可连接

通常情况下,我们使用 adb devices 命令在命令行查看与本机连接的设备详情,或者在 Airtest IDE 的设备连接窗口查看当前设备列表时,只有设备状态为 device 的设备,才是与本机正常连接且可通讯的设备:

2)unauthorized:未允许 USB 调试

如果开启了手机的 USB调试 选项并且用 USB 线连接好了设备和电脑,却发现设备状态为 unauthorized ,则表示未处理 允许USB调试 的弹窗,允许该弹窗即可:

3)offline:设备掉线不可用

常见于 2 种设备连接情况:

一种是连接模拟器设备,模拟器未启动完全就使用 adb connect 命令连接或者使用过程中模拟器挂了,都会出现模拟器的状态为 offline 的情况。这时候只要重新使用 adb connect 命令再次连接模拟器即可。

另外,也可能是模拟器自带的 adb 版本与 Airtest 自带的 adb 版本不一致,发生了冲突,导致 adb 连接出现问题,也会造成模拟器的状态为 offline 。这时需要将 2 个不一样版本的 adb 统一成一个相同的版本即可。

第二种情况常见于真机的无线连接。WiFi 波动导致设备断连,出现 offline 状态,则需要重新执行 adb connect ip:port 。如还不能解决,则需要将无线连接的所有步骤重来一次,真机无线连接的教程可以参考:https://airtest.doc.io.netease.com/IDEdocs/device_connection/1_android_phone_connection/#3

29. no moudle named 'poco.drivers'

如在运行脚本过程中出现 no moudle named 'poco.drivers' 的报错,则表示当前 python 环境误装了 poco 库,未安装 pocoui 库。

需要注意的是,poco 框架的库名为 pocoui ,并不是 poco,此时需要卸载掉 poco 库,安装正确的 pocoui 库即可:

pip uninstall poco
pip install pocoui

30.安装指定版本的库

命令如下:

pip install -U airtest==1.1.6

31.使用 IDE 截图特别模糊如何处理

如果同学们发现使用 IDE 截出来的图片非常模糊,可以尝试在 AirtestIDE 的 选项--设置 中,把 手机设备显示分辨率 调成 2000,之后再重新连接设备,查看截图清晰度是否有所改善。

如未改善,还可以查看设备连接窗口的设备画面是否清晰,如还是非常模糊的话,可以先断开连接,然后在 conncet 之前勾选 use javacap ,之后再尝试截图。

32.如何判断当前该选用哪种 poco 模式

IDE 的 poco 辅助窗内,给同学们提供了多种 poco 模式:

其中,如果我们测试的是安卓原生应用,则选取其中的 Android 模式即可,安卓的微信小程序也是选择此模式,且该模式不需要应用额外接入 poco-sdk;

如果我们测试的是 iOS 原生应用,则选取其中的 iOS 模式即可,但目前不支持测试 iOS 微信小程序,所以 iOS 模式仅适用于测试 iOS 原生应用的情况,应用也无需额外接入 poco-sdk;

其余模式,如 unity、UE4、Cocos-lua 等,指的是所测游戏项目的引擎类型,使用这些模式时,要求在游戏项目中接入对应的 poco-sdk,并且打出项目包安装在设备上之后,才能使用,比如使用 unity 模式获取 unity 游戏项目的控件树:

33.如何安排脚本初始化、poco 初始化和启动应用的顺序

很多新手在使用 poco 的时候,都容易把连接设备、初始化 poco 和打开应用的脚本顺序搞乱,导致出现一大堆奇妙的报错。

比如大家最常见的:“远程主机强迫关闭了一个现有的连接”“socket connection broken” 等等。

最正确的顺序是:先连接设备(一般在 auto_setup 接口里面连接)--> 再打开应用(一般用 start_app 接口)--> 等应用开启完毕,最后才初始化 poco

# -*- encoding=utf8 -*-
__author__ = "Airtest"
from airtest.core.api import *

# 连接设备
auto_setup(__file__,logdir=True,devices=["Android://127.0.0.1:5037/emulator-5554?cap_method=JAVACAP"])

#启动应用
start_app("com.NetEase")
sleep(6.0)

# 初始化poco
from poco.drivers.unity3d import UnityPoco
poco = UnityPoco()

poco("btn_start").click()

所以同学们在初始化 poco 的时候,千万记住要检查下这几条代码的顺序,避免产生不必要的报错。

34.同一个脚本初始化多个 poco

在同一个脚本内,支持初始化多个不一样的 poco,比如 Android poco 和 unity poco,就是可以共存的:

from airtest.core.api import *

auto_setup(__file__,devices=["android://127.0.0.1:5037/emulator-5554?cap_method=MINICAP_STREAM&&ori_method=MINICAPORI&&touch_method=MINITOUCH"])

from poco.drivers.android.uiautomation import AndroidUiautomationPoco
A_poco = AndroidUiautomationPoco(use_airtest_input=True, screenshot_each_action=False)

sleep(1.0)

A_poco("poco").click()
sleep(2.0)

from poco.drivers.unity3d import UnityPoco
U_poco = UnityPoco()

U_poco("btn_start").click()

但是我们不能在同一个脚本内,反复初始化相同的 poco,比如多次初始化 Android poco,就有可能导致奇奇怪怪的错误出现。

35.指定 python 环境安装第三方库

很多情况下,同学们的电脑里面可能安装了不止一个 python 环境,比如同时存在 python2 和 python3,要在指定的 python 环境下安装第三方库,可使用如下命令:

python3 -m pip install airtest # 在python3环境下安装airtest库
python2 -m pip install airtest # 在python2环境下安装airtest库

除了从命令层面来区分以外,更直接的办法是同学们自己去对应的 python 目录下,用那个目录下的 pip.exe 来安装。

36.三个备选的连接参数

1)备选参数在哪里选择

在 AirtestIDE 的设备连接窗口中,点击 connect 连接设备之前,单击 connect 右侧的下拉按钮,即可找到 3 个连接设备的备选参数:

2)3 个备选参数分别代表什么意思

① 第一个 Use javacap ,是给部分无法正常看到手机画面、minicap 初始化失败 的手机或设备用的,所以模拟器看到黑屏、部分特殊的平板等设备可以考虑勾选这个选项

② 第二个 Use ADB orientation 是用于 屏幕旋转 的,如果在安卓手机屏幕旋转方向检测有问题、或者是部分特殊的平板无法显示正确的屏幕方向时可以勾选

③ 第三个 Use ADB touch 是 发送 adb 指令来点击屏幕 ,效果很差,速度也很慢,不建议勾选,只有在 部分无法点击屏幕的特殊安卓设备 上才需要使用(例如智能后视镜、特殊型号的平板等设备上)正常情况下,手机都可以点击,如果无法被点击(比如小米设备),一般都是因为手机设置有选项漏了打开,特别是小米设备要注意 开启允许模拟点击 的设置

3)是不是把备选参数全带上就能适配所有设备

正常情况下,同学们连接设备是不需要勾选任何备选参数的,我们也不建议大家主动把所有备选参数都勾选上,因为这些备选参数会影响设备连接和使用的效果。

除非是上述提到的特殊情况,比如无法使用 minicap 的设备,可以通过勾选 use javacap 来连接;常见的需要勾选备选参数的设备,MIUI12 的小部分型号,部分模拟器,部分特殊安卓设备等。

4)如何在脚本中添加备选参数

如在 IDE 连接设备时,勾选了一些备选参数,则同学们在脚本中连接该设备,也要添加对应的备选参数。特别是使用此类设备在命令行运行脚本时,千万要记得将参数加在设备连接字符串上:

# 添加了3个备选参数的1个安卓设备
Android://127.0.0.1:5037/79d03fa?cap_method=JAVACAP&&ori_method=ADBORI&&touch_method=ADBTOUCH

37.Airtest 的多图查找

Airtest 没有提供专门的 API 给我们进行多图查找,但是我们可以用简单的语法来实现:

picList = [pic1,pic2,pic3]  # 截图的图片对象列表
for pic in picList:
     pos = exists(pic)
     if pos:
         touch(pos)
         break  # 只要找到图片列表中的任何一张图片,就执行touch

38.poco 的多元素查找

poco 有专门的 API 实现了多元素等待:

# 等待多元素其中的任意一个元素出现
bomb = poco("bomb")
yellow = poco("yellow")
blue = poco("blue")

while True:
    fish = poco.wait_for_any([bomb,yellow,blue])
    print(fish.get_name())

# 等待多元素的所有元素都出现
poco.wait_for_all([yellow,blue,black])

39.'NoneType' object has no attribute xxxx

这个报错可能出现在不同的方法里面,比如:

AttributeError: 'NoneType' object has no attribute 'snapshot'

AttributeError: 'NoneType' object has no attribute 'start_app'

出现这些报错,基本上都是因为同学们在脚本中没有连接设备,所以只要在脚本开头,补充上连接设备的脚本即可。

40.怎么获取 Windows 窗口的句柄

1)在 IDE 的 log 窗口查看

在 IDE 中连接上该 Windows 窗口,然后随便运行 1 个自动化脚本,我们可以在 log 查看窗的最上面,看到运行该脚本的命令,其中包含 Windows 窗口的句柄:

2)使用网上的工具查看

使用 VC 或者 VS 里面 tool 中的 SPY++,也可以查看窗口的句柄、名字、类、类型、大小和位置等。还有其它的一些方法和工具可以自行百度。

41.UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-1: ordinal not in range(128)

编码报错,一般情况下我们可以通过在脚本开头声明编码来规避这个问题:

# -*- encoding=utf8 -*-

如该声明无效,脚本运行到某些 print 中文的语句中,还是会报这个错误,可以单独指定这个中文的编码:

s = '中文'
print(s.decode('utf-8'))

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

官方答疑 Q 群:654700783

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


↙↙↙阅读原文可查看相关链接,并与作者交流