oh-capi-xts-gen 是 OpenHarmony 的 CAPI XTS 测试用例生成器(方式2,N-API 封装测试)。用途是依据 C 头文件自动生成 N-API 封装与 ETS/ArkTS 测试用例,适用于 CAPI、C 测试、Native 测试及 .h 文件解析等场景。
主要能力:解析 .h 头文件与工程配置,分析覆盖率;生成 C++ N-API 封装、TypeScript 声明(index.d.ts)与 .test.ets 测试;进行 N-API 三重校验与编译验证;遵循严格命名格式 SUB_[Subsystem][Module][API][Type][Sequence]。
使用方式:工作流分 Flow A(用户提供覆盖率报告时仅做风格扫描并补充缺失用例,不新建工程)与 Flow B(默认,先做全量覆盖率分析再生成)。流程含 Phase 1 确定子系统配置、Phase 2 解析头文件、Phase 3 覆盖率分析/风格扫描、Phase 4 生成用例、Phase 5 N-API 三重校验(不可跳过)、Phase 6 编译验证、Phase 7 输出。生成物包括 NapiTest.cpp、types/libentry/index.d.ts、*.test.ets 及 BUILD.gn、Test.json。可用脚本:bash scripts/verify_napi_triple.sh ${TARGET_PATH}、bash scripts/check_test_suite_structure.sh ${TARGET_PATH}。
限制:仅使用 .h 中声明的接口;模块名必须为 entry;禁止修改非测试文件;新建测试套必须从 template_project/capi_test_template/ 复制;每个用例须含标准 @tc 注释;错误处理使用 napi_throw_error;兼容 OpenHarmony API 10+。部分配置、价格与平台细节暂未提供。