【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南 原创 精华

Haoc_小源同学
发布于 2023-5-6 17:49
浏览
5收藏

@toc

概述

OpenHarmony自动化测试框架是OpenHarmony提供的支持JS/TS语言的单元UI测试框架,支持开发者针对应用接口或系统接口进行单元测试,并且可基于UI操作进行UI自动化脚本的编写。

OpenHarmony自动化测试框架重要分为两大部分:单元测试框架UI测试框架

  • 单元测试框架是测试框架的基础底座,提供了最基本的用例识别、调度、执行及结果汇总的能力
  • UI测试框架主要调用提供的UiTest API对不同测试场景进行测试,而其脚本的运行基础还是单元测试框架

从代码的角度体现为,每个OpenHarmony工程在新建时都会提供一个ohosTest模块,包含基础的单元测试运行脚本,如下图所示

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

其中各文件间的大致关系如下图所示

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

单元测试脚本的基础运行流程如下图所示,依赖aa test命令作为执行入口(可结合上述代码中的关系图进行对比)

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

开发步骤

(可选)新建测试脚本

在工程目录下打开待测试模块下的ets文件,将光标置于代码中任意位置,单击右键 > Show Context Actions > Create Ohos Test或快捷键Alt+enter > Create Ohos Test创建测试类,如下图所示。

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

完成后自动生成一个测试脚本

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

编写单元测试脚本

import { describe, beforeAll, beforeEach, afterEach, afterAll, it, expect } from '@ohos/hypium'
import abilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'

const delegator = abilityDelegatorRegistry.getAbilityDelegator()
export default function abilityTest() {
  describe('ActsAbilityTest', function () {
    it('testUiExample',0, async function (done) {
      console.info("uitest: TestUiExample begin");
      //start tested ability
      await delegator.executeShellCommand('aa start -b com.ohos.uitest -a MainAbility').then(result =>{
        console.info('Uitest, start ability finished:' + result)
      }).catch(err => {
        console.info('Uitest, start ability failed: ' + err)
      })
      await sleep(1000);
      //check top display ability
      await delegator.getCurrentTopAbility().then((Ability)=>{
        console.info("get top ability");
        expect(Ability.context.abilityInfo.name).assertEqual('MainAbility');
      })
      done();
    })

    function sleep(time) {
      return new Promise((resolve) => setTimeout(resolve, time));
    }
  })
}

单元测试脚本需要包含如下基本元素:

1、依赖导包,以便使用依赖的测试接口。

2、测试代码编写,主要编写测试代码的相关逻辑,如接口调用等。

3、断言接口调用,设置测试代码中的检查点,如无检查点,则不可认为一个完整的测试脚本。

编写UI测试脚本

UI测试脚本是在单元测试框架的基础上编写,主要就是增加了UI测试框架提供的接口调用,实现对应的测试逻辑。

下面的示例代码是在上面的测试脚本基础上增量编写,首先需要增加依赖导包,如下示例代码所示:

import {Driver,ON,Component,MatchPattern} from '@ohos.uitest'

然后是具体测试代码编写,场景较为简单,就是在启动的应用页面上进行点击操作,然后增加检查点检查用例。

export default function abilityTest() {
  describe('ActsAbilityTest', function () {
    it('testUiExample',0, async function (done) {
      console.info("uitest: TestUiExample begin");
      //start tested ability
      await delegator.executeShellCommand('aa start -b com.ohos.uitest -a MainAbility').then(result =>{
        console.info('Uitest, start ability finished:' + result)
      }).catch(err => {
        console.info('Uitest, start ability failed: ' + err)
      })
      await sleep(1000);
      //check top display ability
      await delegator.getCurrentTopAbility().then((Ability)=>{
        console.info("get top ability");
        expect(Ability.context.abilityInfo.name).assertEqual('MainAbility');
      })
      //ui test code
      //init driver
      var driver = await Driver.create();
      await driver.delayMs(1000);
      //find button by text 'Next'
      var button = await driver.findComponent(ON.text('Next'));
      //click button
      await button.click();
      await driver.delayMs(1000);
      //check text
      await driver.assertComponentExist(ON.text('after click'));
      await driver.pressBack();
      done();
    })

    function sleep(time) {
      return new Promise((resolve) => setTimeout(resolve, time));
    }
  })
}

执行测试脚本

执行测试脚本可以直接在DevEco Studio中通过点击按钮执行,当前支持以下执行方式:

1、测试包级别执行即执行测试包内的全部用例。

2、测试套级别执行即执行describe方法中定义的全部测试用例。

3、测试方法级别执行即执行指定it方法也就是单条测试用例。

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

其中测试包内的全部测试用例运行任务可按如下步骤创建

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

查看测试结果

测试执行完毕后可直接在DevEco Studio中查看测试结果,如下图示例所示:

【小源笔记】第九期 | OpenHarmony自动化测试框架开发指南-鸿蒙开发者社区

参考资料

[1]自动化测试框架使用指南

[2]@ohos.UiTest

【小源笔记】为笔者开发过程中的一些经验分享,旨在解决官方文档过于晦涩难懂或者示例代码不够详细的问题,同时方便笔者日后回顾以及其他开发者更快上手,欢迎评论留言~

往期推荐:

【小源笔记】第六期 | 解决应用申请权限失败导致安装报错问题
【小源笔记】第七期 | 鸿蒙解决DevEco Studio无法识别设备问题
【小源笔记】第八期 | OpenHarmony编译Full-SDK

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
已于2023-6-9 14:16:20修改
6
收藏 5
回复
举报
8条回复
按时间正序
/
按时间倒序
红叶亦知秋
红叶亦知秋

通过五个窗口描述关系,这样看起来就很明了

回复
2023-5-6 18:03:35
离北况归
离北况归

来了,给大佬点赞

1
回复
2023-5-6 18:13:47
Haoc_小源同学
Haoc_小源同学 回复了 离北况归
来了,给大佬点赞

位置给大佬留好了,请上座

回复
2023-5-6 18:47:25
FlashinMiami
FlashinMiami

确实是很方便的测试框架

回复
2023-5-8 10:26:32
物联风景
物联风景

不错不错,加油

回复
2023-5-9 21:54:21
wx5fbdcd61ccc0a
wx5fbdcd61ccc0a

您好,请问下,可以转载吗?会在文末备注 作者及本文章链接哈


回复
2023-5-11 10:42:09
Haoc_小源同学
Haoc_小源同学 回复了 wx5fbdcd61ccc0a
您好,请问下,可以转载吗?会在文末备注 作者及本文章链接哈

可以的


回复
2023-5-16 09:12:53
wx5fbdcd61ccc0a
wx5fbdcd61ccc0a

谢谢啦~

回复
2023-5-16 11:35:14
回复
    相关推荐