同步操作将从 OpenHarmony/xts_hats 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
XTS子系统是OpenHarmony生态认证测试套件的集合,当前包括hats(hardware abstract test suite),HAL兼容性测试套件。
XTS子系统当前包括hats与tools软件包:
更多XTS子系统相关概念,请参考:xts_acts/README_zh.md。
OpenHarmony支持如下几种系统类型:
轻量系统(mini system)
面向MCU类处理器例如Arm Cortex-M、RISC-V 32位的设备,硬件资源极其有限,支持的设备最小内存为128KiB,可以提供多种轻量级网络协议,轻量级的图形框架,以及丰富的IOT总线读写部件等。可支撑的产品如智能家居领域的连接类模组、传感器设备、穿戴类设备等。
小型系统(small system)
面向应用处理器例如Arm Cortex-A的设备,支持的设备最小内存为1MiB,可以提供更高的安全能力、标准的图形框架、视频编解码的多媒体能力。可支撑的产品如智能家居领域的IP Camera、电子猫眼、路由器以及智慧出行领域的行车记录仪等。
标准系统(standard system)
面向应用处理器例如Arm Cortex-A的设备,支持的设备最小内存为128MiB,可以提供增强的交互能力、3D GPU以及硬件合成能力、更多控件以及动画效果更丰富的图形能力、完整的应用框架。可支撑的产品如高端的冰箱显示屏。
/test/xts
├── hats # 测试代码存放目录
│ └── subsystem # 标准系统子系统测试用例源码存放目录
│ └── subsystem_lite # 轻量系统、小型系统子系统测试用例源码存放目录
│ └── BUILD.gn # 标准系统测试用例编译配置
│ └── build_lite # 轻量系统、小型系统测试用例编译配置存放目录
│ └── BUILD.gn # 轻量系统、小型系统测试用例编译配置
└── tools # 测试工具代码存放目录
轻量系统用例开发语言是C,小型系统用例开发语言是C++。
表 1 用例级别说明
表 2 用例粒度说明
表 3 测试类型说明
根据测试系统选择测试框架和对应测试用例语言。
表 4 系统和测试框架、开发语言对应关系
示例:轻量系统测试用例开发
当前使用的测试框架是hctest,hctest测试框架支持使用C语言编写测试用例,在开源测试框架unity的基础上进行了增强和适配。
用例目录规范:测试用例存储到test/xts/hats仓中
├── hats
│ └──subsystem_lite
│ │ └── module_hal
│ │ │ └── BUILD.gn
│ │ │ └── src
│ └──build_lite
│ │ └── BUILD.gn
src目录下用例编写样例。
1.引用测试框架
#include"hctest.h"
/**
* @brief register a test suit named "IntTestSuite"
* @param test subsystem name
* @param example module name
* @param IntTestSuite test suit name
*/
LITE_TEST_SUIT(test, example, IntTestSuite);
命名方式:测试套件名称+Setup,测试套件名称+TearDown。
Setup与TearDown必须存在,可以为空函数。
包括三个参数:测试套件名称,测试用例名称,用例属性(测试类型、用例粒度、用例级别)。
LITE_TEST_CASE(IntTestSuite, TestCase001, Function | MediumTest | Level1)
{
//do something
};
RUN_TEST_SUITE(IntTestSuite);
测试模块的配置文件(BUILD.gn)样例:
在每个测试模块目录下新建BUILD.gn编译文件,用于指定编译后静态库的名称、依赖的头文件、依赖的库等;具体写法如下:
import("//test/xts/tools/lite/build/suite_lite.gni")
hctest_suite("HatsDemoTest") {
suite_name = "hats"
sources = [
"src/test_demo.cpp",
]
include_dirs = [ ]
cflags = [ "-Wno-error" ]
}
hats下BUILD.gn增加编译选项。
需要将测试模块加入到hats目录下的编译脚本中,编译脚本路径:test/xts/hats/build_lite/BUILD.gn。
lite_component("hats") {
...
if(board_name == "liteos_m") {
features += [
...
"//xts/hats/subsystem_lite/module_hal:HatsDemoTest"
]
}
}
示例:轻量系统测试用例执行
将版本镜像烧录进开发板。
测试步骤
测试结果分析指导
基于串口打印日志进行分析。
执行每个测试套件以Start to run test suite开始,以xx Tests xx Failures xx Ignored结束。
示例:小型系统测试用例开发(标准系统参考具体样例目录:global/i18n_standard)
当前使用的测试框架是hcpptest,hcpptest测试框架在开源的googletest测试框架的基础上进行了增强和适配。
规范用例目录:测试用例存储到test/xts/hats仓中:
├── hats
│ └──subsystem_lite
│ │ └── module_posix
│ │ │ └── BUILD.gn
│ │ │ └── src
│ └──build_lite
│ │ └── BUILD.gn
测试模块src下用例编写样例:
需要引用gtest.h 如:#include "gtest/gtest.h"
#include "gtest/gtest.h"
using namespace std;
using namespace testing::ext;
class TestSuite: public testing::Test {
protected:
// Preset action of the test suite, which is executed before the first test case
static void SetUpTestCase(void){
}
// Test suite cleanup action, which is executed after the last test case
static void TearDownTestCase(void){
}
// Preset action of the test case
virtual void SetUp()
{
}
// Cleanup action of the test case
virtual void TearDown()
{
}
};
普通测试用例的定义:HWTEST(测试套名称, 测试用例名称, 用例标注)。
包含SetUp和TearDown的测试用例的定义 :HWTEST_F(测试套名称, 测试用例名称, 用例标注)。
宏定义包括三个参数:测试套件名称,测试用例名称,用例属性(测试类型、用例粒度、用例级别)。
HWTEST_F(TestSuite, TestCase_0001, Function | MediumTest | Level1) {
// do something
}
测试模块下用例配置文件(BUILD.gn)样例:
每个测试模块目录下新建BUILD.gn编译文件,用于指定编译后可执行文件的名称、依赖的头文件、依赖的库等;具体写法如下。每个测试模块将独立编译成.bin可执行文件, 该文件可直接push到单板上进行测试。
举例:
import("//test/xts/tools/lite/build/suite_lite.gni")
hcpptest_suite("HatsDemoTest") {
suite_name = "hats"
sources = [
"src/TestDemo.cpp"
]
include_dirs = [
"src",
...
]
deps = [
...
]
cflags = [ "-Wno-error" ]
}
hats目录下增加编译选项(BUILD.gn)样例:
将测试模块加入到hats目录下的编译脚本中,编译脚本为:test/xts/hats/build_lite/BUILD.gn。
lite_component("hats") {
...
else if(board_name == "liteos_a") {
features += [
...
"//xts/hats/subsystem_lite/module_posix:HatsDemoTest"
]
}
}
示例:小型系统测试用例执行
目前执行用例采用nfs共享的方式,mount到单板去执行。
环境搭建
使用网线或无线网络将开发板与PC进行连接。
开发板配置IP、子网掩码、网关,确保开发板与PC处于同一个网段。
PC安装nfs服务器并完成注册,启动nfs服务。
开发板配置mount命令,确保开发板可以访问PC端的nfs共享文件。
格式:mount [nfs服务器IP]:[/nfs共享目录] [/开发板目录] nfs
举例:
mount 192.168.1.10:/nfs /nfs nfs
用例执行
测试套件执行 HatsDemoTest.bin 触发用例执行,基于串口打印日志进行分析。
全量编译test/xts/hats目录下执行编译命令:./build.sh product_name=hispark_taurus_standard suite=hats system_size=standard
测试用例输出目录:out/hispark_taurus/suites/hats/testcases
测试框架&用例整体输出目录:out/hispark_taurus/suites/hats(编译用例时会同步编译测试套执行框架)
Windows工作台下安装python3.7及以上版本,确保工作台和测试设备正常连接。
注:高版本python不带 easy_install,可以安装低于 52.0.0 的 setuptools,解决该问题。
pip install setuptools==50.0.0
测试执行目录(对应编译生成的out/hispark_taurus/suites/hats目录)
├── testcase # 测试套文件存放目录
│ └──xxx # 测试套可执行二进制文件
│ └──xxx.json # 测试套对应执行配置文件
├── tools # 测试框架工具目录
├── run.bat # window平台测试套启动执行文件
├── report # 测试报告生成目录
用例执行
在Windows工作台上,找到从Linux服务器上拷贝下来的测试套件用例目录,在Windows命令窗口进入对应目录,直接执行hats\run.bat。
界面启动后,输入用例执行指令。
全量执行:run hats
模块执行(具体模块可以查看\hats\testcases):run –l HatsHdfInputTest
查看测试报告。 进入hats\reports\,获取当前的执行记录,打开“summary_report.html”可以获取到测试报告。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。