diff --git a/zh-cn/device-dev/subsystems/subsys-testguide-envbuild.md b/zh-cn/device-dev/subsystems/subsys-testguide-envbuild.md new file mode 100644 index 0000000000000000000000000000000000000000..3f339049deae0ec32fbe9af6ae7908c2757bb6e8 --- /dev/null +++ b/zh-cn/device-dev/subsystems/subsys-testguide-envbuild.md @@ -0,0 +1,82 @@ + + +# 环境配置 +## 测试框架基础环境依赖 + +|环境依赖|操作系统|Linux系统扩展组件|python|python插件|NFS Server|HDC| +|------------|------------|------------|------------|------------|------------|------------| +|版本型号|Ubuntu18.04及以上|libreadline-dev|3.7.5版本及以上|pyserial 3.3及以上、paramiko2.7.1及以上、setuptools40.8.0及以上、rsa4.0及以上|haneWIN NFS Server 1.2.50及以上或者 NFSSv4及以上| 1.1.0版本及以上 | +|详细说明|代码编译环境|命令行读取插件|测试框架语言 |pyserial：支持python的串口通信；paramiko：支持python使用SSH协议；setuptools：支持python方便创建和分发python包；rsa：支持python rsa加密 |支持设备通过串口连接| 支持设备通过HDC连接 | + +## 安装流程 +1. 安装Linux扩展组件readline，安装命令如下： +``` +sudo apt-get install libreadline-dev +``` +安装成功提示如下： +``` +Reading package lists... Done +Building dependency tree +Reading state information... Done +libreadline-dev is already the newest version (7.0-3). +0 upgraded, 0 newly installed, 0 to remove and 11 not upgraded. +``` +2. 安装setuptools插件，安装命令如下： +``` +pip3 install setuptools +``` +安装成功提示如下： +``` +Requirement already satisfied: setuptools in d:\programs\python37\lib\site-packages (41.2.0) +``` +3. 安装paramiko插件，安装命令如下： +``` +pip3 install paramiko +``` +安装成功提示如下： +``` +Installing collected packages: pycparser, cffi, pynacl, bcrypt, cryptography, paramiko +Successfully installed bcrypt-3.2.0 cffi-1.14.4 cryptography-3.3.1 paramiko-2.7.2 pycparser-2.20 pynacl-1.4.0 +``` +4. 安装python的rsa插件，安装命令如下： +``` +pip3 install rsa +``` +安装成功提示如下： +``` +Installing collected packages: pyasn1, rsa +Successfully installed pyasn1-0.4.8 rsa-4.7 +``` +5. 安装串口插件pyserial，安装命令如下： +``` +pip3 install pyserial +``` +安装成功提示如下： +``` +Requirement already satisfied: pyserial in d:\programs\python37\lib\site-packages\pyserial-3.4-py3.7.egg (3.4) +``` +6. 如果设备仅支持串口输出测试结果，则需要安装NFS Server +- Windows环境下安装，例如安装haneWIN NFS Server1.2.50。 +- Linux环境下安装，安装命令如下： +``` +sudo apt install nfs-kernel-server +``` +安装成功提示如下： +``` +Reading package lists... Done +Building dependency tree +Reading state information... Done +nfs-kernel-server is already the newest version (1:1.3.4-2.1ubuntu5.3). +0 upgraded, 0 newly installed, 0 to remove and 11 not upgraded. +``` +7. 如果设备支持HDC连接，则需要安装HDC工具，安装流程请参考如下链接 +https://gitee.com/openharmony/developtools_hdc_standard/blob/master/README_zh.md + +## 安装环境检查 + +| 检查项 |操作 |满足环境 | +| --- | --- | --- | +| 检查python安装成功 |命令行窗口执行命令：python --version |版本不小于3.7.5即可 | +| 检查python扩展插件安装成功 |打开test/xdevice目录，执行run.bat或run.sh| 可进入提示符“>>>”界面即可 | +|检查NFS Server启动状态（被测设备仅支持串口时检测） |通过串口登录开发板，执行mount命令挂载NFS |可正常挂载文件目录即可 | +|检查HDC安装成功 |命令行窗口执行命令：hdc_std -v |版本不小于1.1.0即可 | diff --git a/zh-cn/device-dev/subsystems/subsys-testguide-test.md b/zh-cn/device-dev/subsystems/subsys-testguide-test.md index 1797e29f6a3ef77e96481d8b862f553815555593..c25d46e1ec519dffb71ffac79414604004a57bea 100644 --- a/zh-cn/device-dev/subsystems/subsys-testguide-test.md +++ b/zh-cn/device-dev/subsystems/subsys-testguide-test.md @@ -1,982 +1,849 @@ -# 测试用例开发指导 - -- [概述](#section12403172115920) - - [基本概念](#section53632272090) - - [运作机制](#section2394431106) - -- [约束与限制](#section2029921310472) -- [搭建环境](#section175012297491) - - [环境要求](#section935055691014) - - [安装环境](#section6511193210111) - - [检验环境是否搭建成功](#section1899144517117) - -- [开发指导](#section16741101301210) - - [场景介绍](#section93782214124) - - [接口说明](#section54131732101218) - - [开发步骤](#section53541946111218) - -- [开发实例](#section7477121918136) -- [测试平台使用](#section76401945124810) -- [包结构说明](#section1875515364133) - -## 概述 - -### 基本概念 - -测试子系统提供基于python开发的一键式的开发者自测试平台，支持跨平台使用以及三方测试框架拓展，主要包括测试用例编译、测试用例管理、测试用例调度分发、测试用例执行、测试结果收集、测试报告生成、测试用例模板、测试环境管理等模块。 - -在测试子系统开发前，开发者应先了解以下概念： - -- 测试用例编译 - - 支持将测试用例源代码编译成可在被测设备侧执行的二进制文件。 - -- 测试用例调度分发 - - 支持将测试用例通过网口通道或者串口通道分发到不同的被测设备上，并且为每一个测试用例分配特定的测试用例执行器。 - -- 测试用例执行器 - - 负责测试用例的预处理，用例执行，结果记录等执行逻辑。 - -- 测试用例模板 - - 定义了测试用例以及用例编译配置GN文件的统一格式。 - -- 测试平台kit - - 测试平台运行过程中公共方法，如提供测试用例目录向被测设备挂载文件系统，测试用例推送到被测设备，或者从被测设备获取测试结果等操作。 - -- 测试报告生成 - - 定义开发者自测试报告模板，生成web测试报告。 - -- 测试环境管理 - - 支持通过USB、串口等方式管理被测设备，功能包括设备发现，设备状态查询等。 - - -### 运作机制 - -- 测试平台架构图如下： - -**图 1** 测试平台架构 -![](figure/测试平台架构.png "测试平台架构") - -- 测试平台运行时序图如下： - -**图 2** 测试平台运行时序 -![](figure/测试平台运行时序.png "测试平台运行时序") - -- 测试平台运行原理 - -测试平台通过shell脚本启动，以命令行方式支持一系列的测试指令执行，通过命令行输出测试结果。 - -## 约束与限制 - -- 功能使用范围：开发自测试平台仅支持代码级的测试用例开发和验证，如单元测试，模块测试。 -- 规格限制：当前测试框架的适用范围仅支持白盒测试。 -- 操作限制：一台测试设备上仅支持启动单个测试平台。 - -## 搭建环境 +# 测试子系统 +OpenHarmony为开发者提供了一套全面的自测试框架，开发者可根据测试需求开发相关测试用例，开发阶段提前发现缺陷，大幅提高代码质量。 + +本文从基础环境构建，用例开发，编译以及执行等方面介绍OpenHarmony测试框架如何运行和使用。 +## 基础环境构建 +测试框架依赖于python运行环境，在使用测试框架之前可参阅以下方式进行配置。 + - [环境配置](subsys-testguide-envbuild.md) + - [源码获取](../get-code/sourcecode-acquire.md) + + +## 测试框架目录简介 +以下是测试框架的目录层级架构，在使用测试框架过程中可在相应目录查找对应组件。 +``` +test # 测试子系统 +├── developertest # 开发者测试组件 +│ ├── aw # 测试框架的静态库 +│ ├── config # 测试框架配置 +│ │ │ ... +│ │ └── user_config.xml # 用户使用配置 +│ ├── examples # 测试用例示例 +│ ├── src # 测试框架源码 +│ ├── third_party # 测试框架依赖第三方组件适配 +│ ├── reports # 测试结果报告 +│ ├── BUILD.gn # 测试框架编译入口 +│ ├── start.bat # 开发者测试入口（Windows） +│ └── start.sh # 开发者测试入口（Linux） +└── xdevice # 测试框架依赖组件 +``` +## 测试用例编写 +### 测试用例目录规划 +使用测试框架过程中，可根据以下层级关系规划测试用例目录。 +``` +subsystem # 子系统 +├── partA # 部件A +│ ├── moduleA # 模块A +│ │ ├── include +│ │ ├── src # 业务代码 +│ │ └── test # 测试目录 +│ │ ├── unittest # 单元测试 +│ │ │ ├── common # 公共用例 +│ │ │ │ ├── BUILD.gn # 测试用例编译配置 +│ │ │ │ ├── testA_test.cpp # 单元测试用例源码 +│ │ │ ├── phone # 手机形态用例 +│ │ │ ├── ivi # 车机形态 +│ │ │ └── liteos-a # ipcamera使用liteos内核时的用例 +│ │ └── resource # 依赖资源 +│ │ └── ohos_test.xml +│ ├── moduleB # 模块B +│ ├── test +│ │ └── moduletest # 模块测试 +│ │ ├── common +│ │ ├── phone +│ │ ├── ivi +│ │ └── liteos-a +│ │ ... +│ └── ohos_build # 编译入口配置 +... +``` +> **注意：** 测试用例根据不同设备形态差异分为通用用例和非通用用例，建议将通用用例存放在common目录下，非通用用例存放在相应设备形态目录下。 + +### 测试用例编写 +本测试框架支持多种语言用例编写，针对不同语言提供了不同的模板以供编写参考。 +- **C++参考示例** + +1.用例源文件命名规范 + +测试用例源文件名称和测试套内容保持一致，文件命名采用全小写+下划线方式命名，以test结尾，具体格式为：[功能]_[子功能]_test，子功能支持向下细分。 +示例： +``` +calculator_sub_test.cpp +``` + +2.用例示例 +``` +/* + * Copyright (c) 2021 XXXX Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "calculator.h" +#include + +using namespace testing::ext; + +class CalculatorSubTest : public testing::Test { +public: + static void SetUpTestCase(void); + static void TearDownTestCase(void); + void SetUp(); + void TearDown(); +}; + +void CalculatorSubTest::SetUpTestCase(void) +{ + // input testsuit setup step，setup invoked before all testcases +} + +void CalculatorSubTest::TearDownTestCase(void) +{ + // input testsuit teardown step，teardown invoked after all testcases +} + +void CalculatorSubTest::SetUp(void) +{ + // input testcase setup step，setup invoked before each testcases +} + +void CalculatorSubTest::TearDown(void) +{ + // input testcase teardown step，teardown invoked after each testcases +} + +/** + * @tc.name: integer_sub_001 + * @tc.desc: Verify the sub function. + * @tc.type: FUNC + * @tc.require: Issue Number + */ +HWTEST_F(CalculatorSubTest, integer_sub_001, TestSize.Level1) +{ + // step 1:调用函数计算结果 + int actual = Sub(4，0)； + // Step 2:使用断言比较预期与计算结果 + EXPECT_EQ(4, actual); +} +``` +详细内容介绍： +1. 添加测试用例文件头注释信息 + ``` + /* + * Copyright (c) 2021 XXXX Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + ``` +2. 引用测试框架头文件和命名空间 + ``` + #include + + using namespace testing::ext; + ``` +3. 添加被测试类的头文件 + ``` + #include "calculator.h" + ``` +4. 定义测试套（测试类） + ``` + class CalculatorSubTest : public testing::Test { + public: + static void SetUpTestCase(void); + static void TearDownTestCase(void); + void SetUp(); + void TearDown(); + }; + + void CalculatorSubTest::SetUpTestCase(void) + { + // input testsuit setup step，setup invoked before all testcases + } + + void CalculatorSubTest::TearDownTestCase(void) + { + // input testsuit teardown step，teardown invoked after all testcases + } + + void CalculatorSubTest::SetUp(void) + { + // input testcase setup step，setup invoked before each testcases + } + + void CalculatorSubTest::TearDown(void) + { + // input testcase teardown step，teardown invoked after each testcases + } + ``` + > **注意：** 在定义测试套时，测试套名称应与编译目标保持一致，采用大驼峰风格。 + +5. 测试用例实现，包含用例注释和逻辑实现 + ``` + /** + * @tc.name: integer_sub_001 + * @tc.desc: Verify the sub function. + * @tc.type: FUNC + * @tc.require: Issue Number + */ + HWTEST_F(CalculatorSubTest, integer_sub_001, TestSize.Level1) + { + //step 1:调用函数计算结果 + int actual = Sub(4，0)； + //Step 2:使用断言比较预期与计算结果 + EXPECT_EQ(4, actual); + } + ``` + 在编写用例时，我们提供了三种用例模板供您选择。 + + | 类型 | 描述 | + | ------------| ------------| + | HWTEST(A,B,C)| 用例执行不依赖Setup()时，可选取| + | HWTEST(A,B,C)| 用例执行依赖于Setup()时，可选取| + | HWTEST(A,B,C)| 需要做参数化测试时，可选取| + + 其中，参数A，B，C的含义如下： + - 参数A为测试套名。 + - 参数B为测试用例名，其命名必须遵循[功能点]_[编号]的格式，编号为3位 数字，从001开始。 + - 参数C为测试用例等级，具体分为门禁level0 以及非门禁level1-level4共五 个等级，其中非门禁level1-level4等级的具体选取规则为：测试用例功能越重要，level等级越低。 + + **注意：** + - 测试用例的预期结果必须有对应的断言。 + - 测试用例必须填写用例等级。 + - 测试体建议按照模板分步实现。 + - 用例描述信息按照标准格式@tc.xxx value书写，注释信息必须包含用例名称，用例类型，需求编号四项。其中用例测试类型@tc.type参数的选取，可参考下表。 + + | 测试类型名称|功能测试|性能测试|可靠性测试|安全测试|模糊测试| + | ------------|------------|------------|------------|------------|------------| + | 类型编码|FUNC|PERF|RELI|SECU|FUZZ| + + +- **JavaScript参考示例** + +1.用例源文件命名规范 + +测试用例原文件名称采用大驼峰风格，以TEST结尾，具体格式为：[功能][子功能]TEST，子功能支持向下细分。 +示例： +``` +AppInfoTest.js +``` + +2.用例示例 +``` +/* + * Copyright (C) 2021 XXXX Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +import app from '@system.app' + +import {describe, beforeAll, beforeEach, afterEach, afterAll, it, expect} from 'deccjsunit/index' + +describe("AppInfoTest", function () { + beforeAll(function() { + // input testsuit setup step，setup invoked before all testcases + console.info('beforeAll caled') + }) + + afterAll(function() { + // input testsuit teardown step，teardown invoked after all testcases + console.info('afterAll caled') + }) + + beforeEach(function() { + // input testcase setup step，setup invoked before each testcases + console.info('beforeEach caled') + }) + + afterEach(function() { + // input testcase teardown step，teardown invoked after each testcases + console.info('afterEach caled') + }) -### 环境要求 + /* + * @tc.name:appInfoTest001 + * @tc.desc:verify app info is not null + * @tc.type: FUNC + * @tc.require: Issue Number + */ + it("appInfoTest001", 0, function () { + var info = app.getInfo() + expect(info != null).assertEqual(true) + }) +}) +``` +详细内容介绍： +1. 添加测试用例文件头注释信息 + ``` + /* + * Copyright (C) 2021 XXXX Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + ``` +2. 导入被测api和jsunit测试库 + ``` + import app from '@system.app' + + import {describe, beforeAll, beforeEach, afterEach, afterAll, it, expect} from 'deccjsunit/index' + ``` +3. 定义测试套 + ``` + describe("AppInfoTest", function () { + beforeAll(function() { + // input testsuit setup step，setup invoked before all testcases + console.info('beforeAll caled') + }) + + afterAll(function() { + // input testsuit teardown step，teardown invoked after all testcases + console.info('afterAll caled') + }) + + beforeEach(function() { + // input testcase setup step，setup invoked before each testcases + console.info('beforeEach caled') + }) + + afterEach(function() { + // input testcase teardown step，teardown invoked after each testcases + console.info('afterEach caled') + }) + ``` +4. 测试用例实现 + ``` + /* + * @tc.name:appInfoTest001 + * @tc.desc:verify app info is not null + * @tc.type: FUNC + * @tc.require: Issue Number + */ + it("appInfoTest001", 0, function () { + var info = app.getInfo() + expect(info != null).assertEqual(true) + }) + ``` + +### 测试用例编译文件编写 +根据测试用例目录规划，当执行某一用例时，测试框架会根据编译文件逐层查找，最终找到所需用例进行编译。下面通过不同示例来讲解gn文件如何编写。 + +#### 测试用例编译配置文件 +针对不同语言，下面提供不同的编译模板以供参考。 + +- **C++用例编译配置示例** +``` +# Copyright (c) 2021 XXXX Device Co., Ltd. + +import("//build/test.gni") + +module_output_path = "subsystem_examples/calculator" + +config("module_private_config") { + visibility = [ ":*" ] + + include_dirs = [ "../../../include" ] +} + +ohos_unittest("CalculatorSubTest") { + module_out_path = module_output_path + + sources = [ + "../../../include/calculator.h", + "../../../src/calculator.cpp", + ] + + sources += [ "calculator_sub_test.cpp" ] + + configs = [ ":module_private_config" ] + + deps = [ "//third_party/googletest:gtest_main" ] +} + +group("unittest") { + testonly = true + deps = [":CalculatorSubTest"] +} +``` +详细内容如下： + +1. 添加文件头注释信息 + ``` + # Copyright (c) 2021 XXXX Device Co., Ltd. + ``` +2. 导入编译模板文件 + ``` + import("//build/test.gni") + ``` +3. 指定文件输出路径 + ``` + module_output_path = "subsystem_examples/calculator" + ``` + > **说明：** 此处输出路径为部件/模块名。 + +4. 配置依赖包含目录 + + ``` + config("module_private_config") { + visibility = [ ":*" ] + + include_dirs = [ "../../../include" ] + } + ``` + > **说明：** 一般在此处对相关配置进行设置，在测试用例编译脚本中可直接引用。 + +5. 指定测试用例编译目标输出的文件名称 + + ``` + ohos_unittest("CalculatorSubTest") { + } + ``` +6. 编写具体的测试用例编译脚本（添加需要参与编译的源文件、配置和依赖） + ``` + ohos_unittest("CalculatorSubTest") { + module_out_path = module_output_path + sources = [ + "../../../include/calculator.h", + "../../../src/calculator.cpp", + "../../../test/calculator_sub_test.cpp" + ] + sources += [ "calculator_sub_test.cpp" ] + configs = [ ":module_private_config" ] + deps = [ "//third_party/googletest:gtest_main" ] + } + ``` + + > **说明：根据测试类型的不同，在具体编写过程中可选择不同的测试类型：** + > - ohos_unittest：单元测试 + > - ohos_moduletest：模块测试 + > - ohos_systemtest：系统测试 + > - ohos_performancetest：性能测试 + > - ohos_securitytest：安全测试 + > - ohos_reliabilitytest：可靠性测试 + > - ohos_distributedtest：分布式测试 + +7. 对目标测试用例文件进行条件分组 + + ``` + group("unittest") { + testonly = true + deps = [":CalculatorSubTest"] + } + ``` + > **说明：** 进行条件分组的目的在于执行用例时可以选择性的执行某一种特定类型的用例。 + +- **JavaScript用例编译配置示例** + +``` +# Copyright (C) 2021 XXXX Device Co., Ltd. + +import("//build/test.gni") + +module_output_path = "subsystem_examples/app_info" + +ohos_js_unittest("GetAppInfoJsTest") { + module_out_path = module_output_path + + hap_profile = "./config.json" + certificate_profile = "//test/developertest/signature/openharmony_sx.p7b" +} + +group("unittest") { + testonly = true + deps = [ ":GetAppInfoJsTest" ] +} +``` + +详细内容如下： + +1. 添加文件头注释信息 + + ``` + # Copyright (C) 2021 XXXX Device Co., Ltd. + ``` +2. 导入编译模板文件 + + ``` + import("//build/test.gni") + ``` +3. 指定文件输出路径 + + ``` + module_output_path = "subsystem_examples/app_info" + ``` + > **说明：** 此处输出路径为部件/模块名。 + +4. 指定测试用例编译目标输出的文件名称 + + ``` + ohos_js_unittest("GetAppInfoJsTest") { + } + ``` + > **说明：** + >- 使用模板ohos_js_unittest定义js测试套，注意与C++用例区分。 + >- js测试套编译输出文件为hap类型，hap名为此处定义的测试套名，测试套名称必须以JsTest结尾。 + +5. 指定hap包配置文件config.json和签名文件，两个配置为必选项 + + ``` + ohos_js_unittest("GetAppInfoJsTest") { + module_out_path = module_output_path + + hap_profile = "./config.json" + certificate_profile = "//test/developertest/signature/openharmony_sx.p7b" + } + ``` + config.json为hap编译所需配置文件，需要开发者根据被测sdk版本配置“target”项，其余项可默认，具体如下所示： + + ``` + { + "app": { + "bundleName": "com.example.myapplication", + "vendor": "example", + "version": { + "code": 1, + "name": "1.0" + }, + "apiVersion": { + "compatible": 4, + "target": 5 # 根据被测sdk版本进行修改，此例为sdk5 + } + }, + "deviceConfig": {}, + "module": { + "package": "com.example.myapplication", + "name": ".MyApplication", + "deviceType": [ + "phone" + ], + "distro": { + "deliveryWithInstall": true, + "moduleName": "entry", + "moduleType": "entry" + }, + "abilities": [ + { + "skills": [ + { + "entities": [ + "entity.system.home" + ], + "actions": [ + "action.system.home" + ] + } + ], + "name": "com.example.myapplication.MainAbility", + "icon": "$media:icon", + "description": "$string:mainability_description", + "label": "MyApplication", + "type": "page", + "launchType": "standard" + } + ], + "js": [ + { + "pages": [ + "pages/index/index" + ], + "name": "default", + "window": { + "designWidth": 720, + "autoDesignWidth": false + } + } + ] + } + } + ``` +6. 对目标测试用例文件进行条件分组 + ``` + group("unittest") { + testonly = true + deps = [ ":GetAppInfoJsTest" ] + } + ``` + > **说明：** 进行条件分组的目的在于执行用例时可以选择性的执行某一种特定类型的用例。 + +#### 编译入口配置文件ohos.build + +当完成用例编译配置文件编写后，需要进一步编写部件编译配置文件，以关联到具体的测试用例。 +``` +"partA": { + "module_list": [ + + ], + "inner_list": [ + + ], + "system_kits": [ + + ], + "test_list": [ + "//system/subsystem/partA/calculator/test:unittest" //配置模块calculator下的test + ] + } +``` +> **说明：** test_list中配置的是对应模块的测试用例。 + +### 测试用例资源配置 +测试依赖资源主要包括测试用例在执行过程中需要的图片文件，视频文件、第三方库等对外的文件资源。 + +依赖资源文件配置步骤如下： +1. 在部件或者模块的test目录下创建resource目录，存放需要的资源文件 + +2. 在resource目录下创建一个ohos_test.xml文件，文件内容格式如下 + ``` + + + + + + + + ``` +3. 在测试用例的编译配置文件中定义resource_config_file进行指引，用来指定对应的资源文件ohos_test.xml + ``` + ohos_unittest("CalculatorSubTest") { + resource_config_file = "//system/subsystem/partA/calculator/test/resource/ohos_test.xml" + } + ``` + >**说明：** + >- target_name: 测试套的名称，定义在测试目录的BUILD.gn中。preparer: 表示该测试套执行前执行的动作。 + >- src="res": 表示测试资源位于test目录下的resource目录下，src="out" 表示位于out/release/$(部件)目录下。 + +## 测试用例执行 +在执行测试用例之前，针对用例使用设备的不同，需要对相应配置进行修改，修改完成即可执行测试用例。 + +### user_config.xml配置 +``` + + + + false + + false + + true + + + + + + + + + + + + + cmd + 115200 + 8 + 1 + 1 + + + + + + + + + + + + + + + + + + +``` +>**说明：** 在执行测试用例之前，若使用HDC连接设备，用例仅需配置设备IP和端口号即可，其余信息均默认不修改。 + +### Windows环境执行 +#### 测试用例编译 + +由于Windows环境下无法实现用例编译，因此执行用例前需要在Linux环境下进行用例编译，用例编译命令： +``` +./build.sh --product-name Hi3516DV300 --build-target make_test +``` +编译完成后，测试用例将自动保存在out/ohos-arm-release/packages/phone/images/tests目录下。 + +>说明: Hi3516DV300为当前版本所支持的平台，make_test表示全部用例。根据不同需求，编译选项可进行不同选择： +> - --product-name # 编译产品名称（必选） +> - --build-target # 指定编译目标（可选） + +#### 搭建执行环境 +1. 在Windows环境创建测试框架目录Test，并在此目录下创建testcase目录 + +2. 从Linux环境拷贝测试框架developertest和xdevice到创建的Test目录下，拷贝编译好的测试用例到testcase目录下 + >**说明：** 将测试框架及测试用例从Linux环境移植到Windows环境，以便后续执行。 + +3. 修改user_config.xml + ``` + + + false + + + + D:\Test\testcase\tests + + ``` + >**说明：** ``标签表示是否需要编译用例；``标签表示测试用例查找路径。 + +#### 执行用例 +1. 启动测试框架 + ``` + start.bat + ``` +2. 选择产品形态 +进入测试框架，系统会自动提示您选择产品形态，请根据实际的开发板进行选择。例如：Hi3516DV300。 + +3. 执行测试用例 +当选择完产品形态，可参考如下指令执行测试用例。 + ``` + run -t UT -ts CalculatorSubTest -tc interger_sub_00l + ``` + 执行命令参数说明： + ``` + -t [TESTTYPE]: 指定测试用例类型，有UT，MST，ST，PERF等。（必选参数） + -tp [TESTTYPE]: 指定部件，可独立使用。 + -tm [TESTTYPE]: 指定模块，不可独立使用，需结合-tp指定上级部件使用。 + -ts [TESTTYPE]: 指定测试套，可独立使用。 + -tc [TESTTYPE]: 指定测试用例，不可独立使用，需结合-ts指定上级测试套使用。 + -h : 帮助命令。 + ``` +### Linux环境执行 +#### 远程端口映射 +为了在Linux远程服务器以及Linux虚拟机两种环境下执行测试用例，需要对端口进行远程映射，以实现与设备的数据通路连接。具体操作如下： +1. HDC Server指令： + ``` + hdc_std kill + hdc_std -m -s 0.0.0.0:8710 + ``` + >**说明：** IP和端口号为默认值。 + +2. HDC Client指令： + ``` + hdc_std -s xx.xx.xx.xx:8710 list targets + ``` + >**说明：** 此处IP填写设备侧IP地址。 -**表 1** **环境要求** +#### 执行用例 +1. 启动测试框架 + ``` + ./start.sh + ``` +2. 选择产品形态 +进入测试框架，系统会自动提示您选择产品形态，请根据实际的开发板进行选择。例如：Hi3516DV300。 - - - - - - - - - - - - - - - -

项目

-

测试设备

-

被测设备

-

硬件

-
  • 内存：8G及以上
  • 硬盘：100G及以上
  • 硬件架构：X86或ARM64
-
  • Hi3516 DV300开发板
  • Hi3518 EV300开发板
-

软件

-
  • 操作系统：Windows 10 64位 或 Ubuntu 18.04

    系统组件（Linux）： libreadline-dev

    -
  • Python：3.7.5及以上
  • Python插件：pyserial3.3及以上、paramiko2.7.1及以上、setuptools40.8.0及以上，rsa4.0及以上
  • NFS Server：haneWIN NFS Server1.2.50及以上或者 NFSv4及以上
-
  • 系统软件：版本不低于OpenHarmony 1.0
  • 内核类型：LiteOS-A或者Linux
-
+3. 执行测试用例 +测试框架在执行用例时会根据指令找到所需用例，自动实现用例编译，执行过程，完成自动化测试。 + ``` + run -t UT -ts CalculatorSubTest -tc interger_sub_00l + ``` + 执行命令参数说明： + ``` + -t [TESTTYPE]: 指定测试用例类型，有UT，MST，ST，PERF等。（必选参数） + -tp [TESTTYPE]: 指定部件，可独立使用。 + -tm [TESTTYPE]: 指定模块，不可独立使用，需结合-tp指定上级部件使用。 + -ts [TESTTYPE]: 指定测试套，可独立使用。 + -tc [TESTTYPE]: 指定测试用例，不可独立使用，需结合-ts指定上级测试套使用。 + -h : 帮助命令。 + ``` -### 安装环境 +## 测试报告日志 +当执行完测试指令，控制台会自动生成测试结果，若需要详细测试报告您可在相应的数据文档中进行查找。 -1. 如测试环境为Linux，需要安装系统组件readline，命令如下： +### 测试结果 +测试结果输出根路径如下： +``` +test/developertest/reports/xxxx_xx_xx_xx_xx_xx +``` +>**说明：** 测试报告文件目录将自动生成。 - ``` - sudo apt-get install libreadline-dev - ``` +该目录中包含以下几类结果： +| 类型 | 描述| +| ------------ | ------------ | +| result/ |测试用例格式化结果| +| log/plan_log_xxxx_xx_xx_xx_xx_xx.log | 测试用例日志 | +| summary_report.html | 测试报告汇总 | +| details_report.html | 测试报告详情 | - 安装成功提示如下： +### 测试框架日志 +``` +reports/platform_log_xxxx_xx_xx_xx_xx_xx.log +``` - ``` - Reading package lists... Done - Building dependency tree - Reading state information... Done - libreadline-dev is already the newest version (7.0-3). - 0 upgraded, 0 newly installed, 0 to remove and 11 not upgraded. - ``` +### 最新测试报告 +``` +reports/latest +``` -2. 安装Python扩展组件setuptools、（rsa、paramiko、以及pyserial，设备仅支持串口时安装），命令如下: - 1、安装setuptools，安装命令如下： - ``` - pip install setuptools - ``` - 安装成功提示如下： - ``` - Requirement already satisfied: setuptools in d:\programs\python37\lib\site-packages (41.2.0) - ``` - 2、安装rsa，安装命令如下： - ``` - pip install rsa - ``` - 安装成功提示如下： - ``` - Installing collected packages: pyasn1, rsa - Successfully installed pyasn1-0.4.8 rsa-4.7 - ``` - 3、安装Paramiko，安装命令如下： - ``` - pip install paramiko - ``` - - 安装成功提示如下： - - ``` - Installing collected packages: pycparser, cffi, pynacl, bcrypt, cryptography, paramiko - Successfully installed bcrypt-3.2.0 cffi-1.14.4 cryptography-3.3.1 paramiko-2.7.2 pycparser-2.20 pynacl-1.4.0 - ``` - - 4、安装pyserial（被测设备仅支持串口时安装），安装命令如下： - - ``` - pip install pyserial - ``` - - 安装成功提示如下： - - ``` - Requirement already satisfied: pyserial in d:\programs\python37\lib\site-packages\pyserial-3.4-py3.7.egg (3.4) - ``` - -3. 安装NFS server（被测设备仅支持串口时安装）。 - - **Windows环境安装** - - 下载并安装haneWIN NFS Server1.2.50，地址：https://www.hanewin.net/nfs-e.htm - - **Linux环境下安装** - - ``` - sudo apt install nfs-kernel-server - ``` - - 所有环境配置安装完成，即可在IDE中进行测试平台代码开发调试，推荐的IDE为 DevEco Studio。 - - -### 检验环境是否搭建成功 - -**表 2** **检验环境** - - - - - - - - - - - - - - - - - - - - -

检查项

-

操作

-

满足条件

-

检查python安装与否，版本是否满足要求。

-

命令行窗口执行命令：python --version。

-

版本不小于3.7.5即可。

-

检查python扩展插件安装与否。

-

打开test/xdevice目录，执行run.bat或run.sh。

-

可进入提示符“>>>”界面即可。

-

检查NFS Server启动状态（被测设备仅支持串口时检测）。

-

通过串口登录开发板，执行mount命令挂载NFS。

-

可正常挂载文件目录即可。

-
-## 开发指导 - -### 场景介绍 -针对开发的业务代码进行白盒测试验证。 - -### 接口说明 - -测试框架集成了开源的单元测试框架，并对测试用例的宏定义做了扩展，具体框架说明详见开源官方文档。 - -**表 3** 测试框架扩展宏定义说明 - - - - - - - - - - - - - - - - -

宏定义

-

描述

-

HWTEST

-

测试用例执行不依赖Setup&Teardown。HWTEST对TEST增加了“用例级别”参数“TestSize.Level1”，例如HWTEST(CalculatorAddTest, TestPoint_001, TestSize.Level1)。

-

HWTEST_F

-

测试用例（不带参数）执行依赖Setup&Teardown。HWTEST_F对TEST_F增加了“用例级别”参数“ TestSize.Level1”，例如HWTEST_F(CalculatorAddTest, TestPoint_001, TestSize.Level1)。

-

HWTEST_P

-

测试用例（带参数）执行依赖Setup&Teardown。HWTEST_P对TEST_P增加了“用例级别”参数“ TestSize.Level1”，例如HWTEST_P(CalculatorAddTest, TestPoint_001, TestSize.Level1)。

-
- -### 开发步骤 - -1. 按照开发者测试用例目录规划定义测试套文件，需要继承testing::Test类，命名以被测特性+Test命名，示例代码路径：test/developertest/examples/lite/cxx\_demo/test/unittest/common/calc\_subtraction\_test.cpp - - ``` - /* - * Copyright (c) 2020 OpenHarmony. - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - #include - - using namespace std; - using namespace testing::ext; - - class CalcSubtractionTest : public testing::Test { - public: - static void SetUpTestCase(void); - static void TearDownTestCase(void); - void SetUp(); - void TearDown(); - }; - ``` - - >![](../public_sys-resources/icon-note.gif) **说明：** - >测试用例规范 - >- 命名规范 - > 测试用例源文件名称和测试套内容保持一致，测试套与用例之间关系1:N，测试套与测试源文件之间关系1:1，每个源文件全局唯一，格式：\[特性\]\_\[功能\]\_\[子功能1\]\_\[子功能1.1\]，子功能支持向下细分。 - > 文件命名采用全小写+下划线方式命名，以test结尾，如demo用例：developertest/examples/lite/cxx\_demo - >- 测试用例编码规范 - > 开发者测试用例原则上与特性代码编码规范保持一致，另外需要添加必要的用例描述信息，详见[•自测试用例模板](#li2069415903917)。 - >- 测试用例编译配置规范 - > 测试用例采用GN方式编译，配置遵循本开源项目的[编译指导](subsys-build-mini-lite.md)。 - >- 测试用例模板 - > 详见测试demo用例：developertest/examples/lite/cxx\_demo/test/unittest/common/calc\_subtraction\_test.cpp - -2. 实现测试套执行过程需要的预处理操作和后处理操作，即实现SetUp和TearDown方法。 - - ``` - void CalcSubtractionTest::SetUpTestCase(void) - { - // step 1: input testsuite setup step - } - - void CalcSubtractionTest::TearDownTestCase(void) - { - // step 2: input testsuite teardown step - } - - void CalcSubtractionTest::SetUp(void) - { - // step 3: input testcase setup step - } - - void CalcSubtractionTest::TearDown(void) - { - // step 4: input testcase teardown step - } - ``` - -3. 针对被测对象的特性编写测试用例，以使用HWTEST\_F为例说明。 - - ``` - /** - * @tc.name: integer_sub_001 - * @tc.desc: Test Calculator - * @tc.type: FUNC - * @tc.require: AR00000000 SR00000000 - */ - HWTEST_F(CalcSubtractionTest, integer_sub_001, TestSize.Level1) - { - EXPECT_EQ(0, Subtraction(1, 0)); - } - ``` - - >![](../public_sys-resources/icon-note.gif) **说明：** - >- @tc.name：用例名称，对测试目的简要描述。 - >- @tc.desc：描述用例详细描述，包括测试目的、测试步骤、期望结果等。 - >- @tc.type：测试属性分类（FUNC、PERF、SECU、RELI）。 - >- @tc.require：需求编号或者issue编号，用来将修改与用例关联。 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

序号

-

测试类型名称

-

缩写

-

测试类型描述

-

1

-

功能测试(functionality)

-

FUNC

-

验证软件各个功能满足功能设计与规格。

-

2

-

性能测试(performance)

-

PERF

-

验证软件是否满足性能设计指标。包含负载测试，容量测试，压力测试等。

-

3

-

安全性测试(security)

-

SECU

-

验证软件在生命周期内符合安全需求定义和相关法规。

-

4

-

可靠性测试（reliability）

-

RELI

-

在规定的条件下，在规定的时间内，软件不引起系统失效的概率，这里也包含稳定性。

-
- -4. 编写用例编译GN文件，其中包括定义用例编译目标，添加编译配置依赖，源文件等，举例说明： - - 示例文件路径：test/developertest/examples/lite/cxx\_demo/test/unittest/common/BUILD.gn）。 - - ``` - import("//build/lite/config/test.gni") - - unittest("CalcSubTest") { - output_extension = "bin" - sources = [ - "calc_subtraction_test.cpp" - ] - include_dirs = [] - deps = [] - } - ``` - -5. 将用例编译目标添加到子系统编译配置中，保证用例随版本一起编译，举例说明： - 1. 支持hdc连接的设备，编译配置示例路径：test/developertest/examples/ohos.build。 - - ``` - { - "subsystem": "subsystem_examples", - "parts": { - "subsystem_examples": { - "module_list": [ - "//test/developertest/examples/detector:detector", - ... ... - ], - "test_list": [ - "//test/developertest/examples/detector/test:unittest", - ... ... - ] - }, - ... ... - } - ``` - - 2. 仅支持串口的设备，编译配置示例路径：test/developertest/examples/lite/BUILD.gn。 - - ``` - import("//build/lite/config/test.gni") - - subsystem_test("test") { - test_components = [] - if(ohos_kernel_type == "liteos_riscv") { - features += [ - ] - }else if(ohos_kernel_type == "liteos_a") { - test_components += [ - "//test/developertest/examples/lite/cxx_demo/test/unittest/common:CalcSubTest" - ] - } - } - ``` - -6. 编写测试用例资源配置，当测试用例需要使用静态测试资源文件时使用该配置。 - 1. 在部件或者模块的test目录下创建resource目录。 - 2. 在resource目录下创建形态目录，如phone。 - 3. 在设备形态目录下创建一个以模块名命名的文件夹，如testmodule。 - 4. 在模块目录下创建一个ohos\_test.xml文件，文件内容格式如下: - - ``` - - - - - - - - ``` - - 5. 在测试用例的编译配置文件中定义resource\_config\_file，用来指定对应的资源文件ohos\_test.xml。 - - >![](../public_sys-resources/icon-note.gif) **说明：** - >如上资源文件功能：将resource目录下的test.txt文件通过hdc push命令推送到被测设备的/data/test/resource目录下。 - - -7. 以上步骤完成即完成测试用例编写，即可执行测试用例。 - - >![](../public_sys-resources/icon-note.gif) **说明：** - >- 支持hdc连接的设备，测试用例支持单独编译。 - >- 仅支持串口连接的设备，在代码根路径下执行编译debug版本的命令，即可编译测试用例。 - > 测试用例用例的执行详见[测试平台使用](#section76401945124810)。 - - -## 开发实例 - -测试子系统代码仓提供了完整demo用例，demo用例路径：test/developertest/examples/。以一个减法运算方法编写测试用例举例说明： - -- 被测代码如下： - - ``` - static int Subtraction(int a, int b) - { - return a - b; - } - ``` - -- 测试用例代码如下： - - ``` - /** - * @tc.name: integer_sub_002 - * @tc.desc: Verify the Subtraction function. - * @tc.type: FUNC - * @tc.require: AR00000000 SR00000000 - */ - HWTEST_F(CalcSubtractionTest, integer_sub_002, TestSize.Level1) - { - EXPECT_EQ(1, Subtraction(2, 1)); - } - ``` -## 测试平台使用 -1. （可选）安装xdevice组件。安装xdevice后，xdevice组件可以作为python的扩展包使用。 - 打开xdevice安装目录：test/xdevice，执行如下命令： - ``` - python setup.py install - ``` - 安装成功提示如下： - ``` - ... ... - Installed d:\programs\python37\lib\site-packages\xdevice-0.0.0-py3.7.egg - Processing dependencies for xdevice==0.0.0 - Searching for pyserial==3.4 - Best match: pyserial 3.4 - Processing pyserial-3.4-py3.7.egg - pyserial 3.4 is already the active version in easy-install.pth - Installing miniterm.py script to D:\Programs\Python37\Scripts - - Using d:\programs\python37\lib\site-packages\pyserial-3.4-py3.7.egg - Finished processing dependencies for xdevice==0.0.0 - ``` - -2. 修改developertest/config/user\_config.xml 文件配置developertest组件。 - 1. 测试框架通用配置。 - - \[build\] \# 配置测试用例的编译参数，例如： - - ``` - - false - false - true - ... ... - - ``` - - >![](../public_sys-resources/icon-note.gif) **说明：** - >测试用例的编译参数说明如下： - >example：是否编译测试用例示例，默认false。 - >version：是否编译测试版本，默认false。 - >testcase：是否编译测试用例，默认true。 - - 2. 支持hdc连接的被测设备。 - - \[device\] \# 配置标签为usb-hdc的环境信息，测试设备的IP地址和hdc映射的端口号，例如： - - ``` - - 192.168.1.1 - 9111 - - - ``` - - 3. 仅支持串口的被测设备。 - - \[board\_info\] \# 开发板配置信息，例如： - - ``` - - hispark - taurus - ipcamera - hb build - - ``` - - >![](../public_sys-resources/icon-note.gif) **说明：** - >开发板配置信息如下： - >board\_series：开发板系列，默认hispark。 - >board\_type：开发板类型，默认taurus。 - >board\_product：目标产品，默认ipcamera。 - >build\_command：测试版本和用例的编译命令，默认hb build。 - - \[device\] \# 配置标签为ipcamera的串口信息，COM口和波特率，例如： - - ``` - - - COM1 - cmd - 115200 - 8 - 1 - 1 - - - ``` - -3. （可选）修改developertest组件配置。如果测试用例已完成编译，可以直接指定测试用例的编译输出路径，测试平台执行用例时即不会重新编译测试用例。 - - 配置文件：config/user\_config.xml - - 1. \[test\_cases\] \# 指定测试用例的输出路径，编译输出目录，例如： - - ``` - - /home/opencode/out/release/tests - - ``` - - 2. \[NFS\] \# 被测设备仅支持串口时配置，指定NFS的映射路径，host\_dir为PC侧的NFS目录，board\_dir为板侧创建的目录，例如： - - ``` - - D:\nfs - user - - ``` - -4. （可选）测试环境准备。当被测设备仅支持串口时，需要检查。 - - 系统镜像与文件系统已烧录进开发板，开发板上系统正常运行，在系统模式下，如使用shell登录时，设备提示符是“OHOS\#”。 - - 开发主机和开发板串口连接正常，网口连接正常。 - - 开发主机IP与开发板IP处在同一小网网段，相互可以ping通。 - - 开发主机侧创建空目录用于开发板通过NFS挂载测试用例，并且NFS服务启动正常。 - -5. （必选）启动测试平台，执行测试用例。 - - 启动测试框架，打开test/developertest目录，执行启动脚本。 - 1. Windows环境启动测试框架，执行如下脚本： - ``` - start.bat - ``` - 2. Linux环境启动测试框架。 - ``` - ./start.sh - ``` - - 设备形态选择。 - 根据实际的开发板选择，设备形态配置：developertest/config/framework\_config.xml。 - - 执行测试指令。 - 1. 查询测试用例支持的子系统，模块，产品形态以及测试类型，使用show命令，示例如下： - ``` - usage: - show productlist Querying Supported Product Forms - show typelist Querying the Supported Test Type - show subsystemlist Querying Supported Subsystems - show modulelist Querying Supported Modules - ``` - 2. 执行测试指令，其中-t为必选，-ss和-tm为可选字段，示例如下： - - ``` - run -t ut -ss subsystem_examples -tm calculator - ``` - - 3. 参数说明：指定参数可以执行特定特性、模块对应的测试套。 - - ``` - usage: run [-h] [-p PRODUCTFORM] [-t [TESTTYPE [TESTTYPE ...]]] - [-ss SUBSYSTEM] [-tm TESTMODULE] [-ts TESTSUIT] - [-tc TESTCASE] [-tl TESTLEVEL] - - optional arguments: - -h, --help show this help message and exit - -p PRODUCTFORM, --productform PRODUCTFORM Specified product form - -t [TESTTYPE [TESTTYPE ...]], --testtype [TESTTYPE [TESTTYPE ...]] - Specify test type(UT,MST,ST,PERF,ALL) - -ss SUBSYSTEM, --subsystem SUBSYSTEM Specify test subsystem - -tm TESTMODULE, --testmodule TESTMODULE Specified test module - -ts TESTSUIT, --testsuite TESTSUIT Specify test suite - -tc TESTCASE, --testcase TESTCASE Specify test case - -tl TESTLEVEL, --testlevel TESTLEVEL Specify test level - ``` - - - 测试框架帮助。 - - 帮助指令，用于查询测试平台支持哪些测试指令，如下： - - ``` - help - ``` - - - 退出自测试平台。 - - 退出自测试平台，使用如下命令退出测试平台，如下： - - ``` - quit - ``` - -6. （必选）查看测试结果与日志，通过在测试平台中执行测试指令，即可在developertest/reports目录下生成测试日志和测试报告。 - - 测试用例的结果会直接显示在控制台上，执行一次的测试结果根路径如下： - - ``` - reports/xxxx-xx-xx-xx-xx-xx - ``` - - - 测试用例格式化结果目录如下： - - ``` - result/ - ``` - - - 测试用例日志目录如下： - - ``` - log/plan_log_xxxx-xx-xx-xx-xx-xx.log - ``` - - - 测试报告汇总： - - ``` - summary_report.html - ``` - - - 测试报告详情： - - ``` - details_report.html - ``` - - - 测试平台日志目录如下： - - ``` - reports/platform_log_xxxx-xx-xx-xx-xx-xx.log - ``` - - - -## 包结构说明 - -开发者测试平台xdevice组件包结构说明，代码目录test/xdevice，详见下表所示： - -**表 4** xdevice组件包结构说明 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

名称

-

功能描述

-

xdevice

-

测试平台基础组件。

-

xdevice/src/xdevice

-

基础测试框架源码。

-

xdevice/config

-

基础测试框架配置文件定义。

-

xdevice/src/xdevice/__main__.py

-

基础测试框架内部入口。

-

xdevice/src/xdevice/__init__.py

-

包依赖定义，插件依赖。

-

xdevice/src/xdevice/variables.py

-

全局变量定义。

-

xdevice/src/xdevice/_core/command

-

用例输入的命令行处理。

-

xdevice/src/xdevice/_core/config

-

基础测试框架的配置管理。

-

xdevice/src/xdevice/_core/environment

-

基础测试框架的环境管理，包括设备管理。

-

xdevice/src/xdevice/_core/executor

-

基础测试框架用例调度和分发。

-

xdevice/src/xdevice/_core/driver

-

基础测试框架测试执行器。

-

xdevice/src/xdevice/_core/resource

-

基础测试框架资源文件以及测试报告模板。

-

xdevice/src/xdevice/_core/testkit

-

基础测试框架公共操作，包括NFS文件系统挂载等。

-

xdevice/src/xdevice/_core/logger.py

-

基础测试框架日志管理。

-

xdevice/src/xdevice/_core/plugin.py

-

基础测试框架插件管理。

-

xdevice/src/xdevice/_core/interface.py

-

基础测试框架插件接口定义。

-

xdevice/setup.py

-

基础测试框架的安装脚本。

-

xdevice/run.bat

-

基础测试框架启动脚本（Windows）。

-

xdevice/run.sh

-

基础测试框架启动脚本（Linux）。

-
- -开发者测试平台developertest组件包结构说明，代码目录test/developertest，详见下表所示： - -**表 5** developertest组件包结构说明 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

名称

-

描述

-

developertest

-

开发测试框架。

-

developertest/src

-

测试框架源码。

-

developertest/src/core

-

测试执行器。

-

developertest/src/core/build

-

测试用例编译。

-

developertest/src/core/command

-

对用户输入的命令行处理。

-

developertest/src/core/config

-

测试框架配置管理。

-

developertest/src/core/driver

-

测试框架驱动执行器。

-

developertest/src/core/resource

-

测试框架配置文件。

-

developertest/src/core/testcase

-

测试用例管理。

-

developertest/src/core/common.py

-

测试框架公共操作。

-

developertest/src/core/constants.py

-

测试框架全局常量。

-

developertest/src/core/exception.py

-

测试框架异常定义。

-

developertest/src/core/utils.py

-

测试框架工具方法。

-

developertest/src/main

-

测试框架平台。

-

developertest/src/main/__main__.py

-

测试框架内部入口。

-

developertest/examples

-

测试框架demo用例。

-

developertest/third_party

-

测试框架依赖第三方组件适配。

-

developertest/BUILD.gn

-

测试子系统编译配置。

-

developertest/start.bat

-

开发者测试入口（Windows）。

-

developertest/start.sh

-

开发者测试入口（Linux）。

-