【测试】- Android单元测试初探

简介

最近重新开始学习了一下,Android的单元测试,以前都是马马虎虎看了看,觉得用处不大,还要写代码,麻烦。最近动手去写了一些单元测试,在有些情况下,相比通过安装App,界面操作来测试要方便,快捷很多。特别是项目复杂的时候。

其实很多开发者都知道单元测量,也能写一些简单的单元测试,但是就我工作以来,很少,基本没有看到项目中有编写单元测试的。因为编写额外的代码,麻烦,加上不熟悉,就更加不想写了。我以前也是这种想法,但是最近的接触,然后觉得,做单元测试还是很有必要的。

举例

  • 网络请求
    比如测试一个功能,而这个功能会进行网络请求,当出现问题时,我们得拿到网络请求返回的数据,这样才知道是后端问题,还是前端逻辑问题。

    而进入这个功能需要进行好几步操作,如果需要更改什么配置,还需要重新安装apk,想想过程都复杂,而且重新安装apk可以一个耗时的过程。

    这时候,我们就可以用单元测试,可以在不重新安装apk,不用去几番操作就可以拿到网络请求的结果。下面会实战举例。

  • api测试
    这种情况,用单元测试最快捷的,只需要在“test”目录下编写代码,在本机运行即可,比起安装apk,然后去点点点方便很多。

缺点

缺点当然就是要编写额外的测试代码,如果业务逻辑有改动,测试代码也得相应改动,存在后期维护,还有一点点的学习成本。不过总得来说,还是利大于弊的。

参考

studio_test
training_testing
android-testing-templates

单元测试

单元测试可以直接在业务代码的module下编写代码,也可以专门建一个单元测试module。

业务module下做单元测试

我们在新建module的时候,Android Studio会在资源目录src下生成“androidTest”和“test”两个目录,并且有生成一个简单的单元测试文件。单元测试需要的相应依赖也会配置好。你只需要在文件中编写测试代码即可。

  • androidTest目录:
    这些测试在硬件设备或模拟器上运行。这些测试有权使用 Instrumentation API,可让您获取某些信息(例如您要测试的应用的 Context,并且可让您通过测试代码来控制受测应用。在编写集成和功能界面测试来自动执行用户交互时,或者当您的测试具有模拟对象无法满足的 Android 依赖项时,可以使用这些测试。

  • test目录:
    这些测试在计算机的本地 Java 虚拟机 (JVM) 上运行。如果您的测试没有 Android 框架依赖项,或者您可以模拟 Android 框架依赖项,使用这些测试可以最大限度地缩短执行时间。

单独的测试module

我们可以像创建lib库那样,给需要测试的工程创建一个用于单元测试的module。

  • 第一步
    创建一个Android Library module
  • 第二步
    将“apply plugin: 'com.android.library'”改成“apply plugin: 'com.android.test'”
  • 第三步
    添加测试所用的依赖库时,和其它module一样用“implementation”等,而不是“androidTestImplementation”等
  • 第四步
    指定需要被测试的module,在“AndroidManifest.xml”下:
    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
            package="com.pds.testapp" >
        <instrumentation android:name="androidx.test.runner.AndroidJUnitRunner"
              android:targetPackage="com.pds.blog"/>
    </manifest>
    

在build.gradle中指定需要被测试的module: targetProjectPath ':app'。

android:targetPackage 指定需要被测试module的包名,targetProjectPath这是module在工程中的路径。

测试相关配置

具体字段的意思,可以参考官网。

android {
    compileSdkVersion app.compileSdkVersion
    defaultConfig {
        minSdkVersion 26
        targetSdkVersion app.targetSdkVersion
        testApplicationId "com.pds.test.${project.name}"
        testHandleProfiling true
        testFunctionalTest true
        testInstrumentationRunner 'androidx.test.runner.AndroidJUnitRunner'
        // 配置需要被测试的工程,和settings.gradle名字一致
        targetProjectPath ':app'
        javaCompileOptions {annotationProcessorOptions {includeCompileClasspath = true}}}
    testOptions {
        reportDir "$rootDir/test_app/test-reports"
        resultsDir "$rootDir/test_app/test-results"
        // 要仅为本地单元测试指定选项,请配置 testOptions {} 中的 unitTests {} 代码块。
        unitTests {
            // 如果您的测试依赖于资源 默认情况下,Android Studio 3.4 及更高版本提供编译版本的资源。
            includeAndroidResources = true
            all {
                jvmArgs '-XX:MaxPermSize=256m'
                if (it.name == 'test_app') {systemProperty 'debug', 'true'}
            }
        }
    }
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}
基础依赖
dependencies {
    implementation 'androidx.test:rules:1.2.0'
    implementation 'androidx.test:runner:1.2.0'
    implementation 'org.hamcrest:hamcrest-core:1.3'
    implementation 'androidx.test.ext:junit:1.1.1'
    implementation 'androidx.test.ext:truth:1.2.0'
    implementation 'com.google.truth:truth:0.42'
}

实战

  • 启动Activity
    @Test
    public void launchMarqueeTextPage() {
          Context context = InstrumentationRegistry.getInstrumentation().getTargetContext();
          Intent intent = new Intent(context, GlideTestActivity.class);
          intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
          ActivityTestRule<GlideTestActivity> activityTestRule = new ActivityTestRule<>(GlideTestActivity.class, true, false);
          activityTestRule.launchActivity(intent);
          // 让界面不自动退出
          try {
              CountDownLatch countdown = new CountDownLatch(1);
              countdown.await();
          } catch (InterruptedException e) {
              e.printStackTrace();
          }
      }
    }
    
    在测试module里,如果启动继承于AppCompatActivity的Activity会报错,目前没有找到解决办法,可以正常启动继承于Activity的Activity。
  • 网络请求测试
    比如在业务module,定义了一套网络请求的api,那么我们可以直接引用业务module里面写好的网络api,来发起网络请求。
    @Test
    public void getPhoneNumber() {
        Disposable observable
                = ApiManager
                .getUserApi()
                .getPhoneNumber("")
                .subscribeOn(Schedulers.io())
                .observeOn(AndroidSchedulers.mainThread())
                .compose(SchedulersCompat.<BaseEntity<DataEntity>>applyIoSchedulers())
                .map(new HttpResultFunc<DataEntity>())
                .subscribe(new Consumer<DataEntity>() {
                    @Override
                    public void accept(DataEntity data) throws Exception {
    
                    }
                }, new ErrorConsumer() {
                    @Override
                    public void accept(Throwable throwable) {
                        super.accept(throwable);
                    }
                });
    }
    
  • 自定义Rule
     @Rule
     public TipsRule tipsRule = new TipsRule();
    
    public class TipsRule implements TestRule {
      @Override
      public Statement apply(final Statement base, final Description description) {
          return new Statement() {
              // evaluate前执行方法相当于@Before
              @Override
              public void evaluate() throws Throwable {
                  // 获取测试方法的名字
                  String methodName = description.getMethodName();
                  System.out.println("-------"+ methodName + "------>测试开始!");
                  // 运行的测试方法
                  base.evaluate();
                  // evaluate后执行方法相当于@After
                  System.out.println("-------"+ methodName + "------>测试结束!");
              }
          };
      }
    }
    
  • 自定义Matcher
    @Test
    public void testAssertThatMatcher(){assertThat("19508460000",new   MobilePhoneMatcher());}
    
    public class MobilePhoneMatcher extends BaseMatcher<String> {
    
        /**
         * 进行断言判定,返回true则断言成功,否则断言失败
         */
        @Override
        public boolean matches(Object item) {
            if (null == item) return false;
            Pattern pattern = Pattern.compile("(1|861)(3|5|7|8)\\d{9}$*");
            Matcher matcher = pattern.matcher((String) item);
            return matcher.find();
        }
    
        /**
         * 给期待断言成功的对象增加描述
         */
        @Override
        public void describeTo(Description description) {
            description.appendText("预计此字符串是手机号码!");
        }
        /**
         * 给断言失败的对象增加描述
         */
        @Override
        public void describeMismatch(Object item, Description description) {
            description.appendText(item.toString() + "不是手机号码!");
        }
    }
    

monkeyrunner

monkeyrunner 工具提供了一个 API,用于编写可从 Android 代码外部控制 Android 设备或模拟器的程序。使用 monkeyrunner,您可以编写一个 Python 程序,以便安装 Android 应用或测试软件包,运行它,向其发送按键,截取其界面的屏幕截图,并将屏幕截图存储到工作站中。monkeyrunner 工具主要用于在功能/框架级测试应用和设备以及运行单元测试套件,但您也可以自由地将其用于其他目的。参考:monkeyrunner

用python编写测试脚本,然后用monkeyrunner工具运行。

monkeyrunner可执行文件存在于sdk/tools/bin目录下,编写好的python脚本用monkeyrunner命令执行,例如: monkeyrunner monkey.py。单独执行python文件是不行的,没法导入python中用到的Java库。

扩展

之所以可以在python里面写Java,需要Jython库的支持,我们可以在工程中导入该库,那么我们就可以用Java代码执行python脚本。python脚本里面编写Java代码。

  • python脚本


    截屏2020-05-22 下午2.16.09.png
  • Java代码


    截屏2020-05-22 下午2.17.01.png
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,290评论 4 363
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,399评论 1 294
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,021评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,034评论 0 207
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,412评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,651评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,902评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,605评论 0 199
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,339评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,586评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,076评论 1 261
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,400评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,060评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,083评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,851评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,685评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,595评论 2 270