XTS认证子系统开发指南

• 简介

• 设备类型

• 目录

• 约束

• 使用说明

• 用例开发指导

  • C语言用例开发编译指导（适用于轻量系统类设备产品用例开发）
  • C语言用例执行指导（适用于轻量系统类设备产品用例开发）

• 相关仓

简介

XTS子系统是OpenHarmony生态认证测试套件的集合，当前包括acts（application compatibility test suite）应用兼容性测试套件，后续会拓展dcts（device compatibility test suite）设备兼容性测试套件等。

XTS子系统当前包括acts与tools软件包：

• acts，存放acts相关测试用例源码与配置文件，其目的是帮助终端设备厂商尽早发现软件与OpenHarmony的不兼容性，确保软件在整个开发过程中满足OpenHarmony的兼容性要求。
• tools，存放acts相关测试用例开发框架。

设备类型

OpenHarmony支持如下几种设备类型：

• 轻量系统类设备（参考内存≥128KB）

  面向MCU类处理器，例如Arm Cortex-M、RISC-V 32位的设备，资源极其有限，参考内存≥128KB，提供丰富的近距连接能力以及丰富的外设总线访问能力。典型产品有智能家居领域的联接类模组、传感器设备等。联接类模组通常应用在智能物联网设备中，负责实现联接部分的硬件模块，在智能家居领域由厂家集成到其设备中。例如：联接类模组提供WLAN/Bluetooth的接入和数据的联接，模组与厂家家居的芯片通常通过UART或GPIO等总线接口进行通信。

• 小型系统类设备（参考内存≥1MB）

  面向应用处理器，例如Arm Cortex-A的设备，参考内存≥1MB，提供更高的安全能力，提供标准的图形框架，提供视频编解码的多媒体能力。典型产品有智能家居领域的IPCamera、电子猫眼、路由器以及智慧出行域的行车记录仪等。

目录

/test/xts
├── acts                 # 测试代码存放目录
│   └── subsystem       # 大型系统类设备子系统测试用例源码存放目录
│   └── subsystem_lite  # 轻量系统类设备、小型系统类设备子系统测试用例源码存放目录
│   └── BUILD.gn        # 大型系统类设备测试用例编译配置
│   └── build_lite      # 轻量系统类设备、小型系统类设备测试用例编译配置存放目录
│       └── BUILD.gn    # 轻量系统类设备、小型系统类设备测试用例编译配置
└── tools                # 测试工具代码存放目录

约束

轻量系统类设备用例开发语言是C，小型系统类设备用例开发语言是C++。

使用说明

表 1 用例级别说明

表 2 用例粒度说明

表 3 测试类型说明

用例开发指导

根据测试设备选择测试框架和对应测试用例语言。

表 4 设备和测试框架、开发语言对应关系

C语言用例开发编译指导（适用于轻量系统类设备产品用例开发）

示例：轻量系统类设备测试用例开发

当前使用的测试框架是hctest，hctest测试框架支持使用C语言编写测试用例，是在开源测试框架unity的基础上进行增强和适配。

1. 用例目录规范：测试用例存储到test/xts/acts仓中

   ├── acts
   │ └──subsystem_lite
   │ │ └── module_hal
   │ │ │ └── BUILD.gn
   │ │ │ └── src
   │ └──build_lite
   │ │ └── BUILD.gn

2. src目录下用例编写样例。

   1.引用测试框架

   #include "hctest.h"
   2. 使用宏定义LITE_TEST_SUIT定义子系统、模块、测试套件名称

   /**  
   * @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);
   3. 定义Setup与TearDown

   命名方式：测试套件名称+Setup，测试套件名称+TearDown。

   Setup与TearDown必须存在，可以为空函数。

   4. 使用宏定义LITE_TEST_CASE写测试用例

   包括三个参数：测试套件名称，测试用例名称，用例属性（测试类型、用例粒度、用例级别）。

   LITE_TEST_CASE(IntTestSuite, TestCase001, Function | MediumTest | Level1) 
   {  
     //do something 
   };
   5. 使用宏定义 RUN_TEST_SUITE注册测试套件

   RUN_TEST_SUITE(IntTestSuite);

3. 测试模块的配置文件（BUILD.gn）样例：

   在每个测试模块目录下新建BUILD.gn编译文件，用于指定编译后静态库的名称、依赖的头文件、依赖的库等；具体写法如下：

   import("//test/xts/tools/lite/build/suite_lite.gni")
   hctest_suite("ActsDemoTest") {
       suite_name = "acts"
       sources = [
           "src/test_demo.c",
       ]
       include_dirs = [ ]
       cflags = [ "-Wno-error" ]
   }

4. acts下BUILD.gn增加编译选项。

   需要将测试模块加入到acts目录下的编译脚本中，编译脚本路径：test/xts/acts/build_lite/BUILD.gn。

   lite_component("acts") {  
       ...
       if(board_name == "liteos_m") {
           features += [    
               ...
               "//xts/acts/subsystem_lite/module_hal:ActsDemoTest"
           ]    
       }
   }

5. 测试套件编译命令。

   随版本编译，debug版本编译时会同步编译acts测试套件

   说明： acts测试套件编译中间件为静态库，最终链接到版本镜像中 。

C语言用例执行指导（适用于轻量系统类设备产品用例开发）

示例：轻量系统类设备测试用例执行

将版本镜像烧录进开发板。

测试步骤

1. 使用串口工具登录开发板，并保存串口打印信息。
2. 重启设备，查看串口日志。

测试结果分析指导

基于串口打印日志进行分析；

每个测试套件执行以Start to run test suite开始，以xx Tests xx Failures xx Ignored结束。

相关仓

xts_acts

xts_tools