BOOST编译方法
Windows
bjam --toolset=msvc-9.0 --prefix=C:vc9_boostvc9 --build-type=complete link=static threading=multi install
bjam.exe --toolset=msvc-12.0 --without-python --without-graph --without-graph_parallel --stagedir="d:/boost" link=static runtime-link=static threading=multi release address-model=32 variant=release
【一、Boost库的介绍】
Boost库是一个经过千锤百炼、可移植、提供源代码的C++库，作为标准库的后备，是C++标准化进程的发动机之一。 Boost库由C++标准委员会库工作组成员发起，其中有些内容有望成为下一代C++标准库内容。在C++社区中影响甚大，其成员已近2000人。 Boost库为我们带来了最新、最酷、最实用的技术，是不折不扣的“准”标准库。
Boost库中比较有名的几个库：
（1）Regex，正则表达式库；
（2）Spirit，LL parser framework，用C++代码直接表达EBNF；
（3）Graph，图组件和算法；
（4）Lambda，在调用的地方定义短小匿名的函数对象，很实用的functional功能；
（5）concept check，检查泛型编程中的concept；
（6）Mpl，用模板实现的元编程框架；
（7）Thread，可移植的C++多线程库；
（8）Python，把C++类和函数映射到Python之中；
（9）Pool，内存池管理；
（10）smart_ptr，智能指针。
【二、Boost库的编译】
【Setp1 准备工作】：
（1）Boost 下载可以到官方网站下载：
（2）安装VS2008 IDE
【Setp2 编译Boost】
1.打开Visual Studio 2008 命令提示窗口
2.进入D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0oost_1_44_0 oolsjamsrc
3.执行 build.bat 会在D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0oost_1_44_0
oolsjamsrcin.ntx86 生成 bjam.exe文件.
4.Copy bjam.exe 文件到 D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0oost_1_44_0 下
6.进入D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0oost_1_44_0 目录
7.执行bjam.exe 编译命令，如下：
(1)编译所有boost动态库 （release|debug），包括头文件和库文件
bjam --toolset=msvc-9.0 --prefix=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output --without-python --build-type=complete link=shared threading=multi install
(2)只编译 release 版本 regex 动态库，包括头文件和库文件
bjam --toolset=msvc-9.0 --prefix=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output1 --with-regex link=shared threading=multi variant=release runtime-link=shared install
(3)只编译 release 版本 regex 动态库，包括库文件
bjam --toolset=msvc-9.0
--stagedir=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output2
--with-regex link=shared threading=multi variant=release runtime-link=shared stage
【注意】： Boost 源代码所在路径最好全英文，不要有空格、特殊字符、中文等
编译要花上30分钟左右（根据PC性能所定）， 会在指定生成目录：
D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output下生成对应库文件和头文件。
8.设置开发环境
打开VS2008 创建工程， 配置工程属性
设置包含文件目录F:DevelopBoostlibAndDllincludeoost-1_37oost
设置引用文件目录:F:DevelopBoostlibAndDlllib
完成后，可以使用。
【三、介绍Bjam使用】
Usage:
Bjam [options] [properties] [install|stage]
install Install headers and compiled library files to the
======= configured locations (below).
在“--prefix=”指定的目录下生成所有头文件
（boost源代码下boost文件夹下所有文件）和指定库文件
--prefix=<PREFIX> Install architecture independent files here.
Default; C:Boost on Win32
Default; /usr/local on Unix. Linux, etc.
--exec-prefix=<EPREFIX> Install architecture dependent files here.
Default; <PREFIX>
--libdir=<DIR> Install library files here.
Default; <EPREFIX>/lib
--includedir=<HDRDIR> Install header files here.
Default; <PREFIX>/include
stage Build and install only compiled library files
====== to the stage directory.
在“--stagedir=”指定的目录下生成指定库文件
--stagedir=<STAGEDIR> Install library files here
Default; ./stage
【Other Options】:
--build-type=<type> Build the specified pre-defined set of variations
of the libraries. Note, that which variants get
built depends on what each library supports.
minimal (default) - Builds the single
"release" version of the libraries. This
release corresponds to specifying:
"release <threading>multi <link>shared
<link>static <runtime-link>shared" as the
Build variant to build.
complete - Attempts to build all possible
variations.
--build-dir=DIR Build in this location instead of building
within the distribution tree. Recommended!
--show-libraries Displays the list of Boost libraries that require
build and installation steps, then exit.
--layout=<layout> Determines whether to choose library names
and header locations such that multiple
versions of Boost or multiple compilers can
be used on the same system.
versioned (default) - Names of boost
binaries include the Boost version
number and the name and version of the
compiler. Boost headers are installed
in a subdirectory of <HDRDIR> whose
name contains the Boost version number.
system - Binaries names do not include
the Boost version number or the name
and version number of the compiler.
Boost headers are installed directly
into <HDRDIR>. This option is
intended for system integrators who
are building distribution packages.
--buildid=ID Adds the specified ID to the name of built
libraries. The default is to not add anything.
--help This message.
--with-<library> Build and install the specified <library>
If this option is used, only libraries
specified using this option will be built.
--without-<library> Do not build, stage, or install the specified
<library>. By default, all libraries are built.
【Properties】:
toolset=toolset Indicates the toolset to build with.
msvc-6.0 : VC6.0
msvc-7.0: VS2003
msvc-8.0: VS2005
msvc-9.0: VS2008
msvc-10.0: VS2010
variant=debug|release Select the build variant
link=static|shared Whether to build static or shared libraries
threading=single|multi Whether to build single or multithreaded binaries
runtime-link=static|shared Whether to link to static or shared C and C++ runtime.
决定是静态还是动态链接C/C++标准库
Bjam 选项、参数说明
--build-dir=<builddir>
编译的临时文件会放在builddir里(编译完就可以把它删除了)
--stagedir=<stagedir>
存放编译后库文件的路径，默认是stage
--build-type=complete
编译所有版本，不然只会编译一小部分版本（相当于:
variant=release,threading=multi;
link=shared|static;runtime-link=shared）
variant=debug|release
决定编译什么版本(Debug or Release)
link=static|shared
决定使用静态库还是动态库
threading=single|multi
决定使用单线程还是多线程库
runtime-link=static|shared
决定是静态还是动态链接C/C++标准库
--with-<library>
只编译指定的库，如输入--with-regex就只编译regex库了
--show-libraries
显示需要编译的库名称
【四、Bjam 生成文件的分析】
（1）生成 Release 版本，多线程，动态链接C++标准库 的regex 动态库
bjam --toolset=msvc-9.0
--stagedir=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output2
--with-regex link=shared threading=multi variant=release runtime-link=shared stage
-- 输出： boost_regex-vc90-mt.lib
boost_regex-vc90-mt-1_44.lib
boost_regex-vc90-mt-1_44.dll
（2）生成 Release 版本，多线程，静态链接C++标准库 的regex 动态库
bjam --toolset=msvc-9.0
--stagedir=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output2
--with-regex link=shared threading=multi variant=release runtime-link= static stage
-- 输出： 没有这种配置
（3）生成 Release 版本，多线程，动态链接C++标准库 的regex静态库
bjam --toolset=msvc-9.0
--stagedir=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output2
--with-regex link= static threading=multi variant=release runtime-link=shared stage
-- 输出： libboost_regex-vc90-mt-s.lib
libboost_regex-vc90-mt-1_44.lib
（4）生成 Release 版本，多线程，静态链接C++标准库 的regex 静态库
bjam --toolset=msvc-9.0
--stagedir=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output3
--with-regex link=static threading=multi variant=release runtime-link=static stage
-- 输出：libboost_regex-vc90-mt-s.lib
libboost_regex-vc90-mt-s-1_44.lib
--------------------------------------------------------------------------------------------------------------------
（1）生成 Debug 版本，多线程，动态链接C++标准库 的regex 静态库
bjam --toolset=msvc-9.0
--stagedir=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output4
--with-regex link=static threading=multi variant=debug runtime-link=shared stage
-- 输出： libboost_regex-vc90-mt-gd.lib
libboost_regex-vc90-mt-gd-1_44.lib
（2）生成 Debug 版本，多线程，静态链接C++标准库 的regex 静态库
bjam --toolset=msvc-9.0
--stagedir=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output5
--with-regex link=static threading=multi variant=debug runtime-link=static stage
-- 输出： libboost_regex-vc90-mt-sgd.lib
libboost_regex-vc90-mt-sgd-1_44.lib
（3）生成 Debug 版本，多线程，动态链接C++标准库 的regex 动态库
bjam --toolset=msvc-9.0
--stagedir=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output5
--with-regex link=shared threading=multi variant=debug runtime-link=shared stage
- 输出： boost_regex-vc90-mt-gd.lib
boost_regex-vc90-mt-gd-1_44.lib
boost_regex-vc90-mt-gd-1_44.dll
（4）生成 Debug 版本，多线程，静态链接C++标准库 的regex动态库
bjam --toolset=msvc-9.0
--stagedir=D: 5_Computer 4_3rdPatry 2Boostoost_1_44_0output5
--with-regex link=shared threading=multi variant=debug runtime-link=static stage
-- 输出：没有这种配置
【总结】：
（1） 编译成功后，Bjam 都会给你生成一对一样的导入库文件或者静态库文件（如下），
唯一不同的是两个文件名称一个在后面加上了boost版本信息， 为了让用户知道使用的boost的版本信息。
boost_regex-vc90-xxxxx.lib
boost_regex-vc90-xxxxx-1_44.lib
（2） Bjam编译选项 有4个， 理论上应该有 2*2*2*2 = 16 种配置
ink= static| shared
threading= single |multi
variant=release|debug
runtime-link= static |shared
实际使用的多为多线程， 所以 threading= multi， 这样剩下的3个选项组成的编译配置就是上面所罗列的， 其中静态链接C++标准库的boost动态库这种配置也不存在， 所以就只有4种情况。
（3）
link= static ： 静态库。 生成的库文件名称以 “lib”开头
link= shared ： 动态库。生成的库文件名称无“lib”开头
threading= mult : 支持多线程。 生成的库文件名称中包含 “-mt”
variant=release 生成的库文件名称不包含 “-gd”
variant= debug 生成的库文件名称包含 “-gd”
runtime-link= static 生成的库文件名称包含 “-s”
runtime-link= shared 生成的库文件名称不包含 “-s”
一直以来都是在Win32环境下Build和使用boost，但现在基本上每天都在64位Win7下工作，所以很有必要把这几天的经验总结下来。
1. 下载并解压boost 1.61.0 压缩包
2. 解压并运行批处理文件bootstrap.bat，目录下会生成两个可执行文件
3. 和32位环境不同，x64环境下编译得先从开始菜单启动Visual Studio的VS2015 x64 Native Tools Command Prompt 进入命令提示符，而不是随便打开任意一个命令行窗口就行。
4. 然后cd到boost根文件夹，运行bootstrap.bat生成x64版的b2.exe 和 bjam.exe (他们只是版本不同的产物，但是用法一致，bjam是之前版本的，b2 是最新的)
5. 然后运行命令：
b2 --build-type=complete toolset=msvc-14.0 threading=multi link=shared address-model=64
即可生成DLL版平台库，如果要编译静态库版就把shared改为static。
- 只生成一个库的话加上例如--with-python得编译选项，避免生成东西太多、时间太长。
- 要有address-model=64属性，如果没有这个属性的话，会默认生成32位的平台库，加入这个选项才能生成64位的DLL。
- 如果要生成Boost.Python库，需要先下载安装x64版的Python安装包，我用的版本是3.2.3。在使用这个库编写Python扩展DLL时，默认是使用动态库版的Boost.Python，要使用静态版的必须在C++项目中定义BOOST_PYTHON_STATIC_LIB宏，这样就不用在使用或发布扩展时带着boost_python-vc90-mt-1_50.dll一起了，当然扩展DLL的尺寸会大些，如果做实验没必要这样，编译又慢生成的文件也大。
- vs工具链版本：vs2003 : msvc-7.1，vs2005 : msvc-8.0，vs2008 : msvc-9.0，vs2010 : msvc-10.0， vs2015：msvc-14.0
生成文件命名规则：boost中有许多库，有的库需要编译、而有的库不需要编译，只需包含头文件就可以使用。编译生成的文件名字普遍较长，同一个库根据编译链接选项不同，又可以生成多个不同名字的文件。生成的文件名字是很长，可是这样带的信息才多，也就容易识别出用途。其实生成文件的名字遵循一定的规则，有着固定的格式。识别这种格式，能帮助我们更高效地使用boost库。生成文件名字格式如：
BOOST_LIB_PREFIX + BOOST_LIB_NAME + "-" + BOOST_LIB_TOOLSET + "-" + BOOST_LIB_THREAD_OPT + "-" + BOOST_LIB_RT_OPT + "-" + BOOST_LIB_VERSION
这些定义为:
BOOST_LIB_PREFIX: 静态库为 "lib" (否则无,是用动态链接库)
BOOST_LIB_NAME: 库的基本名称 ( 比方说 boost_regex).
BOOST_LIB_TOOLSET: 编译工具集名称 ( 比如：vc6, vc7, bcb5 )
BOOST_LIB_THREAD_OPT: 多线程为 "-mt" ，否则为空
BOOST_LIB_RT_OPT: 指示使用的运行库的后缀,
组合下面的一个或者更多字符:
s 静态运行库，指的是静态链接到运行时库(不出现表示动态).
g 调试/诊断 runtime (release if not present).
d 调试版本 (不出现表示 release 版 ).
p STLPort 版本.
注：对 vc 来说，gd 总是一起出现
BOOST_LIB_VERSION: Boost 版本, Boost 版本 x.y 表示为 x_y形式.
编译：为了简化boost库的编译,boost库中带了一个用来编译的工具,名字是bjam.exe或者b2.exe.
1:运行boost下的bootstap.bat脚本就会自动生上述的两个编译工具,并且拷贝到boost目录下. 也可以进入tools/build目录下找到类似的脚本或者项目源码来编译.
2: bjam.exe的参数
|
Feature |
Allowed values |
Notes |
|
variant |
debug,release |
|
|
link |
shared,static |
Determines if Boost.Build creates shared or static libraries |
|
threading |
single,multi |
Cause the produced binaries to be thread-safe. This requires proper support in the source code itself. |
|
address-model |
32,64 |
Explicitly request either 32-bit or 64-bit code generation. This typically requires that your compiler is appropriately configured. Please refer to the section called “C++ Compilers” and your compiler documentation in case of problems. |
|
toolset |
(Depends on configuration) |
The C++ compiler to use. See the section called “C++ Compilers” for a detailed list. (Vs2008)msvc-8.0 (vs2010)msvc-10.0 |
|
include |
(Arbitrary string) |
Additional include paths for C and C++ compilers. |
|
define |
(Arbitrary string) |
Additional macro definitions for C and C++ compilers. The string should be either SYMBOL or SYMBOL=VALUE |
|
cxxflags |
(Arbitrary string) |
Custom options to pass to the C++ compiler. |
|
cflags |
(Arbitrary string) |
Custom options to pass to the C compiler. |
|
linkflags |
(Arbitrary string) |
Custom options to pass to the C++ linker. |
|
runtime-link |
shared,static |
Determines if shared or static version of C and C++ runtimes should be used. |
|
--build-dir=<builddir> |
编译的临时文件会放在builddir里(这样比较好管理，编译完就可以把它删除了) |
|
--stagedir=<stagedir> |
存放编译后库文件的路径，默认是stage |
|
--build-type=complete |
编译所有版本，不然只会编译一小部分版本（确切地说是相当于:variant=release, threading=multi;link=shared|static;runtime-link=shared） |
|
variant=debug|release |
决定编译什么版本（对应文件中的d 调试版本 不出现表示 release 版） |
|
link=static|shared |
决定使用静态库还是动态库。（对应文件中的BOOST_LIB_PREFIX ） |
|
threading=single|multi |
决定使用单线程还是多线程库。（对应文件中的BOOST_LIB_THREAD_OPT） |
|
runtime-link=static|shared |
决定是静态还是动态链接C/C++标准库。（对应文件中的BOOST_LIB_THREAD_OPT） |
|
--with-<library> |
只编译指定的库，如输入--with-regex就只编译regex库了。 |
|
--show-libraries |
显示需要编译的库名称 |
bjam.exe --toolset=msvc-10.0 --with-date_time runtimelink=static link=static stage
意思是要生静态库,该静态库静态链接C运行时库
生成的文件名字是:libboost_date_time-vc100-mt-sgd-1_48.lib(debug version),libboost_date_time-vc100-mt-s-1_48.lib(release version) 两个文件.
bjam.exe --toolset=msvc-10.0 --with-date_time runtimelink=shared link=static stage
意思是要生静态库,该静态库动态链接C运行时库
生成的文件名字是:libboost_date_time-vc100-mt-gd-1_48.lib(debug verion),libboost_date_time-vc100-mt-1_48.lib(release version) 两个文件.
bjam.exe --toolset=msvc-10.0 --with-date_time runtimelink=shared link=shared stage
意思是要生动态库,该动态库动态链接C运行时库
生成的文件名字是:boost_date_time-vc100-mt-gd-1_48.lib(debug version),boost_date_time-vc100-mt-1_48.lib(release version) 两个文件.
生成的dll名字是:boost_date_time-vc100-mt-gd-1_48.dll(debug version),boost_date_time-vc100-mt-1_48.dll(release version)
编译选项方面还有install等参数.
Jsoncpp Linux编译
export SCONS_PATH=/usr/tmp/scons-2.2.0
export SCONS_LIB_DIR=$SCONS_PATH/engine
export JSONCPP_PATH=/usr/tmp/jsoncpp-src-0.6.0-rc2
python $SCONS_PATH/script/scons platform=linux-gcc