Looking for android-espresso Answers? Try Ask4KnowledgeBase
Looking for android-espresso Keywords? Try Ask4Keywords

android-espresso開始使用android-espresso


備註

本節概述了android-espresso是什麼,以及開發人員為什麼要使用它。

它還應該提到android-espresso中的任何大型主題,並鏈接到相關主題。由於android-espresso的文檔是新的,您可能需要創建這些相關主題的初始版本。

濃縮咖啡設置說明

  • 設置您的測試環境
  • 下載濃縮咖啡
  • 設置儀表運行器
  • 示例build.gradle文件
  • Analytics(分析)
  • 添加第一個測試
  • 運行測試本指南介紹如何使用SDK Manager安裝Espresso並使用Gradle進行構建。建議使用Android Studio。

設置您的測試環境

為避免瑕疵,我們強烈建議您關閉用於測試的虛擬或物理設備上的系統動畫。

在您的設備上,在Settings-> Developer options下,禁用以下3個設置:

  • 窗口動畫比例
  • 過渡動畫比例
  • 動畫師持續時間刻度

下載濃縮咖啡

  • 確保您已在Extras下安裝了最新的Android Support Repository(請參閱說明)。

  • 打開應用程序的build.gradle文件。這通常不是頂級build.gradle文件,而是app / build.gradle。

  • 在依賴項中添加以下行:

    androidTestCompile'c​​om.android.support.test.espresso:espresso-core:2.2.2'androidTestCompile'c​​om.android.support.test:runner:0.5'

  • 有關更多工件,請參閱下載部分(espresso-contrib,espresso-web等)

  • 設置儀表運行器

將相同的build.gradle文件添加到android.defaultConfig中的以下行:testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" 示例build.gradle文件

apply plugin: 'com.android.application'

    android {
        compileSdkVersion 22
        buildToolsVersion "22"
    
        defaultConfig {
            applicationId "com.my.awesome.app"
            minSdkVersion 10
            targetSdkVersion 22.0.1
            versionCode 1
            versionName "1.0"
    
            testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        }
    }

dependencies {
    // App's dependencies, including test
    compile 'com.android.support:support-annotations:22.2.0'

    // Testing-only dependencies
    androidTestCompile 'com.android.support.test:runner:0.5'
    androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.2'
}
 

Analytics(分析)

為了確保每個新版本都在正確的軌道上,測試運行器會收集分析。更具體地說,它為每次調用上傳待測應用程序的包名稱的哈希值。這使我們可以使用Espresso測量獨特包裝的數量以及使用量。

如果您不希望上傳此數據,可以通過將以下參數傳遞給測試運行器來選擇退出:disableAnalytics“true”(請參閱如何傳遞自定義參數)。

添加第一個測試

Android Studio默認在src / androidTest / java / com.example.package /中創建測試

使用規則的示例JUnit4測試:

@RunWith(AndroidJUnit4.class)
@LargeTest
public class HelloWorldEspressoTest {

    @Rule
    public ActivityTestRule<MainActivity> mActivityRule = new ActivityTestRule(MainActivity.class);

    @Test
    public void listGoesOverTheFold() {
        onView(withText("Hello world!")).check(matches(isDisplayed()));
    }
}
 

運行測試

在Android Studio中

創建測試配置

在Android Studio中:

  • 打開運行菜單 - >編輯配置

  • 添加新的Android測試配置

  • 選擇一個模塊

  • 添加特定的儀表運行器:

    android.support.test.runner.AndroidJUnitRunner

運行新創建的配置。

從命令行到Gradle

執行

./gradlew connectedAndroidTest
 

Espresso基本上有三個組成部分:

  1. ViewMatchers - 允許在當前視圖層次結構中查找視圖

  2. ViewActions - 允許對視圖執行操作

  3. ViewAssertions - 允許斷言視圖的狀態

基礎濃咖啡測試

onView(ViewMatcher)       -- 1     
 .perform(ViewAction)     -- 2
   .check(ViewAssertion); -- 3
 
  1. 找到視圖
  2. 對視圖執行操作
  3. 驗證斷言

檢查選項菜單項(使用Spoon來截取屏幕截圖)

/**
 * @author piotrek1543
 *
 * This example provides a specific UI testing problem and how it is already solved 
 * with Google's Espresso. Notice that I used also Spoon framework, as Espresso 
 * lacks of taking screenshots functionality.
 */

@RunWith(AndroidJUnit4.class)
public class MainActivityAndroidTest {
    @Rule
    public ActivityTestRule<MainActivity> mRule = new ActivityTestRule<>(MainActivity.class);

    @Test
    public void checkIfSettingsMenuItemsAreVisible() throws InterruptedException {
        //open OptionsMenu to see available items
        openActionBarOverflowOrOptionsMenu(mRule.getActivity());
        //create a screenshot with 'options_menu' TAG
        Spoon.screenshot(mRule.getActivity(), "options_menu");
        //check if Settings item is Visible
        onView(withText(R.string.action_settings)).check(matches(isDisplayed()));
        //check if `Sort` item is Visible
        onView(withText(R.string.action_sort)).check(matches(isDisplayed()));
        //perform click on `Sort` OptionsMenu item
        onView(withText(R.string.action_sort)).perform(click());
        //create a screenshot with 'options_menu_sort' TAG
        Spoon.screenshot(mRule.getActivity(), "options_menu_sort");
        //check if `Sort -> By Value id` item is Visible
        onView(withText(R.string.menu_sort_length)).check(matches(isDisplayed()));
        //check if `Sort -> By Joke length` item is Visible
        onView(withText(R.string.menu_sort_a_z)).check(matches(isDisplayed()));
    }
}
 

按ID查找一些視圖

onView(withId(R.id.pay))
 

按文字查找視圖

onView(withText("Pay"))
onView(withText(R.string.pay))
 

Hello World Espresso示例

這是一個創建hello world示例的教程:用於此示例:Android Studio 2.3;

要開始使用Android Studio創建具有空活動的新項目。然後我們向App添加一些我們可以測試的簡單功能:我們添加一個按鈕,當點擊在文本視圖中顯示“Hello World”時。

活動代碼如下所示:

package com.example.testing.helloworld;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {

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

        final TextView textView = (TextView) findViewById(R.id.textView);

        findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                textView.setText("Hello World!");
            }
        });
    }
}
 

此活動的activity_main 佈局如下所示:

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

    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="" />

    <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Say Hello" />
</LinearLayout>
 

現在我們想要使用espresso來測試這個新創建的應用程序的行為。通常,您的應用程序本身的代碼在main 包中,單元測試在內部test ,espresso檢測測試在androidTest 包內。如果您使用Android Studio創建一個新的空活動項目,它應該已經創建了這些包和類,它應該如下所示:

在此處輸入圖像描述

要從espresso開始,我們必須確保espresso-core 依賴項包含在build.gradle 文件中(請注意,它不是使用compile 關鍵字註釋,而是使用androidTestCompile )。 Android studio創建的build.gradle 文件中的依賴項應如下所示:

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'
    })
    compile 'com.android.support:appcompat-v7:25.2.0'
    compile 'com.android.support.constraint:constraint-layout:1.0.2'
    testCompile 'junit:junit:4.12'
}
 

現在已經完成所有設置,我們可以從實際測試開始:打開ExampleInstrumentationTest 文件,您會看到已經有一個生成的useAppContext 測試。我們將更改此測試類並創建測試以檢查我們的應用程序行為:

@RunWith(AndroidJUnit4.class)
public class ExampleInstrumentedTest {

    @Rule
    public ActivityTestRule<MainActivity> mActivityRule = new ActivityTestRule<>(
        MainActivity.class, false, true);

    @Test
    public void checkHelloWorld() throws Exception {
        onView(withId(R.id.textView)).check(matches(withText("")));
        onView(withId(R.id.button)).perform(click());
        onView(withId(R.id.textView)).check(matches(withText("Hello World!")));
    }
}
 

通過運行ExampleInstrumentedTest 類來啟動測試。然後,這個測試做了三件事:

  1. 它檢查textview是否包含空字符串(“”)
  2. 它單擊我們佈局中的按鈕
  3. 如果它包含“Hello World!”,它會再次檢查textview的文本。

頂部的ActivityTestRule定義測試哪個活動,並在測試開始時啟動它。 (您也可以自動啟動活動,然後手動在每個測試中啟動它)

測試規則非常簡單:

  • onView(withId(R.id.textView)) 通過activity_main 佈局文件中的視圖ID在當前屏幕內查找視圖。
  • .check(matches(withText(""))); 然後在該視圖上執行測試用例。
  • .perform(click()) 對視圖執行操作:此操作可以是點擊,長按或滑動等。

這是一個從android espresso Instrumentation測試開始的教程,我希望它給了你一些見解!

查看測試

onView(withId(R.id.greet_button)) // withId(R.id.my_view) is a ViewMatcher
.perform(click())                 // click() is a ViewAction
.check(matches(not(isEnabled())); // matches(isEnabled()) is a ViewAssertion