Android Unit Test 入门

这篇文章主要是讲述一些unit test基本类库中的基本方法，实践下来发现只要掌握这些基本的API，大部分的测试用例都是可以实现的，万变不离其宗。

我们新建项目会自动生成这两个测试目录，androidTest和test，这两个目录的主要区别在于其一个需要连接真机/虚拟机去测试，另一个只需要运行在JVM之上，即使一个空的case放在androidTest也会触发真机运行。另一个区别是相关的库互不相通，test package下不能使用androidTestImplementation引用的库，同样androidTest也不能使用testImplementation引用的库。

Junit
测试基本库，提供了常用的注解和方法。androidTest默认包含该库，不用单独再引用。

testImplementation ‘junit:junit:4.12’
@Test：标记某个方法为测试方法。可以传参数timeout=xx，如果测试方法超过这个数值即为失败。
@Before: 类中每个case执行前先执行该方法。
@After: 类中每个case执行后都执行该方法。
@BeforeClass: 每个测试类执行之前先跑一次
@AfterClass: 每个测试类所有case执行完跑一次
Assert相关方法，assertFalse/assertTrue/assertEquals等，也可以直接用kotlin的assert(boolen)方法，不过相比Assert类中的方法failed时不能提供有效的日志信息，所以还是推荐是用Assert类中的方法。
MockK
模拟隔离框架。现在Android开发已经逐渐切换到kotlin，使用之前的mock库例如mockito会碰到一些问题，比如被mock的类要求是非final的，而kotlin的类除非显示声明为open不然默认都是final，比如object/companion/扩展函数/顶层函数的mock。
mockK库的专为kotlin语言，完全包含之前常用的mocktio和powermock的功能。

testImplementation ‘io.mockk:mockk:1.9’
mock
获取模拟对象，mock的对象主要目的是要模拟该对象的方法，通常和下面要说的every配合使用，如果最终想要模拟的方法时static方法，可以调用mockkStatic()/mockObject()。
假设有个Student类和一个Library类，我们想要mock学生从图书馆借书的动作，则需要先mock一个图书馆类。
val library = mockk()
所有mock对象的方法的调用都必须通过every方法提前定义好。

every
相当于mocktio中的when(). thenReturn()方法，every { } returns 方法体中添加某个对象的方法，当在测试代码中执行到该方法时并不会真的去执行，而是直接返回returns之后的对象。也可以不加returns而使用every { } just Runs跳过执行。
我们完善一下上面的例子
class Student(val library: Library) {
val books = mutableListOf()
fun borrowBook() {
val book = library.borrowBook()
books.add(book)
}
}

@Test
fun testStudentBorrowBook() {
val library = mockk()
val student = new Student(libaray)

 //需要通过图书馆借书时直接返回一本书
 every {libaray.borrowBook() } returns Book("book name")

 student.borrowBook()
 assertEquals(student.books.list[0].getName(), "book name")

}
如果every里面的方法是suspend方法，需要用coEvery{}去mock.

Annotation
也可以通过注解的方式去mock对象，但是需要在before里手动调用下MockKAnnotations.init(this)
class Test {
@MockK
lateinit var fragment: TestFragment

@Before
fun setup() {
    MockKAnnotations.init(this)
}

}
verify
想要验证某个对象的某个方法是否被执行了，可以使用此方法。比如学生要借书时需要刷卡，则可以通过verify方法验证学生有没有刷过卡。
class Student(val library: Library) {
val books = mutableListOf()
val bookCard = BookCard()

fun borrowBook() {
      library.swipeCard(bookCard)
      val book = library.borrowBook()
      books.add(book)
}

}

@Test
fun testStudentBorrowBook() {
val library = mockk()
val student = new Student(libaray)

 //需要通过图书馆借书时直接返回一本书
 every {libaray.borrowBook() } returns Book("book name")
 every {library.swipeCard(student.bookCard) } just Runs

 student.borrowBook()
 verify {library.swipeCard(student.bookCard) }

}
Robolectric
如果我们想测试一些Android特性的东西，如启动application，获取UI信息等，但是又不想连接设备去测试，这时候就需要Robolectric了。

testImplementation ‘org.robolectric:robolectric:4.3.1’

android {
testOptions {
unitTests.includeAndroidResources = true
}
}
下面是一个简单的测试示例

@RunWith(RobolectricTestRunner::class)
@Config(sdk = [Build.VERSION_CODES.P], application = TestApplication::class)
class ExampleUnitTest {
@Test
fun testActivity() {
val activity = Robolectric.buildActivity(MainActivity::class.java).create().start().resume().get()
val textView = activity.findViewById(R.id.main_hello_text_view)
assertEquals(textView.text, “Hello World!”)
}
}
启动某个activity会先启动Application，正常项目里Application会有很多初始化动作，通常我们为了方便可以在config指定一个TestApplication，config里还可以指定其他一些配置，比如manifest。

buildActivity
启动Activity的方法。Robolectric.buildActivity(MainActivity::class.java)该方法会返回ActivityController对象，通过该对象可以方便的控制Activity的生命周期。

shadowOf()
每个shadow对象都可以认为是对应控件的测试方法库。
方法里面可以传入很多常用的控件类型返回相应的shadow对象，比如Application，Activity，ListView，AlertDialog，Theme等。
比如Activity和ListView提供了以下的方法

@RunWith(RobolectricTestRunner::class)
@Config(sdk = [Build.VERSION_CODES.P], application = TestApplication::class)
class ExampleUnitTest {
@Test
fun testActivity() {
val activity = Robolectric.buildActivity(MainActivity::class.java).create().start().resume().get()
val textView = activity.findViewById(R.id.main_hello_text_view)
assertEquals(textView.text, “Hello World!”)

    val activityShadow = shadowOf(activity)
    //可以动态授权
    activityShadow.grantPermissions(Manifest.permission.READ_SMS)
    //假设点击后会跳转到SecondActivity
    textView.performClick()

    val nextActivityName = activityShadow.nextStartedActivity.component?.className
    //验证点击后跳转的activity是否正确
    assertEquals(nextActivityName, SecondActivity::class.java.simpleName)
}

}
@Test
fun testListView() {
val activity = Robolectric.buildActivity(MainActivity::class.java).create().start().resume().get()
val listView = activity.findViewById(R.id.main_hello_text_view)

    val listViewShadow = shadowOf(listView)
    //需要先调populateItems才能正确绘制listView
    listViewShadow.populateItems()
    //点击第一个item
    listViewShadow.clickFirstItemContainingText("First")
}

具体使用的时候可以查看shadow对象源码了解其提供了哪些方法。

fragment test
Robolectric提供了buildFragment(class)的方法
但是如果我们使用的是androidx的fragment是没办法使用该方法直接创建 fragment的，这时如果我们想简单的启动一个fragment需要另外引入一个支持库
debugImplementation ‘androidx.fragment:fragment-testing:1.2.3’
testImplementation “androidx.test:core:1.2.0”
该库提供了直接启动fragment和activity的方法

//fragment会放入一个emptyActivity之中，并且直接到onResume状态。
val fragment = launchFragment(themeResId = R.style.AppTheme, factory = FragmentFactory())

//启动一个activity，并且直接到onResume状态
val activityScenario = ActivityScenario.launch(MainActivity::class.java)
activityScenario.onActivity { activity ->

}
这种启动方式的缺点是状态无法控制，直接到resume，如果onCreate等生命周期中有需要mock的对象则难以控制。如果想较为灵活的控制就可以通过Android的API去加载fragment

@Test
fun testFragment() {
    val activityController = Robolectric.buildActivity(MainActivity::class.java).create()
    val fragment = TestFragment()
    activityController.get().supportFragmentManager.beginTransaction().add(R.id.fragment_container, fragment).commit()
    
    activityController.start().resume()
}

Espresso
设备化测试库，可以方便的进行UI操作

onView
可以通过id或者文本内容找到相应的view
onView(withId(R.id.bottom)).perform(click())
onView(withText(“next”)).perform(click())
perform
可以模拟各种用户操作，点击、长按、输入文本、滑动等
//输入文本
onView(withId(R.id.bottom)).perform(typeText(“Steve”))
//下滑操作
onView(withText(“next”)).perform(swipeDown())
最后
欢迎点赞或者斧正。

原文