[object Object]

算子kernel侧和host侧实现开发完成后，需要对算子工程进行编译，生成自定义算子安装包*.run，详细的编译操作包括：

• 编译Ascend C算子kernel侧代码实现文件*.cpp，分为源码发布和二进制发布两种方式。

  • 源码发布：不对算子kernel侧实现进行编译，保留算子kernel源码文件*.cpp。该方式可以支持算子的在线编译、通过ATC模型转换的方式编译算子的场景。
  • 二进制发布：对算子kernel侧实现进行编译，生成描述算子相关信息的json文件*.json和算子二进制文件*.o。算子调用时，如果需要直接调用算子二进制，则使用该编译方式，比如通过的方式完成单算子的调用，PyTorch框架中单算子调用的场景，动态网络中调用算子的场景。

• 编译Ascend C算子host侧代码实现文件*.cpp、*.h。

  • 将原型定义和shape推导实现编译成算子原型定义动态库libcust_opsproto_*.so，并生成算子原型对外接口op_proto.h。
  • 将Tiling实现编译成Tiling动态库liboptiling.so等。
  • 基于算子原型定义，自动生成单算子API调用代码和头文件aclnn_*.h，并编译生成单算子API调用的动态库libcust_opapi.so。

上述编译过程示意图如下：

图 1 算子工程编译示意图[object Object][object Object]

[object Object]

1. 完成工程编译相关配置。

   • 修改工程目录下的CMakePresets.json cacheVariables的配置项。CMakePresets.json文件内容如下，需要配置的参数请参考，其他参数会在工程创建时自动生成。

     [object Object]

     表 1 需要开发者配置的参数列表

     [object Object][object Object]

     [object Object]

   • 配置编译相关环境变量（可选）

     表 2 环境变量说明

     [object Object][object Object]

     [object Object]

2. 在算子工程目录下执行如下命令，进行算子工程编译。

   ./build.sh

   编译成功后，会在当前目录下创建build_out目录，并在build_out目录下生成自定义算子安装包custom_opp_<target os>__<target architecture>.run。

   用户如果需要编译过程日志存盘，可以使用环境变量ASCENDC_BUILD_LOG_DIR来控制存储路径。用户设置该选项之后，如果编译过程中无错误产生，则对应的log文件后缀会添加"_success"，若编译过程有错误产生，则会在屏幕打印对应的报错信息，以及指示用户log文件的具体路径与文件名，同时，对应log文件后缀会添加“_error”。

   [object Object]

[object Object]

完成算子代码实现后，如果当前平台架构和运行环境一致则参考上一节的内容进行编译即可，如果需要实现算子包的交叉编译，您可以参考如下流程。

1. 交叉编译工具下载，下表以Ubuntu系列操作系统为例，展示了编译工具下载命令的样例。其他操作系统，请替换为实际的下载命令。

   表 3 Ubuntu系列操作系统交叉编译工具下载命令样例

   [object Object][object Object]

   [object Object]

2. 自定义算子工程交叉编译，构建生成自定义算子包。

   1. 修改CMakePresets.json中ENABLE_CROSS_COMPILE为True，使能交叉编译。

      [object Object]

   2. 修改CMakePresets.json中CMAKE_CROSS_PLATFORM_COMPILER为安装后的交叉编译工具路径。

      [object Object]

   3. 在算子工程目录下执行如下命令，进行算子工程交叉编译。

      ./build.sh

      编译成功后，会在当前目录下创建build_out目录，并在build_out目录下生成自定义算子安装包custom_opp_<target os>__<target architecture>.run

[object Object]

在算子工程中，如果开发者想对算子kernel侧代码增加一些自定义的编译选项，可以参考如下内容进行编译选项的定制。

修改算子工程op_kernel目录下的CMakeLists.txt，使用add_ops_compile_options来增加编译选项，方法如下：

具体参数的介绍如下：

表 4 具体参数介绍

[object Object][object Object]

[object Object]undefined

[object Object]

[object Object]

Ascend C框架提供的编译选项介绍如下：

• --tiling_key，设置该选项后，只编译指定的相关的kernel代码，用于加速编译过程。若不指定TilingKey编译，则默认编译所有的TilingKey。配置多个TilingKey时，TilingKey之间不能有空格。示例如下，其中1、2为tiling_key。

  [object Object]

• 编译宏开关请参考。

• --op_relocatable_kernel_binary，设置该选项为true时，会额外编译一份可被重新链接的二进制文件；不配置或设置为false时该选项均不生效。该选项用于自定义Tiling下沉算子使能SuperKernel的场景，配置该选项所生成的二进制文件，可以使算子在SuperKernel编译时直接复用二进制文件，降低编译耗时。

• --kernel-template-input，用于，设置该选项后，只编译指定的模板参数组合相关的Kernel代码，用于加速编译过程。若不设置该选项，则默认编译所有的模板参数组合。传入的参数为键值对列表，整体需用双引号或单引号包裹。不同模板参数之间用英文分号（;）分隔，相同模板参数配置多个值时用英文逗号（,）分隔。配置时不能有空格。示例如下：

  [object Object]

  配置模板参数组合时，模板参数名需要与Kernel入口处以及Host侧定义的模板参数名匹配。对于模板参数组合的值，如果存在自定义类型，需要替换为其对应数字值，如果为原生支持数据类型，则与Kernel入口处入参保持一致。示例如下：

  [object Object]

  编译选项示例如下：

  [object Object]