此文章来源于项目官方公众号：“AirtestProject”
版权声明：允许转载，但转载必须保留原链接；请勿用作商业或者非法用途
今天我们来聊一个非常实用的话题！有很多同学提过，我能不能修改 Airtest 报告显示的步骤名称，不想要 touch 全部显示成 点击 ，控件点击全部显示成 Poco Click 之类的：
那今天我们就利用 --plugins 参数传入插件，来实现同学们的这个需求。
--plugins参数简介可能还有很多同学不那么熟悉 --plugins 这个参数，这里简单解释一下。在生成 Airtest 报告的命令 airtest report + 脚本路径 后面，支持添加 --plugins 参数，传入报告插件，用来对报告内容做一些简单的定制。
如果我们生成的是纯 Airtest 脚本的报告，其实是不用理会这个参数的（定制除外）。
但如果我们生成带有 poco 或者 airtest-selenium 脚本的报告，就需要带上这个参数，传入项目给出的对应插件，用于对 poco/airtest-selenium 语句的解析和处理，并修改一些显示效果。
我们以包含 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 的报告插件文件：
那我们了解了如何利用 --plugins 参数传入插件来修改 Airtest 报告内容之后，这里再以一个最简单的修改范例，看下 如何写出自己的插件来对 Airtest 报告做标题定制 。
以修改 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 。
我们可以写一个插件，来替换掉 _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方法。
写好报告插件之后，为了快速演示效果，我们把插件保存到与当前 .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 。
关于报告插件加载的原理，我们可以直接看源码： 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，因为支持多个插件传入。
了解了如何 自定义插件 并且知道了 插件的加载原理 之后，我们就可以着手 “定制” 自己的 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
呀~这么认真都看到这里啦，帮忙点击左下角的爱心，给我点个赞支持一下把，灰常感谢~
