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

1. 前言

今天我们来聊一个非常实用的话题！有很多同学提过，我能不能修改 Airtest 报告显示的步骤名称，不想要 touch 全部显示成 点击 ，控件点击全部显示成 Poco Click 之类的：

那今天我们就利用 --plugins 参数传入插件，来实现同学们的这个需求。

2. --plugins参数简介

可能还有很多同学不那么熟悉 --plugins 这个参数，这里简单解释一下。在生成 Airtest 报告的命令 airtest report + 脚本路径 后面，支持添加 --plugins 参数，传入报告插件，用来对报告内容做一些简单的定制。

如果我们生成的是纯 Airtest 脚本的报告，其实是不用理会这个参数的（定制除外）。

但如果我们生成带有 poco 或者 airtest-selenium 脚本的报告，就需要带上这个参数，传入项目给出的对应插件，用于对 poco/airtest-selenium 语句的解析和处理，并修改一些显示效果。

1）生成 poco 脚本报告的插件示例

我们以包含 Poco 语句的脚本报告为例，来看下传入项目给出的插件和不传入插件的差别：

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

from airtest.core.api import *
from airtest.report.report import simple_report,LogToHtml

auto_setup(__file__)

from poco.drivers.android.uiautomation import AndroidUiautomationPoco
poco = AndroidUiautomationPoco(use_airtest_input=True, screenshot_each_action=False)

poco(text="网易云音乐").click()

• 不添加 --plugins 参数生成的报告：

• 添加 --plugins 参数生成的报告：

这就是命令行里 --plugins 这个参数的作用，可以传入指定的插件，用来修改报告内容。

具体它做了什么事，可以直接看源码： https://github.com/AirtestProject/Poco/blob/master/poco/utils/airtest/report.py

我们也可以在 AirtestIDE 的AirtestIDE\poco\utils\airtest\report.py路径下找到源码文件：

同理，给含有 airtest-selenium 语句的脚本生成报告，也可以使用下述方式传入对应的插件：

--plugins airtest_selenium.report

我们也可以在 AirtestIDE 的AirtestIDE\airtest_selenium\report.py路径下面找到 airtest-selenium 的报告插件文件：

3. 对 Airtest 报告做步骤标题的内容定制

那我们了解了如何利用 --plugins 参数传入插件来修改 Airtest 报告内容之后，这里再以一个最简单的修改范例，看下 如何写出自己的插件来对 Airtest 报告做标题定制 。

1）查看插件源码找到用来显示报告左侧标题的内容

以修改 Airtest 的 touch 步骤标题为例。我们可以先查看一下，airtest 的 report.py 的源码：https://github.com/AirtestProject/Airtest/blob/master/airtest/report/report.py 。

可以看到有个叫 _translate_title 的方法，是专门用来显示报告左侧标题内容的：

def _translate_title(self, name, step):
        title = {
            "touch": u"Touch",
            "swipe": u"Swipe",
            "wait": u"Wait",
            "exists": u"Exists",
            "text": u"Text",
            "keyevent": u"Keyevent",
            "sleep": u"Sleep",
            "assert_exists": u"Assert exists",
            "assert_not_exists": u"Assert not exists",
            "snapshot": u"Snapshot",
            "assert_equal": u"Assert equal",
            "assert_not_equal": u"Assert not equal",
        }

        return title.get(name, name)

也就是说，假如脚本里面调用了 touch 函数，报告里会对应地用函数名称找到对应的标题 Touch 。

2）如何自定义插件

我们可以写一个插件，来替换掉 _translate_title 的返回值，可以去模仿一下 poco.utils.airtest.report 的源码是怎么写的：

假如我们想把touch步骤对应的标题Touch，修改成Click，可以自定义 1 个这样的插件 new_report.py ：

# -*- coding: utf-8 -*-
import airtest.report.report as report

old_translate_title = report.LogToHtml._translate_title

def new_translate_title(self, name, step):
    title = old_translate_title(self, name, step)

    if title == "Touch":
        title = "Click"
    return title

report.LogToHtml._translate_title = new_translate_title

这段代码的意思是，用一个新的函数 new_translate_title，来替换掉原本 airtest 模块里的LogToHtml当中的 _translate_title方法。

3）通过--plugins 传入自定义插件

写好报告插件之后，为了快速演示效果，我们把插件保存到与当前 .air 脚本同层目录下，并且按住 shift+右键 在当前目录下打开 cmd/PowerShell：

不传入我们自定义的插件生成的报告，touch 步骤依旧是按旧插件的内容显示：

airtest report D:\test_plu\song.air -log_root D:/test/test01\ed879c1f10fa732db3e5e2c417ca7221 --outfile  D:\test_plu\song.air\old_re.html

传入我们自定义的插件，步骤标题就会按照我们自定义的插件内容来显示了：

python -m airtest report song.air --log_root D:/test/test01\ed879c1f10fa732db3e5e2c417ca7221 --outfile  D:\test_plu\song.air\new_re.html --plugins new_report

可以看到步骤标题上，原本的 Touch 已经被替换成了 Click 。

4. 拓展：报告插件加载的原理

关于报告插件加载的原理，我们可以直接看源码： https://github.com/AirtestProject/Airtest/blob/master/airtest/report/report.py#L73-L82 。

Airtest 使用了 python 的 __import__ 来尝试导入插件模块，比如 poco 中的 airtest 报告插件，在 import 的时候是 import poco.utils.airtest.report ，因此在命令行中我们用了--plugins poco.utils.airtest.report 来导入。

如果想要在非当前目录下导入自定义的报告插件，直接传入路径是不行的，比如试图传入 --plugins d:\test\report\new_report.py 这样的参数，会发现无法加载成功。

我们可以开个 python 终端试一下：

>>> __import__("d:\\test\\report\\new_report.py")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'd:\\test\\report\\new_report'

但是如果尝试把文件所在路径加入到系统 PATH 中，sys.path 添加完路径后就能够找得到了:

>>> import sys
>>> sys.path.append("d:\\test\\report")
>>> __import__("new_report")
<module 'new_report' from 'd:\\test\\report\\new_report.py'>

>>> import sys
>>> from airtest.report.report import LogToHtml
>>> sys.path.append("d:\\test\\report")
>>> rpt = LogToHtml(r"D:\test\report\yongli.air", r"D:\test\report\logs", plugins=["new_report"])
[14:32:22][DEBUG]<airtest.report.report> try loading plugin: new_report
>>> rpt.report()

这时候再去打开生成的 html 文件，就发现成功生效了，可以看到刚才执行完 LogToHtml 之后 airtest 自动打了一条加载插件的 log 出来，说明成功加载到了。
注意plugins的参数是一个 list，因为支持多个插件传入。

5. 小结

了解了如何 自定义插件 并且知道了 插件的加载原理 之后，我们就可以着手 “定制” 自己的 Airtest 报告了。

举个例子，我们在进行一些控件点击的时候，通常会使用如下的脚本：

poco(text="网易云音乐").click()

假设我们自定义了 1 个 poco 插件，可以让这条脚本的步骤标题显示成 “点击控件：网易云音乐”，会不会比统一的Poco Click看着要更清晰明了一些呢？

当然，这种定制款的 Airtest 报告就有待同学们去深入挖掘啦，毕竟每位同学的需求或者阅读习惯都是不一样的，希望大家早日 “定制” 出让自己满意的 Airtest 报告。

---

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

官方答疑 Q 群：654700783

呀~这么认真都看到这里啦，帮忙点击左下角的爱心，给我点个赞支持一下把，灰常感谢~