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

前言

有很多新手同学在刚开始使用 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 官网：airtest.netease.com/
Airtest 教程官网：airtest.doc.io.netease.com/
搭建企业私有云服务：airlab.163.com/b2b

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