从.air脚本到纯.py脚本的距离究竟有多远

前言

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

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

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

本期目录：

• 1.新建.py脚本
• 2.详解auto_setup()里面的logdir和devices
• 3.生成纯.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官网：http://airtest.netease.com/
Airtest教程官网：https://airtest.doc.io.netease.com/
搭建企业私有云服务：https://airlab.163.com/b2b