Windows下Android项目搭建Jenkins持续构建+自动化测试

PS: 该文章写的非常详细,接下来将进行具体操作。

使用持续集成和自动化测试的好处就不说了,网上一搜一大把,不太了解的可以去Googlesearch。下面开始介绍如何在Windows环境下为Android项目搭建Jenkins。本文中使用的版本管理工具是SVN,大部分内容都参考自Jenkins官网,而且本文不考虑SDKTools 14以下的情况。

 

安装Jenkins +建立项目

1, 打开http://jenkins-ci.org/,下载jenkins.war。

2, Jenkins的安装非常简单,可以直接在命令行中使用java –jar jenkins.war运行,也可以将jenkins.war放在tomcat中去执行。

3, 打开Jenkins的系统管理>系统设置:

a)        在jdk中填入jdk安装地址。

b)        在ant中填入ant安装地址。

c)        在最下面的邮件通知中设置邮箱的smtp地址等信息。设置完成后可以测试是否设置成功。

4, 打开系统管理>插件管理>可选插件,安装如下插件:

a)        ant

b)        Android EmulatorPlugin

c)        Jenkins Emma plugin

d)        FindBugs Plug-in

5, 在Eclipse中新建一个Android项目以及测试项目,假设你的项目目录结构如下所示:

/workspace/android-app

/workspace/android-test

安装ApacheAnt。

1.        在Eclipseworkspace下为Android app项目添加ant,执行:

android update project -pandroid-app

2.        为测试项目添加ant,执行:

android update test-project -m../android-app -p android-test

3.        现在app项目中生成了local.properties文件,这个文件应该在版本控制工具中设置为忽略;在test项目中现在生成了ant.properties和local.properties两个文件,这两个文件必须要加入版本控制工具中(SVN)。

4.        在命令行中执行下面的代码看看ant是不是成功运行了:

ant clean debug

5.        开启一个Android模拟器,然后在test工程下执行下面的代码看看测试工程是否可以成功运行:

ant all clean emma debuginstall test

6.        如果成功的话会在测试工程下生成coverage目录,内含一个名为coverage.html的文件,里面是测试用例的覆盖率等数据。

 

安装Emma

        Emma用于在Jenkins中生成出Ant执行的测试用例的报表,上面我们测试后生成的是html格式的,但是要想在jenkins中生成图形等,则必须生成出xml格式的文件。

1, 打开SDK安装目录,打开tools/ant/build.xml,复制其中名为coverage的target到你的测试项目中的build.xml文件中。

2, 将<html outfile="coverage.html"/>节点替换成:

<html outfile="coverage.html"/>

<xmloutfile="coverage/coverage.xml" />

3, 将<ehco>节点替换成:

<echo>Saving the report filein${basedir}/coverage/coverage.xml</echo>

4, 再次运行:ant all clean emmadebug install test命令后,在coverage文件夹中多了一个coverage.xml 文件的话则成功。

 

安装FindBugs

        FindBugs用来找到你的项目中的bug,目前我还没有使用到它。不过Jenkins官方文档中的步骤将它配置了,所以我们也来做它的配置。

1, 下载FindBugs,将其中lib/findbugs-ant.jar 拷贝到Ant安装目录下的lib文件夹中。

2, 在app工程文件夹下的local.properties文件中加入:findbugs.home=** 其中**为你的findbugs的安装目录。

3, 如果你需要在R.java中查找bug的话则需要在app工程目录下添加一个名为findbugs-exclude.xml的文件,在其中写入下面的代码。

       <?xmlversion="1.0" encoding="UTF-8"?>

                   <FindBugsFilter>

                                      <Match>

                                                         <Class name="~.*\.R\$.*"/>

                                                         <Bug code="Nm"/>

                                      </Match>

                   </FindBugsFilter>

4, 在app工程目录下的build文件中加入下面的代码。

<taskdefname="findbugs"classname="edu.umd.cs.findbugs.anttask.FindBugsTask"/>

<targetname="findbugs">

<mkdirdir="reports" />

        <findbugs home="${findbugs.home}" output="xml"outputFile="reports/findbugs.xml"excludeFilter="findbugs-exclude.xml">

          <auxClasspath path="${android.jar}"/>

          <class location="${out.dir}"/>

</findbugs>

</target>

5, 执行ant clean compilefindbugs 后在app工程目录下生成一个名为reports的文件夹,里面包含了一个名为findbugs.xml的文件。

 

配置jenkins

        Jenkins环境修改:

1, 下载android-junit-report-1.2.6.jar(可以下载更新的版本),将它加入test工程的build path中。

2, 修改testproject的AndroidManifest.xml,找到tag "instrumentation" 将属性"android:name"的值改成 com.zutubi.android.junitreport.JUnitReportTestRunner。

3, 打开test工程下的build.xml,在</run-test-helper>节点后加入下面的代码:<echo>DownloadingXML test report...</echo>

<execexecutable="${adb}" fail>

<argline="${adb.device.arg}"/>

<argvalue="pull" />

<argvalue="/data/data/${tested.manifest.package}/files/junit-report.xml"/>

<argvalue="junit-report.xml" />

</exec>

4, 找到其中名为test.runner的property节点,将它的值改为:com.zutubi.android.junitreport.JUnitReportTestRunner

 

        配置App工程:

1, 添加一个自由风格任务,选择subversion,将app项目的svn地址填入(第一次使用的时候会要求提供svn账户密码)。

2, 添加一个InvokeAnt构建步骤,在其中的Targets填入clean compile findbugs。

3, 在高级选项中的properties填入下面内容(注意填自己的安装信息):sdk.dir=D:\\WORK\\ENVIROMENT\\ANDROID\\AndroidSDK

findbugs.home=D:\\WORK\\ENVIROMENT\\FingBugs\\findbugs-2.0.0

4, 构建后选项选择:Publish FindBugsanalysis results,然后填入:reports/findbugs.xml。

5, 选择Archive theartifacts,这样可以在每次构建后提供构建出来的apk版本。

6, 勾选E-mailNotification选项,在下面的recipients中填入需要接收构建异常信息的联系人邮件地址。勾选“每次不稳定的构建都发送邮件通知”选项。

配置test工程:

1, 添加自由风格任务,选择subversion,将test项目的svn地址填入。

2, 在InvokeAnt的target中填入:all clean emma debug installtest。

3, 在buildfile中填入build.xml。

4, 在properties中填入sdk.dir=D:\\WORK\\ENVIROMENT\\ANDROID\\AndroidSDK。

5, 勾选Publish JUnit test resultreport,填入:junit-report.xml。

6, 勾选Record Emma coveragereport,填入:coverage/coverage.xml。

7, 勾选E-mailNotification,如app工程配置。

所有配置工作到此结束,现在可以去跑了。

你可能感兴趣的:(Windows下Android项目搭建Jenkins持续构建+自动化测试)