1# XTS子系统<a name="ZH-CN_TOPIC_0000001117409671"></a> 2 3- [简介](#section465982318513) 4- [系统类型](#section125090457443) 5- [目录](#section161941989596) 6- [约束](#section119744591305) 7- [使用说明](#section137768191623) 8- [用例开发指导](#section3695134065513) 9 - [C语言用例开发编译指导（适用于轻量系统产品用例开发）](#section198193336544) 10 - [C语言用例执行指导（适用于轻量系统产品用例开发）](#section13820233175418) 11 - [C++语言用例开发编译指导（适用于小型系统、标准系统用例开发）](#section3822123311540) 12 - [C++语言用例执行指导（适用于小型系统、标准系统用例开发）](#section128222336544) 13 14- [相关仓](#section1371113476307) 15 16## 简介<a name="section465982318513"></a> 17 18XTS子系统是OpenHarmony生态认证测试套件的集合，当前包括dcts（distributed compatibility test suite）分布式兼容性测试套件。 19 20XTS子系统当前包括dcts与tools软件包： 21 22- dcts，存放dcts相关测试用例源码与配置文件，其目的是帮助终端设备厂商尽早发现在分布式场景下与OpenHarmony的不兼容性，确保软件在整个开发过程中满足OpenHarmony的兼容性要求。 23- tools，存放dcts相关测试用例开发框架。 24 25## 系统类型<a name="section125090457443"></a> 26 27OpenHarmony支持如下几种系统类型： 28 29- 轻量系统（mini system） 30 31 面向MCU类处理器例如Arm Cortex-M、RISC-V 32位的设备，硬件资源极其有限，支持的设备最小内存为128KiB，可以提供多种轻量级网络协议，轻量级的图形框架，以及丰富的IOT总线读写部件等。可支撑的产品如智能家居领域的连接类模组、传感器设备、穿戴类设备等。 32 33- 小型系统（small system） 34 35 面向应用处理器例如Arm Cortex-A的设备，支持的设备最小内存为1MiB，可以提供更高的安全能力、标准的图形框架、视频编解码的多媒体能力。可支撑的产品如智能家居领域的IP Camera、电子猫眼、路由器以及智慧出行领域的行车记录仪等。 36 37- 标准系统（standard system） 38 39 面向应用处理器例如Arm Cortex-A的设备，支持的设备最小内存为128MiB，可以提供增强的交互能力、3D GPU以及硬件合成能力、更多控件以及动画效果更丰富的图形能力、完整的应用框架。可支撑的产品如高端的冰箱显示屏。 40 41 42## 目录<a name="section161941989596"></a> 43 44``` 45/test/xts 46├── dcts # 测试代码存放目录 47│ └── subsystem # 标准系统子系统测试用例源码存放目录 48│ └── subsystem_lite # 轻量系统、小型系统子系统测试用例源码存放目录 49│ └── common # 测试用例依赖共享内存源码存放目录 50│ └── BUILD.gn # 标准系统测试用例编译配置 51│ └── build_lite # 轻量系统、小型系统测试用例编译配置存放目录 52│ └── BUILD.gn # 轻量系统、小型系统测试用例编译配置 53└── tools # 测试工具代码存放目录 54``` 55 56## 约束<a name="section119744591305"></a> 57 58轻量系统用例开发语言是C，小型系统用例开发语言是C++。 59 60## 使用说明<a name="section137768191623"></a> 61 62**表 1** 用例级别说明 63 64<a name="table12856113719456"></a> 65<table><thead align="left"><tr id="row88561737114517"><th class="cellrowborder" valign="top" width="33.333333333333336%" id="mcps1.2.4.1.1"><p id="p54711456452"><a name="p54711456452"></a><a name="p54711456452"></a>级别名称</p> 66</th> 67<th class="cellrowborder" valign="top" width="33.283328332833285%" id="mcps1.2.4.1.2"><p id="p114834544518"><a name="p114834544518"></a><a name="p114834544518"></a>基本定义</p> 68</th> 69<th class="cellrowborder" valign="top" width="33.383338333833386%" id="mcps1.2.4.1.3"><p id="p348154574518"><a name="p348154574518"></a><a name="p348154574518"></a>测试范围</p> 70</th> 71</tr> 72</thead> 73<tbody><tr id="row78561137134514"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.2.4.1.1 "><p id="p17481345124512"><a name="p17481345124512"></a><a name="p17481345124512"></a>Level0</p> 74</td> 75<td class="cellrowborder" valign="top" width="33.283328332833285%" headers="mcps1.2.4.1.2 "><p id="p1548945204514"><a name="p1548945204514"></a><a name="p1548945204514"></a>冒烟</p> 76</td> 77<td class="cellrowborder" valign="top" width="33.383338333833386%" headers="mcps1.2.4.1.3 "><p id="p174824517456"><a name="p174824517456"></a><a name="p174824517456"></a>验证关键功能点基本功能/最基本DFX属性在最常见输入下的表现，通过表示功能基本可运行。</p> 78</td> 79</tr> 80<tr id="row28563372451"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.2.4.1.1 "><p id="p448445144512"><a name="p448445144512"></a><a name="p448445144512"></a>Level1</p> 81</td> 82<td class="cellrowborder" valign="top" width="33.283328332833285%" headers="mcps1.2.4.1.2 "><p id="p44813452452"><a name="p44813452452"></a><a name="p44813452452"></a>基本</p> 83</td> 84<td class="cellrowborder" valign="top" width="33.383338333833386%" headers="mcps1.2.4.1.3 "><p id="p648184584514"><a name="p648184584514"></a><a name="p648184584514"></a>验证各功能点基本功能/基本DFX属性在常见输入下的表现，通过表示功能基本可测试。</p> 85</td> 86</tr> 87<tr id="row12856137204514"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.2.4.1.1 "><p id="p164834520453"><a name="p164834520453"></a><a name="p164834520453"></a>Level2</p> 88</td> 89<td class="cellrowborder" valign="top" width="33.283328332833285%" headers="mcps1.2.4.1.2 "><p id="p148245184511"><a name="p148245184511"></a><a name="p148245184511"></a>重要</p> 90</td> 91<td class="cellrowborder" valign="top" width="33.383338333833386%" headers="mcps1.2.4.1.3 "><p id="p348945124510"><a name="p348945124510"></a><a name="p348945124510"></a>验证各功能点的基本功能/基本DFX属性在常规输入/常见异常情况下的表现，通过表示功能基本正常可用，可开展Beta。</p> 92</td> 93</tr> 94<tr id="row48571137204514"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.2.4.1.1 "><p id="p7481545184513"><a name="p7481545184513"></a><a name="p7481545184513"></a>Level3</p> 95</td> 96<td class="cellrowborder" valign="top" width="33.283328332833285%" headers="mcps1.2.4.1.2 "><p id="p1748184514455"><a name="p1748184514455"></a><a name="p1748184514455"></a>一般</p> 97</td> 98<td class="cellrowborder" valign="top" width="33.383338333833386%" headers="mcps1.2.4.1.3 "><p id="p8481245104519"><a name="p8481245104519"></a><a name="p8481245104519"></a>验证各功能点的全部功能/全部DFX属性在各种常规/非常规输入组合下，或各种正常/异常预置条件组合下的表现。</p> 99</td> 100</tr> 101<tr id="row14857133712451"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.2.4.1.1 "><p id="p1248144515456"><a name="p1248144515456"></a><a name="p1248144515456"></a>Level4</p> 102</td> 103<td class="cellrowborder" valign="top" width="33.283328332833285%" headers="mcps1.2.4.1.2 "><p id="p94804514519"><a name="p94804514519"></a><a name="p94804514519"></a>生僻</p> 104</td> 105<td class="cellrowborder" valign="top" width="33.383338333833386%" headers="mcps1.2.4.1.3 "><p id="p1248445164516"><a name="p1248445164516"></a><a name="p1248445164516"></a>验证关键功能点在极端异常预置条件下、用户难以触及的异常输入组合下的表现。</p> 106</td> 107</tr> 108</tbody> 109</table> 110 111**表 2** 用例粒度说明 112 113<a name="table1690733521014"></a> 114<table><thead align="left"><tr id="row9907143516105"><th class="cellrowborder" valign="top" width="19.591959195919593%" id="mcps1.2.4.1.1"><p id="p1141312416102"><a name="p1141312416102"></a><a name="p1141312416102"></a>用例规模</p> 115</th> 116<th class="cellrowborder" valign="top" width="35.17351735173517%" id="mcps1.2.4.1.2"><p id="p34131416109"><a name="p34131416109"></a><a name="p34131416109"></a>被测试对象</p> 117</th> 118<th class="cellrowborder" valign="top" width="45.23452345234523%" id="mcps1.2.4.1.3"><p id="p12413141171010"><a name="p12413141171010"></a><a name="p12413141171010"></a>测试环境</p> 119</th> 120</tr> 121</thead> 122<tbody><tr id="row2907335181017"><td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.2.4.1.1 "><p id="p6414134117109"><a name="p6414134117109"></a><a name="p6414134117109"></a>LargeTest</p> 123</td> 124<td class="cellrowborder" valign="top" width="35.17351735173517%" headers="mcps1.2.4.1.2 "><p id="p20414104113101"><a name="p20414104113101"></a><a name="p20414104113101"></a>业务功能/全场景特性/整机及场景级DFX</p> 125</td> 126<td class="cellrowborder" valign="top" width="45.23452345234523%" headers="mcps1.2.4.1.3 "><p id="p5414841121013"><a name="p5414841121013"></a><a name="p5414841121013"></a>尽量使用贴近真实的环境设备</p> 127</td> 128</tr> 129<tr id="row10907635131015"><td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.2.4.1.1 "><p id="p19414134117104"><a name="p19414134117104"></a><a name="p19414134117104"></a>MediumTest</p> 130</td> 131<td class="cellrowborder" valign="top" width="35.17351735173517%" headers="mcps1.2.4.1.2 "><p id="p114141241141018"><a name="p114141241141018"></a><a name="p114141241141018"></a>模块/子系统集成至设备后的功能/DFX</p> 132</td> 133<td class="cellrowborder" valign="top" width="45.23452345234523%" headers="mcps1.2.4.1.3 "><p id="p14414941111015"><a name="p14414941111015"></a><a name="p14414941111015"></a>使用真实的单设备进行验证，可进行消息模拟，尽量不对函数进行MOCK</p> 134</td> 135</tr> 136<tr id="row1990713353100"><td class="cellrowborder" valign="top" width="19.591959195919593%" headers="mcps1.2.4.1.1 "><p id="p641414110109"><a name="p641414110109"></a><a name="p641414110109"></a>SmallTest</p> 137</td> 138<td class="cellrowborder" valign="top" width="35.17351735173517%" headers="mcps1.2.4.1.2 "><p id="p54141541181018"><a name="p54141541181018"></a><a name="p54141541181018"></a>模块/类/函数</p> 139</td> 140<td class="cellrowborder" valign="top" width="45.23452345234523%" headers="mcps1.2.4.1.3 "><p id="p1841494131013"><a name="p1841494131013"></a><a name="p1841494131013"></a>在开发者个人环境进行测试，尽量不依赖其他模块，存在大量的MOCK</p> 141</td> 142</tr> 143</tbody> 144</table> 145 146**表 3** 测试类型说明 147 148<a name="table18811230124619"></a> 149<table><thead align="left"><tr id="row48163019466"><th class="cellrowborder" valign="top" width="19.040000000000003%" id="mcps1.2.3.1.1"><p id="p1791784418465"><a name="p1791784418465"></a><a name="p1791784418465"></a>测试类型名称</p> 150</th> 151<th class="cellrowborder" valign="top" width="80.96%" id="mcps1.2.3.1.2"><p id="p2917164444614"><a name="p2917164444614"></a><a name="p2917164444614"></a>测试类型定义</p> 152</th> 153</tr> 154</thead> 155<tbody><tr id="row682630104615"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p1091784414469"><a name="p1091784414469"></a><a name="p1091784414469"></a>Function</p> 156</td> 157<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p16917344104618"><a name="p16917344104618"></a><a name="p16917344104618"></a>验证被测对象提供给用户的业务功能实现正确性的测试项，这里的“用户”可以是终端用户或开发者，功能包括业务功能及平台功能</p> 158</td> 159</tr> 160<tr id="row1821930154611"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p591714474612"><a name="p591714474612"></a><a name="p591714474612"></a>Performance</p> 161</td> 162<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p15917154410463"><a name="p15917154410463"></a><a name="p15917154410463"></a>验证被测对象在特定预置条件/负载模型下的处理能力的测试项，“处理能力”一般以单位时间内可处理的业务量来衡量，如呼叫/秒，帧率/秒，事件处理量/秒等</p> 163</td> 164</tr> 165<tr id="row13821030104616"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p691711440467"><a name="p691711440467"></a><a name="p691711440467"></a>Power</p> 166</td> 167<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p159171544104616"><a name="p159171544104616"></a><a name="p159171544104616"></a>验证被测对象在特定预置条件/负载模型下在一定时间内能源消耗量的测试项</p> 168</td> 169</tr> 170<tr id="row6821330114618"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p13917164454612"><a name="p13917164454612"></a><a name="p13917164454612"></a>Reliability</p> 171</td> 172<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p11917194416465"><a name="p11917194416465"></a><a name="p11917194416465"></a>验证被测对象在正常/异常输入情况下，或业务量压力和长时间连续运行压力情况下业务表现的测试项，含稳定性、压力、故障注入、Monkey测试项</p> 173</td> 174</tr> 175<tr id="row11821930184612"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p1691774474618"><a name="p1691774474618"></a><a name="p1691774474618"></a>Security</p> 176</td> 177<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p1791784410463"><a name="p1791784410463"></a><a name="p1791784410463"></a>验证系统对恶意威胁的防护能力，威胁包括但不限于未授权访问、使用、泄露、破坏、修改、毁灭，以保障信息的机密性、完整性和可用性; 验证系统对用户隐私的保护能力，保障用户的隐私数据被收集、使用、保有、披露和处置符合法律规范，保障用户的隐私权; 验证对各类安全规范的遵从情况，如安全设计规范、安全红线、工信部安全认证规范等，保障安全相关法律法规的合规。</p> 178</td> 179</tr> 180<tr id="row16825307467"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p129188444462"><a name="p129188444462"></a><a name="p129188444462"></a>Global</p> 181</td> 182<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p179186444465"><a name="p179186444465"></a><a name="p179186444465"></a>验证被测对象在是否具有国际化数据支持和本地化能力的测试项，包括语言显示、输入/输出习惯、时间显示、区域特性如货币时间禁忌等等</p> 183</td> 184</tr> 185<tr id="row08211308464"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p191814447465"><a name="p191814447465"></a><a name="p191814447465"></a>Compatibility</p> 186</td> 187<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p99181344144613"><a name="p99181344144613"></a><a name="p99181344144613"></a>当被测对象为应用时，包括被测对象对于自身数据的后向兼容性、对于系统的前后向兼容性、对于不同用户数据(如播放器之音频文件格式/智能短信之用户短信内容)的兼容性测试项； 当被测对象为系统时，包括被测系统对于系统自身数据的后向兼容性、以及对于生态中常用应用的兼容性测试项；当被测对象为软件时，包括被测系统对于相关的硬件的兼容性；</p> 188</td> 189</tr> 190<tr id="row1782730124618"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p13918144134614"><a name="p13918144134614"></a><a name="p13918144134614"></a>User</p> 191</td> 192<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p1291844494611"><a name="p1291844494611"></a><a name="p1291844494611"></a>验证被测对象在真实用户场景下的用户体验感受的测试项，注意此种情况下没有客观的“正确”与“失败”，所有的结论及评价都应该来自于用户</p> 193</td> 194</tr> 195<tr id="row58243024617"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p1291884474614"><a name="p1291884474614"></a><a name="p1291884474614"></a>Standard</p> 196</td> 197<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p0918124424614"><a name="p0918124424614"></a><a name="p0918124424614"></a>验证被测对象对于行业及公司内标准/协议/规范的遵从情况的测试项，注意此处的“标准”不包含任何安全标准，针对安全标准的测试项划归为“安全测试”类型</p> 198</td> 199</tr> 200<tr id="row382830124619"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p119181044164619"><a name="p119181044164619"></a><a name="p119181044164619"></a>Safety</p> 201</td> 202<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p1291818443468"><a name="p1291818443468"></a><a name="p1291818443468"></a>验证被测对象的Safety属性，避免产品可能对人身安全、健康以及产品本身带来的危害。</p> 203</td> 204</tr> 205<tr id="row1083153014465"><td class="cellrowborder" valign="top" width="19.040000000000003%" headers="mcps1.2.3.1.1 "><p id="p39187441469"><a name="p39187441469"></a><a name="p39187441469"></a>Resilience</p> 206</td> 207<td class="cellrowborder" valign="top" width="80.96%" headers="mcps1.2.3.1.2 "><p id="p891815444462"><a name="p891815444462"></a><a name="p891815444462"></a>验证被测对象的韧性属性，确保系统受攻击时承受并保持在有定义的运行状态（包括降级）、恢复并适应攻击以保障Mission达成。</p> 208</td> 209</tr> 210</tbody> 211</table> 212 213## 用例开发指导<a name="section3695134065513"></a> 214 215根据测试系统选择测试框架和对应测试用例语言。 216 217**表 4** 系统和测试框架、开发语言对应关系 218 219<a name="table4418343171415"></a> 220<table><thead align="left"><tr id="row34183435145"><th class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.2.4.1.1"><p id="p941874311148"><a name="p941874311148"></a><a name="p941874311148"></a>系统</p> 221</th> 222<th class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.2.4.1.2"><p id="p1841804341413"><a name="p1841804341413"></a><a name="p1841804341413"></a>测试框架</p> 223</th> 224<th class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.2.4.1.3"><p id="p2418104311148"><a name="p2418104311148"></a><a name="p2418104311148"></a>语言</p> 225</th> 226</tr> 227</thead> 228<tbody><tr id="row8419164319148"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.1 "><p id="p7419194312143"><a name="p7419194312143"></a><a name="p7419194312143"></a>轻量系统</p> 229</td> 230<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.2 "><p id="p10419124312145"><a name="p10419124312145"></a><a name="p10419124312145"></a>hctest</p> 231</td> 232<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.3 "><p id="p11419643191410"><a name="p11419643191410"></a><a name="p11419643191410"></a>c</p> 233</td> 234</tr> 235<tr id="row141915438147"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.1 "><p id="p441911436141"><a name="p441911436141"></a><a name="p441911436141"></a>小型系统</p> 236</td> 237<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.2 "><p id="p541916432142"><a name="p541916432142"></a><a name="p541916432142"></a>hcpptest</p> 238</td> 239<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.3 "><p id="p54191643131416"><a name="p54191643131416"></a><a name="p54191643131416"></a>c++</p> 240</td> 241</tr> 242<tr id="row4419134341417"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.1 "><p id="p341964313143"><a name="p341964313143"></a><a name="p341964313143"></a>标准系统</p> 243</td> 244<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.2 "><p id="p10419443171416"><a name="p10419443171416"></a><a name="p10419443171416"></a>HJSUnit、hcpptest</p> 245</td> 246<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.2.4.1.3 "><p id="p9419143181414"><a name="p9419143181414"></a><a name="p9419143181414"></a>js、c++</p> 247</td> 248</tr> 249</tbody> 250</table> 251 252### C语言用例开发编译指导（适用于轻量系统产品用例开发）<a name="section198193336544"></a> 253 254**示例：轻量系统测试用例开发** 255 256当前使用的测试框架是hctest，hctest测试框架支持使用C语言编写测试用例，是在开源测试框架unity的基础上进行增强和适配。 257 2581. 用例目录规范：测试用例存储到test/xts/dcts仓中 259 260 ``` 261 ├── dcts 262 │ └──subsystem_lite 263 │ │ └── module_hal 264 │ │ │ └── BUILD.gn 265 │ │ │ └── src 266 │ └──build_lite 267 │ │ └── BUILD.gn 268 ``` 269 2702. src目录下用例编写样例。 271 272 1.引用测试框架 273 274 ``` 275 #include "hctest.h" 276 ``` 277 278 2. 使用宏定义LITE\_TEST\_SUIT定义子系统、模块、测试套件名称 279 280 ``` 281 /** 282 * @brief register a test suit named "IntTestSuite" 283 * @param test subsystem name 284 * @param example module name 285 * @param IntTestSuite test suit name 286 */ 287 LITE_TEST_SUIT(test, example, IntTestSuite); 288 ``` 289 290 3. 定义Setup与TearDown 291 292 命名方式：测试套件名称+Setup，测试套件名称+TearDown。 293 294 Setup与TearDown必须存在，可以为空函数。 295 296 4. 使用宏定义LITE\_TEST\_CASE写测试用例 297 298 包括三个参数：测试套件名称，测试用例名称，用例属性（测试类型、用例粒度、用例级别）。 299 300 ``` 301 LITE_TEST_CASE(IntTestSuite, TestCase001, Function | MediumTest | Level1) 302 { 303 //do something 304 }; 305 ``` 306 307 5. 使用宏定义 RUN\_TEST\_SUITE注册测试套件 308 309 ``` 310 RUN_TEST_SUITE(IntTestSuite); 311 ``` 312 3133. 测试模块的配置文件（BUILD.gn）样例： 314 315 在每个测试模块目录下新建BUILD.gn编译文件，用于指定编译后静态库的名称、依赖的头文件、依赖的库等；具体写法如下： 316 317 ``` 318 import("//test/xts/tools/lite/build/suite_lite.gni") 319 hctest_suite("DctsDemoTest") { 320 suite_name = "dcts" 321 sources = [ 322 "src/test_demo.c", 323 ] 324 include_dirs = [ ] 325 cflags = [ "-Wno-error" ] 326 } 327 ``` 328 3294. dcts下BUILD.gn增加编译选项。 330 331 需要将测试模块加入到dcts目录下的编译脚本中，编译脚本路径：test/xts/dcts/build\_lite/BUILD.gn。 332 333 ``` 334 lite_component("dcts") { 335 ... 336 if(board_name == "liteos_m") { 337 features += [ 338 ... 339 "//xts/dcts/subsystem_lite/module_hal:DctsDemoTest" 340 ] 341 } 342 } 343 ``` 344 3455. 测试套件编译命令。 346 347 随版本编译，debug版本编译时会同步编译dcts测试套件 348 349 > **说明：** 350 >dcts测试套件编译中间件为静态库，最终链接到版本镜像中 。 351 352 353### C语言用例执行指导（适用于轻量系统产品用例开发）<a name="section13820233175418"></a> 354 355**示例：轻量系统测试用例执行** 356 357将版本镜像烧录进开发板。 358 359**测试步骤** 360 3611. 使用串口工具登录开发板，并保存串口打印信息。 3622. 重启设备，查看串口日志。 363 364**测试结果分析指导** 365 366基于串口打印日志进行分析； 367 368每个测试套件执行以Start to run test suite开始，以xx Tests xx Failures xx Ignored结束。 369 370### C++语言用例开发编译指导（适用于小型系统、标准系统用例开发）<a name="section3822123311540"></a> 371 372**示例：小型系统测试用例开发**（标准系统参考具体样例目录：global/i18n\_standard） 373 374当前使用的测试框架是hcpptest，hcpptest测试框架是在开源的googletest测试框架的基础上进行的增强和适配。 375 3761. 规范用例目录：测试用例存储到test/xts/dcts仓中。 377 378 ``` 379 ├── dcts 380 │ └──subsystem_lite 381 │ │ └── module_posix 382 │ │ │ └── BUILD.gn 383 │ │ │ └── src 384 │ └──build_lite 385 │ │ └── BUILD.gn 386 ``` 387 3882. 测试模块src下用例编写样例： 389 390 1. 引用测试框架： 391 392 需要引用gtest.h 如：\#include "gtest/gtest.h" 393 394 ``` 395 #include "gtest/gtest.h" 396 ``` 397 398 2. 定义Setup与TearDown 399 400 ``` 401 using namespace std; 402 using namespace testing::ext; 403 class TestSuite: public testing::Test { 404 protected: 405 // Preset action of the test suite, which is executed before the first test case 406 static void SetUpTestCase(void){ 407 } 408 // Test suite cleanup action, which is executed after the last test case 409 static void TearDownTestCase(void){ 410 } 411 // Preset action of the test case 412 virtual void SetUp() 413 { 414 } 415 // Cleanup action of the test case 416 virtual void TearDown() 417 { 418 } 419 }; 420 ``` 421 422 3. 使用宏定义HWTEST或HWTEST\_F写测试用例 423 424 普通测试用例的定义：HWTEST（测试套名称， 测试用例名称， 用例标注）。 425 426 包含SetUp和TearDown的测试用例的定义 ：HWTEST\_F（测试套名称， 测试用例名称，用例标注）。 427 428 宏定义包括三个参数：测试套件名称，测试用例名称，用例属性（测试类型、用例粒度、用例级别）。 429 430 ``` 431 HWTEST_F(TestSuite, TestCase_0001, Function | MediumTest | Level1) { 432 // do something 433 } 434 ``` 435 4363. 测试模块下用例配置文件（BUILD.gn）样例： 437 438 每个测试模块目录下新建BUILD.gn编译文件，用于指定编译后可执行文件的名称、依赖的头文件、依赖的库等；具体写法如下。每个测试模块将独立编译成.bin可执行文件， 该文件可直接push到单板上进行测试。 439 440 举例： 441 442 ``` 443 import("//test/xts/tools/lite/build/suite_lite.gni") 444 hcpptest_suite("DctsDemoTest") { 445 suite_name = "dcts" 446 sources = [ 447 "src/TestDemo.cpp" 448 ] 449 450 include_dirs = [ 451 "src", 452 ... 453 ] 454 deps = [ 455 ... 456 ] 457 cflags = [ "-Wno-error" ] 458 } 459 460 ``` 461 4624. dcts目录下增加编译选项（BUILD.gn）样例： 463 464 将测试模块加入到dcts目录下的编译脚本中，编译脚本为：test/xts/dcts/build\_lite/BUILD.gn。 465 466 ``` 467 lite_component("dcts") { 468 ... 469 else if(board_name == "liteos_a") { 470 features += [ 471 ... 472 "//xts/dcts/subsystem_lite/module_posix:DctsDemoTest" 473 ] 474 } 475 } 476 ``` 477 4785. 测试套件编译命令。 479 480 随版本编译，debug版本编译时会同步编译dcts测试套件 481 482 > **说明：** 483 >小型系统dcts独立编译成可执行文件（bin格式）， 在编译产物的suites\\dcts目录下归档。 484 485 486### C++语言用例执行指导（适用于小型系统、标准系统用例开发）<a name="section128222336544"></a> 487 488**示例：小型系统测试用例执行** 489 490目前的用例执行采用nfs共享的方式，mount到单板去执行。 491 492**环境搭建** 493 4941. 使用网线或无线网络将开发板与PC进行连接。 4952. 开发板配置IP、子网掩码、网关，确保开发板与PC处于同一个网段。 4963. PC安装nfs服务器并完成注册，启动nfs服务。 4974. 开发板配置mount命令，确保开发板可以访问PC端的nfs共享文件。 498 499 格式：mount \[nfs服务器IP\]:\[/nfs共享目录\] \[/开发板目录\] nfs 500 501 举例： 502 503 ``` 504 mount 192.168.1.10:/nfs /nfs nfs 505 ``` 506 507 508**用例执行** 509 510测试套件执行 DctsDemoTest.bin 触发用例执行，基于串口打印日志进行分析。 511 512### 全量编译指导（适用于标准系统）<a name="section128222336544"></a> 513 514全量编译test/xts/dcts目录下执行编译命令: ./build.sh suite=dcts system_size=standard 515 516测试用例输出目录：out/release/suites/dcts/testcases 517 518测试框架&用例整体输出目录：out/release/suites/dcts(编译用例时会同步编译测试套执行框架) 519 520### 全量用例执行指导（适用于小型系统、标准系统）<a name="section128222336544"></a> 521 522搭建测试环境 Windows工作台下安装python3.7及以上版本，确保工作台和测试设备正常连接。 523 524测试执行目录（对应编译生成的out/release/suites/dcts目录） 525 526 ``` 527├── testcase # 测试套文件存放目录 528│ └──xxx.hap # 测试套可执行hap文件 529│ └──xxx.json # 测试套对应执行配置文件 530├── tools # 测试框架工具目录 531├── run.bat # window平台测试套启动执行文件 532├── report # 测试报告生成目录 533 534 ``` 535用例执行 536 537在Windows工作台上，找到从Linux服务器上拷贝下来的测试套件用例目录，在Windows命令窗口进入对应目录，直接执行dcts\run.bat。 538 539界面启动后，输入用例执行指令。 540 541全量执行：run dcts 542 543模块执行(具体模块可以查看\dcts\testcases)：run –l DctsSamgrTest 544 545查看测试报告。 进入dcts\reports\，获取当前的执行记录，打开“summary_report.html”可以获取到测试报告。 546 547 548## 相关仓<a name="section1371113476307"></a> 549 550xts\_dcts 551 552xts\_tools 553 554
