10分钟上手DevEco Testing:编写你的第一个HarmonyOS5单元测试

单元测试是保障代码质量的核心环节。本文将带你快速掌握在HarmonyOS中使用DevEco Testing编写单元测试的方法,只需10分钟即可完成第一个测试用例!


一、环境准备

  1. 开发工具
  • DevEco Studio 5.0.4+
  • HarmonyOS SDK 5.0.0+
  1. 工程配置build-profile.json5中添加测试依赖:
json 复制代码
"dependencies": {
  "unitTest": {
    "compileOnly": true,
    "runtimeOnly": true
  }
}

二、创建第一个测试用例

示例场景:日期工具类测试

假设有日期处理工具DateUtils.ets

typescript 复制代码
// DateUtils.ets
export class DateUtils {
  static isSameDay(date1: Date, date2: Date): boolean {
    return date1.getFullYear() === date2.getFullYear() &&
           date1.getMonth() === date2.getMonth() &&
           date1.getDate() === date2.getDate();
  }
}

单元测试代码

src/test/ets/DateUtils.test.ets中编写测试:

typescript 复制代码
import { describe, it, expect } from '@ohos/hypium'; // 测试框架
import { DateUtils } from '../main/ets/utils/DateUtils';

describe('DateUtilsTest', () => {
  it('testIsSameDay_positive', 0, () => {
    const date1 = new Date(2025, 5, 9); // 6月9日
    const date2 = new Date(2025, 5, 9);
    expect(DateUtils.isSameDay(date1, date2)).assertTrue();
  });

  it('testIsSameDay_negative', 0, () => {
    const date1 = new Date(2025, 5, 9);
    const date2 = new Date(2025, 5, 10);
    expect(DateUtils.isSameDay(date1, date2)).assertFalse();
  });
});

三、运行与解读测试

  1. 执行测试 右键点击测试文件 → 选择Run 'DateUtilsTest'
scss 复制代码
[RESULT] DateUtilsTest
  ✓ testIsSameDay_positive (3ms)
  ✓ testIsSameDay_negative (1ms)
  1. 测试报告
  • 绿色对勾:测试通过
  • 代码覆盖率:在Run面板点击Show Coverage Data查看
  • 失败定位:直接跳转到断言失败的行

四、高级测试技巧

  1. Mock外部依赖 使用@ohos/hypium的mock功能隔离网络请求:
typescript 复制代码
import { mock } from '@ohos/hypium';

const mockFetch = mock(globalThis, 'fetch', async () => {
  return new Response(JSON.stringify({ data: "mock" }));
});
  1. 异步测试 处理Promise返回值:
typescript 复制代码
it('testAsync', async () => {
  const result = await fetchData();
  expect(result).assertEqual("expected");
});

五、最佳实践

  1. 测试规范
  • 测试类名:被测试类名 + Test
  • 测试方法:test_方法名_测试场景
  • 覆盖率目标:核心逻辑 ≥80%
  1. 常见问题
  • 依赖缺失 :在oh-package.json5中确认@ohos/hypium版本
  • API兼容:确保测试设备API≥9

结语

通过本文,你已掌握了HarmonyOS单元测试的核心流程。持续编写单元测试能显著提升代码健壮性,减少线上故障。下一步建议:

  1. 为复杂业务模块添加测试
  2. 配置持续集成自动运行测试
  3. 探索UI测试框架UiTest

环境说明:本文示例基于HarmonyOS 5.0.0+,DevEco Studio 5.0.4+

相关推荐
双力臂4048 小时前
Spring Boot 单元测试进阶:JUnit5 + Mock测试与切片测试实战及覆盖率报告生成
java·spring boot·后端·单元测试
超浪的晨2 天前
Java 单元测试详解:从入门到实战,彻底掌握 JUnit 5 + Mockito + Spring Boot 测试技巧
java·开发语言·后端·学习·单元测试·个人开发
安卓开发者3 天前
Android 测试全指南:单元测试与UI测试框架详解
android·ui·单元测试
人生在勤,不索何获-白大侠5 天前
day24——Java高级技术深度解析:单元测试、反射、注解与动态代理
java·开发语言·单元测试
飞鸟_Asuka8 天前
SpringBoot集成测试笔记:缩小测试范围、提高测试效率
java·单元测试·集成测试·springboot
一只特立独行的猫8 天前
单元测试学习+AI辅助单测
人工智能·学习·单元测试
ezreal_pan9 天前
巧用 Golang 函数特性实现单元测试中的数据库操作 Mock
开发语言·后端·golang·单元测试·函数
一个快乐的小测试10 天前
JUnit-自动化测试框架
java·junit·单元测试·自动化
长路 ㅤ   11 天前
Java单元测试JUnit
junit·单元测试·springboot·注解·断言