CMake：生成单个头文件

Question

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

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

此致 Lehks

Answer 1

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

我最近收集了一些链接，以为ApprovalTests.cpp创建一个单头发行版。

我最初将它们记录在对an issue in podsiadly/ImageApprovals的评论中：这个答案是为了使这些信息更易于共享。

C ++-单头发行脚本

选项：

• 其中一些工具只能将头文件放在一起，如果您的主源代码仅是头文件，这很好。
• 其他人也有一种方法可以拉入.cpp文件，或者将inline添加到输出中，或者将.cpp文件中的所有代码放入输出中的一个位置，该文​​件仅被编译一次。
  • 例如，这就是Catch2的CATCH_CONFIG_MAIN的工作方式。

要求宽泛

• quom
  • 使用Python
  • 没有提及添加inline
• Heady
  • C ++程序
  • 具体说明提取.cpp个文件
  • 确认是否需要向.cpp中的某些功能添加inline：具有（可自定义）约定，用于将inline_t放入源代码中，其中inline应该包含在源代码中生成的标题
• Corrade Acme
  • 使用Python
  • 您创建一种模板文件，其中包含#include行以及各种模板标记，语法和类似内容
  • 不提及提取.cpp文件吗？
  • 没有提及添加inline

特定于图书馆

• Catch2
  • scripts/generateSingleHeader.py
  • 我认为它可以读取并扩展标题：include/catch.hpp
  • 然后查找此文本// ~*~* CATCH_CPP_STITCH_PLACE *~*~-在include/internal/catch_impl.hpp中找到该文本，并按字母顺序粘贴所有.cpp文件
• ImageApprovals
  • single_header.py
  • 已测试：single_header_test.py
  • 应该可重用
  • 脚本：
    • 遍历所有标题/源
    • 搬迁包括守卫和亲戚#include（在preprocess_file中）
    • 对文件进行拓扑排序（如果a.hpp包含b.hpp，则b.hpp将首先被处理，SingleHeaderGen.generate）
    • 最后将所有内容合并到一个标头中，首先将公用标头和实现文件放在#ifdef/#endif中。
    定义ImageApprovals_IMPLEMENT时，.cpp文件中的
    • 代码仅被编译一次
• jfalcou/spy
  • embed.py
  • 删除评论
  • 删除额外的包含卫兵
  • 不处理.cpp个文件
• ApprovalTests.cpp
  • 在build/scripts/中实现
  • 不处理.cpp个文件
  • 相关脚本：
  • code_generation.py
  • single_header_file.py
  • embed.py
    • 这是上面jfalcou / spy脚本的修改版本。
    • 保留评论
    • 可以选择放弃特定样式的行（“可丢弃物品”）
    • 在注释中包含原始文件的名称