#

總覽

NameLocationDescription

libmock_ril	hardware\ril\mock-ril	A mock ril like SecRil.
mockrilcontroller	frameworks\opt\telephony\mockril	Communicate with libmock_ril,send and receive fake RIL cmd to/from libmock_ril via socket.
TelephonyMockRilTests	frameworks\opt\telephony\tests\telephonymockriltests	A Package communicates with libmock_ril via mockrilcontroller, it use InstrumentationTestCase framework to test libmock_ril`s mock functions.
FrameworksTelephonyTests	frameworks\opt\telephony\tests\telephonytests	A Package using InstrumentationTestRunner and TestCase to test Telephony.

上圖中，同一層的模塊功能相同：

RIL

Reference-ril是Android提供的參考代碼。Mock-ril則是一個(gè)模擬的Ril模塊。三者的功能相同。

Telephony

Telephony和RIL層之間通過Socket通信，mockrilcontroller功能和telephony-common類似，只不過其是與Mock-ril通信。還有一個(gè)區(qū)別是telephony-common編譯為動(dòng)態(tài)庫，而mockrilcontroller為靜態(tài)庫

Package

TelephonyMockRilTests 模塊中包含靜態(tài)庫mockrilcontroller。通過查看Manifest可以看出TelephonyMockRilTests 測試的目標(biāo)package是其本身。主要目的是測試mockrilcontroller和Mock-ril模塊。
FrameworksTelephonyTests模塊中則包含動(dòng)態(tài)庫telephony-common，通過查看Manifest可以看出FrameworksTelephonyTests測試的目標(biāo)package也是其本身。主要目的是測試telephony-common模塊。

FrameworksTelephonyTests 分析

根據(jù)上一章的測試實(shí)例分析，現(xiàn)在來看FrameworksTelephonyTests就不太復(fù)雜了。FrameworksTelephonyTests能夠同時(shí)測試Telephony-common和Mock-ril模塊（TelephonyMockRilTests只是對(duì)Mock-ril的一個(gè)簡單測試，在FrameworksTelephonyTests已經(jīng)覆蓋了這部分測試，所以就不再單獨(dú)分析 TelephonyMockRilTests）。
測試是從TestRunner開始的，FrameworksTelephonyTests新建了一個(gè)自定義的TestRunner類TelephonyMockRilTestRunner，用來輔助測試Mock-ril，而對(duì)Telephony-common模塊的測試，則是直接使用的Android測試框架的的InstrumentationTestRunner。
如下圖所示，由于測試用例較多，這里僅挑選2個(gè)典型的測試用例進(jìn)行說明。

GSMPhoneTest

GSMPhoneTest繼承了AndroidTestCase類并實(shí)現(xiàn)了PerformanceTestCase接口，根據(jù)上文可知，AndroidTestCase 繼承于JUnit的TestCase，并沒有使用Instrumentation框架，所以GSMPhoneTest該用例不能使用Android Instrumentation框架的方法。

1 setUp():

首先初始化GSMTestHandler和GSMPhone對(duì)象，得到GSMPhone的引用。并通過GSMPhone對(duì)象的方法，注冊(cè)EVENT_POST_DIAL等一系列事件。

sc = new SimulatedCommands(); mGSMPhone = new GSMPhone(mContext, sc, new TestPhoneNotifier(), true);

不過新建GSMPhone時(shí)，傳遞的RIL接口是一個(gè)模擬的接口，這樣在調(diào)用GSMPhone方法時(shí)，并非調(diào)用到正常的RIL.java發(fā)送AT指令。而是一個(gè)模擬的ril對(duì)象SimulatedCommands上。
這樣，該測試除了ril接口和調(diào)用者是虛擬的，其他Telephony流程和正常流程一致，見下圖：

2 testOutgoingCallFailImmediately():

該測試方法用來測試呼出的呼叫立即失敗的邊緣測試（呼叫還沒有出現(xiàn)在call list之前就立即終結(jié)），這會(huì)導(dǎo)致該失敗的呼叫在ForegroundCall list中以IDLE call的形式出現(xiàn)。

public void testOutgoingCallFailImmediately() throws Exception {Message msg;mRadioControl.setNextDialFailImmediately(true);Connection cn = mGSMPhone.dial("+13125551212");msg = mGSMTestHandler.waitForMessage(EVENT_DISCONNECT);assertNotNull("Message Time Out", msg);assertEquals(PhoneConstants.State.IDLE, mGSMPhone.getState());assertEquals(Connection.DisconnectCause.NORMAL, cn.getDisconnectCause());assertEquals(0, mGSMPhone.getRingingCall().getConnections().size());assertEquals(1, mGSMPhone.getForegroundCall().getConnections().size());assertEquals(0, mGSMPhone.getBackgroundCall().getConnections().size());assertEquals(Call.State.IDLE, mGSMPhone.getRingingCall().getState());assertEquals(Call.State.DISCONNECTED, mGSMPhone.getForegroundCall().getState());assertEquals(Call.State.IDLE, mGSMPhone.getBackgroundCall().getState());assertTrue(mGSMPhone.getForegroundCall().getEarliestCreateTime() > 0);assertEquals(0, mGSMPhone.getForegroundCall().getEarliestConnectTime()); }

3 testHangupOnOutgoing:

該測試方法用來測試通話呼出后，在不同狀態(tài)下（DIALING、ALERTING等）進(jìn)行掛斷。然后判斷Phone的狀態(tài)、Call的狀態(tài)和連接斷開原因是否符合預(yù)期。

public void testHangupOnOutgoing() throws Exception {Connection cn;Message msg;mRadioControl.setAutoProgressConnectingCall(false);// Test 1: local hangup in "DIALING" statemGSMPhone.dial("+13125551212");do {assertNotNull("Message Time Out", mGSMTestHandler.waitForMessage(ANY_MESSAGE));}while (mGSMPhone.getForegroundCall().getState() != Call.State.DIALING);cn = mGSMPhone.getForegroundCall().getEarliestConnection();mGSMPhone.getForegroundCall().hangup();msg = mGSMTestHandler.waitForMessage(EVENT_DISCONNECT);assertNotNull("Message Time Out", msg);assertEquals(PhoneConstants.State.IDLE, mGSMPhone.getState());assertEquals(Call.State.DISCONNECTED, mGSMPhone.getForegroundCall().getState());assertEquals(Connection.DisconnectCause.LOCAL, cn.getDisconnectCause());// Test 2: local hangup in "ALERTING" statemGSMPhone.dial("+13125551212");do {assertNotNull("Message Time Out", mGSMTestHandler.waitForMessage(ANY_MESSAGE));} while (mGSMPhone.getState() != PhoneConstants.State.OFFHOOK);mRadioControl.progressConnectingCallState();do {assertNotNull("Message Time Out", mGSMTestHandler.waitForMessage(ANY_MESSAGE));}while (mGSMPhone.getForegroundCall().getState() != Call.State.ALERTING);cn = mGSMPhone.getForegroundCall().getEarliestConnection();mGSMPhone.getForegroundCall().hangup();msg = mGSMTestHandler.waitForMessage(EVENT_DISCONNECT);assertNotNull("Message Time Out", msg);assertEquals(PhoneConstants.State.IDLE, mGSMPhone.getState());assertEquals(Call.State.DISCONNECTED, mGSMPhone.getForegroundCall().getState());assertEquals(Connection.DisconnectCause.LOCAL, cn.getDisconnectCause());// Test 3: local immediate hangup before GSM index is// assigned (CallTracker.hangupPendingMO case)mRadioControl.pauseResponses();cn = mGSMPhone.dial("+13125551212");cn.hangup();mRadioControl.resumeResponses();msg = mGSMTestHandler.waitForMessage(EVENT_DISCONNECT);assertNotNull("Message Time Out", msg);assertEquals(PhoneConstants.State.IDLE, mGSMPhone.getState());assertEquals(Call.State.DISCONNECTED, mGSMPhone.getForegroundCall().getState());assertEquals(Connection.DisconnectCause.LOCAL, mGSMPhone.getForegroundCall().getEarliestConnection().getDisconnectCause());}

MockRilTest

MockRilTest繼承了InstrumentationTestCase類，根據(jù)上文可知，InstrumentationTestCase繼承于JUnit的TestCase，并使用Instrumentation框架，所以MockRilTest該用例可以使用Android Instrumentation框架的方法。該用例是由自定義的TestRunner——TelephonyMockRilTestRunner運(yùn)行的。并持有RilChannel對(duì)象引用。進(jìn)而調(diào)用RIL層的mock-ril進(jìn)行測試。

1 setUp():

首先初始化TelephonyMockRilTestRunner和RilChannel對(duì)象，得到RilChannel的引用。通過RilChannel的socket和mock-ril進(jìn)行通信。
如下圖所示：

注：聚合關(guān)系的方向畫錯(cuò)了，暫時(shí)沒法修改，見諒。

MockRilTest通過RilChannel和mock-ril建立socket連接并通信。MockRilTest的各個(gè)測試方法通過Msg類的靜態(tài)方法，收發(fā)RilChannel指令。

mRunner = (TelephonyMockRilTestRunner)getInstrumentation();mMockRilChannel = mRunner.mMockRilChannel;

2 testGetRadioState():

public void testGetRadioState() throws IOException {log("testGetRadioState E");Msg.send(mMockRilChannel, 1, 9876, 0, null);Msg resp = Msg.recv(mMockRilChannel);//resp.printHeader("testGetRadioState");assertTrue(String.format("expected cmd == 1 was %d", resp.getCmd()),resp.getCmd() == 1);assertTrue(String.format("expected token == 9876 was %d", resp.getToken()),resp.getToken() == 9876);assertTrue(String.format("expected status == 0 was %d", resp.getStatus()),resp.getStatus() == 0);RilCtrlCmds.CtrlRspRadioState rsp = resp.getDataAs(RilCtrlCmds.CtrlRspRadioState.class);int state = rsp.getState();log("testGetRadioState state=" + state);assertTrue(String.format("expected RadioState >= 0 && RadioState <= 9 was %d", state),((state >= 0) && (state <= 9)));log("testGetRadioState X");}

3 testStartIncomingCallAndHangup():

public void testStartIncomingCallAndHangup() throws IOException {log("testStartIncomingCallAndHangup");RilCtrlCmds.CtrlReqSetMTCall cmd = new RilCtrlCmds.CtrlReqSetMTCall();String incomingCall = "6502889108";// set the MT callcmd.setPhoneNumber(incomingCall);Msg.send(mMockRilChannel, RilCtrlCmds.CTRL_CMD_SET_MT_CALL, 0, 0, cmd);// get responseMsg resp = Msg.recv(mMockRilChannel);log("Get response status: " + resp.getStatus());assertTrue("The ril is not in a proper state to set MT calls.",resp.getStatus() == RilCtrlCmds.CTRL_STATUS_OK);// allow the incoming call alerting for some timetry {Thread.sleep(5000);} catch (InterruptedException e) {}// we are playing a trick to assume the current is 1RilCtrlCmds.CtrlHangupConnRemote hangupCmd = new RilCtrlCmds.CtrlHangupConnRemote();hangupCmd.setConnectionId(1);hangupCmd.setCallFailCause(16); // normal hangupMsg.send(mMockRilChannel, RilCtrlCmds.CTRL_CMD_HANGUP_CONN_REMOTE, 0, 0, hangupCmd);// get responseresp = Msg.recv(mMockRilChannel);log("Get response for hangup connection: " + resp.getStatus());assertTrue("CTRL_CMD_HANGUP_CONN_REMOTE failed",resp.getStatus() == RilCtrlCmds.CTRL_STATUS_OK);}

運(yùn)行測試

應(yīng)用編譯并安裝到目標(biāo)測試機(jī)器中后，通過ADB工具進(jìn)入終端，通過指令：
am instrument -w com.android.frameworks.telephonytests /android.test.InstrumentationTestRunner
即可運(yùn)行該測試應(yīng)用，自動(dòng)運(yùn)行每一個(gè)測試用例，并將測試結(jié)果顯示在輸出中。如下所示：

com.android.internal.telephony.ATResponseParserTest:. com.android.internal.telephony.AdnRecordTest:. com.android.internal.telephony.ApnSettingTest: Failure in testFromString: junit.framework.AssertionFailedError: expected:<2> but was:<4>at com.android.internal.telephony.ApnSettingTest.assertApnSettingEqual(ApnSettingTest.java:42)at com.android.internal.telephony.ApnSettingTest.testFromString(ApnSettingTest.java:93)at java.lang.reflect.Method.invokeNative(Native Method)at android.test.AndroidTestRunner.runTest(AndroidTestRunner.java:190)at android.test.AndroidTestRunner.runTest(AndroidTestRunner.java:175)at android.test.InstrumentationTestRunner.onStart(InstrumentationTestRunner.java:555)at android.app.Instrumentation$InstrumentationThread.run(Instrumentation.java:1661) . com.android.internal.telephony.GsmAlphabetTest:... com.android.internal.telephony.GsmSmsTest:.......... Error in testFragmentTurkishText: java.lang.IllegalAccessError: tried to access method com.android.internal.telephony.GsmAlphabet.getEnabledSingleShiftTables:()V from class com.android.internal.telephony.GsmSmsTestat com.android.internal.telephony.GsmSmsTest.testFragmentTurkishText(GsmSmsTest.java:281)at java.lang.reflect.Method.invokeNative(Native Method)at android.test.AndroidTestRunner.runTest(AndroidTestRunner.java:190)at android.test.AndroidTestRunner.runTest(AndroidTestRunner.java:175)at android.test.InstrumentationTestRunner.onStart(InstrumentationTestRunner.java:555)at android.app.Instrumentation$InstrumentationThread.run(Instrumentation.java:1661) ... com.android.internal.telephony.IccServiceTableTest:.. com.android.internal.telephony.IntRangeManagerTest:......... com.android.internal.telephony.MccTableTest:..... com.android.internal.telephony.NeighboringCellInfoTest:... com.android.internal.telephony.PhoneNumberUtilsTest:.. Failure in testCheckAndProcessPlusCode: junit.framework.ComparisonFailure: expected:<[011]8475797000> but was:<[+]8475797000>

總結(jié)

作為白盒測試，測試用例的設(shè)計(jì)至關(guān)重要，對(duì)于已有的代碼，其類與類之間相關(guān)性較大的情況，測試用例的設(shè)計(jì)就會(huì)增加復(fù)雜度，需要設(shè)計(jì)多個(gè)模擬類來替代相關(guān)類，必要時(shí)應(yīng)該在代碼設(shè)計(jì)階段就應(yīng)該考慮其可測試性。
大多是先設(shè)計(jì)測試用例，以測試推進(jìn)開發(fā)。

總結(jié)

以上是生活随笔為你收集整理的Telephony单元测试分析的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。