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è)試框架。

https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-uitest.md

從代碼的角度體現(xiàn)為，每個(gè) OpenHarmony 工程在新建時(shí)都會(huì)提供一個(gè) ohosTest 模塊，包含基礎(chǔ)的單元測(cè)試運(yùn)行腳本。

如下圖所示：

其中各文件間的大致關(guān)系如下圖所示：

單元測(cè)試腳本的基礎(chǔ)運(yùn)行流程如下圖所示，依賴 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è)試類。

如下圖所示：

完成后自動(dòng)生成一個(gè)測(cè)試腳本：

編寫(xiě)單元測(cè)試腳本

代碼如下：

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

constdelegator=abilityDelegatorRegistry.getAbilityDelegator()
exportdefaultfunctionabilityTest(){
describe('ActsAbilityTest',function(){
it('testUiExample',0,asyncfunction(done){
console.info("uitest:TestUiExamplebegin");
//starttestedability
awaitdelegator.executeShellCommand('aastart-bcom.ohos.uitest-aMainAbility').then(result=>{
console.info('Uitest,startabilityfinished:'+result)
}).catch(err=>{
console.info('Uitest,startabilityfailed:'+err)
})
awaitsleep(1000);
//checktopdisplayability
awaitdelegator.getCurrentTopAbility().then((Ability)=>{
console.info("gettopability");
expect(Ability.context.abilityInfo.name).assertEqual('MainAbility');
})
done();
})

functionsleep(time){
returnnewPromise((resolve)=>setTimeout(resolve,time));
}
})
}

單元測(cè)試腳本需要包含如下基本元素：

依賴導(dǎo)包，以便使用依賴的測(cè)試接口。

測(cè)試代碼編寫(xiě)，主要編寫(xiě)測(cè)試代碼的相關(guān)邏輯，如接口調(diào)用等。

斷言接口調(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ě)，首先需要增加依賴導(dǎo)包，如下示例代碼所示：

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

exportdefaultfunctionabilityTest(){
describe('ActsAbilityTest',function(){
it('testUiExample',0,asyncfunction(done){
console.info("uitest:TestUiExamplebegin");
//starttestedability
awaitdelegator.executeShellCommand('aastart-bcom.ohos.uitest-aMainAbility').then(result=>{
console.info('Uitest,startabilityfinished:'+result)
}).catch(err=>{
console.info('Uitest,startabilityfailed:'+err)
})
awaitsleep(1000);
//checktopdisplayability
awaitdelegator.getCurrentTopAbility().then((Ability)=>{
console.info("gettopability");
expect(Ability.context.abilityInfo.name).assertEqual('MainAbility');
})
//uitestcode
//initdriver
vardriver=awaitDriver.create();
awaitdriver.delayMs(1000);
//findbuttonbytext'Next'
varbutton=awaitdriver.findComponent(ON.text('Next'));
//clickbutton
awaitbutton.click();
awaitdriver.delayMs(1000);
//checktext
awaitdriver.assertComponentExist(ON.text('afterclick'));
awaitdriver.pressBack();
done();
})

functionsleep(time){
returnnewPromise((resolve)=>setTimeout(resolve,time));
}
})
}

執(zhí)行測(cè)試腳本

執(zhí)行測(cè)試腳本可以直接在 DevEco Studio 中通過(guò)點(diǎn)擊按鈕執(zhí)行，當(dāng)前支持以下執(zhí)行方式： ①測(cè)試包級(jí)別執(zhí)行即執(zhí)行測(cè)試包內(nèi)的全部用例。 ②測(cè)試套級(jí)別執(zhí)行即執(zhí)行 describe 方法中定義的全部測(cè)試用例。

③測(cè)試方法級(jí)別執(zhí)行即執(zhí)行指定 it 方法也就是單條測(cè)試用例。

其中測(cè)試包內(nèi)的全部測(cè)試用例運(yùn)行任務(wù)可按如下步驟創(chuàng)建：

查看測(cè)試結(jié)果

測(cè)試執(zhí)行完畢后可直接在 DevEco Studio 中查看測(cè)試結(jié)果，如下圖示例所示：

審核編輯：湯梓紅