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

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

然而，由于HarmonyOS應用具備一些獨特性（例如能夠實現應用的一次開發、多端部署，例如支持使用Java和JS兩種語言進行開發和混合開發），因此，除了業界普遍的APP測試場景外，HarmonyOS應用的測試還需要解決下述幾個問題：

1.“一次開發，多端部署”應用的測試

HarmonyOS APP支持”一次開發，多端部署”，即同一套代碼可以針對不同的目標設備形態編譯打包出對應的hap。那么，針對不同設備形態的hap，應該怎么進行測試呢？

2. 混合語言應用的測試

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

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

今天我們為大家帶來的是HarmonyOS單元測試測試框架的編譯打包/運行機制和關鍵功能特性，通過這個內容，你可以快速了解和上手HarmonyOS單元測試測試框架哦~

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

測試框架機制介紹

編譯打包/運行機制

根據HarmonyOS應用框架定義，一個HarmonyOS APP由一個entry-hap模塊和若干feature-hap模塊構成。根據HarmonyOS應用程序框架的多hap機制，開發者可借助編譯打包工具將“單元測試測試框架+測試代碼”打包為一個feature-hap，在打包過程中采用provided依賴模式關聯目標APP代碼（可為entry-hap或者feature-hap）。運行態下，測試hap（test.hap）與目標hap（app.hap）被應用程序框架共進程加載運行。

而測試用例通過接口調用來完成對目標代碼和APP組件的控制、觸發和查詢，從而實現測試邏輯。

測試代碼的分離打包和共進程運行機制

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

獲取測試APP進程AbilityDelegator實例的方法：

AbilityDelegatorRegistry.getAbilityDelegator（）

“一次開發，多端部署”應用的測試

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

一套測試代碼同時編譯出多種產品形態的測試hap如圖2所示：

（圖2 一套測試代碼同時編譯出多種產品形態的測試hap）

混合語言應用的測試

混合語言應用測試的語法介紹

HarmonyOS應用可以使用Java或者JS開發，相應的，單元測試測試框架通過HJUnit和HJSUnit支持進行Java和JS的測試，并且支持兩種語言混合執行。

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

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

· JUnit4詳細介紹

https://junit.org/junit4/

HJSUnit單元測試測試框架參考OSGI插件機制和業內通用的測試用例表達方式，使用describe和it函數標識測試套和測試用例，采用expect（XXX）.assertXX的斷言方式檢查結果。JS用例編寫語法支持JS的標準 ES6語法。

多語言測試用例介紹

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

HJUnit測試用例

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

public class ExampleOhosTest { @Test public void checkScreenShape（） { // 獲取 IAbilityDelegator 實例 final IAbilityDelegator delegator = AbilityDelegatorRegistry.getAbilityDelegator（）; // 從IabilityDelegator實例中獲取應用content內容 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的彈出對話框接口，該接口可以實現在當前頁面上層彈出對話框，顯示指定的文本，在接口測試中可以通過接口執行回調判斷當前接口是否調用成功，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語言進行開發，也支持混合語言開發。JS UI框架提供了JS FA（Feature Ability）調用Java PA（Particle Ability）的機制，該機制提供了一種通道來傳遞方法調用、處理數據返回以及訂閱事件上報。

當前提供Ability和Internal Ability兩種調用方式，開發者可以根據業務場景選擇合適的調用方式進行開發。

Ability：擁有獨立的Ability生命周期，FA使用遠端進程通信拉起并請求PA服務，適用于基本服務供多FA調用或者服務在后臺獨立運行的場景。

Internal Ability：與FA共進程，采用內部函數調用的方式和FA進行通信，適用于對服務響應時延要求較高的場景。該方式下PA不支持其他FA訪問調用。

JS端與Java端通過bundleName和abilityName來進行關聯。在系統收到JS調用請求后，根據開發者在JS接口中設置的參數來選擇對應的處理方式。開發者在指定接口onRemoteRequest（）中實現PA提供的業務邏輯。詳細信息請參考JS FA調用Java PA機制—— JS FA如何調用Java PA。

· JS FA如何調用Java PA

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

而在測試方面，目前單元測試測試框架支持上述JS FA調用PA機制的使用。

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

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

編輯：jq