已关闭
[Documentation|文档反馈]: 修正UT依赖安装与AddExample调测、安装指引 #6699
yangyang016创建于  3 天前关闭于  3 天前
yangyang016成员
3 天前 创建

Document Link(文档链接)

Issues Section(问题文档片段)

  1. UT安装步骤使用 pip3 install -r tests/requirements.txt,但该依赖文件未引用项目根目录的 requirements.txt。
  2. 快速入门的 printf 示例包含 tileNum_、tileLength_ 等与当前 AddExample 实现不一致的代码,使用 AscendC::PRINTF,且未明确插入位置;blockLength_ 为 int64_t,原示例使用 %llu。
  3. 自定义算子包安装步骤只给出默认安装命令,未说明共享库依赖检查失败时的处理方式。

Existing Issues(存在的问题)

  • 单独按UT文档安装依赖时,未统一纳入根目录的依赖及版本约束,安装指引也未区分仅编译与执行UT两种场景。
  • 直接照搬旧printf示例与当前源码不匹配,影响用户完成算子调测。
  • 若依赖库不在默认搜索路径,安装可能报 shared library validation failed;文档缺少兼容性检查及后续处理说明。

预期结果与修复建议

  1. 在 tests/requirements.txt 中通过 -r ../requirements.txt 复用根目录依赖约束,并同步说明编译、UT各自的安装命令。
  2. 按当前 AddExample 实现更新示例:在 AddExample<T>::Init 中 ubLength_ = tilingData->ubFactor; 之后添加 AscendC::printf("Tiling blockLength is %lld\n", blockLength_);。
  3. 补充安装共享库校验失败的说明:先确认CANN版本与构建环境兼容,再按需使用 --force 跳过检查,并说明错误使用可能导致运行时加载失败,不建议默认启用。

关联PR

https://gitcode.com/cann/ops-nn/pull/11986

likedislike
Yyangyang016成员
3 天前 添加了label:documentation
yuning_chenyuning_chen成员
3 天前 将 yangyang016 设为负责人
CANN-robotCANN-robot成员
3 天前 关闭了 issue
CANN-robotCANN-robot成员
3 天前 添加了label:resolved