From ff69dffe64060b142f2fd93637c55cf44cdeea57 Mon Sep 17 00:00:00 2001 From: yuyan0428 Date: Fri, 21 Oct 2022 09:06:19 +0000 Subject: [PATCH 1/2] Signed-off-by: yuyan0428 Signed-off-by: yuyan0428 --- README_zh.md | 86 +++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 78 insertions(+), 8 deletions(-) diff --git a/README_zh.md b/README_zh.md index 09d6fd0..315b0d9 100755 --- a/README_zh.md +++ b/README_zh.md @@ -7,7 +7,7 @@ OpenHarmony为开发者提供了一套全面的开发自测试框架OHA-develope - [环境配置](https://gitee.com/openharmony/docs/tree/master/zh-cn/device-dev/subsystems/subsys-testguide-envbuild.md) - [源码获取](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/get-code/sourcecode-acquire.md) -开发自测试框架依赖于测试调度框架test_xdevice，在使用时两个框架放在同级目录，命名为xdevice +开发自测试框架依赖于测试调度框架testfwk_xdevice，在使用时两个框架放在同级目录 ## 开发自测试框架目录简介 以下是开发自测试框架的目录层级架构，在使用开发自测试框架过程中可在相应目录查找对应组件。 @@ -745,7 +745,9 @@ subsystem # 子系统 + ``` + >**说明：** 在执行测试用例之前，若使用HDC连接设备，用例仅需配置设备IP和端口号即可，其余信息均默认不修改。 #### Windows环境执行 @@ -794,32 +796,43 @@ subsystem # 子系统 3. 执行测试用例 - 当选择完产品形态，可参考如下指令执行测试用例。 + 当选择完产品形态，可参考如下指令执行TDD测试用例。 ``` + run -t UT + run -t UT -tp PartName + run -t UT -tp PartName -tm TestModuleName + run -t UT -tp PartName -tm TestModuleName -ts CalculatorSubTest + run -t UT -ts CalculatorSubTest run -t UT -ts CalculatorSubTest -tc interger_sub_00l + run -t UT -cov coverage ``` + + 执行命令参数说明： ``` - -t [TESTTYPE]: 指定测试用例类型，有UT，MST，ST，PERF，FUZZ，BENCHMARK等。（必选参数） + -t [TESTTYPE]: 指定测试用例类型，有UT，MST，ST，PERF，FUZZ，BENCHMARK,ACTS等。（必选参数） -tp [TESTPART]: 指定部件，可独立使用。 -tm [TESTMODULE]: 指定模块，不可独立使用，需结合-tp指定上级部件使用。 -ts [TESTSUITE]: 指定测试套，可独立使用。 -tc [TESTCASE]: 指定测试用例，不可独立使用，需结合-ts指定上级测试套使用。 + -cov [COVERAGE]: 覆盖率执行参数 -h : 帮助命令。 ``` + + #### Linux环境执行 ##### 远程端口映射 为了在Linux远程服务器以及Linux虚拟机两种环境下执行测试用例，需要对端口进行远程映射，以实现与设备的数据通路连接。具体操作如下： 1. HDC Server指令： ``` - hdc_std kill - hdc_std -m -s 0.0.0.0:8710 + hdc kill + hdc -m -s 0.0.0.0:8710 ``` >**说明：** IP和端口号为默认值。 2. HDC Client指令： ``` - hdc_std -s xx.xx.xx.xx:8710 list targets + hdc -s xx.xx.xx.xx:8710 list targets ``` >**说明：** 此处IP填写设备侧IP地址。 @@ -832,24 +845,81 @@ subsystem # 子系统 进入测试框架，系统会自动提示您选择产品形态，请根据实际的开发板进行选择。 - 如需手动添加，请在config/framework_config.xml的\标签内增加产品项。 + 若需要自测试框架编译测试用例，且没有找到需要的产品形态需手动添加，请在config/framework_config.xml的\标签内增加产品项。 + + ``` + + + + + + ``` 3. 执行测试用例 + 1）TDD命令 + 测试框架在执行用例时会根据指令找到所需用例，自动实现用例编译，执行过程，完成自动化测试。 ``` + run -t UT + run -t UT -tp PartName + run -t UT -tp PartName -tm TestModuleName + run -t UT -tp PartName -tm TestModuleName -ts CalculatorSubTest + run -t UT -ts CalculatorSubTest run -t UT -ts CalculatorSubTest -tc interger_sub_00l + run -t -cov coverage ``` 执行命令参数说明： ``` - -t [TESTTYPE]: 指定测试用例类型，有UT，MST，ST，PERF，FUZZ，BENCHMARK等。（必选参数） + -t [TESTTYPE]: 指定测试用例类型，有UT，MST，ST，PERF，FUZZ，BENCHMARK，ACTS等。（必选参数） -tp [TESTPART]: 指定部件，可独立使用。 -tm [TESTMODULE]: 指定模块，不可独立使用，需结合-tp指定上级部件使用。 -ts [TESTSUITE]: 指定测试套，可独立使用。 -tc [TESTCASE]: 指定测试用例，不可独立使用，需结合-ts指定上级测试套使用。 + -cov [COVERAGE]: 覆盖率执行参数。 -h : 帮助命令。 ``` + 在linux下可以使用help命令查看有哪些产品形态、测试类型、支持的子系统、部件 + ``` + 查看帮助命令：help + 查看show命令：help show + 查看支持的设备形态： show productlist + 查看支持的测试类型： show typelist + 查看支持的测试子系统： show subsystemlist + 查看支持的测试部件： show partlist + ``` + 2)ACTS命令 + + 当选择完产品形态，可以参考如下执行执行ACTS测试用例 + ``` + run -t ACTS + run -t ACTS -ss arkui + run -t ACTS -ss arkui, modulemanager + run -t ACTS -ss arkui -ts ActsAceEtsTest + run -t ACTS -ss arkui -ts ActsAceEtsTest, ActsAceEtsResultTest + run -t ACTS -ss arkui -ts ActsAceEtsTest -ta class:alphabetIndexerTest#alphabetIndexerTest001 + run -t ACTS -ss arkui -ts ActsAceEtsTest -ta class:alphabetIndexerTest#alphabetIndexerTest001 --repeat 2 + run -hl + run -rh 1 + run --retry + ``` + 执行命令参数说明,与TDD有所不同： + ``` + -t [TESTTYPE]: 指定测试用例类型，有UT，MST，ST，PERF，FUZZ，BENCHMARK,ACTS等。（必选参数） + -ss [SUBSYSTEM]: 指定子系统，可单独使用，且可以执行多个子系统，用逗号隔开。 + -ts [TESTSUITE]: 指定测试套，可独立使用，且可以执行多个测试套，用逗号隔开。 + -ta [TESTARGS]: 指定测试类测试方法，需结合-ts指定上级测试套使用。 + --repeat : 支持设置用例执行次数。 + -hl [HISTORYLIST]: 显示最近10条测试用例，超过10条，只显示最近10条。 + -rh [RUNHISTORY]: 执行历史记录的第几条记录运行 + --retry：检查上次运行结果，如果有失败用例则重复测试 + ``` + ### 测试报告日志 当执行完测试指令，控制台会自动生成测试结果，若需要详细测试报告您可在相应的数据文档中进行查找。 -- Gitee From bb7516e6b150bd798aa371a3f329ed03785330b6 Mon Sep 17 00:00:00 2001 From: yuyan0428 Date: Fri, 21 Oct 2022 09:14:09 +0000 Subject: [PATCH 2/2] Signed-off-by: yuyan0428 Signed-off-by: yuyan0428 --- README_zh.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README_zh.md b/README_zh.md index 315b0d9..3b7f6c1 100755 --- a/README_zh.md +++ b/README_zh.md @@ -900,7 +900,8 @@ subsystem # 子系统 run -t ACTS run -t ACTS -ss arkui run -t ACTS -ss arkui, modulemanager - run -t ACTS -ss arkui -ts ActsAceEtsTest + run -t ACTS -ss arkui -ts ActsAceEtsTest + run -t ACTS -ss arkui -tp ActsPartName run -t ACTS -ss arkui -ts ActsAceEtsTest, ActsAceEtsResultTest run -t ACTS -ss arkui -ts ActsAceEtsTest -ta class:alphabetIndexerTest#alphabetIndexerTest001 run -t ACTS -ss arkui -ts ActsAceEtsTest -ta class:alphabetIndexerTest#alphabetIndexerTest001 --repeat 2 @@ -912,6 +913,7 @@ subsystem # 子系统 ``` -t [TESTTYPE]: 指定测试用例类型，有UT，MST，ST，PERF，FUZZ，BENCHMARK,ACTS等。（必选参数） -ss [SUBSYSTEM]: 指定子系统，可单独使用，且可以执行多个子系统，用逗号隔开。 + -tp [TESTPART]: 指定部件，可独立使用。 -ts [TESTSUITE]: 指定测试套，可独立使用，且可以执行多个测试套，用逗号隔开。 -ta [TESTARGS]: 指定测试类测试方法，需结合-ts指定上级测试套使用。 --repeat : 支持设置用例执行次数。 -- Gitee