目的
充分的單元測(cè)試就是提高代碼質(zhì)量最有效的手段之一切油,而單元測(cè)試嚴(yán)重依賴代碼的可測(cè)試性,本文主要通過一個(gè)簡(jiǎn)單的DEMO演示如何對(duì)Android原生應(yīng)用進(jìn)行單元測(cè)試件相,同時(shí)示例代碼采用MVP模式以提高代碼的可讀性和可測(cè)試性
簡(jiǎn)介
在Android原生應(yīng)用開發(fā)中,存在兩種單元測(cè)試:本地JVM測(cè)試和Instrumentation測(cè)試。本文僅介紹本地JVM測(cè)試
本地jvm的單元測(cè)試
這種方式運(yùn)行速度快疙赠,對(duì)運(yùn)行環(huán)境沒有特殊要求,可以很方便的做自動(dòng)化測(cè)試朦拖,是單元測(cè)試首選的方法Instrumentation測(cè)試
Instrumentation測(cè)試需要運(yùn)行在Android環(huán)境下圃阳,可以是模擬器或者手機(jī)等真實(shí)設(shè)備。這種方式運(yùn)行速度慢璧帝,且嚴(yán)重依賴Android運(yùn)行環(huán)境捍岳,更適合用來做集成測(cè)試
準(zhǔn)備
我準(zhǔn)備了一個(gè)簡(jiǎn)單的APP,模擬一個(gè)耗時(shí)的網(wǎng)絡(luò)請(qǐng)求獲得一段數(shù)據(jù)并顯示在界面上睬隶,針對(duì)這個(gè)APP編寫單元測(cè)試用例并進(jìn)行本地單元測(cè)試锣夹。
依賴庫
依賴庫 | 作用 |
---|---|
JUnit-4.12 | 基礎(chǔ)得單元測(cè)試框架 |
Robolectric-3.8 | Android SDK測(cè)試框架 |
PowerMock-1.6.6 | 模擬被測(cè)對(duì)象依賴的靜態(tài)方法 |
Mockito-1.10.19 | 模擬被測(cè)對(duì)象依賴的對(duì)象 |
配置build.gradle
- 增加編譯選項(xiàng),在測(cè)試中包含資源文件
testOptions {
unitTests {
includeAndroidResources true
}
}
- 添加測(cè)試依賴庫
testImplementation 'junit:junit:4.12'
testImplementation 'org.robolectric:robolectric:3.8'
testImplementation 'org.robolectric:shadows-supportv4:3.8'
testImplementation 'org.powermock:powermock-module-junit4:1.6.6'
testImplementation 'org.powermock:powermock-module-junit4-rule:1.6.6'
testImplementation 'org.powermock:powermock-api-mockito:1.6.6'
testImplementation 'org.powermock:powermock-classloading-xstream:1.6.6'
testImplementation 'org.mockito:mockito-all:1.10.19'
測(cè)試Activity
測(cè)試Activity主要是測(cè)試它各個(gè)生命周期的狀態(tài)變化苏潜、對(duì)外界輸入的響應(yīng)是否符合預(yù)期银萍,Activity測(cè)試完全依賴Android SDK,需要用Robolectric恤左。
Robolectric是一個(gè)開源的單元測(cè)試框架贴唇,能夠完全模擬Android SDK并在JVM中運(yùn)行。
UI依賴于Persenter飞袋,在Activity中通過靜態(tài)工廠方法創(chuàng)建依賴的Presenter實(shí)例戳气,需要使用PowerMock來模擬創(chuàng)建Presenter過程,完成Presenter模擬對(duì)象的注入
配置
- 通過@RunWith指定使用RobolectricTestRunner
- 通過@Config配置Robolectric的運(yùn)行環(huán)境
- 通過@PrepareForTest配置PowerMock需要模擬的靜態(tài)類型
@RunWith(RobolectricTestRunner.class)
@Config(sdk = 21, constants = BuildConfig.class)
@PowerMockIgnore({"org.mockito.*", "org.robolectric.*", "android.*"})
@PrepareForTest({PresenterFactory.class})
@Before
public void setUp() {
appContext = RuntimeEnvironment.application.getApplicationContext();
PowerMockito.mockStatic(PresenterFactory.class);
}
onCreate用例
通過Robolectric的ActivityController來構(gòu)建并管理activity的生命周期巧鸭,運(yùn)行至onCreate階段瓶您,然后驗(yàn)證這個(gè)階段text1是否正確初始化
@Test
public void onCreate_text1() {
MainActivity activity = Robolectric.buildActivity(MainActivity.class).create().get();
String expect = appContext.getString(R.string.hell_world);
assertEquals(expect, ((TextView)activity.findViewById(R.id.lbl_text1)).getText());
}
Click Button1用例
Activity完全顯示以后,驗(yàn)證button1的click操作是否顯示toast消息
@Test
public void btn1_click() {
MainActivity activity = Robolectric.setupActivity(MainActivity.class);
activity.findViewById(R.id.btn_1).performClick();
String expect = appContext.getString(R.string.hell_world);
assertEquals(expect, ShadowToast.getTextOfLatestToast());
}
Click Button2用例
Activity完全顯示以后,驗(yàn)證button2的click操作是否調(diào)用了presenter的fetch方法
@Test
public void btn2_click() {
MainContract.Presenter presenter = Mockito.mock(MainContract.Presenter.class);
PowerMockito.when(PresenterFactory.create(Mockito.any(MainContract.View.class), Mockito.any(AppExecutors.class)))
.thenReturn(presenter);
MainActivity activity = Robolectric.setupActivity(MainActivity.class);
activity.findViewById(R.id.btn_2).performClick();
Mockito.verify(presenter, Mockito.times(1))
.fetch();
}
測(cè)試Presenter
Presenter的測(cè)試一般可以不用依賴Android SDK了呀袱,Presenter依賴于底層的領(lǐng)域服務(wù)芯肤,也依賴上層View,demo中對(duì)領(lǐng)域服務(wù)的依賴沒有通過構(gòu)造函數(shù)的方式注入压鉴,而是通過靜態(tài)工廠方法構(gòu)建崖咨,還是需要用到PowerMock
配置
- 通過@RunWith指定使用PowerMockRunner
- 通過@PrepareForTest配置PowerMock需要模擬的靜態(tài)類型
@RunWith(PowerMockRunner.class)
@PrepareForTest({ServiceFactory.class})
@Before
public void setUp() {
PowerMockito.mockStatic(ServiceFactory.class);
}
成功路徑用例
驗(yàn)證View的方法是否成功調(diào)用且調(diào)用參數(shù)是否一致
@Test
public void fetch_success() {
String expected = "hello world";
SlowService service = Mockito.mock(SlowService.class);
Mockito.when(service.fetch()).thenReturn(expected);
PowerMockito.when(ServiceFactory.create())
.thenReturn(service);
MainContract.View view = Mockito.mock(MainContract.View.class);
MainPresenter presenter = new MainPresenter(view, executors);
presenter.fetch();
Mockito.verify(service, Mockito.times(1)).fetch();
Mockito.verify(view, Mockito.times(1)).onFetchStarted();
Mockito.verify(view, Mockito.times(1)).onFetchCompleted();
Mockito.verify(view, Mockito.times(0)).onFetchFailed(Mockito.anyObject());
ArgumentCaptor<String> captor = ArgumentCaptor.forClass(String.class);
Mockito.verify(view, Mockito.times(1)).onFetchSuccess(captor.capture());
assertEquals(expected, captor.getValue());
}
失敗路徑用例
@Test
public void fetch_failed() {
RuntimeException exception = new RuntimeException("fetch failed");
SlowService service = Mockito.mock(SlowService.class);
Mockito.when(service.fetch()).thenThrow(exception);
PowerMockito.when(ServiceFactory.create())
.thenReturn(service);
MainContract.View view = Mockito.mock(MainContract.View.class);
MainPresenter presenter = new MainPresenter(view, executors);
presenter.fetch();
Mockito.verify(service, Mockito.times(1)).fetch();
Mockito.verify(view, Mockito.times(1)).onFetchStarted();
Mockito.verify(view, Mockito.times(1)).onFetchCompleted();
ArgumentCaptor<Throwable> captor = ArgumentCaptor.forClass(Throwable.class);
Mockito.verify(view, Mockito.times(1)).onFetchFailed(captor.capture());
assertEquals(exception, captor.getValue());
Mockito.verify(view, Mockito.times(0)).onFetchSuccess(Mockito.anyString());
}
測(cè)試Service
Service不會(huì)對(duì)上層有依賴,可以直接使用JUnit測(cè)試
public class SlowServiceImplTest {
@Test
public void fetch_data() {
SlowServiceImpl impl = new SlowServiceImpl();
String data = impl.fetch();
assertEquals("from slow service", data);
}
}
自動(dòng)化測(cè)試
自動(dòng)化測(cè)試一般是在持續(xù)集成環(huán)境中使用命令來執(zhí)行單元測(cè)試
gradlew :app:testDebugUnitTest
總結(jié)
寫完這個(gè)demo油吭,總覺得給Android APP做單元測(cè)試還是非常簡(jiǎn)單的击蹲,作為一個(gè)優(yōu)秀的程序員,怎么能夠不關(guān)注自己的代碼質(zhì)量呢婉宰,還是自己動(dòng)手試試吧
源碼下載
https://github.com/hziee514/android-testing