本地安装jenkins+邮件发送带测试截图的测试报告

一、本地安装jenkins

先下载jenkins包，下载地址：
http://mirrors.jenkins.io/war-stable/latest/jenkins.war
下载之后把jenkins.war可以放到D盘，打开cmd进入放jenkins.war包的目录，输入：
java -jar jenkins.war 就能启动jenkins了，在浏览器中输入:
http://localhost:8080能进入jenkins中

image.png

获取密码，并粘贴进来，密码可以从指定的文件中获取，也可以在cmd的启动jenkins服务的命令中查看：

image.png

选择插件来安装：

image.png

勾选插件，勾选github，如果公司用的是gitlab也可以勾选gitlab：

image.png

勾选这两个插件后，点击安装：

image.png

安装过程中：

image.png

安装完成，下一步配置用户信息：

image.png

随便写描述：

image.png

源码管理，选择git，配置git仓库地址和用户名、密码：

image.png

选择添加的用户名：

image.png

因为在主分支就直接用master，如果有其他分支选择其他分支就行：

image.png

在构建触发器中勾选Build when job nodes start，其他的不用填写：

image.png

在构建--增加构建步骤中选择执行windows 批处理命令（如果jenkins是安装在linux环境中就需要执行shell命令）

image.png

jenkins任务建成后，运行时的工作目录就是：
C:\Users\Administrator.jenkins\workspace\appiumtest
先从git上拉取代码，放到该目录下，然后处理windows命令，mvn clean package打包构建的意思。
填完后点击保存。
任务已经建成：

image.png

点击#5旁边的倒三角，点击控制台输出，查看构建日志：

image.png

构建成功：

image.png

构建的时候手机端也会自动执行测试用例。

二、在jenkins中配置邮件发送测试报告

本人使用的是新浪邮箱，在配置jenkins发邮件之前，需要先登录新浪邮箱，开通smtp服务，这样才能用新浪邮箱的账号和密码授权给jenkins发送邮件。
进入新浪邮箱，点击设置，点击“客户端pop/imap/smtp”，开启POP3/SMTP服务和IMAP4服务/SMTP服务，点击保存：

image.png

同时查看到smtp服务器地址是：smtp.sina.com

注：如果使用的是其他邮箱，请在网上搜索开通SMTP服务获取授权用户名和密码的方法。如果是公司内部邮箱，可以找运维要SMTP服务器地址和授权用户名和密码。

进入jenkins的系统管理--系统设置，找到Jenkins Location

image.png

再找到Extended E-mail Notification：

image.png

再找到SMTP port 端口号是25，固定是25

image.png

再找到邮件通知：
一些配置跟上面的配置一样，勾选通过发送测试邮件测试配置，可以先输入自己的邮箱，点击Test Configuration测试邮件是否发送成功，显示Email was successfully sent就代表发送成功。

image.png

进入邮箱查看发送的邮箱内容，由于没有配置邮件模板，内容过于简单：

image.png

设置html格式的邮件内容：

image.png

html:

<!DOCTYPE html>    
<html>    
<head>    
<meta charset="UTF-8">    
<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>    
</head>    
    
<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4"    
    offset="0">    
    <table width="95%" cellpadding="0" cellspacing="0"  style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">    
        <tr>    
            本邮件由系统自动发出，无需回复！<br/>            
            各位同事，大家好，以下为${PROJECT_NAME }项目构建信息</br> 
            <td><font color="#CC0000">构建结果 - ${BUILD_STATUS}</font></td>   
        </tr>    
        <tr>    
            <td><br />    
            <b><font color="#0B610B">构建信息</font></b>    
            <hr size="2" width="100%" align="center" /></td>    
        </tr>    
        <tr>    
            <td>    
                <ul>    
                    <li>项目名称 ： ${PROJECT_NAME}</li>    
                    <li>构建编号 ： 第${BUILD_NUMBER}次构建</li>    
                    <li>触发原因： ${CAUSE}</li>    
                    <li>构建状态： ${BUILD_STATUS}</li>    
                    <li>构建日志： <a href="${BUILD_URL}console">${BUILD_URL}console</a></li>    
                    <li>构建  Url ： <a href="${BUILD_URL}">${BUILD_URL}</a></li>    
                    <li>工作目录 ： <a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li>    
                    <li>项目  Url ： <a href="${PROJECT_URL}">${PROJECT_URL}</a></li>    
                </ul>    

<h4><font color="#0B610B">失败用例</font></h4>
<hr size="2" width="100%" />
$FAILED_TESTS<br/>

<h4><font color="#0B610B">最近提交(#$SVN_REVISION)</font></h4>
<hr size="2" width="100%" />
<ul>
${CHANGES_SINCE_LAST_SUCCESS, reverse=true, format="%c", changesFormat="<li>%d [%a] %m</li>"}
</ul>
详细提交: <a href="${PROJECT_URL}changes">${PROJECT_URL}changes</a><br/>

            </td>    
        </tr>    
    </table>    
</body>    
</html>

如果想在邮件中展示测试报告地址，可以这样设置html：

<!DOCTYPE html>    
<html>    
<head>    
<meta charset="UTF-8">    
<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>    
</head>    
    
<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4"    
    offset="0">    
    <table width="95%" cellpadding="0" cellspacing="0"  style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">    
        <tr>    
            本邮件由系统自动发出，无需回复！<br/>            
            各位同事，大家好，以下为${PROJECT_NAME }项目构建信息</br> 
            <td><font color="#CC0000">构建结果 - ${BUILD_STATUS}</font></td>   
        </tr>    
        <tr>    
            <td><br />    
            <b><font color="#0B610B">构建信息</font></b>    
            <hr size="2" width="100%" align="center" /></td>    
        </tr>    
        <tr>    
            <td>    
                <ul>    
                    <li>项目名称 ： ${PROJECT_NAME}</li>    
                    <li>构建编号 ： 第${BUILD_NUMBER}次构建</li>    
                    <li>触发原因： ${CAUSE}</li>    
                    <li>构建状态： ${BUILD_STATUS}</li>    
                    <li>测试报告： <a href="${PROJECT_URL}ws/test-output/index.html">${PROJECT_URL}ws/test-output/index.html</a></li>
                    <li>构建日志： <a href="${BUILD_URL}console">${BUILD_URL}console</a></li>    
                    <li>构建  Url ： <a href="${BUILD_URL}">${BUILD_URL}</a></li>    
                    <li>工作目录 ： <a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li>    
                    <li>项目  Url ： <a href="${PROJECT_URL}">${PROJECT_URL}</a></li>    
                </ul>    

<h4><font color="#0B610B">失败用例</font></h4>
<hr size="2" width="100%" />
$FAILED_TESTS<br/>

<h4><font color="#0B610B">最近提交(#$SVN_REVISION)</font></h4>
<hr size="2" width="100%" />
<ul>
${CHANGES_SINCE_LAST_SUCCESS, reverse=true, format="%c", changesFormat="<li>%d [%a] %m</li>"}
</ul>
详细提交: <a href="${PROJECT_URL}changes">${PROJECT_URL}changes</a><br/>

            </td>    
        </tr>    
    </table>    
</body>    
</html>

${PROJECT_URL}ws/test-output/index.html是测试报告的地址。

配置邮件触发机制：

image.png

配置完成点击保存。

项目配置：
在完成系统设置后，还需要给需要构建的项目进行邮件配置。

image.png

配置完成后先点击保存。

因为要发送html格式的报告，需要安装一个插件：

image.png

插件安装成功后回到项目中再配置publish html reports：
点击增加构建后操作步骤，选中publish html reports配置测试报告的路径和名称：

image.png

构建项目，查看邮件：

image.png

在jenkins中点击appiumtest的项目也能看到测试报告，可以点击进入查看报告：

image.png

测试报告会出现格式不正确的情况，解决方法如下：
1、在“系统管理－脚本命令行”中运行如下命令：
System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")

image.png

再查看报告看到格式可能会正确，也可能会出现不正确

2、不过这只是暂时解决，jenkins重启之后，配置会消失，为了解决这个问题，我们需要加入Groovy插件

image.png

然后在项目的构建步骤中加入如下配置即可

image.png

但是在创建时会提示脚本执行失败，导致构建失败。

3、加入Groovy Postbuild插件:

image.png

在项目配置中添加构建后操作，选择Groovy Postbuild,添加脚本：
System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")

image.png

重新构建项目，构建时不会报错，构建成功，查看报告格式正确。
但是重启jenkins服务后仍会出现报告格式不正确的情况。

4、在启动jenkins服务时，启动命令改为：
java -Dhudson.model.DirectoryBrowserSupport.CSP= -jar jenkins.war
不管在linux中还是windows中启动jenkins这个命令都可以使用，启动jenkins后再看报告就不会出现格式错误的情况。

还有两种解决方法请参考：
https://www.jianshu.com/p/0dc97ff17501

三、配置有截图的测试报告

测试报告中显示的截图是需要在代码中增加Reporter.log的日志

        Reporter.log("<a href=http://localhost:8080/job/appiumTest/ws/testimages/" +photoname+ " target=_blank>"+photoname+"</a>", true);
        Reporter.log("<img src=http://localhost:8080/job/appiumTest/ws/testimages/"+photoname+" style=width:30px;height:30px img/>", true);

其中http://localhost:8080/job/appiumTest/ws/testimages/ 是截图放置的路径
photoname是截图文件的名称
具体在测试报告中的展示为：

image.png

四、深入了解配置邮件模板请参考：

https://blog.csdn.net/u013066244/article/details/78665075