cmake 生成接口文件

CMake 并不直接生成接口文件，但是可以通过它来生成代码文档。

在 CMake 中，可以使用 Doxygen 工具来生成代码文档。Doxygen 是一个自动化文档生成工具，可以从代码注释中提取信息，并生成 HTML、LaTeX、RTF 等格式的文档。

以下是一个使用 CMake 和 Doxygen 生成代码文档的示例：

1. 下载安装 Doxygen 工具；
2. 在项目根目录下创建 Doxygen 配置文件 Doxyfile.in；
3. 在 CMakeLists.txt 中添加以下内容：

# 查找 Doxygen 工具
find_package(Doxygen)

if(DOXYGEN_FOUND)
    # 生成 Doxyfile 文件
    configure_file(${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile @ONLY)
    # 添加文档生成命令
    add_custom_target(doc ALL
        COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
        WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
        COMMENT "Generating API documentation with Doxygen"
        VERBATIM)
endif()

4. 在 Doxyfile.in 中指定代码注释的格式和输出格式。

完成以上步骤后，执行 CMake 命令，即可在项目构建目录的 doc/html 目录下生成 API 文档。