移植案例与原理 - XTS子系统之应用兼容性测试用例开发

XTS（X Test Suite）子系统是OpenHarmony生态认证测试套件的集合，当前包括：

• acts（application compatibility test suite）应用兼容性测试套件，看护北向HAP兼容、OpenHarmony开发API兼容。

• hats（Hardware Abstraction Test Suite ）硬件抽象测试套，看护HDI层接口。

• dcts（Distributed Compatibility Test Suite ）分布式兼容性测试套，看护分布式兼容（待上线）

在移植芯片开发板后，需要运行应用兼容性测试套件。对于大部分工程师，是不需要开发ACTS测试用例的。但是了解一下这些知识，在问题定位等会带来极大的方便。本文主要介绍下ACTS应用兼容性测试用例开发编译。使用的编程语言为C语言。

1、XTS测试套件目录

XTS的ACTS应用兼容性测试套件目录test\xts\acts，器目录如下，包含各个子系统的测试用例源代码及测试工具代码。

/test/xts
├── acts                         # 测试代码存放目录
│   └── aafwk                    #  标准系统的 元能力框架子系统 测试用例源码存放目录
│   └── aafwk_lite               # 轻量系统、小型系统的 元能力框架 子系统测试用例源码存放目录
│   └── communication            #  标准系统的 communication子系统 测试用例源码存放目录
│   └── communication_lite       # 轻量系统、小型系统的 communication 子系统测试用例源码存放目录
|   └── .......                  # 其他子系统的测试用例源码存放目录
│   └── BUILD.gn                 # 标准系统测试用例编译配置
│   └── build_lite               # 轻量系统、小型系统测试用例编译配置存放目录
│       └── BUILD.gn             # 轻量系统、小型系统测试用例编译配置
└── tools                        # 测试工具代码存放目录

2、测试用例级别、粒度和类型

测试用例分为5个级别，分布为Level0、Level1、Level2、Level3、Level4，这几个宏定义在文件test\xts\tools\lite\hctest\include\hctest_internal.h。对这几个级别的解释可以从文章尾部的参考站点上可以了解。

/**
  * test case level
  */
enum TestRank {
    Level0 = 1,
    Level1 = 2,
    Level2 = 3,
    Level3 = 4,
    Level4 = 5
};

用例粒度分为LargeTest、MediumTest和SmallTest，同样在文件test\xts\tools\lite\hctest\include\hctest_internal.h中定义。

/**
 * test size
 */
enum TestSize {
    SmallTest = 1 << 4,
    MediumTest = 2 << 4,
    LargeTest = 3 << 4
};

测试类型分为Function、Performance、Power、Reliability、Security、Global、Compatibility、User、Standard、Safety和Resilience。宏定义如下，具体含义见参考站点中链接。

/**
 * test type
 */
enum