Closed
[Documentation|文档反馈]: 快速入门遗漏多个 UT 测试分组 #1947
aodebiaoAdd on  23 days agoClosed at  12 days ago
aodebiao
aodebiao
23 days ago Create

问题描述

中英文快速入门的 UT 执行步骤只列出 --adv_test 和 --basic_test_one/two/three。实际 build.sh 还提供 --adv_test_two、--basic_test_four、--basic_test_five 和 --arm_test 等测试分组;其中这些分组在 tests/test_parts.sh 中对应非空目标列表。开发者按文档所列命令检查时可能遗漏这些测试。

复现与预期

对照 bash build.sh --help 与 docs/zh/quick_start.md、docs/en/quick_start.md 的 UT 执行章节,可见上述四个分组只出现在脚本帮助中,没有出现在文档的在线及离线示例中。预期给出完整测试入口 --test,并列出可按需选择的其他测试分组。

验证范围

实际运行 bash build.sh --help,并核对 tests/test_parts.sh 的目标分组;修改后自动检查中英文指南的两组示例均覆盖 8 个分组,参数均存在于脚本帮助。仅验证文档与脚本的一致性,未运行完整 UT 或 NPU 测试。

修复 PR:https://gitcode.com/cann/asc-devkit/merge_requests/7091

审核后范围修订(2026-11-03)

按维护者意见,移除将全量 --test 入口补入指南的建议;本项只补齐分组命令。中文、英文在线/离线示例均与 tests/test_parts.sh 定义的八个分组一致,真实 Git Bash CLI --help 返回 0。补充的分组为 adv_test_two、basic_test_four、basic_test_five、arm_test。修订 630ac0e8;未执行完整 UT 构建或 NPU 测试。

修复 PR:https://gitcode.com/cann/asc-devkit/merge_requests/7091

CI 链接修订(2026-11-03)

新 CI 的 Markdown 链接检查发现两份指南同一插件市场入口返回 404,真实 HTTP 请求复现。已同步改用华为云官方 Huawei Developer Space 安装指导,浏览器确认 HTTP 200 且包含同一插件的安装步骤。分组命令内容保留,两个文档仍为本 PR 全部文件;适用的原生格式/安全/拼写检查及差异检查通过。修订 8bb4d2e0,完整仓库 Markdown 检查由更新后的 CI 复核,本地未宣称全仓通过。

修复 PR:https://gitcode.com/cann/asc-devkit/merge_requests/7091

likedislike
aodebiaoaodebiao
23 days ago Associated pull request
aodebiaoaodebiao
23 days ago Modify description of issue
lihuaichaolihuaichaoCollaborators
23 days ago Assign lihuaichao as responsible person
lihuaichao
lihuaichaoCollaborators
23 days ago Comments:

感谢反馈。经确认,快速入门文档确实遗漏了部分 UT 测试分组,导致文档内容与当前 build.sh 支持的测试选项不一致,该问题确实存在。

看到您已关联修复 PR,感谢贡献。PR 修改和合入过程中如有任何问题,欢迎随时沟通。

likedislike
lihuaichaolihuaichaoCollaborators
20 days ago Assign gxhgxh2475698 as responsible person
maohp_hwmaohp_hwCollaborators
19 days ago Assign haipingmao as responsible person
aodebiaoaodebiao
19 days ago Modify description of issue
aodebiaoaodebiao
19 days ago Modify description of issue
maohp_hw
maohp_hwCollaborators
12 days ago Comments:

您好

快速入门文档确实遗漏了部分 UT 测试分组,导致文档内容与当前 build.sh 支持的测试选项不一致。

此问题已经合入主线,详见PR:#7091

我们现在关闭此Issue,如果后续有问题,欢迎再提Issue交流~

likedislike
maohp_hwmaohp_hwCollaborators
12 days ago changed custom state from 进行中 to 已解决
maohp_hwmaohp_hwCollaborators
12 days ago Close issue
CANN-robotCANN-robotCollaborators
12 days ago Added label: resolved