一、如何脱离AirtestIDE跑自动化脚本

1. 前言

新手同学往往会借助AirtestIDE编写/运行自动化脚本;但是熟练Airtest和Poco框架之后,我们完全可以脱离AirtestIDE编写/运行脚本。

本文将详细讲述脱离AirtestIDE跑脚本的2种方式和注意事项,感兴趣的同学可以认真阅读下述内容哦!

2. 使用命令行跑自动化脚本

1)根据IDE的运行脚本命令跑

我们使用IDE自带的环境跑脚本时,在log查看窗的顶部会刷出运行当前脚本的一条命令,我们可以直接复制该命令去命令行终端运行:

image

直接只用此条命令运行脚本,实际上我们还是利用了AirtestIDE自带的环境跑脚本,好处是我们无需额外部署本地Python环境

image

但这里有一个小细节需要注意下,如命令行中包含类似&&这样的字符,是需要转义的:

  1. # 特殊字符在Windows下的转义
  2. &&-->^&^&
  3. # 特殊字符在Mac下的转义
  4. &&-->/&/&

如果 不转义的话,最终结果是命令行被截断 ,如图中所示,尽管我们的运行命令是指定了log保存路径的,但是仍提示我们do not save log,这是因为该命令从特殊字符&&之后,就被截断了。

并且我们还会在最后的运行log中,看到类似 ‘ori_method’ 不是内部或外部命令,也不是可运行的程序 或批处理文件这样的提示:

image

加上转义之后,就不会出现命令行被截断的情况了:

image

2)部署本地Python环境跑

除了使用AirtestIDE自带的Python环境跑脚本之外,我们还可以部署本地的Python环境来跑脚本。

首先我们要准备一个合适的Python环境,大于Python3,小于等于Python3.9均可。

然后就在这里Python环境里面,像安装其它Python第三方库一样,安装我们的自动化测试框架:

  1. # 安装Airtest框架
  2. pip install airtest
  3. # 安装Poco框架;编写了Poco语句就需要安装
  4. pip install pocoui
  5. # 安装airtest-selenium框架;编写了airtest-selenium语句就需要安装
  6. pip install airtest-selenium

如安装第三方库过程中,出现报错或者超时,请先确保自己的Python版本是在支持范围之内的,然后再 使用清华源或者其它国内源安装

  1. pip install -i https://pypi.tuna.tsinghua.edu.cn/simple airtest

成功安装之后,我们可以使用pip list命令,查看我们的安装情况及框架版本信息:

image

image

(PS: 不能同时安装pocopocoui,俩者会产生冲突!)

接下来,我们就可以在这个环境里面运行我们编写好的自动化脚本了:

  1. airtest run "D:\test_plu\song.air" --device android://127.0.0.1:5037/127.0.0.1:7555 --log "D:/test/test01\ed879c1f10fa732db3e5e2c417ca7221"
  2. # 或者
  3. python -m airtest run "D:\test_plu\song.air" --device android://127.0.0.1:5037/127.0.0.1:7555 --log "D:/test/test01\ed879c1f10fa732db3e5e2c417ca7221"

使用命令运行脚本和生成Airtest报告的内容可以参考我们的往期推文 Airtest报告“全攻略”

3. 使用其它编辑器跑自动化脚本

这里以常见的Python编辑器,pychram为例,详细讲述该如何使用这款编辑器编写/运行自动化脚本。

1)环境部署

我们在pycharm新建项目之后,就需要为该项目设置Python解释器;pycharm支持我们直接设置本地安装好的Python作为解释器,也支持使用虚拟Python环境作为解释器。

这2者的差别是,如果我们直接设置本地安装好的Python作为解释器,那么本地Python安装的所有第三方库都会导入进来为这个pycharm项目所使用:

image

但如果我们是新建了一个虚拟环境的话,则是基于本地的某个Python解释器,复制了一个不带任何第三方包的干净的Python虚拟环境,意思是已经安装到这个本地Python解释器中的所有第三方包都不会复制过来:

image

这也是很多同学刚开始使用pycharm的时候,明明在本地Python环境已经安装好了需要的第三方库,到了pycharm却仍旧找不到第三方库的原因。(需要注意是否是因为使用了虚拟环境)

那在pycharm安装第三方库的方式,就非常简单了,在项目使用的Python解释器里,点击右侧的+ 号,输入想要添加的包名,然后点击 安装包 按钮即可:

image

环境部署好之后,我们就可以着手在pycharm编写/运行脚本了。

直接从AirtestIDE复制脚本到pycharm运行 为例,我们详细了解下有哪些内容我们需要特别注意下的:

2)log保存

首先是脚本运行的log内容保存,我们在AirtestIDE编写和运行脚本,没有考虑过这个问题,是因为AirtestIDE会自动帮我们保存脚本运行的log内容,默认路径是 选项--设置--Airtest--默认Log存放路径 里设置的路径:

image

把代码复制到pycharm运行时,如需保存log内容(为后续生成测试报告做准备),我们就需要手动添加上这块的内容:

  1. # 在auto_setup接口里设置logdir,用于保存log内容
  2. # logdir可以传入具体的log保存路径,或者是True,传入True表示在当前项目目录下生成log内容
  3. auto_setup(__file__,logdir=True)

image

log内容往往包含一些报告所需的步骤截图和一个 log.txt 文件。

3)设备连接

第二个常见的问题,就是在AirtestIDE里,只要设备连接窗口已经连接上指定设备,我们在.air脚本中无需额外处理,运行.air脚本时,就会自动连接设备窗口的当前设备来跑脚本。

而pycharm显然不会帮我们处理设备连接的工作,所以我们需要在脚本中连接上待测设备:

  1. # 在auto_setup接口传入devices参数
  2. auto_setup(__file__,logdir=True,devices=["android://127.0.0.1:5037/127.0.0.1:7555"])

当然,我们还有非常多的接口可以用于连接我们各种待测设备,这里不一一举例,感兴趣的同学可以参考我们的往期推文 用1行代码搞定自动化测试的设备连接问题

4)图片路径

在AirtestIDE截取的图片,默认的路径都是相对路径,保存在.air脚本下,与.py文件同路径:

  1. touch(Template(r"tpl1638179990578.png", record_pos=(0.179, -0.57), resolution=(810, 1440)))

但复制到pycharm执行时,相对路径大概率会发生变化,导致后面同学们运行时,经常出现 airtest.aircv.error.FileNotExistError: File not exist: tpl1638179990578.png 的报错。

此时我们要么修改成正确的相对路径,要么修改成绝对路径,只要保证pycharm能按你设定的路径找得到你的脚本截图即可:

  1. touch(Template(r"D:\test_plu\song.air\tpl1638179990578.png", record_pos=(0.179, -0.57), resolution=(810, 1440)))

5)文件引用路径

很多同学会在自己的自动化脚本里面,调用一些公共脚本,可能是.air脚本,也可能是.py脚本等。

假设我们有如下几个脚本,各脚本的存放关系如下:

image

image

如果我们要在 song.air 脚本里面,调用 common.air 脚本 和 im_ex.py 脚本,可以这么编写脚本:

image

其中,调用 .air 脚本,我们可以使用Airtest提供的专用接口 using ;调用 .py 脚本,就与标准Python无异,直接 from ... import ... 即可。

但当我们在pycharm中打开 song.air 并且运行之后,会发现在AirtestIDE可以运行的脚本,到pycharm就找不到模块了:

image

我们可以通过手工添加 sys.path 的方式,让pycharm能找到 common.air 脚本:

image

6)报告生成

最后一个需要注意的内容就是报告生成啦,在AirtestIDE运行完.air脚本之后,我们可以直接点击 查看报告 按钮,迅速生成并且打开HTML格式的测试报告。

但pycharm并没有这个功能,所以我们需要生成Airtest报告的话,只能在脚本中编写生成测试报告的语句:

  1. # -*- encoding=utf8 -*-
  2. __author__ = "AirtestProject"
  3. from airtest.core.api import *
  4. from airtest.report.report import simple_report
  5. auto_setup(__file__,logdir=True,devices=["android://127.0.0.1:5037/127.0.0.1:7555"])
  6. touch(Template(r"tpl1638243250870.png", record_pos=(-0.362, 0.13), resolution=(810, 1440)))
  7. simple_report(__file__,logpath=True)

使用脚本生成Airtest报告,有很多注意事项:

  • 报告生成语句要放在具体脚本的后面,防止未运行具体步骤就生成了空的测试报告

  • 当脚本中包含poco或者airtest-selenium语句时,需添加对应的报告插件 plugins

  • 不论中间的步骤运行成功与否,都生成测试报告,我们可以使用 try-finally 语句

  • 需要生成测试报告,就必须保存log内容,因为报告的生成依赖于log内容

  • 如需将报告发送给别人查看,需要在生成报告的语句中添加导出参数,只有导出报告才能发送给别人查看

更多关于使用脚本生成测试报告的内容,可以参考我们的往期脚本 Airtest报告“全攻略”,看完直接用脚本生成、导出报告,真香!