OpenHarmony 入门——单元测试UnitTest快速入门

引言

OpenHarmony 的单元测试（UnitTest）是一个关键的软件开发过程，它确保代码的各个部分能够按预期工作，OpenHarmony的测试框架中提供了很多种的单元测试，今天简单介绍下UnitTest 类型的TDD测试。

OpenHarmony 的TDD 测试是支持全自动化测试的，本篇文章介绍的是手动运行测试用例的方式。

一、测试用例的类型和等级

测试用例类型包括功能测试（FUNC）、性能测试（PERF）、可靠性测试（RELI）、安全测试（SECU）等；测试用例等级分为门禁级（Level0）和非门禁级（Level1-Level4），其中 Level1-Level4 等级越低表示功能越重要。

二、 配置编译脚本和bundle.json

单元测试的用例也是需要像普通的功能一样，需要挂靠到对应的子系统上并且在bundle.json中的test 节点下配置触发编译。

#注意区别非单元测试引入的build gn脚本是import("//build/ohos.gni")import("//build/test.gni")
#编译单元测试可执行文件则是通过ohos_unittest
ohos_unittest("NnrtDeviceServiceTest"){
  module_out_path = module_output_path
  
  sources =["nnrt_device_service_test.cpp",]

  configs =[]

  external_deps =[]

  deps =[]}

bundle.json则是在“test” 节点下单独配置：

三、编译指令及运行

编译单元测试的所有用例

./build.sh --product-name rk3568 --target-cpu arm64 --device-typetablet--no-prebuilt-sdk --ccache --build-target make_test

单编指定单元测试用例

drivers/peripheral/nnrt/v2_0/test/unittest/BUILD.gn里的group 节点名为unittest
./build.sh --product-name rk3568 --target-cpu arm64 --device-typetablet--no-prebuilt-sdk --ccache --build-target drivers/peripheral/nnrt/v2_0/test/unittest:unittest

然后就会在：

\out\rk3568tests\unittest\drivers_peripheral_nnrt下生成单元测试用例可执行文件，CHMOD 赋予可执行权限后就可以直接运行了。

三、单元测试的语法

在 OpenHarmony 的单元测试框架中，SetUpTestCase()、TearDownTestCase()、SetUp() 和 TearDown() 是用于设置和清理测试环境的函数，它们在测试的不同阶段被调用。这些函数对于初始化测试资源、配置测试环境以及在测试结束后进行清理和恢复操作非常重要。

classMyTestCase{public:staticvoidSetUpTestCase(){// 测试套件级别的初始化
        HiLog::Info(LABEL,"SetUpTestCase: Initializing test suite environment.");// ... 初始化代码}staticvoidTearDownTestCase(){// 测试套件级别的清理
        HiLog::Info(LABEL,"TearDownTestCase: Cleaning up test suite environment.");// ... 清理代码}voidSetUp(){// 测试用例级别的初始化
        HiLog::Info(LABEL,"SetUp: Initializing test case environment for each test.");// ... 初始化代码}voidTearDown(){// 测试用例级别的清理
        HiLog::Info(LABEL,"TearDown: Cleaning up test case environment after each test.");// ... 清理代码}voidTestFunction1(){// ... 测试代码}voidTestFunction2(){// ... 测试代码}};

1、SetUpTestCase() 和 TearDownTestCase()

SetUpTestCase() 和 TearDownTestCase() 是测试用例级别的设置和清理函数，它们分别在所有测试用例执行之前和之后执行一次。

• SetUpTestCase()：这个函数在测试套件中的所有测试用例执行之前调用。它用于执行一次性的初始化操作，比如创建测试所需的资源、初始化数据结构、配置系统环境等。这个函数只执行一次，为整个测试套件设置共享的测试环境。
• TearDownTestCase()：这个函数在测试套件中的所有测试用例执行之后调用。它用于执行一次性的清理操作，比如释放资源、关闭文件、恢复系统设置等。这个函数也只执行一次，用于清理测试套件结束后的环境。

2、SetUp() 和 TearDown()

SetUp() 和 TearDown() 是测试用例级别的设置和清理函数。它们分别在每个测试用例执行之前和之后执行。

• SetUp()：这个函数在每个测试用例执行之前调用。它用于为每个测试用例设置特定的测试环境，比如创建临时文件、初始化对象状态、配置测试参数等。每个测试用例在执行前都会调用这个函数，确保每个测试用例都在一个已知的初始状态下开始。
• TearDown()：这个函数在每个测试用例执行之后调用。它用于清理每个测试用例后的资源，比如删除临时文件、恢复对象状态、验证测试结果等。与 SetUp() 相对应，TearDown() 确保测试用例执行后的环境得到妥善处理。

#include "frameworks/native/device_manager.h"
#include <gtest/gtest.h>
#include "nnrt_device_service.h"namespaceOHOS{namespaceHDI{namespace Nnrt {namespaceV2_0{
using namespaceOHOS::HDI::Nnrt::V2_0;
using namespace testing::ext;
using namespace std;classNnrtDeviceServiceTest:public testing::Test {public:staticvoidSetUpTestCase();staticvoidTearDownTestCase();voidSetUp();voidTearDown();};void NnrtDeviceServiceTest::SetUpTestCase(){}void NnrtDeviceServiceTest::TearDownTestCase(){}void NnrtDeviceServiceTest::SetUp(){}void NnrtDeviceServiceTest::TearDown(){}HWTEST_F(NnrtDeviceServiceTest, get_device_name, TestSize.Level1){
    NnrtDeviceService iDevice =NnrtDeviceService();
    std::string deviceName;
    iDevice.GetDeviceName(deviceName);EXPECT_EQ("MOCK-NNRT", deviceName);}}// V2_0}// Nnrt}// HDI}// OHOS

更多详情参照开发自测试执行框架