前言

上一章并没有说仪器化测试，仪器化测试存放在src/androidTest目录中，仪器化测试即UI测试。

本文并没有多加理解，按照Android UI 测试指南之 Espresso抄袭（会标注转载），只是我这里采用的是androidx，并且补充一些东西，仅此而已

参考文献

Android UI 测试指南之 Espresso

Espresso文档

关于 Espresso

Espresso 是一个简单好用的 Android UI 测试框架

Espresso 主要由以下三个基础部分组成：

  • ViewMatchers - 在当前View层级去匹配指定的View .
  • ViewActions - 执行Views的某些行为，如点击事件 .
  • ViewAssertions - 检查Views的某些状态，如是否显示 .

Espresso 使用示例

onView(ViewMatcher) //1.匹配View
      .perform(ViewAction) //2.执行View行为
           .check(ViewAssertion); //3.验证View

准备（采用androidx）

第一步. build.gradle 添加如下依赖：

    androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.0'
    androidTestImplementation 'androidx.test:runner:1.1.0'
    androidTestImplementation 'androidx.test:rules:1.1.0'

第二步. android.defaultConfig 添加如下配置

     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"

基础用法

获得View

  • withId方式
onView(withId(R.id.my_view))
  • withText方式
onView(withText("Hello World!"))

执行View行为

  • 点击
onView(...).perform(click());
  • 文本内容输入
onView(...).perform(typeText("Hello"), click());
  • scrollTo 滑动
onView(...).perform(scrollTo(), click());

检验View

  • 检验View的文本内容
onView(...).check(matches(withText("Hello!")));
  • 检验View的显示状态
onView(...).check(matches(isDisplayed()));

示例场景：

简单的登陆场景测试

activity_login.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:orientation="vertical"
    tools:context=".MainActivity">

    <EditText
        android:id="@+id/etName"
        android:layout_width="match_parent"
        android:layout_height="50dp"
        android:layout_margin="10dp" />

    <EditText
        android:id="@+id/etPwd"
        android:layout_width="match_parent"
        android:layout_height="50dp"
        android:layout_margin="10dp" />

    <Button
        android:id="@+id/btnLogin"
        android:layout_width="match_parent"
        android:layout_height="50dp"
        android:layout_margin="10dp"
        android:text="登录" />
</LinearLayout>

LoginActivity.java:

package com.example.androidtest;

import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
import android.widget.Toast;

import androidx.appcompat.app.AppCompatActivity;

public class LoginActivity extends AppCompatActivity {

    EditText etName;
    EditText etPwd;
    Button btnLogin;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_login);
        etName = findViewById(R.id.etName);
        etPwd = findViewById(R.id.etPwd);
        btnLogin = findViewById(R.id.btnLogin);

        btnLogin.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Toast.makeText(LoginActivity.this, "点击了登录按钮", Toast.LENGTH_LONG).show();
            }
        });
    }
}

UI测试一定要在Androidmainifest.xml中配置

<activity android:name=".LoginActivity"/>

测试类：

package com.example.androidtest;

import org.junit.Rule;
import org.junit.Test;
import org.junit.runner.RunWith;

import androidx.test.ext.junit.runners.AndroidJUnit4;
import androidx.test.rule.ActivityTestRule;

import static androidx.test.espresso.Espresso.onView;
import static androidx.test.espresso.action.ViewActions.click;
import static androidx.test.espresso.action.ViewActions.closeSoftKeyboard;
import static androidx.test.espresso.action.ViewActions.typeText;
import static androidx.test.espresso.assertion.ViewAssertions.matches;
import static androidx.test.espresso.matcher.ViewMatchers.isDisplayed;
import static androidx.test.espresso.matcher.ViewMatchers.withId;
import static androidx.test.espresso.matcher.ViewMatchers.withText;

/**
 * Copyright (C), 2019-2020, 佛生
 * FileName: LoginUITest
 * Author: 佛学徒
 * Date: 2020/11/18 10:49
 * Description:
 * History:
 */
@RunWith(AndroidJUnit4.class)
public class LoginUITest {

    @Rule
    public ActivityTestRule<LoginActivity> rule=new ActivityTestRule<LoginActivity>(LoginActivity.class,true);

    @Test
    public void login(){
        //login
        onView(withId(R.id.etName)).perform(typeText("Jack"),closeSoftKeyboard());
        onView(withId(R.id.etPwd)).perform(typeText("1234"),closeSoftKeyboard());
        onView(withText("登录")).perform(click());

        //verify
		onView(withId(R.id.btnLogin)).check(matches(isDisplayed()));    
	}

}

自己试下，感觉挺酸爽

进阶用法

1. 使用IdlingResource

通常，我们实际的应用当中会有很多异步任务，例如网络请求，图片加载等，但是Espresso并不知道你的异步任务什么时候结束，所以需要借助于IdlingResource .

这里需要注意的是，如果你是通过AsyncTask或者AsyncTaskCompat方式的异步任务，Espresso已经处理好，并不需要去额外的处理。

第一步：添加依赖库

implementation 'androidx.test.espresso:espresso-idling-resource:3.1.0'

第二步：自定义一个 SimpleIdlingResource类，继承自 IdlingResource

SimpleIdlingResource代码

public final class SimpleIdlingResource implements IdlingResource {

    private final AtomicInteger counter = new AtomicInteger(0);

    private volatile ResourceCallback resourceCallback;

    @Override
    public String getName() {
        return "SimpleIdlingResource";
    }

    /**
     * 如果counter的值等于0，说明当前是空闲状态
     */    
    @Override
    public boolean isIdleNow() {
        return counter.get() == 0;
    }

    @Override
    public void registerIdleTransitionCallback(ResourceCallback resourceCallback) {
        this.resourceCallback = resourceCallback;
    }

    /**
     * counter的值增长方法
     */
    public void increment() {
        counter.getAndIncrement();
    }

    /**
     *counter的值减少方法
     */
    public void decrement() {
        int counterVal = counter.decrementAndGet();
        if (counterVal == 0) {
            // 执行onTransitionToIdle()方法，告诉Espresso，当前是空闲状态。
            if (null != resourceCallback) {
                resourceCallback.onTransitionToIdle();
            }
        }

        if (counterVal < 0) {
            throw new IllegalArgumentException("Counter has been corrupted!");
        }
    }
}

第三部，在LoginActivity加上一个图片加载glide

package com.example.androidtest;

import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ImageView;
import android.widget.Toast;

import com.bumptech.glide.Glide;
import com.bumptech.glide.load.resource.drawable.GlideDrawable;
import com.bumptech.glide.request.animation.GlideAnimation;
import com.bumptech.glide.request.target.GlideDrawableImageViewTarget;
import com.example.androidtest.test.SimpleIdlingResource;

import androidx.appcompat.app.AppCompatActivity;

public class LoginActivity extends AppCompatActivity {

    EditText etName;
    EditText etPwd;
    Button btnLogin;
    ImageView ivHead;

    public static SimpleIdlingResource sIdlingResource=new SimpleIdlingResource();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_login);
        etName = findViewById(R.id.etName);
        etPwd = findViewById(R.id.etPwd);
        btnLogin = findViewById(R.id.btnLogin);
        ivHead = findViewById(R.id.ivHead);

        //App 开始进入忙碌状态 ，等待通知
        sIdlingResource.increment();

        //开始加载头像图片
        Glide.with(this).load("https://avatars2.githubusercontent.com/u/2297803?v=3&s=460").into(new GlideDrawableImageViewTarget(ivHead) {
            @Override
            public void onResourceReady(GlideDrawable resource,
                                        GlideAnimation<? super GlideDrawable> animation) {
                super.onResourceReady(resource, animation);
                ivHead.setImageDrawable(resource);
                //加载完毕后，将App设置成空闲状态
                sIdlingResource.decrement();
            }
        });

        btnLogin.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Toast.makeText(LoginActivity.this, "点击了登录按钮", Toast.LENGTH_LONG).show();
            }
        });
    }
}

然后在src/androidTest目录下定义IdlingResourceTest测试异步

package com.example.androidtest;

import org.junit.After;
import org.junit.Before;
import org.junit.Rule;
import org.junit.Test;
import org.junit.runner.RunWith;

import androidx.test.espresso.Espresso;
import androidx.test.ext.junit.runners.AndroidJUnit4;
import androidx.test.rule.ActivityTestRule;

import static androidx.test.espresso.Espresso.onView;
import static androidx.test.espresso.assertion.ViewAssertions.matches;
import static androidx.test.espresso.matcher.ViewMatchers.isDisplayed;
import static androidx.test.espresso.matcher.ViewMatchers.withId;

/**
 * Copyright (C), 2019-2020, 佛生
 * FileName: IdlingResourceTest
 * Author: 佛学徒
 * Date: 2020/11/19 9:27
 * Description:
 * History:
 */
@RunWith(AndroidJUnit4.class)
public class IdlingResourceTest {

    @Rule
    public ActivityTestRule<LoginActivity> rule=new ActivityTestRule<>(LoginActivity.class,true);

    @Before
    public void registerIdlingResource(){
        Espresso.registerIdlingResources(rule.getActivity().sIdlingResource);
    }

    @Test
    public void avatarDisplayed(){
        onView(withId(R.id.ivHead)).check(matches(isDisplayed()));
    }

    @After
    public void unregisterIdlingResource() {
        Espresso.unregisterIdlingResources(
                rule.getActivity().sIdlingResource);
    }

}

这里主要测试该glide异步任务是否执行，测试起来也比较容易，在AndroidMainifest.xml删除网络权限，则可以测试请求超时

<uses-permission android:name="android.permission.INTERNET" />

2.创建一个自定义 Espresso matcher

目前Espresso提供的方法基本上可以满足你的测试需求，如下图所示：

在这里插入图片描述
如果你需要对自定义的View中某个自定义属性进行测试的话，你可以创建一个自定义的Matcher

   public static Matcher<View> isMoved() {
        return new TypeSafeMatcher<View>() {
            @Override
            public void describeTo(Description description) {
                description.appendText("is moved");
            }

            @Override
            public boolean matchesSafely(View view) {
                return ((CustomView)view).isMoved();
            }
        };
    }

3.如何处理动画

  • 系统动画： 为了避免动画线程运行期间对Espresso测试产生的影响，官方强烈建议关闭系统动画。如图所示：
    在这里插入图片描述
  • 自定义动画： 对于自定义动画，开发者可以借助以下代码去控制动画的开和关。

该方法可以监听系统动画的开关事件，这是一个值得推荐的做法，不仅仅是在Espresso测试中。

    boolean animationEnabled=true;

    if (Build.VERSION.SDK_INT>=Build.VERSION_CODES.JELLY_BEAN_MR1){
        try {
            if (Settings.Global.getFloat(getContentResolver(),Settings.Global.ANIMATOR_DURATION_SCALE)==0.0f){
                animationEnabled=false;
            }
        } catch (Settings.SettingNotFoundException e) {
            e.printStackTrace();
        }
    }

4.优雅的 IntentTest

  • 普通的方式
    @Rule
    public ActivityTestRule<MainActivity> rule=new ActivityTestRule<MainActivity>(MainActivity.class){

        @Override
        protected Intent getActivityIntent() {
            Intent result=new Intent(...);
            result.putExtra(...)
            return result;
        }
    };

如果使用普通的方式，那么该单元测试类下的所有测试都是基于该Intent启动的Activity，这样显然不够灵活。

  • 优雅的方式
    @Rule
    public ActivityTestRule<MainActivity> rule=new ActivityTestRule<MainActivity>(MainActivity.class,true,false);//第三个参数为是否自动运行Activity

    public void myTest(){
        Intent result=new Intent(...);
        result.putExtra(...);
        rule.launchActivity(result);
    }

5.保证测试的独立性

通常使用Espresso进行UI测试的时候，你并不期望去测试网络或者远程的服务相关的东西，所以，你可以借助于Espresso Intent，Mockito for mocking，以及依赖注射、Dagger2。
总之，尽量去分离那些不属于UI层面的内容。

例如：你需要某个按钮的点击事件进行测试，但是该按钮的点击后，会跳转到别的Activity，可是你不希望去测试别的Activity，那么这里就可以通过拦截Intent来解决。

首先你需要添加IntentTest依赖库：

androidTestImplementation 'androidx.test.espresso:espresso-intents:3.1.0'

InterceptIntentTest示例代码

@RunWith(AndroidJUnit4.class)
public class InterceptIntentTest {

    @Rule
    public IntentsTestRule<MainActivity> rule=new IntentsTestRule<>(MainActivity.class);

    @Before
    public void stubCameraIntent(){
        // 模拟一个ActivityResult
        Instrumentation.ActivityResult result = createImageCaptureActivityResultStub();
        //拦截MediaStore.ACTION_IMAGE_CAPTURE，并返回模拟后的result
        intending(hasAction(MediaStore.ACTION_IMAGE_CAPTURE)).respondWith(result);
    }

    @Test
    public void takePhoto_cameraIsLaunched(){
        onView(withId(R.id.button_take_photo)).perform(click());
        intended(hasAction(MediaStore.ACTION_IMAGE_CAPTURE));
        ...
    }

    private Instrumentation.ActivityResult createImageCaptureActivityResultStub() {
        // Create the ActivityResult, with a null Intent since we do not want to return any data
        // back to the Activity.
        return new Instrumentation.ActivityResult(Activity.RESULT_OK, null);
    }

}

6.避免直接复制粘贴test代码

举个简单的例子。

onData(allOf(is(instanceOf(Map.class)),hasEntry(equalTo("STR"),is("item:50")))).perform(click());

以上这段代码是匹配列表中符合条件的item，并执行执行点击事件，测试也正常，同样这段代码也被复制到了其他的测试方法中使用，
这时，设想一下，如果你的adapter中的数据源改成了cursor或者其他，于是悲催了，你需要修改很多地方，显然，这不是一个合格的CV战士。

所以，我们需要对之前那行代码进行改装：

    @Test
    public void myTest(){
        onData(withItemContent("item:50")).perform(click());
    }

    public static Matcher<? extends Object> withItemContent(String expectedText) {
        ....
    }

很简单，只需将可能变化的部分抽出来即可。

7.如何测试View的位置

如图所示：

在这里插入图片描述
8.自定义错误日志

默认的错误日志打印信息比较多，如图：

在这里插入图片描述
如果你只想显示你关心的日志信息，你可以自定义FailureHandler：

private static class CustomFailureHandler implements FailureHandler {
    private final FailureHandler delegate;

    public CustomFailureHandler(Context targetContext) {
        delegate = new DefaultFailureHandler(targetContext);
    }

    @Override
    public void handle(Throwable error, Matcher<View> viewMatcher) {
        try {
            delegate.handle(error, viewMatcher);
        } catch (NoMatchingViewException e) {
            throw new MySpecialException(e);
        }
    }
}


@Override
public void setUp() throws Exception {
    super.setUp();
    getActivity();
    setFailureHandler(new CustomFailureHandler(getInstrumentation()
                                              .getTargetContext()));
}

主要个人还是针对一两个进行了demo练习，其他的也是直接看，并没有手动去做，因为后面有自己的项目，这些肯定都会用到，到时候直接上手，真正意义的上手肯定是一番磨…练!!! over!

# android
Logo
华为云开发者联盟

为开发者提供学习成长、分享交流、生态实践、资源工具等服务，帮助开发者快速成长。

更多推荐

cover

通过HPA+CronHPA组合应对业务复杂弹性伸缩场景

avatar 华为云开发者联盟
cover

FT-FMEA融合混沌演练，零售运营系统韧性架构在线验证实践

avatar 华为云开发者联盟
cover

如何使用Python和Plotly绘制3D图形

avatar 华为云开发者联盟