简述HarmonyOS单元测试框架

作者：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