Hypium测试框架

        “Hypium”是“Hyper Automation + ium”的组合词，“Hyper Automation”表示超级自动化， “ium”意指稳定、可靠的测试框架能力底座。打造一个以超级自动化测试为理想目标、且稳定可靠的测试框架，一套新的自动化测试框架。

        应用程序的自动化测试，从应用场景上主要分为两类：一类主要测试程序的内部功能逻辑，聚焦在测试程序内的函数接口，用于开发人员自测试使用；另一类主要是所见即所得的界面测试，操作页面并检查页面控件是否符合预期的端到端的测试，用于测试人员覆盖全路径的验证测试。

 上述两种应用场景，自动化测试框架Hypium推出了单元测试框架和UI测试框架两个子框架。

● 单元测试框架（HJsUnit）：提供单元测试用例编写的基础接口，以及用于测试系统或应用的接口。支持开发者编写和执行单元测试用例，并且生成对应的测试报告。

● UI测试框架（HUiTest）：通过简洁易用的API提供查找和操作界面控件的能力，支持开发基于界面操作的自动化测试脚本。

单元测试框架

       HarmonyOS作为面向万物互联时代的分布式智能操作系统，支持在手机、平板、智能座舱、智慧屏、轻量级设备（如智能穿戴）等多种终端设备上使用。开发者在开发HarmonyOS应用时，也需要考虑适配多种终端设备。这就要求测试框架能够针对不同设备支持定制相应的测试能力。

      HarmonyOS的开发框架支持开发者使用Java/JS/eTS等多种语言进行应用开发。这就要求测试框架在执行测试用例时需要考虑多语言以及语法兼容等。

      在设计阶段就考虑到了单元测试框架需要具备多语言统一执行，语法兼容，空间占用最小化，功能可定制裁剪等能力。经过研发团队的不懈努力，最终实现了具备语法统一、执行统一、可裁剪、轻量化特点的单元测试框架。

● 语法统一：ArkUI开发框架支持基于JS语言的类Web开发范式以及基于eTS语言的声明式开发范式。针对不同的语言和开发范式，单元测试框架提供一套统一的测试用例开发接口。开发者可基于统一的接口，来开发支持不同语言和开发范式的测试用例。

● 执行统一：单元测试框架支持Java与JS/eTS的测试用例在同一个测试hap中运行，结果统一展示。

● 可裁剪：单元测试框架采用了标准的插件机制，除了核心的基础用例运行与基础接口部分，其余的扩展能力可以根据不同的需求而动态组合。开发者可以根据不同的设备能力和测试需求，动态地定制测试框架能力。

● 轻量化：单元测试框架内核部分的代码量很少，打包编译之后小于10KB，可用于开发在轻量化设备上执行的测试用例。

Hypium的单元测试框架：

 单元测试框架由Core、EXT和SPE三个模块组成：

● Core（核心模块）：包含测试用例执行需要的核心接口和逻辑，是运行测试用例所需的最小集合。对于轻量化设备，单元测试框架可以只包含Core模块。

● EXT（扩展能力模块）：在核心模块的基础上增加测试框架常用的能力，支持自定义断言，用例异常超时控制等。

● SPE（专项测试能力模块）：增加部分特殊测试能力，例如Mock模拟、数据驱动测试、压力测试等。

UI测试框架

UI测试框架主要提供UI界面测试的能力，主要面临以下两大挑战：

UI界面操作繁琐，学习和使用成本高。

UI界面测试在行业内已广泛应用，核心逻辑主要包含以下三个操作：

• 识别界面结构，获取操作坐标 。

• 操作控件，注入UI操作事件，驱动事件响应。

• 检查页面响应，验证是否符合操作逻辑 。

WebView混合开发、多窗口等特性，给UI界面测试带来很大难度

在UI界面测试中，WebView混合开发、多窗口等特性，一直是UI界面测试的难点。

• WebView混合开发没有使用系统提供的开发框架，所以系统的无障碍服务无法获取WebView中的控件信息，从而也无法进行UI界面测试。

• 多窗口是指窗口之间有层叠关系，无法做到所见即所得，需要开发者动态地指定窗口来获取其在前台显示的页面结构。如果发生窗口拖拽等窗口移动的情况，开发者所见的界面会有比较大的变化，但是多窗口页面结构没有变化，这种情况下UI界面测试脚本的编写和稳定性都面临很大的挑战。

UI测试框架将所有操作封装到UiDriver、By和UiComponent三个核心类中

 

• UiDriver：UI测试能力入口类，负责与设备（系统的无障碍服务）交互，提供页面控件查找、检查存在性以及注入按键等能力。

• By：用于描述目标控件特性(文本、id、类型等)。UiDriver根据By描述的控件特征来查找控件。

• UiComponent：根据UiDriver查找返回的控件对象，记录控件相关属性，并提供控件相关UI操作，例如点击、滑动、双击等。

UI测试框架的详细架构：

 UI测试框架主要分为三个部分

● uitest-api：封装提供应用UI测试场景的测试API。

● test-agent：提供跨应用UI测试场景设备端辅助测试模块，通过uitest与系统核心库对接。

● uitest：UI测试核心模块，对接系统服务，提供控件树获取、解析、查找、操作等能力。

参考：

HarmonyOS自动化测试框架—Hypium