构建robotium+jenkins+TMTS可持续集成自动化测试

作者 hunterno4

Windows下构建robotium+jenkins+TMTS可持续集成自动化测试

前言
TMTS是淘宝的自动化测试构架，优缺点都较为明显
优点：最主要的就是已经实现出错截屏并提供日志
缺点：比较小众化，遇到问题也无人解答

自动化测试终究是要能够持续集成才能有更大的意义的，利用robotium+jenkins可以实现集成测试，但此时要想得到出错截屏加日志就麻烦了。
TMTS主要由三部分组成
1.TmtsFramework进行自动化用例编写
2.TmtsToolkit进行出错截屏与获取日志报告
3.hudson进行apk包的自动打包、安装，并进行用例执行

TmtsFramework编写用例其实与robotium编写用例一样都是基于instrument的，因此想用robotium编写用例，而同时又想得到出错截屏与日志报告
就完全可以使用robotium+TmtsToolkit

因此就可以用robotium+jenkins+TmtsToolkit构建可持续集成自动化测试

Windows下环境搭建

软件安装
1.安装jdk
2.安装tomcat

http://tomcat.apache.org/download-70.cgi

3.安装ant

http://ant.apache.org/bindownload.cgi

4.安装jenkins

http://jenkins-ci.org/

下载war包，放于tomcat的webapps目录下，启动tomcat将自动部署
5.安装Android SDK

http://developer.android.com/sdk/index.html

搭建android开发环境，包括eclipse，ADT等
6.下载TMTS架构中的athena-1.1.jar、ddmlib.jar包

http://code.taobao.org/p/TMTS/src/branches/V1.1/trunk/android/AthrunTest/

当然最好把整个TMTS下载下来

环境变量PATH添加
\java\apache-ant-1.8.2\bin\
\java\android-sdk-windows\tools\
\java\android-sdk-windows\platform-tools\
\Java\jdk1.6.0_07\bin\
添加ANDROID_HOME
添加JAVA_HOME
添加ANT_HOME
有什么命令找不到了就加下PATH变量

tomcat启动
运行 \java\apache-tomcat-7.0.8\bin\startup.bat

jenkins配置
浏览器访问  http://localhost:8080/jenkins

插件安装
Hudson Subversion Plug-in，jenkins的svn插件
Android Emulator Plugin，android模拟器插件
JUnit Attachments Plugin，junit测试报告附件插件
Email-ext plugin，邮件扩展插件。此处说明下，默认Jenkins只会发送构建失败的邮件，我们需安装此插件才能自定义不同场景
除了这些之外还可以安装其它一些插件，那样可以使得Jenkins非常强大，需要什么安装什么

构建build.xml文件，使用ant自动打apk包，构建build.xml文件及ant打包可以参考其它文章

构建任务
1.使用jenkins新建任务时，填入任务名称，选择“构建一个自由风格的软件项目”，以后新建类似任务时则可以选择“复制现有任务”
2.勾选“This build is parameterized”进行参数化构建
Add Parameter项选择Choice，填入Name项：ANDROID_AVD_DEVICE；填入Choices项：emulator-5554(为模拟器序列号，adb devices将显示当前连接的设备序列)
3.进行SVN代码库关联
Source Code Management选择“Subversion”，Repository URL中填入SVN地址
4.添加构建步骤
Build项Add build step中选择“Execute Windows batch command”
这里填的命令与Windows中cmd下命令行中的命令是一样的
填入如下命令：
(
cd TmtsApp\tool
ant
adb -s %ANDROID_AVD_DEVICE% uninstall com.taobao.tmts.framework.app
adb -s %ANDROID_AVD_DEVICE% install apk\TmtsApp.apk
)
根据实际需要cd到相应目录，卸载apk包、安装apk包

再下拉添加一个Execute Windows batch command
(
cd TmtsTest\tool
test-packet.bat
adb -s %ANDROID_AVD_DEVICE% uninstall com.taobao.tmts.framework.test
adb -s %ANDROID_AVD_DEVICE% install apk\TmtsTest.apk
)
根据实际需要cd到相应目录，卸载测试工程的apk包、安装测试工程的apk包

再下拉添加一个Execute Windows batch command
echo %ANDROID_AVD_DEVICE%
cd TmtsTest
del TEST-*.xml /q
(
athena . “TEST-GridViewActivityTest.xml” %ANDROID_AVD_DEVICE% com.taobao.tmts.framework.test.GridViewActivityTest
athena . “TEST-ListViewActivityTest.xml” %ANDROID_AVD_DEVICE% com.taobao.tmts.framework.test.ListViewActivityTest
athena . “TEST-MainActivityTest.xml” %ANDROID_AVD_DEVICE% com.taobao.tmts.framework.test.MainActivityTest
)

这里调用的是athena.bat文件进行批处理
robotium中单个用例执行是类似这样的：
adb shell am instrument -w -e class com.megafon.test.MegafonTest#testDeleteContact com.megafon.test/android.test.InstrumentationTestRunner
athena.bat内容如下：
java -cp athena-1.1.jar;ddmlib.jar com.synaptik.athena.Athena %1 %2 %3 %4 E:\\android\\upload
调用了athena-1.1.jar和ddmlib.jar，所有这里与TMTS相关的其实就是需要这两个jar包以实现截图与日志报告功能

5.构建后操作
Post-build Actions勾选“Publish JUnit test result report”，填入TmtsTest\TEST-*.xml
当然jenkins也可以选择构建后发送邮件，构建后再执行其它任务等

Linux下构建robotium+jenkins+TMTS可持续集成自动化测试

前言
为什么要在Linux上构建自动化环境呢？
因为在Linux上执行速度要比在Windows快很多，以打包apk为例，至少快一倍。。。
如果公司每个版本要打几百个apk渠道包，这效率将大幅提升。

软件安装
1.安装jdk
2.安装tomcat

http://tomcat.apache.org/download-70.cgi

3.安装ant

http://ant.apache.org/bindownload.cgi

4.安装jenkins

http://jenkins-ci.org/

下载war包，放于tomcat的webapps目录下，启动tomcat将自动部署
5.安装Android SDK

http://developer.android.com/sdk/index.html

在linux中搭建android开发环境，包括eclipse，ADT等
6.下载TMTS架构中的athena-1.1.jar、ddmlib.jar包

http://code.taobao.org/p/TMTS/src/branches/V1.1/trunk/android/AthrunTest/

当然最好把整个TMTS下载下来

所需软件是与Windows中一样的，只不过相应软件需要用Linux版，且需要注意32位与64位

环境变量、Jenkins配置与Windows上差不多，略

构建任务

与Windows上的区别在于这里要执行的是shell命令
Build项Add build step中选择“Execute Shell”

(
cd TmtsApp/tool
ant
adb -s $ANDROID_AVD_DEVICE uninstall com.taobao.tmts.framework.app
adb -s $ANDROID_AVD_DEVICE install apk/TmtsApp.apk
)
根据实际需要cd到相应目录，卸载apk包、安装apk包
注意：在对ANDROID_AVD_DEVICE这个参数进行参数构建时，Windows中是用两个%%即%ANDROID_AVD_DEVICE%，
而Linux中变量则用$表示，即$ANDROID_AVD_DEVICE

再下拉添加一个“Execute Shell”
(
cd TmtsTest\tool
test-packet.bat
adb -s $ANDROID_AVD_DEVICE uninstall com.taobao.tmts.framework.test
adb -s $ANDROID_AVD_DEVICE install apk/TmtsTest.apk
)
根据实际需要cd到相应目录，卸载测试工程的apk包、安装测试工程的apk包
再下拉添加一个“Execute Shell”

echo $ANDROID_AVD_DEVICE
cd TmtsTest

rm -rf TEST-*.xml
(
./athena . “TEST-GridViewActivityTest.xml” $ANDROID_AVD_DEVICE com.taobao.tmts.framework.test.GridViewActivityTest
./athena . “TEST-ListViewActivityTest.xml” $ANDROID_AVD_DEVICE com.taobao.tmts.framework.test.ListViewActivityTest
./athena . “TEST-MainActivityTest.xml” $ANDROID_AVD_DEVICE com.taobao.tmts.framework.test.MainActivityTest
)

这里需要将Windows中的athena.bat修改成Linux中的athena脚本文件并进行执行
athena.bat文件内容：java -cp athena-1.1.jar;ddmlib.jar com.synaptik.athena.Athena %1 %2 %3 %4 E:\\android\\upload
修改为athena文件：java -cp athena-1.1.jar:ddmlib.jar com.synaptik.athena.Athena $1 $2 $3 $4 /usr/upload
robotium中单个用例执行是类似这样的：
adb shell am instrument -w -e class com.megafon.test.MegafonTest#testDeleteContact com.megafon.test/android.test.InstrumentationTestRunner
运行./athena时调用了athena-1.1.jar和ddmlib.jar，将实现截图与日志报告功能
这里如果用的是原来淘宝athena-1.1.jar的话会报错：
Test class com/taobao/tmts/framework/test/GridViewActivityTest un-match com.cplatform.surfdesktop.test.GridViewActivityTest , continue next…
路径问题，见本文后面注意。

构建后操作
Post-build Actions勾选“Publish JUnit test result report”，填入TmtsTest/TEST-*.xml
当然jenkins也可以选择构建后发送邮件，构建后再执行其它任务等

注意：
在Linux中构建ant自动打包用的build.xml文件时，有两处需要注意
1.运行android相关tool工具的区别，Windows上有exe、bat后缀，而Linux上没有这些后缀，如果直接使用Windows上原来的build.xml文件
将报找不到aapt.exe命令的错误，当然还有可能是aapt不能在64位机器的Linux上运行的原因（本文中的环境就是Ubuntu 64机器），如果你装的是64位机的话，此时需要安装32位支持库。
<condition property=”exe” value=”.exe” else=””><os family=”windows” /></condition>
<condition property=”bat” value=”.bat” else=””><os family=”windows” /></condition>
<property name=”aapt” value=”${android_platform-tools}/aapt${exe}” />
<property name=”aidl” value=”${android_platform-tools}/aidl${exe}” />
<property name=”dx” value=”${android_platform-tools}/dx${bat}” />
<property name=”apk-builder” value=”${android-tools}/apkbuilder${bat}” />
<property name=”proguard-home” value=”${android-tools}/proguard/lib”/>

2.Windows上与Linux上路径的区别
在Windows上路径分隔符为\，而在Linux上路径分隔符为/，因此在build.xml文件中涉及路径的用/吧，因为这样对Windows上没影响，但Linux上可能就用不了

在athena-1.1.jar包上程序上获取测试类时是通过路径的，如com\cplatformsurfdesktop\test\GridViewActivityTest在athena中会将其中的
\全部转化为.  即得到com.cplatform.surfdesktop.test.GridViewActivityTest
因此才能得到Test class com.taobao.tmts.framework.test.GridViewActivityTest match com.cplatform.surfdesktop.test.GridViewActivityTest，然后执行用例
因此如果直接用原来的athena-1.1.jar包的话就会出错了

修改源码中Athena.java文件
将原来：className = className.replaceAll(“\\\\”, “\\.”);     //用于将所有\转化为.

修改为：className = className.replaceAll(“/”, “\\.”);        //用于将所有/转化为.

修改后重新导出为jar包即可使用