使用Jenkins进行android项目的自动构建（3）

建立Jenkins项目

1. “新增作业”->填写作业名称->选择“建置 Maven 2 或 3 專案”->OK。新增成功后会进入“組態設定”，暂时先保留默认值，稍后再进行设定。

2. 按一下“马上建置”，会显示“已排入建置”，然后在“建置歷程”会见到#1的链接，点入该链接并选择“終端機輸出”，这时会见到一个失败的构建记录。当然会失败，因为我们还未为项目加入代码和pom.xml，之所以要进行一次构建，是让系统为我们生成项目目录，目录路径是<Jenkins_dir>/workspace/<project_name> 。

3.  上传项目依赖的包，执行以下命令

mvn install:install-file -Dfile=file.jar -DgroupId=group.id -DartifactId=artifact-id -Dversion=1.0.0 -Dpackaging=jar

DgroupId和DartifactId构成了该jar包在pom.xml的坐标，项目就是依靠这两个属性定位。可以自己起名，如果用自己起的名字，在pom.xml的依赖中就要用自己所以的名字。 Dfile表示需要上传的jar包的绝对路径，文件会上传到Maven的默认仓库位置。要留意Jenkins调用的默认仓库路径和上传的默认仓库路径是否一致，windows环境下的仓库路径一般是 C:\Documents and Settings\<user>\.m2 或 C:\.m2，linux则是 <Jenkins_dir>/.m2 或 ~/.m2。

4. 将android 项目代码和pom.xml加入到项目目录里，然后在按一下“马上建置”，如果代码和pom.xml都正确的话，项目应该会构建成功。

5. 现在再回到“組態設定”界面进行设定

因为之前安装了Git Plugin，所以“原始碼管理”中多了一项Git，填入正确的Repository URL，Credentials 加入用户名和密码。新增Additional Behaviours，加入check out to specific local branch。

“建置觸發程序”可以选择“定期建置”或“輪詢 SCM”，“定期建置”是按规定的时间间隔进行构建，“輪詢 SCM”是按规定的时间间隔轮询Git进行构建。

“新增建置前步骤”可以在建置前执行一些命令。

“Root POM”指定pom.xml的位置，“Goal 及選項”填写构建时mvn 命令和参数，例如mvn clean package -P dev surefire-report:report，surefire-report:report 可以生成surefire report，但此report的html没有css，比较难看。可以先运行一次mvn site生成maven surefire report的html和css，然后保存下来，以后每次构建完成后再执行命令复制到report中。

“新增建置后步骤”可以在建置后执行一些命令。

6. “新增建置后动作”可以在建置后执行一些操作，如果安装了Email Extension Plugin的话，可以在构建完成后发出通知邮件。

“新增建置后动作”->“可编式电子邮件通知”->advanced setting->“add trigger”可以增加触发邮件的条件，通知邮件内容中可以使用Content Token。

通知邮件例子：

本郵件由程序自動發送，請勿直接回覆，謝謝<br/><hr/>

構建編號：$BUILD_NUMBER<br/><hr/>

觸發原因：${CAUSE}<br/><hr/>

單元測試報告：${PROJECT_URL}ws/target/site/surefire-report.html<br/><hr/>

${JELLY_SCRIPT,template="html"}<br/><hr/>
${FILE, path="./file.txt"}

更多可用token

${BUILD_LOG, maxLines, escapeHtml} -显示最终构建日志。

• maxLines – 显示该日志最多显示的行数，默认250行。
• escapeHtml -如果为true，格式化HTML。默认false。

${BUILD_LOG_REGEX, regex, linesBefore, linesAfter, maxMatches,showTruncatedLines, substText, escapeHtml, matchedLineHtmlStyle} -按正则表达式匹配显示构建日志的行数。

• 匹配符合该正则表达式的行数。参阅java.util.regex.Pattern，默认“(?i)\b(error|exception|fatal|fail(ed|ure)|un(defined|resolved))\b”。
• linesBefore -包含在匹配行之前的行编号。行数会与当前的另一个行匹配或者linesAfter重叠，默认0。
• linesAfter -包含在匹配行之后的行编号。行数会与当前的另一个行匹配或者linesBefore重叠，默认0。
• maxMatches -匹配的最大数量，如果为0，则包含所有匹配。默认为0。
• showTruncatedLines -如果为true，包含[...truncated ### lines...]行。默认为true。
• substText -如果非空，把这部分文字插入该邮件，而不是整行。默认为空。
• escapeHtml -如果为true，格式化HTML。默认false。
• matchedLineHtmlStyle -如果非空，输出HTML。匹配的行数将变为<b style=”your-style-value”> html escaped matched line </b>格式。默认为空。

${BUILD_NUMBER} -显示当前构建的编号。

${BUILD_STATUS} -显示当前构建的状态(失败、成功等等)

${BUILD_URL} -显示当前构建的URL地址。

${CHANGES, showPaths, format, pathFormat} -显示上一次构建之后的变化。

• showPaths – 如果为 true,显示提交修改后的地址。默认false。
• format – 遍历提交信息，一个包含%X的字符串，其中%a表示作者，%d表示日期，%m表示消息，%p表示路径，%r表示版本。注意，并不是所有的版本系统都支持%d和%r。如果指定showPaths将被忽略。默认“[%a] %m\n”。
• pathFormat -一个包含“%p”的字符串，用来标示怎么打印字符串。

${CHANGES_SINCE_LAST_SUCCESS, reverse, format, showPaths,changesFormat, pathFormat} -显示上一次成功构建之后的变化。

• reverse -在顶部标示新近的构建。默认false。
• format -遍历构建信息，一个包含%X的字符串，其中%c为所有的改变，%n为构建编号。默认”Changes for Build #%n\n%c\n”。
• showPaths, changesFormat, pathFormat – 分别定义如${CHANGES}的showPaths、format和pathFormat参数。

${CHANGES_SINCE_LAST_UNSTABLE, reverse, format, showPaths,changesFormat, pathFormat} -显示显示上一次不稳固或者成功的构建之后的变化。

• reverse -在顶部标示新近的构建。默认false。
• format -遍历构建信息，一个包含%X的字符串，其中%c为所有的改变，%n为构建编号。默认”Changes for Build #%n\n%c\n”。
• showPaths, changesFormat, pathFormat -分别定义如${CHANGES}的showPaths、format和pathFormat参数。

${ENV, var} – 显示一个环境变量。

• var – 显示该环境变量的名称。如果为空，显示所有，默认为空。

${FAILED_TESTS} -如果有失败的测试，显示这些失败的单元测试信息。

${JENKINS_URL} -显示Jenkins服务器的地址。(你能在“系统配置”页改变它)。

${HUDSON_URL} -不推荐，请使用$JENKINS_URL

${PROJECT_NAME} -显示项目的名称。

${PROJECT_URL} -显示项目的URL。

${SVN_REVISION} -显示SVN的版本号。

${CAUSE} -显示谁、通过什么渠道触发这次构建。

${JELLY_SCRIPT, template} -从一个Jelly脚本模板中自定义消息内容。有两种模板可供配置：HTML和TEXT。你可以在$JENKINS_HOME/email-templates下自定义替换它。当使用自动义模板时，”template”参数的名称不包含“.jelly”。

• template -模板名称，默认”html”。

${FILE, path} -包含一个指定文件的内容

• path -文件路径，注意，是工作区目录的相对路径。

${TEST_COUNTS, var} -显示测试的数量。

• var – 默认“total”。
  • total -所有测试的数量。
  • fail -失败测试的数量。
  • skip -跳过测试的数量。

参考资料：

【1】 http://www.juvenxu.com/2011/05/18/hudson-email-ext/