库构建器的预编译头文件用法

Question

根据 这个答案 boost 和 STL 标头属于预编译头文件（MSVC 世界中的stdafx.h）。因此，我更改了动态链接库项目的标头，并将所有 STL/Boost 标头移至项目的 stdafx.h 中。

之前

#include <boost/smart_ptr.hpp>

namespace XXX
{
  class CLASS_DECL_BK CExampleClass // CLASS_DECL_BK is just a standard dll import/export macro
  {
    private:
      boost::scoped_ptr<Replica> m_replica;
  }
}

之后

namespace XXX
{
  class CLASS_DECL_BK CExampleClass
  {
    private:
      boost::scoped_ptr<Replica> m_replica;
  }
}

现在我的优势是减少了编译时间，但是我的库的所有用户都遇到构建错误（例如未知的 boost:: scoped_ptr...），因为缺少包含（现在已移至我的 stdafx.h 中）。

---

解决这个困境的方法是什么？

我希望减少编译时间并且包含我的头文件后出现的编译错误对于 dll 的任何用户来说都是不可接受的。

这有帮助吗？

• 保留所有包含指令原样，但将它们复制到我的“stdafx.h”中？由于 stdafx.h 始终首先包含在我的项目的任何 cpp 文件中，我应该没问题，并且用户不会收到任何错误。或者，如果一个翻译单元中多次包含相同的标头（有标头防护），我是否会失去速度优势？

感谢您的任何提示！

Answer 1

当您将 header-includes 保留在库标头中并将它们另外放入 stdafx.h 中时，您应该会获得几乎相同的速度提升。

或者，您可以添加一个额外的定义（批量外部包含防护）

// stdafx.h
#define MY_LIB_STD_HEADERS_ALREADY_INCLUDED

// library_file.h
#ifndef MY_LIB_STD_HEADERS_ALREADY_INCLUDED
#include <boost/smart_ptr.hpp>
...
#endif

但我仅当您确信有帮助时才会这样做。只需拿一个秒表并运行一些重新编译即可。 （无需链接。）然后您就会看到是否有任何差异。

除此之外，

我不确定在项目中的某个地方添加所需的所有 boost头是否是一个好主意。我想说 shared_ptr 和朋友，boost/foreach，也许 Boost.Format，...是个好主意，但我已经为 Boost 三思而行了。正则表达式标头。 _{注意：我没有进行任何速度测量，但我依稀记得 pch 文件的大小和一些编译器故障有关的问题。我真的应该做一些测试。}

还要检查相关的 Boost 库是否提供转发标头以及您是否应该包含它们。使预编译头文件膨胀也有其缺点。

Answer 2

您可以为此目的创建一个构建配置（调试、发布、检查依赖项）。更改此设置的一个简单方法是使用预处理器根据当前配置包含/排除包含内容。使用它，您可以使用调试或发布（包含更大的包含集）来测试和构建，然后在分发之前构建所有配置。

澄清一下，条件包含 MON_LIBRARY_VALIDATE_DEPENDENCIES 不能在库标头或源中使用，只能在预编译标头中使用：

// my pch:
#include <file1.hpp>
#include <file2.hpp>
// ...

#if !defined(MON_LIBRARY_VALIDATE_DEPENDENCIES)
#include <boost/stuff.hpp>
// ...
#endif

然后您可以将 MON_LIBRARY_VALIDATE_DEPENDENCIES 附加到预处理器定义列表中在 CheckDependency 配置中。

关于守卫：如果您在正常情况下使用守卫，那么应该不是问题 - 编译器使用优化来检测这些情况，这意味着如果文件被多重包含和保护，它们在许多情况下可以避免打开文件正确。事实上，在这个领域尝试智胜编译器实际上可能会减慢处理速度。我想说，除非你的库/依赖项很大并且你确实有明显的问题，否则就将其保留为典型的。

Answer 3

使您的编译单元独立（让它们包含它们使用的所有内容）是非常可取的。这将防止其他不使用预编译标头的编译错误，并且正如您所假设的，标头防护将使这些额外包含的成本保持最低。

这也会产生理想的副作用，即看一眼标题就会告诉用户单元中正在使用哪些其他标题，以及在没有任何模糊的情况下对单个单元进行编译的选项。