CMake：生成单个头文件

Question

我目前正在编写一个实用程序库，该库将附带一个预编译的 DLL 文件和库的头文件。到目前为止，有一大堆头文件，但我想将它们全部编译成一个头文件（有点像只预处理#include指令）。

我想知道，是否以及如何使用 CMake 实现这样的一代。

真诚的，莱克斯

Answer 1

这些工具并非特定于 CMake，但可以在 CMake 内部调用。

我最近收集了一些链接来为ApprovalTests.cpp创建单标头版本。

我最初将它们记录在podsiadly/ImageApprovals 中的一个问题的评论中：这个答案是为了使该信息更容易共享。

C++ - 单标头发布脚本

选项：

• 其中一些工具仅将头文件组合在一起，如果您的主源代码仅包含头文件，那么这很好。
• 其他人也有一种方法来提取 .cpp 文件，要么添加inline到输出，要么将 .cpp 文件中的所有代码放入输出中的一个位置，这只编译一次。
  • CATCH_CONFIG_MAIN例如，这就是 Catch2 的工作原理。

自称一般

• 库姆
  • 使用Python
  • 没有提到添加inline
• 令人兴奋的
  • C++程序
  • 是否具体解释了拉入.cpp文件
  • 是否确认需要添加inline.cpp 中的某些函数：有一个（可定制的）约定用于放入inline_t源代码，其中inline应包含在生成的标头中
• 科拉德·阿克梅
  • 使用Python
  • 您创建一种模板文件，其中包含#include行、各种模板标记、Pragmas 等
  • 没有提到拉入.cpp文件吗？
  • 没有提到添加inline

图书馆特定

• 第二条军规
  • 脚本/generateSingleHeader.py
  • 我认为它会读取此内容并扩展标题：include/catch.hpp
  • 然后查找此文本// ~*~* CATCH_CPP_STITCH_PLACE *~*~- 它在include/internal/catch_impl.hpp中找到，并按字母顺序粘贴所有 .cpp 文件
• 图像批准
  • single_header.py
  • 有测试：single_header_test.py
  • 应该可以重复使用
  • 剧本：
    • 遍历所有标题/来源
    • 删除包括守卫和亲属#include（在preprocess_file）
    • 按拓扑对文件进行排序（如果a.hpp包含b.hpp则将b.hpp首先处理，SingleHeaderGen.generate）
    • 最后将所有内容合并到一个标头中，首先是公共标头，然后是#ifdef/#endif.
    • ImageApprovals_IMPLEMENT.cpp 文件中的代码将仅在定义时编译一次
• jfalcou/间谍
  • 嵌入.py
  • 删除评论
  • 删除额外的包含防护
  • 不处理.cpp文件
• 审批测试.cpp
  • 在build/scripts/中实现
  • 不处理.cpp文件
  • 相关脚本：
  • 代码生成.py
  • single_header_file.py
  • 嵌入.py
    • 这是上面 jfalcou/spy 脚本的修改版本。
    • 保留评论
    • 可以选择丢弃特定的线条图案（“可丢弃”）
    • 在注释中包含原始文件的名称