airtest+pytest实战教程03—常用API总结

前言#

前面介绍了app页面元素获取并且编写了一个简单的脚本，但是我们对airtest的常用api还不太熟悉。

这篇我们就来介绍一下airtest常用的api。

airtest模块api#

api名称	简介
auto_setup	自动初始化当前已链接设备
connect_device	链接设备
start_app	打开app
stop_app	停止app
install	安装应用
snapshot	拍摄目标设备的屏幕截图并将其保存到文件中
wake	唤醒并解锁目标设备
home	返回目标设备的主屏幕
touch	在设备屏幕上执行触摸操作
text	目标设备上的输入文本。文本输入部件必须首先是活动的。
double_click	双击
swipe	在设备屏幕上执行滑动操作。
pinch	在设备屏幕上执行捏合操作
wait	等待与设备屏幕上的模板匹配
exists	检查设备屏幕上是否存在给定目标
find_all	在设备屏幕上查找所有出现的目标并返回其坐标
assert_exists	断言目标存在于设备屏幕上
assert_not_exists	断言目标在设备屏幕上不存在

poco模块api#

api名称	简介
poco()	调用Poco实例以通过查询表达式选择UI元素。
click	对由UI代理表示的UI元素执行click操作
click(pos)	在给定坐标下对目标设备执行单击（触摸，点击等）操作
get_text	获取UI元素的text属性。如果没有这样的属性，则返回None。
set_text	设置UI元素的text属性。如果UI元素不支持突变，则会引发异常
attr	通过给定的属性名称检索UI元素的属性。如果属性不存在，则返回None。
wait_for_all	在给定的时间内等待所有的poco实例加载完毕，超时则报错
wait_for_any	在给定的时间内等待所有的poco实例中只要有一个加载完毕就返回该实例，超时则报错
exists	测试UI元素是否在层次结构中
long_click	对由UI代理表示的UI元素执行长按操作。
pinch	在给定的运动范围和持续时间下，在此UI上挤压或扩展2个手指。
scroll	滚动屏幕，垂直或水平
start_gesture	手势动作
swipe	执行此UI元素指示的滑动操作。
wait	阻止并等待最长给定时间，然后再显示UI元素。
wait_for_appearance	阻止并等待，直到UI元素出现在给定的超时内。
wait_for_disappearance	阻止并等待，直到UI元素在给定的超时时间内消失。

以上这些就是airtest在自动化测试中常用的api，我只是做了一个汇总，至于对这些api的实际应用用，后面的文章再说。