建立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的默认仓库位置。
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/
使用Jenkins进行android项目的自动构建（3）,布布扣,bubuko.com