add test guide

Signed-off-by: Nry <ry.renyi@huawei.com>

zh-cn/application-dev/application-test/arkxtest.md

+# 自动化测试框架使用指南 
+
+
+## 概述
+
+为支撑OpenHarmony操作系统的自动化测试活动开展，我们提供了支持JS/TS语言的单元及UI测试框架，支持开发者针对应用接口或系统接口进行单元测试，并且可基于UI操作进行UI自动化脚本的编写。
+
+本指南重点介绍自动化测试框架的主要功能，并且还会介绍如何编写单元/UI自动化测试脚本，以及如何执行的过程。
+
+
+### 简介
+
+OpenHarmony自动化测试框架arkxtest，作为OpenHarmony工具集的重要组成部分，提供了OpenHarmony自动化脚本编写和运行的基础能力。编写方面提供了一系列支持测试脚本编写的API，包括了基础流程API、断言API以及UI操作相关的API；运行方面提供了识别测试脚本、调度执行测试脚本以及汇总测试脚本执行结果的能力。
+
+
+### 实现原理
+
+框架重要分为两大部分：单元测试框架和UI测试框架。
+
+- 单元测试框架
+
+  单元测试框架是测试框架的基础底座，提供了最基本的用例识别、调度、执行及结果汇总的能力。主要功能如下图所示：
+
+  ![](figures\UnitTest.PNG)
+
+  单元测试脚本的基础运行流程如下图所示，依赖元能力子系统提供的aa test命令作为执行入口，该命令可具体参考[对应指南。](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/ability/ability-delegator.md)
+
+  ![](figures\TestFlow.PNG)
+
+- UI测试框架
+
+  UI测试框架主要对外提供了一批API供开发人员在对应测试场景调用，而其脚本的运行基础还是上面提到的单元测试框架。
+
+  UI测试框架的主要功能如下图所示，其对外的提供的API请见对应的[d.ts文件](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.uitest.d.ts)。
+
+  ![](figures\Uitest.PNG)
+
+
+### 约束与限制
+
+- UI测试框架的能力在OpenHarmony 3.1 release版本之后方可使用，历史版本不支持使用。
+- 单元测试框架的部分能力与其版本有关，具体能力与版本匹配信息可见代码仓中的[文档介绍](https://gitee.com/openharmony/testfwk_arkxtest/blob/master/README_zh.md)。
+
+
+### 相关实例
+
+UI测试框架的接口使用示例可参考以下实例：
+
+- [UI测试框架API使用示例](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-uitest.md)
+
+
+## 环境准备
+
+### 环境要求
+
+OpenHarmony自动化脚本的编写主要基于DevEco Studio，并建议使用3.0之后的版本进行脚本编写。
+
+脚本执行需要PC连接OpenHarmony设备，如RK3568开发板等。
+
+### 搭建环境
+
+DevEco Studio可参考其官网介绍进行[下载](https://developer.harmonyos.com/cn/develop/deveco-studio#download)，并进行相关的配置动作。
+
+
+## 新建测试脚本
+
+1. 在DevEco Studio中新建应用开发工程，其中ohos目录即为测试脚本所在的目录。
+2. 在工程目录下打开待测试模块下的ets文件，将光标置于代码中任意位置，单击**右键 > Show Context Actions** **> Create Ohos Test**或快捷键**Alt+enter** **> Create Ohos Test**创建测试类，更多指导请参考DevEco Studio中[指导](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-openharmony-test-framework-0000001267284568)。
+
+## 编写单元测试脚本
+
+```TS
+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测试框架提供的接口调用，实现对应的测试逻辑。
+
+下面的示例代码是在上面的测试脚本基础上增量编写，首先需要增加依赖导包，如下示例代码所示：
+
+```js
+import {UiDriver,BY,UiComponent,MatchPattern} from '@ohos.uitest'
+```
+
+然后是具体测试代码编写，场景较为简单，就是在启动的应用页面上进行点击操作，然后增加检查点检查用例。
+
+```js
+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 uidriver
+      var driver = await UiDriver.create();
+      await driver.delayMs(1000);
+      //find button by text 'Next'
+      var button = await driver.findComponent(BY.text('Next'));
+      //click button
+      await button.click();
+      await driver.delayMs(1000);
+      //check text
+      await driver.assertComponentExist(BY.text('after click'));
+      await driver.pressBack();
+      done();
+    })
+
+    function sleep(time) {
+      return new Promise((resolve) => setTimeout(resolve, time));
+    }
+  })
+}
+```
+
+## 执行测试脚本
+
+执行测试脚本可以直接在DevEco Studio中通过点击按钮执行，当前支持以下执行方式：
+
+1、测试包级别执行即执行测试包内的全部用例。
+
+2、测试套级别执行即执行describe方法中定义的全部测试用例。
+
+3、测试方法级别执行即执行指定it方法也就是单条测试用例。
+
+![](figures\Execute.PNG)
+
+## 查看测试结果
+
+测试执行完毕后可直接在DevEco Studio中查看测试结果，如下图示例所示：
+
+![](figures\TestResult.PNG)
+