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

引言

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

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

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

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

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

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

typescript 复制代码
#注意区别非单元测试引入的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" 节点下单独配置:

三、编译指令及运行

编译单元测试的所有用例

typescript 复制代码
./build.sh --product-name rk3568 --target-cpu arm64 --device-type tablet --no-prebuilt-sdk --ccache --build-target make_test

单编指定单元测试用例

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

然后就会在:

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

三、单元测试的语法

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

typescript 复制代码
class MyTestCase {
public:
    static void SetUpTestCase() {
        // 测试套件级别的初始化
        HiLog::Info(LABEL, "SetUpTestCase: Initializing test suite environment.");
        // ... 初始化代码
    }

    static void TearDownTestCase() {
        // 测试套件级别的清理
        HiLog::Info(LABEL, "TearDownTestCase: Cleaning up test suite environment.");
        // ... 清理代码
    }

    void SetUp() {
        // 测试用例级别的初始化
        HiLog::Info(LABEL, "SetUp: Initializing test case environment for each test.");
        // ... 初始化代码
    }

    void TearDown() {
        // 测试用例级别的清理
        HiLog::Info(LABEL, "TearDown: Cleaning up test case environment after each test.");
        // ... 清理代码
    }

    void TestFunction1() {
        // ... 测试代码
    }

    void TestFunction2() {
        // ... 测试代码
    }
};

1、SetUpTestCase() 和 TearDownTestCase()

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

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

2、SetUp() 和 TearDown()

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

  • SetUp():这个函数在每个测试用例执行之前调用。它用于为每个测试用例设置特定的测试环境,比如创建临时文件、初始化对象状态、配置测试参数等。每个测试用例在执行前都会调用这个函数,确保每个测试用例都在一个已知的初始状态下开始。
  • TearDown():这个函数在每个测试用例执行之后调用。它用于清理每个测试用例后的资源,比如删除临时文件、恢复对象状态、验证测试结果等。与 SetUp() 相对应,TearDown() 确保测试用例执行后的环境得到妥善处理。
typescript 复制代码
#include "frameworks/native/device_manager.h"
#include <gtest/gtest.h>
#include "nnrt_device_service.h"

namespace OHOS {
namespace HDI {
namespace Nnrt {
namespace V2_0 {
using namespace OHOS::HDI::Nnrt::V2_0;
using namespace testing::ext;
using namespace std;

class NnrtDeviceServiceTest : public testing::Test {
public:
    static void SetUpTestCase();
    static void TearDownTestCase();
    void SetUp();
    void TearDown();
};

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

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

相关推荐
世间万物皆对象4 小时前
Spring Boot核心概念:日志管理
java·spring boot·单元测试
Dnelic-15 小时前
解决 Android 单元测试 No tests found for given includes:
android·junit·单元测试·问题记录·自学笔记
岳哥i18 小时前
前端项目接入单元测试手册
前端·单元测试
qq_433716951 天前
Selenium+Pytest自动化测试框架 ------ 禅道实战
自动化测试·软件测试·selenium·单元测试·pytest·接口测试·压力测试
Dreams°1232 天前
【大数据测试ETL:从0-1实战详细教程】
大数据·数据仓库·python·单元测试·etl
敲代码敲到头发茂密2 天前
怎么做好白盒测试?
java·数据库·mysql·算法·单元测试·模块测试·测试覆盖率
Dreams°1235 天前
【大数据测试HDFS + Flask详细教程与实例】
大数据·功能测试·hdfs·单元测试·flask
CSXB996 天前
三十八、Python(pytest框架-上)
python·功能测试·测试工具·单元测试·pytest
伍肆伍柒7 天前
SpringBoot 2.2.10 无法执行Test单元测试
spring boot·后端·单元测试
互联网杂货铺7 天前
基于Selenium+Python的web自动化测试框架(附框架源码+项目实战)
自动化测试·软件测试·python·selenium·测试工具·单元测试·测试用例