基于Orange的安卓UI自动化学习笔记（二）

上一篇主要介绍了本地独立完成一个UI自动化工程的建立，本篇继续学习安卓UI自动化。
关于安卓UI自动化学习，我的学习路线是这样安排的：
（一）本地：能够独立完成一个UI自动化工程的建立
（二）本地：命令行执行UI自动化测试用例
（三）本地：ant打包测试工程apk+执行UI自动化用例一体化
（四）jenkins:持续集成平台成功构建UI自动化工程
（五）jenkins:真机换成模拟器
（六）jenkins:持续集成平台实现被测apk自动打包编译+自动化一体化
（七）UI自动化用例编写语法和规范
本章内容就是第二部分，本地：命令行执行UI自动化测试用例

一、准备工作

在上一篇的内容中，我们把重签名后的被测应用apk直接预先装到真机设备上，然后我们手工执行测试工程。而orange则可以帮我们重签名被测应用且装在真机设备上，再将测试工程apk装在真机上并执行测试用例。我们只需要给orange提供被测应用apk和配置文件，然后在命令行执行java命令就可以一键实现重签名、安装、执行测试用例了。我们需要做的准备工作有：

• 1.将被测应用apk添加到我们已经建立好的UI自动化工程中。建议新建一个名字是“apk”目录，将apk放入目录。
• 2.新建测试用例xml文件，这个文件主要用于指定哪些用例将被执行。实例如下图所示。
• 3.确定好测试设备，我们这里选择真机，真机通过数据线和adb与PC端保持连接状态，执行adb devices可以确定设备的deviceId，这个值要记住，会写在orange配置文件中。
• 4.将debug.keystore放到测试工程的跟目录下。
• 5.在本地执行一次测试工程。主要目的是在bin目录下生成XXX.apk文件供orange使用。

测试用例xml文件示范

二、添加orange配置文件

在UI自动化工程里添加一个config.properties文件作为orange的配置文件，里面具体细节如下面所列出：
apkpath=apk\\pris.apk 这里指定待测应用apk的存放位置；windows用\\\分割路径；被测应用apk要加入到安卓UI自动化工程的目录中。 testapkpath=bin\\MyFirstAndroidTestProject.apk 这里指测试工程apk的生成路径。 keystore=debug.keystore 这里是指重签名文件的存放路径，我将其存放在主目录。 smtp=163.com [email protected] 这里是UI自动化工程的结果发送的邮件列表。 testCaseFile=MainTestCases.xml 这里是指定测试用例xml文件的存放路径。 [email protected] 这里是邮件发件人的设置。 logTag=Pris- 这里是打日志时带的前缀 devicename=4df72aad457530fd 这里是跑UI自动化的设备名称

三、命令行执行UI自动化测试用例

都准备充分了之后，接下来就是关键的命令行执行测试用例了。
首先通过cmd命令首先进入到项目的跟目录下，然后运行下面的命令，启动测试：

java -jar ./libs/orange-xxx.jar config.properties

四、报错信息及出错原因分析

报错：can't find instrumentation component com.zutubi.android.junitreport.JUnitReportTestRunner
这个问题刚开始蹦出来的时候，整个人还是懵懵的状态。怎么回事呢？只能从orange打出来的日志下手了。通过一步一步地查看日志，大概捋清楚了orange执行UI自动化测试用例的过程：
（1）被测应用apk重签名
（2）adb启动
（3）卸载真机上已安装的被测应用（如果之前没装也不会报错）
（4）卸载真机上已安装的UITest应用（如果之前没装也不会报错）
（5）输出日志到AllLogCat.txt文件中
（6）在真机上安装重签名后的被测应用apk
（7）在真机上安装测试工程应用apk
（8）开始执行测试用例，执行命令 adb shell am instrument -w -e com.zutubi.android.junitreport.JUnitReportTestRunner
我们可以看到前面7个步骤都是orange替UI自动化做准备的过程，替代了我们先前手动操作的部分，最关键的指令就是adb shell am instrument命令，这才真正开始执行UI自动化测试用例。这里adb shell am instrument带的-e参数指明了instrument的component是什么。我们尝试用adb命令adb shell pm list instrumentation列出来真机设备上已安装的instrument component有哪些，是否有我们指定的com.zutubi.android.junitreport呢？

adb shell pm list instrumentation命令执行结果

我们看到的就是之前手动操作执行UI自动化工程时安装在手机上的instrumentation呀！这个instrumentation的package名称是com.example.androiduitest，破折号后面的是instrumentation的名字，尖括号里的com.netease.pris是指我们的目标测试package名称。也就是说orange默认使用instrumentation的component是com.zutubi.android.junitreport.JUnitReportTestRunner，而手机设备里却没有,因而问题出在AndroidManifest.xml设置文件中。我们需要把 如下图所示：

AndroidManifest.xml设置

修改完AndroidManifest.xml之后会出现一些警告，我们可以选择Project-〉Clean-〉选择我们的project即可更新。
注意修改了instrumentation的name之后要在FirstTest上右键run configurations，指定Instrumentation Runner为我们修改之后的名称就可以。