鸿蒙OS开发实战：【自动化测试框架】使用指南

 概述

为支撑HarmonyOS操作系统的自动化测试活动开展，我们提供了支持JS/TS语言的单元及UI测试框架，支持开发者针对应用接口进行单元测试，并且可基于UI操作进行UI自动化脚本的编写。

本指南重点介绍自动化测试框架的主要功能，同时介绍编写单元/UI自动化测试脚本的方法以及执行过程。

简介

HarmonyOS自动化测试框架arkxtest，作为HarmonyOS工具集的重要组成部分，提供了HarmonyOS自动化脚本编写和运行的基础能力。编写方面提供了一系列支持测试脚本编写的API，包括了基础流程API、断言API以及UI操作相关的API，运行方面提供了识别测试脚本、调度执行测试脚本以及汇总测试脚本执行结果的能力。

实现原理

框架重要分为两大部分：单元测试框架和UI测试框架。

• 单元测试框架

  单元测试框架是测试框架的基础底座，提供了最基本的用例识别、调度、执行及结果汇总的能力。主要功能如下图所示：

  

  单元测试脚本的基础运行流程如下图所示，依赖aa test命令作为执行入口，该命令可具体参考。

  

• UI测试框架

  UI测试框架主要对外提供了[UiTest API]供开发人员在对应测试场景调用，而其脚本的运行基础还是上面提到的单元测试框架。

  UI测试框架的主要功能如下图所示：

  

约束与限制

• UI测试框架的能力在HarmonyOS 3.0 release版本之后方可使用，历史版本不支持使用。

• 单元测试框架的部分能力与其版本有关。

更多鸿蒙开发应用知识已更新gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md参考前往。

环境准备

docs.qq.com/doc/DUmN4VVhBd3NxdExK

环境要求

自动化脚本的编写主要基于DevEco Studio，并建议使用3.1.0.400之后的版本进行脚本编写。

脚本执行需要PC连接HarmonyOS设备，如JAD等。

搭建环境

DevEco Studio可参考其官网介绍进行下载，并进行相关的配置动作。

新建测试脚本

1. 在DevEco Studio中新建应用开发工程，其中ohos目录即为测试脚本所在的目录。
2. 在工程目录下打开待测试模块下的ets文件，将光标置于代码中任意位置，单击右键 > Show Context Actions > Create Ohos Test或快捷键Alt+enter > Create Ohos Test创建测试类。

编写单元测试脚本