Google IO 2016 筆記之Espresso 進階

簡介

Espresso 是 Google 官方提供的一個易于測試 Android UI 的開源框架 ， 于2013年10月推出它的 released 版本 ， 目前最新版本已更新到2.x . 并且在AndroidStudio 2.2 預覽版中已經默認集成該測試庫 .

Espresso 由以下三個基礎部分組成：

• ViewMatchers - 在當前View層級去匹配指定的View .
• ViewActions - 執(zhí)行Views的某些行為，如點擊事件 .
• ViewAssertions - 檢查Views的某些狀態(tài)，如是否顯示 .

<!-- more -->

Espresso 測試

onView(ViewMatcher) //1.匹配View
      .perform(ViewAction) //2.執(zhí)行View行為
           .check(ViewAssertion); //3.驗證View

準備

目前AndroidStudio的2.2預覽版已經默認集成：

build.gradle 配置如下：

apply plugin: 'com.android.application'


android {
    compileSdkVersion 24
    buildToolsVersion "23.0.3"
    defaultConfig {
        applicationId "com.sample.espresso"
        minSdkVersion 14
        targetSdkVersion 24
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" 
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}


dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    testCompile 'junit:junit:4.12'
}

基礎

獲得View

• withId方式

  onView(withId(R.id.my_view))

• withText方式

  onView(withText("Hello World!"))

執(zhí)行View行為

• 點擊

  onView(...).perform(click());

• 文本內容輸入

  onView(...).perform(typeText("Hello"), click());

• scrollTo 滑動

  onView(...).perform(scrollTo(), click());

檢驗View

• 檢驗View的文本內容

  onView(...).check(matches(withText("Hello!")));

• 檢驗View的顯示狀態(tài)

  onView(...).check(matches(isDisplayed()));

示例代碼： 簡單的登陸場景測試

@RunWith(AndroidJUnit4.class)
public class LoginUITest {


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


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


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


}

進階

歡迎進入本文的重點內容。

1. 使用IdlingResource

通常，我們實際的應用當中會有很多異步任務，例如網絡請求，圖片加載等，但是Espresso并不知道你的異步任務什么時候結束，所以需要借助于IdlingResource .

這里需要注意的是，如果你是通過AsyncTask或者AsyncTaskCompat方式的異步任務，Espresso已經處理好，并不需要去額外的處理。

第一步：添加依賴庫

compile 'com.android.support.test.espresso:espresso-idling-resource:2.2.2'

第二步：實現IdlingResource接口 .

public interface IdlingResource {


  /**
   * 用來標識 IdlingResource 名稱
   */
  public String getName();


  /**
   * 當前 IdlingResource 是否空閑 .
   */
  public boolean isIdleNow();


  /**
   注冊一個空閑狀態(tài)變換的ResourceCallback回調
   */
  public void registerIdleTransitionCallback(ResourceCallback callback);


  /**
   * 通知Espresso當前IdlingResource狀態(tài)變換為空閑的回調接口
   */
  public interface ResourceCallback {
    /**
     * 當前狀態(tài)轉變?yōu)榭臻e時，調用該方法告訴Espresso
     */
    public void onTransitionToIdle();
  }
}

下面我們以一個示例來說明： 場景：假設當前我們需要測試用戶的頭像的是否正常顯示。

Activity代碼

public class AvatarActivity extends AppCompatActivity{


    private ImageView mAvatar;


    public static SimpleIdlingResource sIdlingResource=new SimpleIdlingResource();


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_idling_resource);


        mAvatar= (ImageView) findViewById(R.id.avatar);


        //App 開始進入忙碌狀態(tài) ，等待通知
        sIdlingResource.increment();
        //開始加載頭像圖片
        Glide.with(this).load("https://avatars2.githubusercontent.com/u/2297803?v=3&s=460").into(new GlideDrawableImageViewTarget(mAvatar) {
            @Override
            public void onResourceReady(GlideDrawable resource,
                                        GlideAnimation<? super GlideDrawable> animation) {
                super.onResourceReady(resource, animation);
                //加載完畢后，將App設置成空閑狀態(tài)
                sIdlingResource.decrement();
            }
        });
    }
}

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，說明當前是空閑狀態(tài)
     */    
    @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) {
            // 執(zhí)行onTransitionToIdle()方法，告訴Espresso，當前是空閑狀態(tài)。
            if (null != resourceCallback) {
                resourceCallback.onTransitionToIdle();
            }
        }


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

IdlingResourceTest代碼

@RunWith(AndroidJUnit4.class)
public class IdlingResourceTest {


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


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


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


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


}

另外，Espresso 提供了一個實現好的CountingIdlingResource類，所以如果沒有特別需求的話，直接使用CountingIdlingResource即可。

2.創(chuàng)建一個自定義 Espresso matcher

目前Espresso提供的方法基本上可以滿足你的測試需求，如下圖所示：

如果你需要對自定義的View中某個自定義屬性進行測試的話，你可以創(chuàng)建一個自定義的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.如何處理動畫

• 系統(tǒng)動畫： 為了避免動畫線程運行期間對Espresso測試產生的影響，官方強烈建議關閉系統(tǒng)動畫。如圖所示：

• 自定義動畫： 對于自定義動畫，開發(fā)者可以借助以下代碼去控制動畫的開和關。

該方法可以監(jiān)聽系統(tǒng)動畫的開關事件，這是一個值得推薦的做法，不僅僅是在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.優(yōu)雅的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`，這樣顯然不夠靈活。


- 優(yōu)雅的方式


```java
    @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依賴庫：

androidTestCompile 'com.android.support.test.espresso:espresso-intents:2.2.2'

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，并執(zhí)行執(zhí)行點擊事件，測試也正常，同樣這段代碼也被復制到了其他的測試方法中使用， 這時，設想一下，如果你的adapter中的數據源改成了cursor或者其他，于是悲催了，你需要修改很多地方，顯然，這不是一個合格的CV戰(zhàn)士。

所以，我們需要對之前那行代碼進行改裝：

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


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

很簡單，只需將可能變化的部分抽出來即可。

7.如何測試View的位置 如圖所示：

8.自定義錯誤日志 默認的錯誤日志打印信息比較多，如圖：

如果你只想顯示你關心的日志信息，你可以自定義FailureHandler：

Espresso.setFailureHandler(new CustomFailureHandler());

參考

Advanced Espresso - Google I/O 2016 Espresso 官方文檔 Android user interface testing with Espresso - Tutorial googlesamples/android-testing