如何配置jenkins 的环境变量

启动Jenkins

1、 安装jdk

从略，建议1.6或以上版本，配置好环境变量。

2、 安装tomcat

从略，安装完调试下tomcat是否正常。

3、 安装ant

下载zip包，解压后配置好环境变量。

4、 安装jenkins

下载war包，命名为Jenkins，拷贝到tomcat/webapps目录下。

5、 安装Android SDK

下载安装,完成后配置好Android_SDK_HOME环境变量。此步骤主要用于进行android自动化测试，若不进行此项可略过。

安装完成后启动tomcat/bin/startup.bat文件(linux下是startup.sh)，在浏览器输入http：//localhost:8080/jenkins，8080为tomcat端口，即可访问jenkins服务器。

配置Jenkins

1、 JDK配置

新增JDK，指定JDK名字和JAVA_HOME

2、 ANT配置

新增ANT，指定ANT名字和ANT_HOME

3、 Maven配置

从略，本文未使用到Maven，具体配置方法参考Google。

4、 Subversion

选择1.6版本SVN，勾选Update default Subversion credentials cache after successful authentication

5、 邮件通知

填写SMTP server、Default user E-mail suffix、System Admin E-mail Address、Jenkins URL、勾选Use SMTP Authentication，填写User Name、Password、Use SSL、SMTP port、Chareset(UTF-8) 、Default Content Type(默认)、Default Recipients(默认收件人)，配置完成后可进行测试邮件。

6、 Jenkins URL

配置该URL，用于别人访问。

插件管理

1、 Hudson Subversion Plug-in，jenkins的svn插件。

2、 Android Emulator Plugin，android模拟器插件。

3、 JUnit Attachments Plugin，junit测试报告附件插件。

4、 Email-ext plugin，邮件扩展插件。此处说明下，默认Jenkins只会发送构建失败的邮件，我们需安装此插件才能自定义不同场景。

5、 Deploy to container Plugin远程发布插件。

自动化测试

打包源工程

Android程序

本小节讲诉如何打包一个Android工程，当前使用的是ant进行编译源码。

1、 首先构建一个自由风格的Job。

2、 添加源码路径，选择所使用的版本控制器，输入源码路径。

3、 构建触发器可根据需要选择是否定时构建。

4、 构建环境，此处Jenkins安装了Android Emulator Plugin插件，可以启动已有模拟器或添加新的模拟器，本文案例中使用真机调试。

5、 构建，卸载手机中原程序 adb –s uninstall com.XXXXXX

6、 生成bulid.xml文件，-p后面跟工程所在的本地jenkins下路径

android update project -n *** c:\被测工程Job路径\workspace

7、 Ant进行编译程序，并安装到当前手机中

ant debug install -f c:\被测工程Job路径\workspace\build.xml

8、 构建后 *** 作，本案例中构建完成后自动启动构建下一个测试Job

Bulid other projects，选择测试工程的Job.

打包测试工程

Android程序

本小节讲诉如何构建一个Android测试工程，包括邮件发送和测试报告展示。

1、 构建步骤1-7和Android程序章节一样，从略。

2、 本文案例中测试程序是通过命令行启动运行的，所以在此处增加一个批处理运行。P.S. adb shell am instrument -w -e class com.megafon.test.MegafonTest#testDeleteContact com.megafon.test/android.test.InstrumentationTestRunner ，此处是通过批处理来单独运行一个个的测试用例。避免了Junit3的无序执行的问题。

3、 删除Workspace中原来存在的测试报告文件，一般不删除也会覆盖。

如何让测试程序生成xml格式的测试报告，其他文章会重点介绍。

4、 从手机中拷贝测试报告，最终测试是在手机上运行，所以报告也生成在手机中，使用adb pull命令把测试报告全部拷贝到workspace下制定目录。

5、 构建后 *** 作，发布测试报告，如果报告中包含附件，此处使用到JUnit Attachments Plugin插件。

6、 邮件通知，此处使用到Email-ext plugin插件，前面的默认，直接使用我们在系统管理里面设置的默认值。

7、 点击右下角高级按钮，可选择不同场景下发送邮件。

8、 测试结果展示，在本次构建的控制台可以显示当前所有的构建日志。

9、测试报告点击Test Result可以显示所有测试记录。

对于这种启动方式，如果每次都通过命令来启动运行，非常不方便，所以，官方提供了 Installing Jenkins as a Windows service ,这样配置之后，jenkins开机就自启动了。** 这里有个注意点，如果开始通过命令行的方式指定了端口号，那么在Installing Jenkins as a Windows service之后端口号又重新变成了8080（真鸡八巨坑），修改jenkins.xml里面的端口然后重启jenkins服务即可。**

在配置为window service之后碰到一个问题，就是通过java -jar jenkins.war创建的账号和密码登录不上了，默认账号为admin，密码在secrets/initialAdminPassword，如果实在是忘记了，登录不上了，解决方法是到.jenkins目录下面找到config.xml文件，修改注释以下部分内容：

重启jenkins服务，这个时候就可以不用账号和密码进入了，然后可以通过如下方式创建账号和密码： 参考资料

系统管理-->Configure Global Security-->勾选相关：

之后在系统管理选项中就会出现管理用户选项，进入就可以创建用户了。

步骤备注： Manage Roles 这里面主要配置一些角色，并给这些角色分配权限。比如下图，配置了三个角色，每个角色赋予相应权限：

实际 *** 作中只能配置Global roles，其他的角色都不能登录，报错：没有Overall/Read权限。

Assign Roles ：给用户分配角色，比如这里给lz_test01,lz_test02分配的角色为test

要安装gradle和Android SDK，并配置好环境变量

要安装的插件主要有 Gradle plugin , Subversion Plugin(Subversion Plug-in) , SVN Publisher plugin 等

jenkins的相关插件列表戳 这里

关于gradle版本的配置，详见这里如下图，里面有相关的脚本版本配置。

这里注意一下，如果主项目有依赖自己编写的库，并且主项目和依赖库不在同一个路径，这个配置稍微有点改动，首先要把主项目和所有的依赖都添加到modules中，然后设置好Local module directory

关于邮件配置，要注意的地方就是除了要配置如下信息

还要填写如下信息，并且两个地址要一致。

如果要把构建的安装包进行邮件发送，可以参考 http://pissedoff-techie.blogspot.com/2015/11/how-to-configure-jenkins-to-send-build.html ,主要就是安装Email-Ext plugin这个插件，然后在项目中配置构建后 *** 作：

不要忘记设置Triggers

---