Android Espresso(一)——环境建立

最新推荐文章于 2024-10-08 15:32:15 发布

VoidHope

最新推荐文章于 2024-10-08 15:32:15 发布

阅读量1.6k

点赞数

分类专栏： Android Test 文章标签： junit Espresso

本文链接：https://blog.csdn.net/sz_chrome/article/details/114587664

版权

Android Test 专栏收录该内容

5 篇文章 1 订阅

订阅专栏

文章目录

Android Testing使用总结(一)

Android Testing使用总结(一)

写了很多年的代码，Test Case代码一直一个被忽略且容易去逃避的问题，总觉得在不停迭代运行过程中，可以插错到很多情况。但事实，一旦进入到QA阶段，很多问题(bug)就是冒出来了。

因此引起重视，开始在完成task的过程中尽可能的编写Test代码。

标注

这里的几个标注先说明下：

@FixMethodOrder决定测试用例方法的执行顺序，其中的参数值定义在MethodSorters有三个：NAME_ASCENDING, JVM, DEFAULT.
- NAME_ASCENDING 表示通过字典序排列方法，执行测试方法。
- JVM 表示由JVM进行排序并执行，不能保证想要的执行顺序。
- DEFAULT 表示不可预知的顺序执行。
@LargeTest 大型测试用例，执行时间 >1000ms，还需要说明的是与之对应的还有 SmallTest, MediumTest
- LargeTest 标注一个大型测试，一般多为功能UI测试，执行时间 >1000ms。
- MediumTest标注一个中型测试，执行时间 <1000ms，一般用以测试单个组件功能。
- SmallTest 标注一个小型测试，这个就是最常说的单元测试，执行时间 < 200ms。
@Before 在 @Test 测试方法执行之前，执行一些初始化动作。
@After 与 @Before 相对，它标注的方法在所有 @Test 方法执行结束之后执行。
@Test 标注用以说明当前方法是一个测试方法。
@Rule 标注一个字段(Field)或者方法(Method)，且字段或方法并须是public且非static。具体描述可以查看 TestRule (JUnit API)

Android Support Test

开始，Android test 库是 support library.

引入

app/build.grdale 内添加基本测试依赖库。

android {

    defaultConfig {
    	// ...
    	testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
	}

    testOptions {
        unitTests {
            includeAndroidResources=true
        }
    }

}

dependencies {
    // ...
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-contrib:3.0.2'
    androidTestImplementation 'com.android.support.test:rules:1.0.2'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.uiautomator:uiautomator-v18:2.1.3'
    androidTestImplementation 'org.hamcrest:hamcrest-integration:1.3'
}

基本使用

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

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

    private UiDevice mDevice;

    @Before
    public void setup() {
        mDevice = UiDevice.getInstance(getInstrumentation());
    }

    @Test
    public  void testPrint() {
        onView(withText(R.string.menu_reports)).perform(click());
        mDevice.wait(Until.hasObject(By.textContains("printing")), 30000);
    }
}

AndroidX Test

AndroidX Test无疑是一开始最该去了解并且运用的。不多说，看使用总结。

可以阅读官方文档的测试基知识来获取知识；在 Android 平台上测试应用

可以去github阅读samples代码：android/testing-samples

测试库

UI Automator

作用：

用于检查布局层次结构的查看器。
用于检索状态信息并在目标设备上执行操作的 API。
支持跨应用界面测试的 API。

gradle引用：

androidTestImplementation 'androidx.test.uiautomator:uiautomator:2.2.0'

官方文档：

UI Automator | Android 开发者 | Android Developers

Espresso

作用：

Espresso 来编写简洁、美观且可靠的 Android 界面测试。

gradle引用：

androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'

其他软件包：

软件包

官方文档：

Espresso | Android 开发者 | Android Developers

上述两个测试库最为基本且重要，其他还有一般引入的有:

    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test:rules:1.3.0'
    androidTestImplementation 'androidx.test:runner:1.3.0'
    androidTestImplementation 'androidx.test:core:1.3.0'
    androidTestImplementation 'org.hamcrest:hamcrest-integration:1.3' // UI匹配器

基本使用示例

gradle依赖引入(app目录下build.gradle)

dependencies {
    // ...
    testImplementation 'junit:junit:4.13.2'

    androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
    androidTestImplementation 'androidx.test.espresso:espresso-intents:3.3.0'

    androidTestImplementation 'androidx.test:rules:1.3.0'
    androidTestImplementation 'androidx.test:runner:1.3.0'
    androidTestImplementation 'androidx.test:core:1.3.0'
    androidTestImplementation 'androidx.test.ext:junit:1.1.2'
    androidTestImplementation 'androidx.test.ext:truth:1.3.0'
    androidTestImplementation 'androidx.test.uiautomator:uiautomator:2.2.0'
    androidTestImplementation 'org.hamcrest:hamcrest-integration:1.3'
    // ...
}

工程根目录下build.gradle

android {
    // ...
    defaultConfig {
		testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    
    testOptions {
        unitTests {
            includeAndroidResources=true
        }
    }

    useLibrary 'android.test.runner'

    useLibrary 'android.test.base'
    useLibrary 'android.test.mock'
    // ...
}

这样Gradle的基本配置结束了。

这里的示例是依赖于Android API，因此测试代码放置于 project/app/src/androidTest目录之下。

线上测试代码：


@RunWith(AndroidJUnit4.class)
@FixMethodOrder(value= MethodSorters.NAME_ASCENDING) // 执行顺序，@Test的方法按照方法名字典序执行
@LargeTest // 大型测试标注
public class TM295TestUnit  {

    @Rule
    public ActivityScenarioRule<PeripheralActivity> activityRule = new ActivityScenarioRule<>(PeripheralActivity.class);

    private UiDevice mDevice; // UI Automator API

    /**
     * 在此初始化一些公共字段，或者通用常量
     */
    @Before
    public void setup() {
        System.out.println("Test Start ~~~");
        mDevice = UiDevice.getInstance(getInstrumentation()); 
        activityRule.getScenario().moveToState(State.RESUMED);
    }

    /**
     * 表明一个test case方法
     */
    @Test
    public void testPrinter_1() {
        onView(withId(R.id.button_init_printer)).perform(click()); // Espresso
        mDevice.wait(Until.hasObject(By.text("Open successfully")), 1000);

        try {
            System.out.println("test1 sleep starts");
            Thread.sleep(1000);
            System.out.println("test1 sleep ends");
        } catch (InterruptedException e) {
            e.printStackTrace();
        }

    }
    
    @After
    public void tearDown() {
        System.out.println("Test Complete");
        activityRule.getScenario().moveToState(State.DESTROYED);
    }
}

示例

这里需要注意的是@Before @After 两个标注，他们标注的方法在@Test标注的方法执行时均被调用，执行顺序是 @Before @Test @After，即每个测试用例方法执行时， @Before @After 方法也都会被执行。

@RunWith(AndroidJUnit4.class)
@MediumTest
public class MainActivityTest {

    @Rule
    public ActivityScenarioRule<MainActivity> activityRule = new ActivityScenarioRule<>(MainActivity.class);

    @Before
    public void setup() {
        Log.v("MainActivityTest", "setup method");
    }

    @Test
    public void test1() {
        Log.i("MainActivityTest", "test method test1");
    }

    @Test
    public void test2() {
        Log.i("MainActivityTest", "test method test2");
        onView(withId(R.id.btn_show_dialog)).perform(click());
    }

    public void test3() {
        Log.i("MainActivityTest", "test method test3");
    }
    
    @After
    public void tearDown() {
        Log.v("MainActivityTest", "tearDown method");
    }
}

上述代码运行结果：

2021-03-15 09:53:42.938 328-351/com.westernunion.android.demo I/TestRunner: started: test1(com.westernunion.android.MainActivityTest)
2021-03-15 09:53:44.384 328-351/com.westernunion.android.demo V/MainActivityTest: setup method
2021-03-15 09:53:44.385 328-351/com.westernunion.android.demo I/MainActivityTest: test method test1
2021-03-15 09:53:44.385 328-351/com.westernunion.android.demo V/MainActivityTest: tearDown method
2021-03-15 09:53:46.047 328-351/com.westernunion.android.demo I/TestRunner: finished: test1(com.westernunion.android.MainActivityTest)
2021-03-15 09:53:46.126 328-351/com.westernunion.android.demo I/TestRunner: started: test2(com.westernunion.android.MainActivityTest)
2021-03-15 09:53:46.740 328-351/com.westernunion.android.demo V/MainActivityTest: setup method
2021-03-15 09:53:46.740 328-351/com.westernunion.android.demo I/MainActivityTest: test method test2
2021-03-15 09:53:48.685 328-351/com.westernunion.android.demo V/MainActivityTest: tearDown method
2021-03-15 09:53:49.788 328-351/com.westernunion.android.demo I/TestRunner: finished: test2(com.westernunion.android.MainActivityTest)

从控制台打印输出可以看到，每个“test method xx”信息前后，都有打印setup method和tearDown method信息。

这就印证代码前的说法。