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

前言

有很多新手同学在刚开始使用 AirtestIDE 的时候,就特别喜欢新建纯 .py 脚本,我想这可能是出于对纯 .py 脚本莫名的熟悉感吧~

而认真看过我们官方教程的同学都知道,对于刚接触 Airtest 和 Poco 这两个自动化测试框架的新手来说,我们还是非常推荐大家从 .air 脚本开始学起的。

但鉴于在普通的 .py 脚本里面调用 Airtest 或者 Poco 的接口,也是同学们的一个刚需,我们今天就先来看看如何借助 AirtestIDE 来帮助我们新建纯 .py 脚本,并了解下这其中有什么特别的注意事项吧~

本期目录:

1.新建.py 脚本

① 打开你的 AirtestIDE,依次选择 文件 - 新建脚本 - .py 纯Python(高级用户)

② 在弹出的设置窗口,依次设置好各个初始化参数:

③ 按上述设置新建的纯 .py 脚本,初始化内容会如图所示:

我们重点来看下这段初始化代码

if not cli_setup():
    auto_setup(__file__, logdir=True, devices=[
            "Android://127.0.0.1:5037/ZPFABE5DI7WWZLAM?cap_method=JAVACAP",
    ])

这段初始化代码的意思是说,当使用 python xxx.py 来运行本文件,且不带任何命令行参数时,则自动使用 auto_setup 这个接口来对 Airtest 相关的参数进行初始化。这样只需要在写 .py 脚本时,填写好期望的参数就能直接用 python xxx.py 指令来运行脚本。

如果是 python xxx.py --device xx --log xx 这种带命令行参数的,只要脚本检测到传入了命令行参数,就依然优先使用命令行参数来初始化 Airtest 相关的参数。

2.详解 auto_setup() 里面的 logdir 和 devices

① 设置脚本运行时的 log 保存路径--logdir

logdir 的值必须为 True 或者是指定的具体保存路径。如果 logdir 的值为 None 的话,则默认在运行脚本时不保存 log 内容,也就是最终不能生成报告。

如果将 logdir 的值设置为 True ,则表示将 log 内容保存在默认为 .py 文件所在目录下的 log/ 目录:

如果填写具体的保存路径,比如 E:/test/log,此时 log 内容就会被保存在指定目录下:

② 连接设备参数--devices

在新建 .py 脚本时,这个 devices 参数一定要加上,你可以使用当前 IDE 已连接的设备进行初始化,也可以建完脚本之后,自己再手动添加上。

如果没有在 .py 脚本中添加这个连接设备的参数,那么脚本内关于 Airtest 或者 Poco 的脚本将无法正常执行(敲黑板!最常见的就是下图这种情况):

不同设备连接参数的写法也不一样,具体可以参考我们往期的推文:“用 1 行代码搞定自动化测试的设备连接问题”

3.生成纯.py 脚本的报告

生成纯 .py 脚本的报告有俩种方法,一种是借助 IDE 的 查看报告 按钮来生成;另一种是使用 simple_report() 方法生成报告。

① 借助 IDE 的 查看报告 按钮

运行完 .py 脚本以后,点击 IDE 的 查看报告 按钮之后,会弹出一个提示框,让你选择 log 目录所在位置:

此时你只需要选择初始化参数 logdir 所填写的路径,再点击 OK 即可。之后会在默认浏览器打开刚才的脚本运行报告。

② 使用 simple_report() 方法

simple_report() 方法在 airtest.report.report 模块中,所以使用之前,我们需要把这个方法引入进来:

# -*- encoding=utf8 -*-
__author__ = "AirtestProject"

from airtest.core.api import *
from airtest.cli.parser import cli_setup

if not cli_setup():
    auto_setup(__file__, logdir=True, devices=[
            "Android://127.0.0.1:5037/ZPFABE5DI7WWZLAM?cap_method=JAVACAP",
    ])

snapshot(msg="请填写测试点.")

# generate html report
from airtest.report.report import simple_report
simple_report(__file__)

如果初始化的时候,logdir 的值为 True ,即 log 内容被保存在 .py 文件的 log/目录下,则我们可以直接使用 simple_report(__file__) ,无需其它参数,即可帮助我们在 .py 文件所在目录生成脚本运行的报告 log.html:

如果初始化的时候,logdir 的值为指定目录,则在 simple_report(__file__) 里面我们还需要加上以下参数:

# -*- encoding=utf8 -*-
__author__ = "AirtestProject"

from airtest.core.api import *
from airtest.cli.parser import cli_setup

if not cli_setup():
    auto_setup(__file__, logdir="E:/test/log", devices=[
            "Android://127.0.0.1:5037/ZPFABE5DI7WWZLAM?cap_method=JAVACAP",
    ])

snapshot(msg="请填写测试点.")

# generate html report
from airtest.report.report import simple_report
simple_report(__file__,logpath="E:/test/log",output="E:/test/log/log.html")

因为初始化的时候,我们把脚本保存目录用 logdir 参数指定为"E:/test/log",则在生成报告的时候,我们也要去找这个地址的 log.txt,所以需要将 logpath 指定为"E:/test/log"。

另外我们希望 log.html,即网页版的报告也保存在此路径,所以我们将 output 也指定为
"E:/test/log/log.html"。

那么我们可不可以不指定 output 地址呢?当然是可以的,如果我们没有指定 output 地址的话,将默认在 .py 脚本所在的目录下生成 log.html:

关于 simple_report(__file__) 更多参数的详情,可以参考此链接:https://airtest.readthedocs.io/zh_CN/latest/_modules/airtest/report/report.html#simple_report


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

关注下方公众号,可以查看更多往期教程,回复 “交流群” 可以加入我们的官方开发者交流群


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