SuperAPI AI 工具集

ohos-test-graphics3d-static-api-unit-test

编程与开发

查看项目

更新于 10-16 03:11

技能介绍

用途:为 OpenHarmony graphic_3d 模块的 ETS/ArkTS 静态 API 类生成单元测试,基于 OpenHarmony GTest 框架,提供测试生成工作流、命名规范与核心模式。适用于新增 ETS 包装类(如 CameraETS、MaterialETS)的单元测试、为已有用例扩展场景,以及搭建新测试模块或环境。

主要能力:规定测试类名(<Module>ETSUnitTest,如 MaterialETSUnitTest)、用例名(<Class><Method><Number>,如 MaterialETS_Create_001)、测试文件名(<module>_ets_unit_test.cpp),要求使用 HWTEST_F 宏及 @tc.name/@tc.desc/@tc.type 注释模板,采用 Arrange-Act-Assert 模式。默认 TestSize.Level1,复杂场景可调高。

使用方式:在 api_unit_test/<module>_ets_unit_test.cpp 创建测试文件,编写带注释的用例,更新 BUILD.gn 的 sources 列表。实现细节见 UNITTEST_GUIDE.md(含 EtsTest fixture、BUILD.gn 模板、环境搭建与构建命令、错误处理示例),仅在首次搭建或遇到阻塞时加载。

适用场景:新增或扩展现有 ETS 静态 API 单元测试。限制:不适用于 Lume 引擎核心层测试(应换其他框架),也不适用于集成测试或性能测试(需不同 fixture)。常见问题包括头文件缺失需检查 BUILD.gn 的 include_dirs、库缺失需确保部署 libAGPDLL.z.so、用例干扰需用 SetUp/TearDown 隔离。不得直接使用 GTest 宏或省略注释,否则会影响测试发现与报告生成。