OpenHarmony自動(dòng)化測(cè)試框架開(kāi)發(fā)指南
想了解更多關(guān)于開(kāi)源的內(nèi)容，請(qǐng)?jiān)L問(wèn)：
概述
OpenHarmony自動(dòng)化測(cè)試框架是OpenHarmony提供的支持JS/TS語(yǔ)言的單元及UI測(cè)試框架，支持開(kāi)發(fā)者針對(duì)應(yīng)用接口或系統(tǒng)接口進(jìn)行單元測(cè)試，并且可基于UI操作進(jìn)行UI自動(dòng)化腳本的編寫(xiě)。
OpenHarmony自動(dòng)化測(cè)試框架重要分為兩大部分：?jiǎn)卧獪y(cè)試框架和UI測(cè)試框架。
- 單元測(cè)試框架是測(cè)試框架的基礎(chǔ)底座，提供了最基本的用例識(shí)別、調(diào)度、執(zhí)行及結(jié)果匯總的能力。
- UI測(cè)試框架主要調(diào)用提供的UiTest API對(duì)不同測(cè)試場(chǎng)景進(jìn)行測(cè)試，而其腳本的運(yùn)行基礎(chǔ)還是單元測(cè)試框架。
從代碼的角度體現(xiàn)為，每個(gè)OpenHarmony工程在新建時(shí)都會(huì)提供一個(gè)ohosTest模塊，包含基礎(chǔ)的單元測(cè)試運(yùn)行腳本，如下圖所示：
其中各文件間的大致關(guān)系如下圖所示：
單元測(cè)試腳本的基礎(chǔ)運(yùn)行流程如下圖所示，依賴(lài)aa test命令作為執(zhí)行入口（可結(jié)合上述代碼中的關(guān)系圖進(jìn)行對(duì)比）。
開(kāi)發(fā)步驟
（可選）新建測(cè)試腳本
在工程目錄下打開(kāi)待測(cè)試模塊下的ets文件，將光標(biāo)置于代碼中任意位置，單擊右鍵 > Show Context Actions > Create Ohos Test或快捷鍵Alt+enter > Create Ohos Test創(chuàng)建測(cè)試類(lèi)，如下圖所示。
完成后自動(dòng)生成一個(gè)測(cè)試腳本。
編寫(xiě)單元測(cè)試腳本
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));
}
})
}單元測(cè)試腳本需要包含如下基本元素：
1、依賴(lài)導(dǎo)包，以便使用依賴(lài)的測(cè)試接口。
2、測(cè)試代碼編寫(xiě)，主要編寫(xiě)測(cè)試代碼的相關(guān)邏輯，如接口調(diào)用等。
3、斷言接口調(diào)用，設(shè)置測(cè)試代碼中的檢查點(diǎn)，如無(wú)檢查點(diǎn)，則不可認(rèn)為一個(gè)完整的測(cè)試腳本。
編寫(xiě)UI測(cè)試腳本
UI測(cè)試腳本是在單元測(cè)試框架的基礎(chǔ)上編寫(xiě)，主要就是增加了UI測(cè)試框架提供的接口調(diào)用，實(shí)現(xiàn)對(duì)應(yīng)的測(cè)試邏輯。
下面的示例代碼是在上面的測(cè)試腳本基礎(chǔ)上增量編寫(xiě)，首先需要增加依賴(lài)導(dǎo)包，如下示例代碼所示：
import {Driver,ON,Component,MatchPattern} from '@ohos.uitest'然后是具體測(cè)試代碼編寫(xiě)，場(chǎng)景較為簡(jiǎn)單，就是在啟動(dòng)的應(yīng)用頁(yè)面上進(jìn)行點(diǎn)擊操作，然后增加檢查點(diǎn)檢查用例。
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));
}
})
}執(zhí)行測(cè)試腳本
執(zhí)行測(cè)試腳本可以直接在DevEco Studio中通過(guò)點(diǎn)擊按鈕執(zhí)行，當(dāng)前支持以下執(zhí)行方式：
1、測(cè)試包級(jí)別執(zhí)行即執(zhí)行測(cè)試包內(nèi)的全部用例。
2、測(cè)試套級(jí)別執(zhí)行即執(zhí)行describe方法中定義的全部測(cè)試用例。
3、測(cè)試方法級(jí)別執(zhí)行即執(zhí)行指定it方法也就是單條測(cè)試用例。
其中測(cè)試包內(nèi)的全部測(cè)試用例運(yùn)行任務(wù)可按如下步驟創(chuàng)建。
查看測(cè)試結(jié)果
測(cè)試執(zhí)行完畢后可直接在DevEco Studio中查看測(cè)試結(jié)果，如下圖示例所示：
