android基础知识12：android自动化测试06—Instrumentation 02 单元测试

转载处（原文出处不可靠，否则请指正）：http://blog.csdn.net/xianming01/article/details/7893402

【IT168 技术文档】任何程序的开发都离不开单元测试来保证其健壮和稳定。Android的程序自然也不例外。从Android SDK 0.9开始，就有了比较成熟的测试框架，但是直到目前最新的1.1版本，也没有详细的文档介绍这个内容，只是简单的给了一个Api Demos里的几个单元测试代码。因此，我在这里对此内容做一下梳理和总结：

　　JUnit还能用么?

　　在 Java下做单元测试必然用到JUnit。这里说的JUnit是指从Apache基金会下载的junit.jar里提供的一系列单元测试功能。这些功能显然是运行在JDK之上的。在Android下已经没有了JDK，自然也无法运行JUnit。但是这并不妨碍我们利用JUnit编写单元测试。只不过在运行单元测试时，一定要用JDK来运行，利用java命令来启动JUnit的某个Runner。如果是用Eclipse的话，可以在Run Configuration里新建一个JUnit。但是一定要记得在Classpath选项卡里将Bootstrap Entries中的Android Library改成JRE，并且添加junit.jar。

很明显的，这种测试就是正规的Java单元测试，和Android没有任何关系。你无法测试任何关于Android系统中的API，你写的Activity，人机界面等等。所以，如果你想测试仅仅是一些封装数据的对象，或者是纯粹的数值计算，还是可以用这种方法的。

　　Android里面的junit.framework包是怎么回事?

　　很多人看到这个包的时候，第一反应是Android是不是已经完整集成了JUnit。很遗憾这不是事实。如果你按照JUnit的运行方法，却不像上面那样改用JDK，就一定会得到一个异常：

　　# An unexpected error hasbeen detected by Java Runtime Environment:

　　# Internal Error(classFileParser.cpp:2924), pid=4900, tid=4476

　　#Error:ShouldNotReachHere()

　　# Java VM: JavaHotSpot(TM) Client VM (10.0-b19 mixed mode windows-x86)

　　# An error report filewith more information is saved as:

　　#E:\Mydoc\EclipseWorkspace\TestAndroid\hs_err_pid4900.log

　　# If you would like tosubmit a bug report, please visit:

　　#http://java.sun.com/webapps/bugreport/crash.jsp

　　实际上，TestCase这个类用于在Android担当所有独特的TestCase的基类的作用，它是一个Abstract Class。Android单元测试类继承关系图如下所示：

之所以有那么多XXXTestCase主要是为了简化工作。例如当你想对一个访问数据库的功能进行测试时，首先需要自己启动并初始化数据库。在这里是类似的，如果你想测试一个Activity，首先要启动它。而ActivityTestCase就会自动帮你做完这些事情。而 ActivityUnitTestCase会更注重测试的独立性，它会让测试与Android底层的联系降到最低。其余的类可以查看相关的Javadoc 来按需挑选。要编写测试，就是找到合适的XXXTestCase作为基类来继承，并且编写自己的测试方法。
　　很明显的，最简单的编写测试的方法就是继承AndroidTestCase写一个自己的TestCase。然后为自己的一组TestCase写一个Activity界面，由界面控制 TestCase的启动，运行和结果报告。但是，你很快会发现，为何要给测试写一个界面呢?这太诡异了。这时就需要一种技术，它可以利用命令行(Shell)来启动一组测试，并且通过命令行的形式给出结果。这就是所谓的Instrumentation。

什么是Instrumentation?

　　一般在开发Android程序的时候，需要写一个manifest文件，其结构是：

[html] view   plaincopy    
  <application android:icon="@drawable/icon" android:label="@string/app_name">  
  <activity android:name=".TestApp" android:label="@string/app_name">  
  ……  
  </activity>  
  </application>   

这样，在启动程序的时候就会先启动一个Application，然后在此Application运行过程中根据情况加载相应的Activity，而Activity是需要一个界面的。但是Instrumentation并不是这样的。你可以将Instrumentation理解为一种没有图形界面的，具有启动能力的，用于监控其他类(用Target Package声明)的工具类。任何想成为Instrumentation的类必须继承android.app.Instrumentation。下面是这个类的解释：

　　“Base class for implementingapplication instrumentation code. When running with instrumentation turned on,this class will be instantiated for you before any of the application code,allowing you to monitor all of the interaction the system has with the application.An Instrumentation implementation is described to the system through anAndroidManifest.xml's tag.“

　　对于单元测试，我们需要认真了解的就是android.test.InstrumentationTestRunner类。这是Android单元测试的主入口。它相当于JUnit当中TestRunner的作用。

　　那么如何加载它呢，首先要在manifest文件中加入一行关于Instrumentation的声明。比如Android Api Demos中的测试里的manifest是这么写的(我滤掉了所有的注释)：

[html] view   plaincopy    
  <manifest xmlns:android="http://schemas.android.com/apk/res/android"  
  package="com.example.android.apis.tests">  
      <application>  
         <uses-library android:name="android.test.runner" />  
    
      </application>  
    
      <instrumentation android:name="android.test.InstrumentationTestRunner"  
    
        android:targetPackage="com.example.android.apis"  
    
          android:label="Tests for Api Demos."/>  
    
  </manifest>   

如果用Eclipse的ADT插件(0.8版本以上)，也可以用图形界面来添加，如下图：

　　编辑好 manifest，就可以打包(build，可以用Eclipse ADT来做，也可以用aapt命令手工完成)，然后安装到虚拟机上(用adb install命令)。之后就可以利用命令行的方式来加载你的单元测试了。在Android Shell中加载一个Instrumentation的方法是利用以下命令：

　　adb shell am instrument –w XXXXXX

　　其中-w是指定Instrumentation类的参数标志。一个简单的例子是：

　　adb shell am instrument -wcom.android.foo/android.test.InstrumentationTestRunner

　　当然，也可以利用adb shell先进入android命令行模式，再直接写am instrument –w XXXXXXX。下面将具体介绍如何将根据需要加载一组单元测试。

如何在Android中利用Instrumentation来进行测试?

　　在介绍具体的命令之前，我们先理解一下单元测试的层次。一组单元测试可以被组织成若干个TestSuite。每个TestSuite包含若干 TestCase(某个继承android.jar的junit.framework.TestCase的类)。每个TestCase又包含若干个 Test(具体的test方法)。

　　如果假设com.android.foo是你的测试代码的包的根。当执行以下命令时，会执行所有的TestCase的所有Test。测试的对象就是在Target Package中指定的包中的代码：

　　adb shell am instrument -wcom.android.foo/android.test.InstrumentationTestRunner

　　如果你想运行一个TestSuite，首先继承android.jar的junit.framework.TestSuite类，实现一个 TestSuite(比如叫com.android.foo.MyTestSuite)，然后执行以下命令执行此TestSuite

　　adb shell am instrument -e classcom.android.foo.MyTestSuite -wcom.android.foo/android.test.InstrumentationTestRunner

　　其中的-e表示额外的参数，语法为-e [arg1] [value1] [arg2] [value2]…这里用到了class参数。

　　如果仅仅想运行一个TestCase(比如叫com.android.foo.MyTestCase)，则用以下命令：

　　adb shell am instrument -e classcom.android.foo.MyTestCase -wcom.android.foo/android.test.InstrumentationTestRunner

　　如果仅仅想运行一个Test(比如就是上面MyTestCase的testFoo方法)，很类似的，就这样写：

　　adb shell am instrument -e classcom.android.foo.MyTestCase#testFoo -wcom.android.foo/android.test.InstrumentationTestRunner

　　然后，所有的测试结果会输出到控制台，并会做一系列统计，如标记为E的是Error，标记为F的是Failure，Success的测试则会标记为一个点。这和JUnit的语义一致。如果希望断点调试你的测试，只需要直接在代码上加上断点，然后将运行命令参数的-e后边附加上debug true后运行即可。更加详细的内容可以看InstrumentationTestRunner的Javadoc。我希望Android能尽快有正式的文档来介绍这个内容。

　　如何在Android的单元测试中做标记?

　　在 android.test.annotation包里定义了几个annotation，包括 @LargeTest，@MediumTest，@SmallTest，@Smoke，和@Suppress。你可以根据自己的需要用这些 annotation来对自己的测试分类。在执行单元测试命令时，可以在-e参数后设置“size large”/ “size medium”/ “size small”来执行具有相应标记的测试。特别的@Supperss可以取消被标记的Test的执行。

　　完整的操作过程

　　总结以上所有的内容，编写并运行完整的测试需要以下的步骤：

　　以上步骤中，在 Android自带的例子中，我发现它有两个manifest.xml。也就是说在步骤3中源代码和测试代码分别生成了两个不同的包。然后步骤4利用 adb install命令安装到了虚拟机上。由于我没有找到Eclipse ADT有办法可以为一个只有Instrumentation，没有Activity的Application打包并安装，于是采用了略微不同的办法完成了这个工作。下文中将一一详细介绍整个过程。

1、编写程序

　　我新建了一个项目TestApp，参数为：

　　Package Name: com.android.testapp

　　Activity Name: MainActivity

　　Application Name: TestApp

　　以下是MainActivity的源代码：

[java] view   plaincopy    
  packagecom.android.testapp;  
  　　importandroid.app.Activity;  
  　　importandroid.os.Bundle;  
  　　publicclassMainActivityextendsActivity {  
  　　/** Called when the activity is first created. */  
  　　@Override  
  　　publicvoidonCreate(Bundle savedInstanceState) {  
  　　super.onCreate(savedInstanceState);  
  　　setContentView(R.layout.main);  
  　　}  
  　　publicintsum(inta,intb) {  
  　　returna + b;  
  　　}  
  　　publicintsubstract(inta,intb) {  
  　　returnb - a;  
  　　}  
  　　}  

其中，我故意将减法的a – b写成了b – a。

2、编写测试程序

　　然后，我新建了一个Source Folder，名为test，并在里面新建了包com.android.testapp.test。并定义了一个TestCase，名为TestMainActivity，源代码如下：

[java] view   plaincopy    
  package com.android.testapp.test;  
  　　import com.android.testapp.MainActivity;  
  　　import android.test.ActivityInstrumentationTestCase;  
  　　import android.test.suitebuilder.annotation.MediumTest;  
  　　public class TestMainActivity extends ActivityInstrumentationTestCase {  
  　　public TestMainActivity() {  
  　　super("com.android.testapp", MainActivity.class);  
  　　}  
  　　public TestMainActivity(String pkg, Class activityClass) {  
  　　super(pkg, activityClass);  
  　　}  
  　　@MediumTest  
  　　public void testSum() {  
  　　assertEquals(3, getActivity().sum(1, 2));  
  　　}  
  　　@MediumTest  
  　　public void testSubstract() {  
  　　assertEquals(-1, getActivity().substract(1, 2));  
  　　}  
  　　}  

我继承了ActivityInstrumentationTestCase。这个TestCase在执行时会自动帮我启动相应的Activity。

　　接下来就是程序的Manifest：

[html] view   plaincopy    
  <?xml version="1.0" encoding="utf-8"?>   
    
  <manifest xmlns:android="http://schemas.android.com/apk/res/android"   
    
  package="com.android.testapp"   
    
  android:versionCode="1"   
    
  android:versionName="1.0.0">   
    
  <application android:icon="@drawable/icon" android:label="@string/app_name">   
    
  <activity android:name=".MainActivity"   
    
  android:label="@string/app_name">   
    
  <intent-filter>   
    
  <action android:name="android.intent.action.MAIN" />   
    
  <category android:name="android.intent.category.LAUNCHER" />   
    
  </intent-filter>   
    
  </activity>   
    
  <uses-library android:name="android.test.runner" />   
    
  </application>   
    
  <instrumentation android:targetPackage="com.android.testapp" android:name="android.test.InstrumentationTestRunner" android:label="Test Unit Tests"></instrumentation>   
    
  </manifest>

在这个文件中，我将 Activity和Instrumentation的声明写到了一起，而没有像Apis Demo那样分开。请注意里面的标签。如果没有那句，在运行测试时会报告找不到TestRunner。这是由于 Android在build的时候只把需要的东西打包，所以你必须明确的告诉Android Builder这一点。

3、Build和Install

　　在 Eclipse上，这两个步骤是一起完成的。只要点一下Run即可。只不过如果你不在Run Configuration里将安装后的Launch Action设为“Do Nothing”，就会自动运行一下你的MainActivity。对于我们，设为Do Nothing即可。如下图：

完成后，利用命令：

　　adb shell pm list packages

　　可以在已经安装的pkg列表里看到com.android.testapp。

　　4、运行测试，查看结果

　　之后就打开命令行，运行以下命令

　　adb shell am instrument –e classcom.android.testapp.test.TestMainActivity –wcom.android.testapp/android.test.InstrumentationTestRunner

　　即可看到如下的结果：

　　可以看到，单元测试正确的找到了减法中的错误。结果中的成功的测试显示为”.”，一个失败的显示为”F”。只不过我还是不太理解为什么我只写了两个测试方法，Tests run却显示了3。

参考资料：

《android上的单元测试》

查看全文
如若内容造成侵权/违法违规/事实不符，请联系编程学习网邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！

Spring中使用事务失效的集中场景
文章目录抛出检查异常导致事务不能正确回滚业务方法内自己 try-catch 异常导致事务不能正确回滚aop 切面顺序导致导致事务不能正确回滚非 public 方法导致的事务失效父子容器导致的事务失效调用本类方法导致传播行为失效Transactional 没有保证原子行为Transactional 方法导致的…...
2024/4/13 12:11:40
Unity 报错之 Scope was not disposed, You should use the ‘using‘ keyword or manually call Dispose.
Unity 报错之 Scope was not disposed! You should use the using keyword or manually call Dispose.发生错误报错信息报错截图详细信息解决方案方法一：方法二：其他方法发生错误本地环境： Mac版本：11.2.2Unity版本&#xff1a…...
2024/4/19 4:19:40
codesys电子凸轮挺杆点的设置与使用
1、序言之前的文章中，我们已经介绍了Codesys电子凸轮的功能设计与使用，参考文章： https://blog.csdn.net/qq_19979629/article/details/122373387 不过我们忽略了电子凸轮的重要功能，挺杆。对于挺杆的作用，作者查询…...
2024/4/16 15:36:41
【大话设计模式】模式十五：观察者模式以及JDK与生俱来的观察者模式
【引入】就拿Vs2019来说吧，当你点击运行程序之后，运行按键会发生变化，而且对多出来一个错误提示框，其他地方不会发生改变，这里就是典型的观察者模式。一、观察者模式观察者模式(Observer Pattern)：定义…...
2024/4/13 12:11:35
【大话设计模式】模式十三：模板方法模式以及其在JDK、Tomcat的应用
【引入】考试我们早已经习以为常了，有没有思考过，考试试卷是机子印刷的好处是什么?当然，首先比手写快是肯定的；但是，关键在于不会出错，因为大家的题目都应该是一模一样的。这就是一个进店的设计模式——模…...
2024/4/25 16:40:08
Flink 消费kafka 自定义KafkaDeserializationSchema
kafka中的数据通常是键值对，所以我们自定义反序列化从kafka中消费键值对的消息实现需求： 读取多个topic数据进行不同处理输出，这里就需要自定义反序列化从kafka消费数据，然后分别处理。效果数据格式转换后效果：…...
2024/4/29 2:14:30
【大话设计模式】模式十一：装饰模式以及在IO体系中的应用
【引入】当系统需要新功能的时候，是向旧类中添加新的代码。这些新的代码通常装饰了原有的类的核心职责或者主要行为，在主类中加入了新的字段，新的方法和新的逻辑。从而增加了主类的复杂度。相比之下，若要扩展功能，装饰…...
2024/4/7 21:59:42
C语言数据结构篇——双链表的创建，插入，节点删除，打印等操作
目录双链表的理解双链表数据节点和头结点的定义双链表的创建双链表数据节点的插入双链表数据节点的删除双链表的理解一般学习双链表都是在学习单链表之后（本文需要一定单链表基础），但单链表有一个缺点，就是无法访问…...
2024/4/18 10:10:03
第四次网页前端培训笔记（CSS常用属性和盒子模型）
本帖只记录学习 1，CSS常用属性 <!DOCTYPE html> <html><head><meta charset"utf-8"><title>常用属性</title><style type"text/css">#div1{height: 37.5rem;/* 背景颜色 */background-color: anti…...
2024/4/13 12:11:35
【大话设计模式】模式十七：JDBC中的桥接模式
【引入】手机品牌与手机软件。两者间有一条聚合线，一个手机品牌可以有多个手机软件。不要一涉及继承就考虑该模式，尽可能把变化的因素封装到最细、最小的逻辑单元中，避免风险扩散。由此引出桥接模式。一、桥接模式桥接模式（Br…...
2024/4/20 10:45:22
Unity 工具之常用插件分类汇总（UI/VR/AR/建模/Shader/动画/网络/AI/资源/数据/区块链等）
目录一、 UI / 2D 相关二、VR/AR 游戏的常用插件三、模型构建/环境构建插件相关四、Shader 相关插件五、动画插件六、网络/网络视频语音插件七、AI 相关八、区块链相关九、资源/数据相关插件一、 UI / 2D 相关 1、Doozy UI Manager Doozy UI Manager是一套…...
2024/4/16 2:34:38
单链表基本操作(尾插，头插，删除，查找，修改，打印)
1创建单链表代码 #include<stdio.h> #include <stdlib.h> //define a struct //定义一个结构体，也就是节点 typedef struct Node { int data; // 存储链表数据 struct Node *next; // 存储结点的地址 }LNode,*LinkList; 2头插法以及尾插法创建代…...
2024/4/15 12:57:53
Springboot项目javax.validation注解大全
注入依赖注意：SpringBoot2 项目web组件已经内置了这个依赖了 <dependency> <groupId>javax.validation</groupId> <artifactId>validation-api</artifactId> <version>2.1.0.Final</version> </depende…...
2024/4/13 12:12:40
STL学习笔记（三）
STL学习笔记（三）——常用算法琐记概述1.常用遍历算法1.1 for_each1.2 transform2.常用查找算法2.1 find2.2 find_if2.3 adjacent_find2.4 binary_search2.5 count2.6 count_if3.常用排序算法3.1 sort3.2 random_shuffle3.3 merge3.4 reverse4.常用拷贝和…...
2024/4/13 12:12:10
嵌入式c：指针
掌握：1）指针 2）结构体指针 3）宏定义了解：Typedef、宏定义、条件编译、内存操作 c语言指针： 指针的基本操作： 定义指针写入数据移动指针数据调用指针、数组都是在RAM空间中占用内存&…...
2024/4/13 12:12:20
Gavin老师Transformer直播课感悟 - 通过Rasa Interactive对Rasa对话机器人项目实战之ConcertBot源码、流程及对话过程解密(四十三)
本文继续围绕工业级业务对话平台和框架Rasa，通过Rasa Interactive对Rasa对话机器人项目实战之ConcertBot源码、流程及对话过程进行解析。一、通过Rasa Interactive对Rasa对话机器人项目实战之ConcertBot源码、流程及对话过程进行解析通过Rasa Visualize从全局分析ConcertBot…...
2024/4/19 23:51:58
《深度学习入门：基于Python的理论与实现》读书笔记：第7章卷积神经网络
目录第7章卷积神经网络 7.1 整体结构 7.2 卷积层 7.2.1 全连接层存在的问题 7.2.2 卷积运算 7.2.3 填充 7.2.4 步幅 7.2.5 3维数据的卷积运算 7.2.6 结合方块思考 7.2.7 批处理 7.3 池化层 7.4 卷积层和池化层的实现 7.4.1 4维数组 7.4.2 基于im2col的展开…...
2024/4/7 21:59:37
【打卡】URL编码（简单）
描述给出一个代表网址 host 的字符串 base_url，和代表查询参数的数组 query_params，你需要返回带查询参数的完整 URL。查询参数由一些包含两个元素的数组组成，第一个元素代表参数，第二个元素代表该参数对应的值。现在需要你拼接…...
2024/4/16 15:41:53
C++类、结构体、函数、变量等命名规则详解
编程越学越深，也慢慢了解到命名规范的重要性，在前面几个数据结构的示例中，大家也看到，命名也是有一定的规则的，这会方便我们阅读代码，方便我们后期完善。今天就给大家总结一下常用的C命名规则。希望对大家有…...
2024/4/25 0:55:23
Angular 的使用注意点
Angular 的使用注意点第一部分命令工具第二部分 1.组件，组件树生成器,理清个组件脉络 Angular2-dependencies-graph 模块 Router 本质上表示的是当前页面的状态第三部分依赖注入： 构造器注入数据绑定： 第四部分. UI库 5.…...
2024/4/13 12:13:25

android基础知识12：android自动化测试06—Instrumentation 02 单元测试

相关文章

最新文章