文章目录每日一句正能量摘要一、HarmonyOS 7.0 测试体系概览1.1 测试金字塔模型1.2 HarmonyOS 测试框架演进二、Hypium 单元测试实战2.1 环境准备与项目结构2.2 基础单元测试用例2.3 异步逻辑测试2.4 Mock 与依赖注入三、UI 自动化测试实战3.1 UI Test 框架选型3.2 UiTest 核心 API 与用例3.3 跨设备流转测试四、性能基准测试与 SmartPerf4.1 为什么需要性能压测4.2 SmartPerf 工具链使用五、CI/CD 测试流水线搭建5.1 流水线架构设计5.2 GitLab CI 配置实战5.3 Jenkins 流水线等价方案六、测试报告与质量门禁6.1 自动化测试报告示例6.2 质量门禁配置建议七、总结与最佳实践每日一句正能量生活中的许多烦恼都源于盲目和别人攀比。攀比的本质是用别人的尺子量自己的生活。你看到的多是他人光鲜的“高光时刻”却拿它对比自己琐碎的日常。切断这种无意义的比较烦恼会减少大半。摘要摘要高质量的自动化测试是保障 HarmonyOS 7.0 应用稳定交付的核心基础设施。本文从测试金字塔理论出发系统讲解 Hypium 单元测试框架、UI 自动化测试引擎、性能基准压测工具的使用方法并基于 GitLab CI / Jenkins 搭建完整的 DevOps 测试流水线。通过真实代码示例与工具链演示帮助开发者构建可落地的鸿蒙自动化测试体系。一、HarmonyOS 7.0 测试体系概览1.1 测试金字塔模型在移动应用测试领域Mike Cohn 提出的测试金字塔依然是最具指导意义的理论框架。针对 HarmonyOS 7.0 的技术栈特点我们可以将测试体系映射为如下三层结构底层单元测试占比最大运行最快成本最低。针对 ArkTS / C 业务逻辑函数进行白盒测试使用 Hypium JUnit 风格断言。中层集成/服务测试验证模块间接口契约、Ability 生命周期、数据持久化等行为使用 Hypium 的 Service Test 能力。顶层UI/E2E 测试模拟真实用户操作路径覆盖页面跳转、手势交互、跨设备流转等场景使用 UI Test / UI Automator。遵循金字塔模型的核心原则越靠近底层测试应该越多越靠近顶层测试应该越少但覆盖关键路径。这既能保障回归效率又能控制维护成本。1.2 HarmonyOS 测试框架演进版本测试框架关键特性HarmonyOS 2.xDevEco Testing基础单元测试与 UI 录制HarmonyOS 3.x/4.xHypium UiTest引入 Hypium 统一测试框架支持异步断言HarmonyOS 5.x/7.0Hypium 2.0 SmartPerf增强性能压测、多设备协同测试、CI/CD 原生集成HarmonyOS 7.0 在测试领域的最大升级是Hypium 2.0与SmartPerf 性能基准工具链的深度整合使得开发即测试、提交即验证成为可能。二、Hypium 单元测试实战2.1 环境准备与项目结构在 DevEco Studio 中创建测试工程时Hypium 框架已内置。标准模块的测试目录结构如下entry/src/ ├── main/ │ └── ets/ │ └── pages/ │ └── Index.ets └── ohosTest/ └── ets/ └── test/ ├── Ability.test.ets # Ability 生命周期测试 ├── Calculator.test.ets # 业务逻辑单元测试 └── List.test.ets # 列表组件行为测试在oh-package.json5中确认依赖{ dependencies: { ohos/hypium: 1.0.16 } }2.2 基础单元测试用例以支付金额校验模块为例演示 Hypium 的测试语法// entry/src/ohosTest/ets/test/PaymentValidator.test.etsimport{describe,it,expect}fromohos/hypium;import{PaymentValidator}from../../../main/ets/utils/PaymentValidator;exportdefaultfunctionpaymentValidatorTest(){describe(PaymentValidator 单元测试套件,(){it(合法金额应通过校验,0,(){constresultPaymentValidator.validate(100.50);expect(result.isValid).assertEqual(true);expect(result.amount).assertEqual(100.50);});it(负数金额应被拒绝,0,(){constresultPaymentValidator.validate(-10.00);expect(result.isValid).assertEqual(false);expect(result.errorCode).assertEqual(ERR_NEGATIVE_AMOUNT);});it(超过限额的金额应被拒绝,0,(){constresultPaymentValidator.validate(999999.99);expect(result.isValid).assertEqual(false);expect(result.errorCode).assertEqual(ERR_EXCEED_LIMIT);});it(非数字字符串应被拒绝,0,(){constresultPaymentValidator.validate(abc);expect(result.isValid).assertEqual(false);expect(result.errorCode).assertEqual(ERR_INVALID_FORMAT);});it(边界值刚好等于限额应通过,0,(){constresultPaymentValidator.validate(50000.00);expect(result.isValid).assertEqual(true);});});}关键语法点describe定义测试套件it定义单个用例第二个参数0表示同步测试异步场景传入TestType.functionexpect(...).assertEqual(...)为基本断言另有assertTrue、assertThrowError、assertUndefined等丰富断言方法。2.3 异步逻辑测试ArkTS 中大量 API 为异步 Promise 风格Hypium 支持async/await测试import{describe,it,expect}fromohos/hypium;import{UserService}from../../../main/ets/services/UserService;exportdefaultfunctionuserServiceTest(){describe(UserService 异步接口测试,(){it(应能正常获取用户信息,TestType.function,async(){constuserawaitUserService.getUserInfo(u123456);expect(user).assertNotNull();expect(user.id).assertEqual(u123456);expect(user.nickname.length).assertLarger(0);});it(不存在的用户应返回 404,TestType.function,async(){try{awaitUserService.getUserInfo(not_exist);expect().assertFail();// 预期进入 catch若走到这里则测试失败}catch(error){expect(error.code).assertEqual(404);}});});}2.4 Mock 与依赖注入单元测试的核心原则之一是隔离被测单元。HarmonyOS 7.0 支持通过mock工具替换依赖import{describe,it,expect,mock}fromohos/hypium;import{OrderService}from../../../main/ets/services/OrderService;exportdefaultfunctionorderServiceMockTest(){describe(OrderService Mock 测试,(){it(应正确计算折扣金额,0,(){// Mock 支付网关避免真实网络调用constmockPaymentGatewaymock.create();mockPaymentGateway.when(queryDiscountRate).afterReturn(0.85);// 模拟返回 85 折constorderServicenewOrderService(mockPaymentGateway);constfinalPriceorderService.checkout(1000);expect(finalPrice).assertEqual(850);});});}三、UI 自动化测试实战3.1 UI Test 框架选型HarmonyOS 7.0 提供两套 UI 自动化能力能力适用场景特点UiTest单设备页面操作基于组件树查找支持断言组件属性UI Automator跨应用/系统级交互支持手势模拟、截图比对、设备流转测试对于常规应用推荐优先使用UiTest它与 ArkUI 组件模型深度绑定定位稳定、执行高效。3.2 UiTest 核心 API 与用例// entry/src/ohosTest/ets/test/LoginPage.test.etsimport{describe,it,expect}fromohos/hypium;import{Driver,ON}fromohos.UiTest;exportdefaultfunctionloginPageTest(){describe(登录页面 UI 自动化测试,(){it(应能完成完整登录流程,TestType.function,async(){constdriverDriver.create();// 1. 等待并点击我的Tabawaitdriver.findComponent(ON.text(我的)).click();// 2. 输入手机号constphoneInputawaitdriver.findComponent(ON.id(phone_input));awaitphoneInput.inputText(13800138000);// 3. 输入密码constpwdInputawaitdriver.findComponent(ON.id(password_input));awaitpwdInput.inputText(Harmony2026);// 4. 点击登录按钮awaitdriver.findComponent(ON.text(登录)).click();// 5. 断言登录成功后的页面元素constwelcomeTextawaitdriver.findComponent(ON.textContains(欢迎回来));expect(awaitwelcomeText.getText()).assertContain(欢迎回来);// 6. 截图留档可选awaitdriver.screenShot(login_success.png);});it(空手机号应提示错误,TestType.function,async(){constdriverDriver.create();awaitdriver.findComponent(ON.id(phone_input)).inputText();awaitdriver.findComponent(ON.id(password_input)).inputText(123456);awaitdriver.findComponent(ON.text(登录)).click();consterrorTipawaitdriver.findComponent(ON.text(请输入手机号));expect(errorTip).assertNotNull();});});}常用定位策略ON.text(精确文本)— 按文本精确匹配ON.textContains(部分文本)— 按文本模糊匹配ON.id(组件ID)— 按开发者声明的 id 匹配最稳定ON.type(组件类型)— 按组件类型匹配如 Button、TextInput。3.3 跨设备流转测试HarmonyOS 的分布式能力是核心竞争力UI Automator 支持多设备协同测试import{describe,it,expect}fromohos/hypium;import{Driver,ON}fromohos.UiTest;exportdefaultfunctiondistributedTest(){describe(跨设备流转 UI 测试,(){it(视频播放应能从手机流转到平板,TestType.function,async(){// 手机端启动视频并点击流转按钮constphoneDriverDriver.create(phone_device_id);awaitphoneDriver.findComponent(ON.text(播放)).click();awaitphoneDriver.findComponent(ON.id(transfer_btn)).click();// 平板端断言视频已接续并播放constpadDriverDriver.create(pad_device_id);constvideoPlayerawaitpadDriver.findComponent(ON.id(video_player));expect(awaitvideoPlayer.getAttr(playbackState)).assertEqual(playing);});});}四、性能基准测试与 SmartPerf4.1 为什么需要性能压测功能正确只是及格线流畅体验才是高分项。HarmonyOS 7.0 对应用的性能指标有明确基线要求指标达标线优秀线首帧绘制时间 300ms 200ms页面转场动画 200ms 120ms内存峰值占用 256MB 180MBCPU 持续占用 30% 15%丢帧率Jank 5% 1%4.2 SmartPerf 工具链使用SmartPerf 是 HarmonyOS 官方提供的性能分析平台支持自动化性能采集与基准对比。步骤一配置性能测试用例// entry/src/ohosTest/ets/test/Performance.test.etsimport{describe,it,expect}fromohos/hypium;import{performance}fromkit.PerformanceKit;exportdefaultfunctionperformanceTest(){describe(首页性能基准测试,(){it(首帧绘制时间应小于 200ms,TestType.function,async(){consttraceperformance.startTrace(page_launch);// 模拟启动首页awaitlaunchEntryAbility();trace.stop();constmetricstrace.getMetrics();expect(metrics.firstFrameTime).assertLess(200);expect(metrics.totalLaunchTime).assertLess(500);});it(长列表滑动丢帧率应小于 2%,TestType.function,async(){consttraceperformance.startTrace(list_scroll);// 模拟快速滑动 100 条数据awaitsimulateFling(1000,-3000);// x, velocityYtrace.stop();constmetricstrace.getMetrics();expect(metrics.jankRate).assertLess(0.02);expect(metrics.avgFrameTime).assertLess(16.6);// 60fps 基准});});}步骤二命令行执行并导出报告# 连接设备并执行性能测试hdc shell am start-aohos.aa.action.ohosTest\-bcom.example.demo\-mentry\-sunittest Performance.test.ets# 拉取性能 trace 文件hdcfilerecv /data/app/el2/100/base/com.example.demo/haps/entry/files/perf.trace ./perf.trace# 使用 SmartPerf-Host 解析并生成 HTML 报告smartperf-cli analyze--input./perf.trace--output./perf-report/五、CI/CD 测试流水线搭建5.1 流水线架构设计上图展示了基于 GitLab CI 的完整测试流水线。每次代码推送触发构建后依次执行单元测试、集成测试、UI 自动化测试与性能基准测试任一阶段失败都将阻断合并。5.2 GitLab CI 配置实战在项目根目录创建.gitlab-ci.ymlstages:-build-unit_test-integration_test-ui_test-perf_test-reportvariables:HOS_SDK:/opt/harmonyos/sdk/7.0NODE_OPTIONS:--max-old-space-size4096# 阶段一编译构建build_job:stage:buildimage:harmonyos/ci-builder:7.0script:-npm install-hvigorw assembleRelease--no-daemonartifacts:paths:-entry/build/default/outputs/default/expire_in:1 hour# 阶段二单元测试unit_test_job:stage:unit_testimage:harmonyos/ci-builder:7.0dependencies:-build_jobscript:-hvigorw test--module entry--testPath ohosTest--no-daemonartifacts:reports:junit:entry/build/default/outputs/ohosTest/report.xmlpaths:-entry/build/default/outputs/ohosTest/# 阶段三集成测试integration_test_job:stage:integration_testimage:harmonyos/ci-builder:7.0script:-hvigorw test--module entry--testPath integrationTest--no-daemon# 阶段四UI 自动化测试需连接真机/模拟器ui_test_job:stage:ui_testtags:-harmonyos-device-farmscript:-hdc list targets-hvigorw uiTest--module entry--no-daemon-mkdir-p ui-screenshots-hdc file recv /data/app/el2/100/base/com.example.demo/haps/entry/files/screenshots/ ui-screenshots/artifacts:paths:-ui-screenshots/expire_in:3 days# 阶段五性能基准测试perf_test_job:stage:perf_testtags:-harmonyos-device-farmscript:-hvigorw perfTest--module entry--no-daemon-smartperf-cli analyze--input entry/build/perf.trace--output perf-report/artifacts:paths:-perf-report/expire_in:7 days# 阶段六聚合报告report_job:stage:reportimage:alpinedependencies:-unit_test_job-ui_test_job-perf_test_jobscript:-echo 所有测试阶段已完成生成聚合报告...only:-merge_requests-main5.3 Jenkins 流水线等价方案若团队使用 Jenkins可通过 Pipeline DSL 实现相同逻辑pipeline{agent any stages{stage(Build){steps{shhvigorw assembleRelease}}stage(Test){parallel{stage(Unit){steps{shhvigorw test --module entry --testPath ohosTest}}stage(UI){steps{shhvigorw uiTest --module entry}}}}}post{always{junit**/report.xmlpublishHTML([allowMissing:false,alwaysLinkToLastBuild:true,keepAll:true,reportDir:perf-report,reportFiles:index.html,reportName:SmartPerf Report])}}}六、测试报告与质量门禁6.1 自动化测试报告示例上图展示了测试流水线执行后的聚合报告包含单元测试通过率、UI 测试覆盖页面、性能指标趋势等关键信息。通过历史数据对比可以直观发现回归问题。6.2 质量门禁配置建议在 Merge Request 合入前建议设置以下硬性门禁门禁项阈值阻断合并单元测试通过率 90%是核心模块覆盖率 70%是UI 关键路径用例100% 通过是首帧绘制时间 300ms是丢帧率 5%否警告内存峰值 256MB否警告七、总结与最佳实践本文从测试金字塔理论出发完整演示了 HarmonyOS 7.0 的自动化测试体系搭建过程单元测试使用 Hypium 框架编写 ArkTS 业务逻辑测试掌握同步/异步/Mock 三种模式UI 自动化使用 UiTest 完成组件定位与操作覆盖单设备与分布式流转场景性能压测使用 SmartPerf 采集首帧、滑动、内存等关键指标建立性能基线CI/CD 流水线基于 GitLab CI / Jenkins 实现提交即测试设置质量门禁阻断劣化代码。可直接落地的行动清单为新模块创建对应的ohosTest目录保持与被测代码的目录对称核心业务函数必须配套单元测试优先覆盖边界条件与异常分支UI 自动化聚焦用户核心路径登录 → 下单 → 支付避免过度测试低频页面性能测试纳入每次 Release 构建对比历史版本发现性能劣化CI 流水线中设置清晰的阶段依赖UI/性能测试使用专属设备标签避免资源争用定期回顾测试报告清理无效/过期的测试用例保持套件健康度。测试不是开发的负担而是持续交付的信心来源。在 HarmonyOS 生态高速迭代的今天一套稳健的自动化测试体系将是团队最值得信赖的质量护城河。转载自https://blog.csdn.net/u014727709/article/details/162935952欢迎 点赞✍评论⭐收藏欢迎指正
【共创季稿事节】HarmonyOS 7.0 自动化测试实战：从单元测试到UI自动化与性能压测
发布时间：2026/7/18 4:00:07
文章目录每日一句正能量摘要一、HarmonyOS 7.0 测试体系概览1.1 测试金字塔模型1.2 HarmonyOS 测试框架演进二、Hypium 单元测试实战2.1 环境准备与项目结构2.2 基础单元测试用例2.3 异步逻辑测试2.4 Mock 与依赖注入三、UI 自动化测试实战3.1 UI Test 框架选型3.2 UiTest 核心 API 与用例3.3 跨设备流转测试四、性能基准测试与 SmartPerf4.1 为什么需要性能压测4.2 SmartPerf 工具链使用五、CI/CD 测试流水线搭建5.1 流水线架构设计5.2 GitLab CI 配置实战5.3 Jenkins 流水线等价方案六、测试报告与质量门禁6.1 自动化测试报告示例6.2 质量门禁配置建议七、总结与最佳实践每日一句正能量生活中的许多烦恼都源于盲目和别人攀比。攀比的本质是用别人的尺子量自己的生活。你看到的多是他人光鲜的“高光时刻”却拿它对比自己琐碎的日常。切断这种无意义的比较烦恼会减少大半。摘要摘要高质量的自动化测试是保障 HarmonyOS 7.0 应用稳定交付的核心基础设施。本文从测试金字塔理论出发系统讲解 Hypium 单元测试框架、UI 自动化测试引擎、性能基准压测工具的使用方法并基于 GitLab CI / Jenkins 搭建完整的 DevOps 测试流水线。通过真实代码示例与工具链演示帮助开发者构建可落地的鸿蒙自动化测试体系。一、HarmonyOS 7.0 测试体系概览1.1 测试金字塔模型在移动应用测试领域Mike Cohn 提出的测试金字塔依然是最具指导意义的理论框架。针对 HarmonyOS 7.0 的技术栈特点我们可以将测试体系映射为如下三层结构底层单元测试占比最大运行最快成本最低。针对 ArkTS / C 业务逻辑函数进行白盒测试使用 Hypium JUnit 风格断言。中层集成/服务测试验证模块间接口契约、Ability 生命周期、数据持久化等行为使用 Hypium 的 Service Test 能力。顶层UI/E2E 测试模拟真实用户操作路径覆盖页面跳转、手势交互、跨设备流转等场景使用 UI Test / UI Automator。遵循金字塔模型的核心原则越靠近底层测试应该越多越靠近顶层测试应该越少但覆盖关键路径。这既能保障回归效率又能控制维护成本。1.2 HarmonyOS 测试框架演进版本测试框架关键特性HarmonyOS 2.xDevEco Testing基础单元测试与 UI 录制HarmonyOS 3.x/4.xHypium UiTest引入 Hypium 统一测试框架支持异步断言HarmonyOS 5.x/7.0Hypium 2.0 SmartPerf增强性能压测、多设备协同测试、CI/CD 原生集成HarmonyOS 7.0 在测试领域的最大升级是Hypium 2.0与SmartPerf 性能基准工具链的深度整合使得开发即测试、提交即验证成为可能。二、Hypium 单元测试实战2.1 环境准备与项目结构在 DevEco Studio 中创建测试工程时Hypium 框架已内置。标准模块的测试目录结构如下entry/src/ ├── main/ │ └── ets/ │ └── pages/ │ └── Index.ets └── ohosTest/ └── ets/ └── test/ ├── Ability.test.ets # Ability 生命周期测试 ├── Calculator.test.ets # 业务逻辑单元测试 └── List.test.ets # 列表组件行为测试在oh-package.json5中确认依赖{ dependencies: { ohos/hypium: 1.0.16 } }2.2 基础单元测试用例以支付金额校验模块为例演示 Hypium 的测试语法// entry/src/ohosTest/ets/test/PaymentValidator.test.etsimport{describe,it,expect}fromohos/hypium;import{PaymentValidator}from../../../main/ets/utils/PaymentValidator;exportdefaultfunctionpaymentValidatorTest(){describe(PaymentValidator 单元测试套件,(){it(合法金额应通过校验,0,(){constresultPaymentValidator.validate(100.50);expect(result.isValid).assertEqual(true);expect(result.amount).assertEqual(100.50);});it(负数金额应被拒绝,0,(){constresultPaymentValidator.validate(-10.00);expect(result.isValid).assertEqual(false);expect(result.errorCode).assertEqual(ERR_NEGATIVE_AMOUNT);});it(超过限额的金额应被拒绝,0,(){constresultPaymentValidator.validate(999999.99);expect(result.isValid).assertEqual(false);expect(result.errorCode).assertEqual(ERR_EXCEED_LIMIT);});it(非数字字符串应被拒绝,0,(){constresultPaymentValidator.validate(abc);expect(result.isValid).assertEqual(false);expect(result.errorCode).assertEqual(ERR_INVALID_FORMAT);});it(边界值刚好等于限额应通过,0,(){constresultPaymentValidator.validate(50000.00);expect(result.isValid).assertEqual(true);});});}关键语法点describe定义测试套件it定义单个用例第二个参数0表示同步测试异步场景传入TestType.functionexpect(...).assertEqual(...)为基本断言另有assertTrue、assertThrowError、assertUndefined等丰富断言方法。2.3 异步逻辑测试ArkTS 中大量 API 为异步 Promise 风格Hypium 支持async/await测试import{describe,it,expect}fromohos/hypium;import{UserService}from../../../main/ets/services/UserService;exportdefaultfunctionuserServiceTest(){describe(UserService 异步接口测试,(){it(应能正常获取用户信息,TestType.function,async(){constuserawaitUserService.getUserInfo(u123456);expect(user).assertNotNull();expect(user.id).assertEqual(u123456);expect(user.nickname.length).assertLarger(0);});it(不存在的用户应返回 404,TestType.function,async(){try{awaitUserService.getUserInfo(not_exist);expect().assertFail();// 预期进入 catch若走到这里则测试失败}catch(error){expect(error.code).assertEqual(404);}});});}2.4 Mock 与依赖注入单元测试的核心原则之一是隔离被测单元。HarmonyOS 7.0 支持通过mock工具替换依赖import{describe,it,expect,mock}fromohos/hypium;import{OrderService}from../../../main/ets/services/OrderService;exportdefaultfunctionorderServiceMockTest(){describe(OrderService Mock 测试,(){it(应正确计算折扣金额,0,(){// Mock 支付网关避免真实网络调用constmockPaymentGatewaymock.create();mockPaymentGateway.when(queryDiscountRate).afterReturn(0.85);// 模拟返回 85 折constorderServicenewOrderService(mockPaymentGateway);constfinalPriceorderService.checkout(1000);expect(finalPrice).assertEqual(850);});});}三、UI 自动化测试实战3.1 UI Test 框架选型HarmonyOS 7.0 提供两套 UI 自动化能力能力适用场景特点UiTest单设备页面操作基于组件树查找支持断言组件属性UI Automator跨应用/系统级交互支持手势模拟、截图比对、设备流转测试对于常规应用推荐优先使用UiTest它与 ArkUI 组件模型深度绑定定位稳定、执行高效。3.2 UiTest 核心 API 与用例// entry/src/ohosTest/ets/test/LoginPage.test.etsimport{describe,it,expect}fromohos/hypium;import{Driver,ON}fromohos.UiTest;exportdefaultfunctionloginPageTest(){describe(登录页面 UI 自动化测试,(){it(应能完成完整登录流程,TestType.function,async(){constdriverDriver.create();// 1. 等待并点击我的Tabawaitdriver.findComponent(ON.text(我的)).click();// 2. 输入手机号constphoneInputawaitdriver.findComponent(ON.id(phone_input));awaitphoneInput.inputText(13800138000);// 3. 输入密码constpwdInputawaitdriver.findComponent(ON.id(password_input));awaitpwdInput.inputText(Harmony2026);// 4. 点击登录按钮awaitdriver.findComponent(ON.text(登录)).click();// 5. 断言登录成功后的页面元素constwelcomeTextawaitdriver.findComponent(ON.textContains(欢迎回来));expect(awaitwelcomeText.getText()).assertContain(欢迎回来);// 6. 截图留档可选awaitdriver.screenShot(login_success.png);});it(空手机号应提示错误,TestType.function,async(){constdriverDriver.create();awaitdriver.findComponent(ON.id(phone_input)).inputText();awaitdriver.findComponent(ON.id(password_input)).inputText(123456);awaitdriver.findComponent(ON.text(登录)).click();consterrorTipawaitdriver.findComponent(ON.text(请输入手机号));expect(errorTip).assertNotNull();});});}常用定位策略ON.text(精确文本)— 按文本精确匹配ON.textContains(部分文本)— 按文本模糊匹配ON.id(组件ID)— 按开发者声明的 id 匹配最稳定ON.type(组件类型)— 按组件类型匹配如 Button、TextInput。3.3 跨设备流转测试HarmonyOS 的分布式能力是核心竞争力UI Automator 支持多设备协同测试import{describe,it,expect}fromohos/hypium;import{Driver,ON}fromohos.UiTest;exportdefaultfunctiondistributedTest(){describe(跨设备流转 UI 测试,(){it(视频播放应能从手机流转到平板,TestType.function,async(){// 手机端启动视频并点击流转按钮constphoneDriverDriver.create(phone_device_id);awaitphoneDriver.findComponent(ON.text(播放)).click();awaitphoneDriver.findComponent(ON.id(transfer_btn)).click();// 平板端断言视频已接续并播放constpadDriverDriver.create(pad_device_id);constvideoPlayerawaitpadDriver.findComponent(ON.id(video_player));expect(awaitvideoPlayer.getAttr(playbackState)).assertEqual(playing);});});}四、性能基准测试与 SmartPerf4.1 为什么需要性能压测功能正确只是及格线流畅体验才是高分项。HarmonyOS 7.0 对应用的性能指标有明确基线要求指标达标线优秀线首帧绘制时间 300ms 200ms页面转场动画 200ms 120ms内存峰值占用 256MB 180MBCPU 持续占用 30% 15%丢帧率Jank 5% 1%4.2 SmartPerf 工具链使用SmartPerf 是 HarmonyOS 官方提供的性能分析平台支持自动化性能采集与基准对比。步骤一配置性能测试用例// entry/src/ohosTest/ets/test/Performance.test.etsimport{describe,it,expect}fromohos/hypium;import{performance}fromkit.PerformanceKit;exportdefaultfunctionperformanceTest(){describe(首页性能基准测试,(){it(首帧绘制时间应小于 200ms,TestType.function,async(){consttraceperformance.startTrace(page_launch);// 模拟启动首页awaitlaunchEntryAbility();trace.stop();constmetricstrace.getMetrics();expect(metrics.firstFrameTime).assertLess(200);expect(metrics.totalLaunchTime).assertLess(500);});it(长列表滑动丢帧率应小于 2%,TestType.function,async(){consttraceperformance.startTrace(list_scroll);// 模拟快速滑动 100 条数据awaitsimulateFling(1000,-3000);// x, velocityYtrace.stop();constmetricstrace.getMetrics();expect(metrics.jankRate).assertLess(0.02);expect(metrics.avgFrameTime).assertLess(16.6);// 60fps 基准});});}步骤二命令行执行并导出报告# 连接设备并执行性能测试hdc shell am start-aohos.aa.action.ohosTest\-bcom.example.demo\-mentry\-sunittest Performance.test.ets# 拉取性能 trace 文件hdcfilerecv /data/app/el2/100/base/com.example.demo/haps/entry/files/perf.trace ./perf.trace# 使用 SmartPerf-Host 解析并生成 HTML 报告smartperf-cli analyze--input./perf.trace--output./perf-report/五、CI/CD 测试流水线搭建5.1 流水线架构设计上图展示了基于 GitLab CI 的完整测试流水线。每次代码推送触发构建后依次执行单元测试、集成测试、UI 自动化测试与性能基准测试任一阶段失败都将阻断合并。5.2 GitLab CI 配置实战在项目根目录创建.gitlab-ci.ymlstages:-build-unit_test-integration_test-ui_test-perf_test-reportvariables:HOS_SDK:/opt/harmonyos/sdk/7.0NODE_OPTIONS:--max-old-space-size4096# 阶段一编译构建build_job:stage:buildimage:harmonyos/ci-builder:7.0script:-npm install-hvigorw assembleRelease--no-daemonartifacts:paths:-entry/build/default/outputs/default/expire_in:1 hour# 阶段二单元测试unit_test_job:stage:unit_testimage:harmonyos/ci-builder:7.0dependencies:-build_jobscript:-hvigorw test--module entry--testPath ohosTest--no-daemonartifacts:reports:junit:entry/build/default/outputs/ohosTest/report.xmlpaths:-entry/build/default/outputs/ohosTest/# 阶段三集成测试integration_test_job:stage:integration_testimage:harmonyos/ci-builder:7.0script:-hvigorw test--module entry--testPath integrationTest--no-daemon# 阶段四UI 自动化测试需连接真机/模拟器ui_test_job:stage:ui_testtags:-harmonyos-device-farmscript:-hdc list targets-hvigorw uiTest--module entry--no-daemon-mkdir-p ui-screenshots-hdc file recv /data/app/el2/100/base/com.example.demo/haps/entry/files/screenshots/ ui-screenshots/artifacts:paths:-ui-screenshots/expire_in:3 days# 阶段五性能基准测试perf_test_job:stage:perf_testtags:-harmonyos-device-farmscript:-hvigorw perfTest--module entry--no-daemon-smartperf-cli analyze--input entry/build/perf.trace--output perf-report/artifacts:paths:-perf-report/expire_in:7 days# 阶段六聚合报告report_job:stage:reportimage:alpinedependencies:-unit_test_job-ui_test_job-perf_test_jobscript:-echo 所有测试阶段已完成生成聚合报告...only:-merge_requests-main5.3 Jenkins 流水线等价方案若团队使用 Jenkins可通过 Pipeline DSL 实现相同逻辑pipeline{agent any stages{stage(Build){steps{shhvigorw assembleRelease}}stage(Test){parallel{stage(Unit){steps{shhvigorw test --module entry --testPath ohosTest}}stage(UI){steps{shhvigorw uiTest --module entry}}}}}post{always{junit**/report.xmlpublishHTML([allowMissing:false,alwaysLinkToLastBuild:true,keepAll:true,reportDir:perf-report,reportFiles:index.html,reportName:SmartPerf Report])}}}六、测试报告与质量门禁6.1 自动化测试报告示例上图展示了测试流水线执行后的聚合报告包含单元测试通过率、UI 测试覆盖页面、性能指标趋势等关键信息。通过历史数据对比可以直观发现回归问题。6.2 质量门禁配置建议在 Merge Request 合入前建议设置以下硬性门禁门禁项阈值阻断合并单元测试通过率 90%是核心模块覆盖率 70%是UI 关键路径用例100% 通过是首帧绘制时间 300ms是丢帧率 5%否警告内存峰值 256MB否警告七、总结与最佳实践本文从测试金字塔理论出发完整演示了 HarmonyOS 7.0 的自动化测试体系搭建过程单元测试使用 Hypium 框架编写 ArkTS 业务逻辑测试掌握同步/异步/Mock 三种模式UI 自动化使用 UiTest 完成组件定位与操作覆盖单设备与分布式流转场景性能压测使用 SmartPerf 采集首帧、滑动、内存等关键指标建立性能基线CI/CD 流水线基于 GitLab CI / Jenkins 实现提交即测试设置质量门禁阻断劣化代码。可直接落地的行动清单为新模块创建对应的ohosTest目录保持与被测代码的目录对称核心业务函数必须配套单元测试优先覆盖边界条件与异常分支UI 自动化聚焦用户核心路径登录 → 下单 → 支付避免过度测试低频页面性能测试纳入每次 Release 构建对比历史版本发现性能劣化CI 流水线中设置清晰的阶段依赖UI/性能测试使用专属设备标签避免资源争用定期回顾测试报告清理无效/过期的测试用例保持套件健康度。测试不是开发的负担而是持续交付的信心来源。在 HarmonyOS 生态高速迭代的今天一套稳健的自动化测试体系将是团队最值得信赖的质量护城河。转载自https://blog.csdn.net/u014727709/article/details/162935952欢迎 点赞✍评论⭐收藏欢迎指正
