此文章来源于项目官方公众号：“AirtestProject”
版权声明：允许转载，但转载必须保留原链接；请勿用作商业或者非法用途
前言
本文将详细介绍如何使用命令行运行脚本、生成报告以及读取报告中的静态资源文件和图片文件。
要用命令行来完成以上的任务，我们就需要用到本地的python环境。所以我们必须保证本地的python环境安装了airtest，否则在执行以上任务时，就会出现 airtest distribution was not found 的错误：
我们可以使用pip list命令来查看当前环境是否安装了airtest：
如果当前环境没有安装airtest，就使用 pip install airtest 命令，然后等待安装完成即可。
使用命令行运行脚本
脚本的运行过程，与报告的生成过程是独立的两个步骤，所以我们可以先用airtest run + 脚本文件路径 指令来运行脚本，该命令的可传参数如下：
--device，用来指定连接的被测设备--log，用来指定log内容和截图存放的目录--recording，运行脚本时进行录屏操作
下面分别介绍下这几个参数的使用方法：
--device
在脚本运行的时候，我们必须连接上一个被测设备。如果在我们脚本的airtest语句之前，没有对设备进行初始化，比如没有运行一个connect_device的语句之类的，在使用airtest run 指令来运行脚本时，就必须传入--device参数，否则命令行会报如下错误：
传入--device参数即可解决上述问题：
# 用airtest运行了report_test.air这个脚本
# airtest run 后面接的是脚本文件的路径
# device参数后面可跟Android、iOS和Windows设备
airtest run D:/test/report_test.air --device Android:///
--log
如果 airtest run 指令没有传入参数--log，那使用命令行运行脚本时，将不保存log内容和截图，并且命令行会提示do not save log：
如果传入的参数为--log log/, 将把生成的log内容放到当前命令行执行目录下的log目录里面：
如果在--log 参数里传入了指定目录，log内容与截图将会放在指定目录里，如图：
--recording
需要在脚本运行时进行录屏操作，则在使用airtest run命令时传入--recording参数即可，录制的视频文件会以MP4格式保存在log内容所在的目录里面。
airtest run D:/test/report_test.air --device Android:/// --log log/ --recording
使用命令行生成报告
在命令行中，使用airtest run指令运行脚本以后，我们就可以使用airtest report + 脚本文件路径指令来生成一份HTML格式的报告。
该命令也有非常多的可传参数，例如：
--log_root，指定log内容和截图文件所在的目录--outfile，指定生成报告的目录--lang，指定报告语言，可以是中文/英文--export，导出一个包含所有资源的报告文件--static_root，指定静态资源文件的路径
需要注意的是，使用 airtest report 指令但没有传入任何参数时，程序会默认去脚本文件所在目录下寻找log/log.txt，然后用找到的内容来生成HTML格式的报告，该报告存放于当前命令行的执行目录下。如果脚本目录里面不存在log/log.txt，命令行则会报错：
所以不传入任何参数来使用airtest report 指令时，需要保证运行时产生的log内容的文件夹必须与脚本文件在同一文件夹内：
--log_root
一些情况下，我们运行脚本时并没有把log内容和截图文件存放在与脚本文件相同的目录下，这时可以用--log_root参数来指定log内容和截图文件所在的目录。假如log内容保存在当前执行目录下的log文件夹里，我们就可以这样指定：
C:\Users\xiaoming>airtest report D:/test/report_test.air --log_root C:/Users/xiaoming/log
log.html
# 命令行显示的log.html表示在当前执行目录下生成了报告log.html
--outfile
当我们不想报告保存到当前执行目录下时，我们就可以用--outfile参数来指定报告生成的目录：
airtest report D:/test/report_test.air --log_root C:/Users/wb.yuxiaojuan/log --outfile E:/log_test/log.html
--lang
- 指定报告语言为中文：
--lang zh - 指定报告语言为英文：
--lang en
注意：如果不指定报告的语言，默认的报告语言为英文。
读取报告中静态资源文件和图片文件
-- export
不传入-- export参数的情况下使用 airtest report 指令，在生成的报告中使用了绝对路径来访问里面的图片文件；同时HTML报告中访问的静态css与js资源文件，也是硬盘上的绝对路径（默认在airtest的安装目录下的report文件夹里）。
因此，直接把HTML格式的报告发送给别人观看，别人是没办法正常观看的。这时我们可以传入 airtest report指令的--export参数，将报告导出到一个指定目录中，然后将整个目录发送给别人观看（该目录会包含报告的静态资源文件和图片文件）。
# 使用了export参数，outfile参数会失效，所以使用了export参数就不要使用outfile
airtest report D:/test/report_test.air --log_root C:/Users/wb.yuxiaojuan/log --lang zh --export E:/log_test/
导出报告的页面中会使用相对路径访问图片和资源文件:
因此，如果要将报告部署到服务器上供其他人查看，同样需要使用 --export 参数来导出报告，这样可以使图片路径为相对路径。
--static_root
每次导出报告时，目录下都会有一份静态资源文件static，它包含了报告中的css和js等文件。一般来说，除非报告的样式做了某些更新，否则这些静态资源文件都是固定不变的。
所以我们可以将这些资源文件部署到静态资源文件服务器上，用例如 https://host:port/static/css/ 的路径来访问它。然后在生成报告时，将这个部署出来的服务器地址作为 --static_root的参数传过去：
airtest report D:/test/report_test.air --log_root C:/Users/xiaoming/log --lang zh --static_root https://host:port --export E:/log_test/
这样报告中会默认去访问--static_root参数传入的服务器地址上，读取静态资源文件，避免导出报告时重复拷贝这些资源文件造成的磁盘空间占用。
关注下方公众号，可以查看更多往期教程；回复“交流群”即可加入我们的测试开发官方交流群
