OpenHarmony 自動化測試框架是 OpenHarmony 提供的支持 JS/TS 語言的單元及 UI 測試框架，支持開發者針對應用接口或系統接口進行單元測試，并且可基于 UI 操作進行 UI 自動化腳本的編寫。

OpenHarmony 自動化測試框架重要分為兩大部分：單元測試框架和 UI 測試框架。

單元測試框架是測試框架的基礎底座，提供了最基本的用例識別、調度、執行及結果匯總的能力。

UI 測試框架主要調用提供的 UiTest API 對不同測試場景進行測試，而其腳本的運行基礎還是單元測試框架。

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

從代碼的角度體現為，每個 OpenHarmony 工程在新建時都會提供一個 ohosTest 模塊，包含基礎的單元測試運行腳本。

如下圖所示：

其中各文件間的大致關系如下圖所示：

單元測試腳本的基礎運行流程如下圖所示，依賴 aa test 命令作為執行入口（可結合上述代碼中的關系圖進行對比）。

開發步驟

①新建測試腳本

在工程目錄下打開待測試模塊下的 ets 文件，將光標置于代碼中任意位置，單擊右鍵→Show Context Actions→Create Ohos Test 或快捷鍵Alt+enter→ Create Ohos Test 創建測試類。

如下圖所示：

完成后自動生成一個測試腳本：

編寫單元測試腳本

代碼如下：

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));
}
})
}

單元測試腳本需要包含如下基本元素：

依賴導包，以便使用依賴的測試接口。

測試代碼編寫，主要編寫測試代碼的相關邏輯，如接口調用等。

斷言接口調用，設置測試代碼中的檢查點，如無檢查點，則不可認為一個完整的測試腳本。

編寫UI 測試腳本

UI 測試腳本是在單元測試框架的基礎上編寫，主要就是增加了 UI 測試框架提供的接口調用，實現對應的測試邏輯。

下面的示例代碼是在上面的測試腳本基礎上增量編寫，首先需要增加依賴導包，如下示例代碼所示：

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));
}
})
}

執行測試腳本

執行測試腳本可以直接在 DevEco Studio 中通過點擊按鈕執行，當前支持以下執行方式： ①測試包級別執行即執行測試包內的全部用例。 ②測試套級別執行即執行 describe 方法中定義的全部測試用例。

③測試方法級別執行即執行指定 it 方法也就是單條測試用例。

其中測試包內的全部測試用例運行任務可按如下步驟創建：

查看測試結果

測試執行完畢后可直接在 DevEco Studio 中查看測試結果，如下圖示例所示：

審核編輯：湯梓紅