【测试】- 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