作者：leidan、houjing ，華為軟件測試工程師

測試是APP開發(fā)中一個重要的環(huán)節(jié)，在開發(fā)迭代中借助高效易用的測試工具來編寫和執(zhí)行自動化測試用例，并及時分析處理用例失敗項；同時測試也是保障應(yīng)用質(zhì)量和提升開發(fā)效率的重要途徑。

然而，由于HarmonyOS應(yīng)用具備一些獨(dú)特性（例如能夠?qū)崿F(xiàn)應(yīng)用的一次開發(fā)、多端部署，例如支持使用Java和JS兩種語言進(jìn)行開發(fā)和混合開發(fā)），因此，除了業(yè)界普遍的APP測試場景外，HarmonyOS應(yīng)用的測試還需要解決下述幾個問題：

1.“一次開發(fā)，多端部署”應(yīng)用的測試

HarmonyOS APP支持”一次開發(fā)，多端部署”，即同一套代碼可以針對不同的目標(biāo)設(shè)備形態(tài)編譯打包出對應(yīng)的hap。那么，針對不同設(shè)備形態(tài)的hap，應(yīng)該怎么進(jìn)行測試呢？

2. 混合語言應(yīng)用的測試

HarmonyOS APP支持使用多語言（Java、JS等）混合開發(fā)且語言互通。那么，開發(fā)者應(yīng)該如何測試多語言開發(fā)的APP呢？

想要知道上述兩個問題的答案，那就不要錯過今天的內(nèi)容啦~

今天我們?yōu)榇蠹規(guī)淼氖荋armonyOS單元測試測試框架的編譯打包/運(yùn)行機(jī)制和關(guān)鍵功能特性，通過這個內(nèi)容，你可以快速了解和上手HarmonyOS單元測試測試框架哦~

讓我們先來進(jìn)入HarmonyOS測試框架機(jī)制介紹，方便大家了解我們的編譯打包和運(yùn)行機(jī)制。

測試框架機(jī)制介紹

編譯打包/運(yùn)行機(jī)制

根據(jù)HarmonyOS應(yīng)用框架定義，一個HarmonyOS APP由一個entry-hap模塊和若干feature-hap模塊構(gòu)成。根據(jù)HarmonyOS應(yīng)用程序框架的多hap機(jī)制，開發(fā)者可借助編譯打包工具將“單元測試測試框架+測試代碼”打包為一個feature-hap，在打包過程中采用provided依賴模式關(guān)聯(lián)目標(biāo)APP代碼（可為entry-hap或者feature-hap）。運(yùn)行態(tài)下，測試hap（test.hap）與目標(biāo)hap（app.hap）被應(yīng)用程序框架共進(jìn)程加載運(yùn)行。

而測試用例通過接口調(diào)用來完成對目標(biāo)代碼和APP組件的控制、觸發(fā)和查詢，從而實現(xiàn)測試邏輯。

測試代碼的分離打包和共進(jìn)程運(yùn)行機(jī)制

AbilityDelegator為元能力子系統(tǒng)提供的測試支持能力，用于控制Ability的生命周期，獲取Ability對象狀態(tài)，注入點擊事件等。使用AbilityDelegator可以提升HJUnit測試用例的開發(fā)效率和穩(wěn)定性。

獲取測試APP進(jìn)程AbilityDelegator實例的方法：

AbilityDelegatorRegistry.getAbilityDelegator（）

“一次開發(fā)，多端部署”應(yīng)用的測試

針對“一次開發(fā)，多端部署”應(yīng)用的測試，測試代碼的編譯打包功能內(nèi)置于HarmonyOS APP編譯打包工具鏈中，自動繼承”一次開發(fā)，多端部署”特性，即同一套測試代碼可被編譯打包出與目標(biāo)代碼一致的針對多形態(tài)設(shè)備的hap包（目標(biāo)設(shè)備形態(tài)在APP工程下的config.json中通過deviceType字段配置）。單元測試測試框架在運(yùn)行時將自動識別當(dāng)前設(shè)備形態(tài)并安裝運(yùn)行相應(yīng)的hap。

一套測試代碼同時編譯出多種產(chǎn)品形態(tài)的測試hap如圖2所示：

（圖2 一套測試代碼同時編譯出多種產(chǎn)品形態(tài)的測試hap）

混合語言應(yīng)用的測試

混合語言應(yīng)用測試的語法介紹

HarmonyOS應(yīng)用可以使用Java或者JS開發(fā)，相應(yīng)的，單元測試測試框架通過HJUnit和HJSUnit支持進(jìn)行Java和JS的測試，并且支持兩種語言混合執(zhí)行。

目前在2.2.0.200版本及以上的Deveco Studio上新建Java或JS模板工程，main和ohosTest目錄下均包含java和js目錄，用戶可以在ohosTest目錄下編寫java和js測試用例，對應(yīng)工程在執(zhí)行時，兩種語言的測試用例均會被執(zhí)行。

HJUnit單元測試測試框架的實現(xiàn)基于JUnit4開源框架。JUnit為業(yè)界通用的Java單元測試框架，它通過Java注解機(jī)制提供了一套用例編寫語法規(guī)范，用戶使用注解來標(biāo)注測試過程各階段的生命周期函數(shù)。HJUnit語法繼承JUnit4，JUnit4的詳細(xì)介紹可以參考下方鏈接。

· JUnit4詳細(xì)介紹

https://junit.org/junit4/

HJSUnit單元測試測試框架參考OSGI插件機(jī)制和業(yè)內(nèi)通用的測試用例表達(dá)方式，使用describe和it函數(shù)標(biāo)識測試套和測試用例，采用expect（XXX）.assertXX的斷言方式檢查結(jié)果。JS用例編寫語法支持JS的標(biāo)準(zhǔn) ES6語法。

多語言測試用例介紹

上文我們已經(jīng)提到，DevEco Studio集成了HarmonyOS單元測試測試框架，為用戶提供了Java和JS的單元測試能力。開發(fā)者可以通過代碼直接測試項目中的指定類、方法，或是針對UI交互功能的測試等及時發(fā)現(xiàn)問題，同時避免在后期開發(fā)引入問題，大大提升了開發(fā)工作效率和保證開發(fā)質(zhì)量。那么測試用例到底是怎么樣的，讓我們來一探究竟~

HJUnit測試用例

具體的Demo如下。在這個Demo中，checkScreenShape用例使用元能力子系統(tǒng)提供的AbilityDelegator測試Kit，可獲取HarmonyOS應(yīng)用程序Context，進(jìn)而可以在測試代碼中對被測應(yīng)用進(jìn)行查、控制、事件監(jiān)聽等操作，以達(dá)到測試目的。

public class ExampleOhosTest { @Test public void checkScreenShape（） { // 獲取 IAbilityDelegator 實例 final IAbilityDelegator delegator = AbilityDelegatorRegistry.getAbilityDelegator（）; // 從IabilityDelegator實例中獲取應(yīng)用content內(nèi)容 final Context appContext = delegator.getAppContext（）; DeviceCapability devCap = appContext.getResourceManager（）.getDeviceCapability（）; assertNotNull（“Null deviceCapability”， devCap）; if （devCap.deviceType == DeviceCapability.DEVICE_TYPE_WEARABLE） { // 斷言 assertTrue（“Unexpected display shape”， devCap.isRound）; } else { assertFalse（“Unexpected display shape”， devCap.isRound）; } } }

HJSUnit測試用例

這里我們測試的對象是pages的彈出對話框接口，該接口可以實現(xiàn)在當(dāng)前頁面上層彈出對話框，顯示指定的文本，在接口測試中可以通過接口執(zhí)行回調(diào)判斷當(dāng)前接口是否調(diào)用成功，assertTrue表示成功。

it（‘testPromptDialog’， 0， function（） { console.info（‘testPromptDialog START’） prompt.showDialog（{ title： ‘dialog showDialog test’， message： ‘message of dialog’， buttons： ［ { text： ‘OK’ } ］， success： function（ret） { expect（true）.assertTrue（）; }， cancel： function（） { expect（true）.assertFalse（）; }， complete： function（） { console.log（‘［prompt.showDialog］ complete’）; } }）; }）;

跨語言測試

HarmonyOS不僅支持使用Java或JS語言進(jìn)行開發(fā)，也支持混合語言開發(fā)。JS UI框架提供了JS FA（Feature Ability）調(diào)用Java PA（Particle Ability）的機(jī)制，該機(jī)制提供了一種通道來傳遞方法調(diào)用、處理數(shù)據(jù)返回以及訂閱事件上報。

當(dāng)前提供Ability和Internal Ability兩種調(diào)用方式，開發(fā)者可以根據(jù)業(yè)務(wù)場景選擇合適的調(diào)用方式進(jìn)行開發(fā)。

Ability：擁有獨(dú)立的Ability生命周期，F(xiàn)A使用遠(yuǎn)端進(jìn)程通信拉起并請求PA服務(wù)，適用于基本服務(wù)供多FA調(diào)用或者服務(wù)在后臺獨(dú)立運(yùn)行的場景。

Internal Ability：與FA共進(jìn)程，采用內(nèi)部函數(shù)調(diào)用的方式和FA進(jìn)行通信，適用于對服務(wù)響應(yīng)時延要求較高的場景。該方式下PA不支持其他FA訪問調(diào)用。

JS端與Java端通過bundleName和abilityName來進(jìn)行關(guān)聯(lián)。在系統(tǒng)收到JS調(diào)用請求后，根據(jù)開發(fā)者在JS接口中設(shè)置的參數(shù)來選擇對應(yīng)的處理方式。開發(fā)者在指定接口onRemoteRequest（）中實現(xiàn)PA提供的業(yè)務(wù)邏輯。詳細(xì)信息請參考JS FA調(diào)用Java PA機(jī)制—— JS FA如何調(diào)用Java PA。

· JS FA如何調(diào)用Java PA

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-js-fa-call-pa-0000001050435961

而在測試方面，目前單元測試測試框架支持上述JS FA調(diào)用PA機(jī)制的使用。

HJSUnit單元測試測試框架借助了HarmonyOS應(yīng)用程序框架的多hap機(jī)制，測試代碼支持“一次開發(fā)，多端部署”。HJSUnit和HJUnit集成到DevEco Studio上的項目模板上，方便用戶采用Java和JS兩種語言做測試。

兩個測試框架測試框架已隨DevEco Studio的Harmony SDK對外發(fā)布，工具的更新迭代也與DevEco Studio的更新節(jié)奏保持一致，歡迎大家點擊【閱讀原文】查看更多測試詳情~

編輯：jq