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

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

相关推荐
王解1 小时前
Jest项目实战(4):将工具库顺利迁移到GitHub的完整指南
单元测试·github
Devil枫12 小时前
Vue 3 单元测试与E2E测试
前端·vue.js·单元测试
小袁在上班18 小时前
Python 单元测试中的 Mocking 与 Stubbing:提高测试效率的关键技术
python·单元测试·log4j
测试199819 小时前
外包干了2年,快要废了。。。
自动化测试·软件测试·python·面试·职场和发展·单元测试·压力测试
安冬的码畜日常1 天前
【The Art of Unit Testing 3_自学笔记06】3.4 + 3.5 单元测试核心技能之:函数式注入与模块化注入的解决方案简介
笔记·学习·单元测试·jest
王解1 天前
Jest项目实战(2): 项目开发与测试
前端·javascript·react.js·arcgis·typescript·单元测试
程序员小雷2 天前
软件测试基础:单元测试与集成测试
python·功能测试·selenium·测试工具·单元测试·集成测试·压力测试
王解2 天前
Jest进阶知识:深入测试 React Hooks-确保自定义逻辑的可靠性
前端·javascript·react.js·typescript·单元测试·前端框架
程序员雷叔2 天前
外包功能测试就干了4周,技术退步太明显了。。。。。
功能测试·测试工具·面试·职场和发展·单元测试·测试用例·postman
安冬的码畜日常2 天前
【玩转 Postman 接口测试与开发2_005】第六章:Postman 测试脚本的创建(上)
javascript·测试工具·单元测试·postman·bdd·chai