已合并
docs: 澄清 protobuf C++ 与 Python 包版本号体系不同(#97) #255
sinat_31531339创建于 5月26日
docs: 澄清 protobuf C++ 与 Python 包版本号体系不同(#97) #255
已合并
共 2 个文件变更+6-2
| @@ -110,7 +110,7 @@ For developers with Ascend devices, if you want to manually set up an Ascend env | |||
| 110 | - ccache | 110 | - ccache |
| 111 | - CANN toolkit package: `Ascend-cann-toolkit_${cann_version}_linux-${arch}.run` | 111 | - CANN toolkit package: `Ascend-cann-toolkit_${cann_version}_linux-${arch}.run` |
| 112 | - CANN ops package: `Ascend-cann-${chip_type}-ops_${cann_version}_linux-${arch}.run` | 112 | - CANN ops package: `Ascend-cann-${chip_type}-ops_${cann_version}_linux-${arch}.run` |
| 113 | - - protobuf >= 25.1 | 113 | + - protobuf >= 25.1 (C++ build dependency fetched/linked by cmake, used to generate .pb.cc) |
| 114 | - abseil >= 20230802.1 | 114 | - abseil >= 20230802.1 |
| 115 | - json >= 3.11.3 | 115 | - json >= 3.11.3 |
| 116 | - patch >= 2.7.6 | 116 | - patch >= 2.7.6 |
| @@ -119,6 +119,8 @@ For developers with Ascend devices, if you want to manually set up an Ascend env | |||
| 119 | - mockcpp (only required when running UT, recommended version 2.7) | 119 | - mockcpp (only required when running UT, recommended version 2.7) |
| 120 | - pytest (only required when running UT, recommended version 9.0.2) | 120 | - pytest (only required when running UT, recommended version 9.0.2) |
| 121 | - pytest-mock (only required when running UT, recommended version 3.15.1) | 121 | - pytest-mock (only required when running UT, recommended version 3.15.1) |
| 122 | + | ||
| 123 | + Python runtime dependencies (required by tools such as asys / msaicerr at runtime, installed via `pip install -r requirements.txt`) are listed in `requirements.txt` at the repository root. Note that `protobuf>=6.33.4` there refers to the Python package `protobuf` on PyPI, which uses a versioning scheme independent from the C++ protobuf 25.1 above; the two version numbers do not conflict. | ||
| 122 | 124 | ||
| 123 | Where: | 125 | Where: |
| 124 | - $\{chip\_type\}: Indicates the Ascend AI processor model (equivalent to `${soc_name}` below), used to compose the CANN ops package name. Run `npu-smi info` and read the `Name` column to identify the chip on this machine, then pick the matching ops package from the table below. | 126 | - $\{chip\_type\}: Indicates the Ascend AI processor model (equivalent to `${soc_name}` below), used to compose the CANN ops package name. Run `npu-smi info` and read the `Name` column to identify the chip on this machine, then pick the matching ops package from the table below. |
| @@ -110,7 +110,7 @@ curl -fsSL https://raw.gitcode.com/cann/oam-tools/raw/master/init_env.sh | bash | |||
| 110 | - ccache | 110 | - ccache |
| 111 | - CANN toolkit组合包：`Ascend-cann-toolkit_${cann_version}_linux-${arch}.run` | 111 | - CANN toolkit组合包：`Ascend-cann-toolkit_${cann_version}_linux-${arch}.run` |
| 112 | - CANN ops组合包：`Ascend-cann-${chip_type}-ops_${cann_version}_linux-${arch}.run` | 112 | - CANN ops组合包：`Ascend-cann-${chip_type}-ops_${cann_version}_linux-${arch}.run` |
| 113 | - - protobuf >= 25.1 | 113 | + - protobuf >= 25.1（C++ 编译依赖，由 cmake 拉取/链接，用于生成 .pb.cc） |
| 114 | - abseil >= 20230802.1 | 114 | - abseil >= 20230802.1 |
| 115 | - json >= 3.11.3 | 115 | - json >= 3.11.3 |
| 116 | - patch >= 2.7.6 | 116 | - patch >= 2.7.6 |
| @@ -119,6 +119,8 @@ curl -fsSL https://raw.gitcode.com/cann/oam-tools/raw/master/init_env.sh | bash | |||
| 119 | - mockcpp（仅执行UT时依赖，建议版本 2.7） | 119 | - mockcpp（仅执行UT时依赖，建议版本 2.7） |
| 120 | - pytest（仅执行UT时依赖，建议版本 9.0.2） | 120 | - pytest（仅执行UT时依赖，建议版本 9.0.2） |
| 121 | - pytest-mock (仅执行UT时依赖，建议版本 3.15.1) | 121 | - pytest-mock (仅执行UT时依赖，建议版本 3.15.1) |
| 122 | + | ||
| 123 | + Python 运行时依赖（asys / msaicerr 等工具运行所需，由 `pip install -r requirements.txt` 安装）的版本要求见仓库根目录的 `requirements.txt`。其中 `protobuf>=6.33.4` 指 Python 包 `protobuf`（PyPI 上独立发版，与上文 C++ 编译用的 protobuf 25.1 是不同的版本号体系），二者不冲突。 | ||
| 122 | 124 | ||
| 123 | 其中： | 125 | 其中： |
| 124 | - \$\{chip\_type\}：表示昇腾AI处理器型号（与下文`${soc_name}`等价），用于拼接CANN ops包名。可通过`npu-smi info`命令查看`Name`列得到本机芯片型号，再按下表选择对应的ops包。 | 126 | - \$\{chip\_type\}：表示昇腾AI处理器型号（与下文`${soc_name}`等价），用于拼接CANN ops包名。可通过`npu-smi info`命令查看`Name`列得到本机芯片型号，再按下表选择对应的ops包。 |