Boost 库裁剪及其应用

2016-07-13 22:08:00

转载自我的博客：Boost 库裁剪及其应用。

STL 全称“标准模板库（Standard Template Library）”，其实它是一套标准，可能有不同的实现，它是 C++ 的“标准库”。Boost 则是一个 C++ 库，被称为“C++ 准标准库”。

Boost 库涵盖的范围极广，有字符串和文本处理相关子库比如 format 库和 regexp 库，有容器相关子库比如 variant 库（和 Qt 的 QVariant 有得一拼），有迭代器子库比如 tokenizer 库（可以把字符进行 tokenize），还有算法、函数对象和高阶编程相关子库如
functional 库、lambda 库和 signal 库，还有泛型编程、模板编程子库如 call traits、mpl，还有并发编程相关的 thread 库，等等等等。

Boost 是如此强大，毫无疑问它也很大。Windows 上安装 boost 需要占用 2G+ 的空间，编译配置起来也十分麻烦。

本文讨论的是如何不配置 boost 库而使用 boost 库。

解决方案用一句话说就是：

裁剪 boost 库，并在项目中内嵌 boost 源码，使项目脱离对 boost 库的依赖。

一个例子说明 boost 库裁剪的意义

或许你还是不明白 boost 库裁剪到底是啥意思，那我们一起来跑一个例子。以我的 cmake-templates 里面的一个 boost 代码为例，源码只有一个 main.cpp，里面只有如下几行：

include

int main( void )
{
namespace pt = boost::posix_time;
pt::ptime now = pt::second_clock::local_time();

printf( "%s\t->\t%04d-%02d-%02d %02d:%02d:%02d\n"      , "date '+%Y-%m-%d %H:%M:%S'"      , (int)now.date().year()      , (int)now.date().month()      , (int)now.date().day()      , (int)now.time_of_day().hours()      , (int)now.time_of_day().minutes()      , (int)now.time_of_day().seconds() );return 0;

}
程序运行输出大概是：

date '+%Y-%m-%d %H:%M:%S'        ->        2016-07-11 19:33:19

这 20 行不到的代码，展示了 Linux 系统下一个常用指令 date 输出当前时间的效果（相当于命令行下输入 date '+%Y-%m-%d %H:%M:%S'）。

如果你的系统配置了 Boost，那就到上面的链接下载源码，进入 boost 文件夹，这里一共有三个文件：一个 main.cpp、一个 CMakeLists.txt，一个 README 说明文档。如果你不知道如何使用 CMake 生成 VS 工程，可以先看我以前写的教程：HOWTO: Win + CMake + Visual Studio 2010 · Issue # 1 · district10/cmake-templates。

但要运行这个程序并不容易，尤其是在一切都要手工的 Windows 系统上：你必须自己去下载合适的 boost 版本，设定一些环境变量。
在 Linux 下则比较简单，只要三步（先下载源码，并 cd 到源码目录）：

sudo apt-get install -y libboost-all-dev cmake
mkdir build && cd build
cmake .. && make && ./BOOST
你不禁感慨，为了运行一个 20 行不到的小程序，居然要手工安装两三个 G 的 boost 库！

这时候 boost 库的裁剪，就显得尤为重要了。我们不希望拿到代码的人还要费时间去配置 boost 库，我们也不希望自己的代码要十分小心地，才能跑起来。我们要让自己的代码不论什么情况都能迅速地跑起来！下面我们来看看刚才那 20 行代码，加上裁剪过的 boost 库源码，一起“发行”的效果：district10/bcp-example-1: An exmaple to show how to use bcp.。

我们裁剪后的 boost 库，头文件大概有 3.18 MB，cpp 文件有两个约 11 KB。看上去挺大，但是压缩完其实就 213 KB！拿到这份代码，首先解压 include.zip 到当前文件夹，然后运行 cmake 生成 VS 工程（或者 Linux 上的 makefile 工程），然后编译、运行。完全不需要再管那烦心的 boost 库的配置了！

我想你一定能把这个程序跑起来的。无论你用什么操作系统，用什么编译器。

运行起来更省心，这就是 boost 库裁剪的意义。

我要怎么裁剪出自己需要的部分？

我们来深究一下怎么拿到上面那 3.18 MB 的头文件，11 KB 的 cpp 文件。

首先，下载 Boost 库源码，你可以去官网，也可以用我的备份：http://whudoc.qiniudn.com/2016/boost_1_58_0_headers_sources.7z（37.6 MB）。我们只需要官方 release 的源码里的 boost 和 libs 文件夹下的东西，所以我建议你下载我的备份。因为它真的小很多，下载起来也很快。而且里面还打包了用于提取 boost 源码的工具 bcp1。

然后，解压下载到的压缩包，进入源码文件夹，新建一个文件夹，比如叫 output，然后在当前窗口打开命令行，输入 ./bcp.exe boost/date_time/posix_time/posix_time_types.hpp output，这里 "./bcp.exe" 是我们的裁剪工具，"boost/date_time/posix_time/posix_time_types.hpp" 是我们自己项目中用到的 boost 头文件，如果有多个头文件，用空格隔开，把它们都敲进命令行。2最后的 "output" 是输出文件夹。

在 cmake 里，这个过程大概是 1）在源码根目录新建 include 文件夹，在根目录的 CMakeLists.txt 加上 include_directories( ${CMAKE_SOURCE_DIR} )；2）新建 libs 文件夹，把裁剪出来的 cpp 文件放到这个文件下的 MiniBoost 文件加下，然后参考 district10/bcp-example-1/libs 写好 CMakeLists 文件，再到根目录的 CMakeLists 文件加上 add_subdirectory( libs)；3）将裁剪出来的 miniboost 链接到我们的二进制：target_link_libraries( ${PROJECT_NAME} MiniBoost )。

你可以仔细对比看看链接系统安装的 Boost 库和使用自带的裁剪后的 Boost 库（我把它称为 MiniBoost）两者的区别和联系，再一次，我们源码链接贴在这里：

cmake-templates/boost at master · district10/cmake-templates
district10/bcp-example-1: An exmaple to show how to use bcp.

哦对，一个需要注意的地方是，提取出来的头文件里，boost/config/auto_link.hpp 里的内容最好删掉，不然在 Windows 平台上，boost 会尝试自动链接。所以我通常把这个文件内容清空。

Boost 库裁剪及其应用

一个例子说明 boost 库裁剪的意义

include

include

我要怎么裁剪出自己需要的部分？

更多的实践

相关文章