本地安装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
选择插件来安装：
image.png
勾选插件，勾选github，如果公司用的是gitlab也可以勾选gitlab：
image.png
勾选这两个插件后，点击安装：
image.png
安装过程中：
image.png
安装完成，下一步配置用户信息：
image.png
image.png
image.png
image.png
image.png
随便写描述：
image.png
源码管理，选择git，配置git仓库地址和用户名、密码：
image.png
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
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
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
配置完成点击保存。
项目配置：
在完成系统设置后，还需要给需要构建的项目进行邮件配置。
image.png
image.png
image.png
image.png
配置完成后先点击保存。
因为要发送html格式的报告，需要安装一个插件：
image.png
插件安装成功后回到项目中再配置publish html reports：
点击增加构建后操作步骤，选中publish html reports配置测试报告的路径和名称：
image.png
构建项目，查看邮件：
image.png
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
