boost安装详解

时间:2024-03-14 20:02:15

原文地址:https://www.cnblogs.com/icmzn/p/5911073.html

1. 为什么要安装?

  boost是一个开源库,因为开源库可以跨平台,可以通过在不同的“硬件”平台上。所以需要安装的操作。

  安装,然后编译生成“静态链接库lib”,或“动态链接库dll”等。

2. 下载boost安装包,现在已经到1.60版本了,所以为了稳定,使用1.59版本

  解压后,后目录如下:

  boost安装详解boost安装详解

3  编译boost源文件

3.1解压后,可以点击index.html文件,可以通过说明文档,进行安装。

(1)双击boostrap.bat文件,执行bootstrap.bat。

  会在boost根目录生成 b2.exe 、bjam.exe 、project-config.jam 、bootstrap.log四个文件。

  其中,b2.exe 、bjam.exe 这两个exe作用是一样的,bjam.exe 是老版本,b2是bjam的升级版本。

3.2 使用bjam(或b2)来编译boost

 bjam命令参数分析

b2  stage  --toolset=msvc-12.0  --with-date_time    --stagedir="D:\boost_1_56_0\"    link=static       runtime-link=static     threading=multi    debug    release

(1)stage/install:

stage表示只生成库(dll和lib),install还会生成包含头文件的include目录。本人推荐使用stage,因为install生成的这个include目录实际就是boost安装包解压缩后的boost目录(只比include目录多几个非hpp文件,都很小),所以可以直接使用,而且不同的IDE都可以使用同一套头文件,这样既节省编译时间,也节省硬盘空间。

(2)toolset:

指定编译器,可选的如borland、gcc、msvc(VC6)、msvc-9.0(VS2008)等。

vs2008 : msvc-9.0,vs2010 : msvc-10.0,

VS2012、VS2013:msvc-12.0

(3)without/with:

选择不编译/编译哪些库。因为python、mpi等库我都用不着,所以排除之。还有wave、graph、math、regex、test、program_options、serialization、signals这几个库编出的静态lib都非常大,所以不需要的也可以without掉。这可以根据各人需要进行选择,默认是全部编译。但是需要注意,如果选择编译python的话,是需要python语言支持的,应该到python官方主页http://www.python.org/下载安装。

查看boost包含库的命令是bjam --show-libraries

(4)stagedir/prefix:

stage时使用stagedir,install时使用prefix,表示编译生成文件的路径。推荐给不同的IDE指定不同的目录,如VS2008对应的是E:\SDK\boost\bin\vc9,VC6对应的是E:\SDK\boost\bin\vc6,否则都生成到一个目录下面,难以管理。如果使用了install参数,那么还将生成头文件目录,vc9对应的就是E:\SDK\boost\bin\vc9\include\boost-1_46\boost,vc6类似(光这路径都这样累赘,还是使用stage好)。

  推荐的配置格式:(为了避免污染源代码,放置在与boost的平等的目录结构位置)

  ***\boost**159\(源文件)

 

  ***\boost**159_bin_SDK\msvc12_release

  ***\boost**159_bin_SDK\msvc12_debug

 

  ***\boost**159_bin_SDK\gcc11_release

  ***\boost**159_bin_SDK\gcc11_debug

(5)build-dir:

编译生成的中间文件的路径。这个本人这里没用到,默认就在根目录(E:\SDK\boost)下,目录名为bin.v2,等编译完成后可将这个目录全部删除(没用了),所以不需要去设置。

(6)link:

生成动态链接库/静态链接库。生成动态链接库需使用shared方式,生成静态链接库需使用static方式。一般boost库可能都是以static方式编译,因为最终发布程序带着boost的dll感觉会比较累赘。

(7)runtime-link:

动态/静态链接C/C++运行时库。同样有shared和static两种方式,这样runtime-link和link一共可以产生4种组合方式,各人可以根据自己的需要选择编译。

(8)threading:

单/多线程编译。一般都写多线程程序,当然要指定multi方式了;如果需要编写单线程程序,那么还需要编译单线程库,可以使用single方式。

(9)debug/release:

编译debug/release版本。一般都是程序的debug版本对应库的debug版本,所以两个都编译。

编译boost

编译boost的命令比较复杂,尤其是 link, runtime-link 这两个选项的功能分不太清楚,他们共有4种相互组合,这些相互组合各有什么含义呢?

所以首先做个实验,仅编译date_time库,观察一下这两个选项的作用。

boost安装详解

第一种;
b2 stage --toolset=msvc-12.0 --with-date_time --stagedir="E:\eCode\boost_1_56_0\bin\vc12" link=static runtime-link=static threading=multi debug release
第二种;
b2 stage --toolset=msvc-12.0 --with-date_time --stagedir="E:\eCode\boost_1_56_0\bin\vc12" link=static runtime-link=shared threading=multi debug release
第三种;
b2 stage --toolset=msvc-12.0 --with-date_time --stagedir="E:\eCode\boost_1_56_0\bin\vc12" link=shared runtime-link=shared threading=multi debug release
第四种:
b2 stage --toolset=msvc-12.0 --with-date_time --stagedir="E:\eCode\boost_1_56_0\bin\vc12" link=shared runtime-link=static threading=multi debug release
第五种:
b2 stage --toolset=msvc-12.0 --with-date_time --stagedir="E:\eCode\boost_1_56_0\bin\vc12_2" (默认,为避免将前面的结果覆盖,配置另一目录vc12_2存放)
第五种:
b2 stage --toolset=msvc-12.0 --with-date_time --stagedir="E:\eCode\boost_1_56_0\bin\vc12_2" --build-type=complete(为避免将前面的结果覆盖,配置另一目录vc12_3存放)

boost安装详解

所得到的响应的Boost库结果如下表所示:

 
序号          link 设置           Runtime设置        生成文件区别 (Debug,Release)两个版本       备注  
1 static static

libboost_date_time-vc120-mt-sgd-1_56.lib

libboost_date_time-vc120-mt-s-1_56.lib

 
2 static shared

libboost_date_time-vc120-mt-gd-1_56.lib

libboost_date_time-vc120-mt-1_56.lib

 (缺省的配置)
3 shared shared

boost_date_time-vc120-mt-gd-1_56.dll

boost_date_time-vc120-mt-gd-1_56.lib

boost_date_time-vc120-mt-1_56.dll

boost_date_time-vc120-mt-1_56.lib

 
4 shared static 不能编译  
5 使用缺省 使用缺省 libboost_date_time-vc120-mt-gd-1_56.lib
libboost_date_time-vc120-mt-1_56.lib
 (与2结果相同)
6  使用--build-type=complete   boost_date_time-vc120-mt-gd-1_56.dll
boost_date_time-vc120-mt-gd-1_56.lib

boost_date_time-vc120-mt-1_56.dll
boost_date_time-vc120-mt-1_56.lib 

libboost_date_time-vc120-mt-sgd-1_56.lib
libboost_date_time-vc120-mt-s-1_56.lib

libboost_date_time-vc120-mt-gd-1_56.lib
libboost_date_time-vc120-mt-1_56.lib

libboost_date_time-vc120-s-1_56.lib
libboost_date_time-vc120-sgd-1_56.lib
 

 说明:

(1)--build-type=complete时link,runtime-link3种组合下debug, release的多线程版本都生成出来了除此之外还生成了link=static,runtime-link=static的debug, release的单线程版本

(2)Boost库的使用方式link决定了生成的库的格式:lib(静态链接库-static), dll(动态链接库-share)

  当link是static时,生成的静态库: libboost_*****.lib

  当link是share时,生成的动态链接库:boost_****.dll

(3)Boost库的编译中runtime-link,决定了生成库与C/C++库的连接方式

  当runtime-link是static使: 生成的库文件名有  s

  当runtime-link是share使: 生成的库文件名没有s

(4)link以及与runtime-link缺省的设置是:

    link是静态的(便于整合到应用中,避免单独移动boost的相关动态连接库)

    runtime-link是share的,这样可以动态调用c/C++运行时库,方便

(5)degug版本的库名称: 含有gd

  release版本中的库名称;不含有gd

(6)threading,设置mutl 多线程的库,则库名称包含:mutl

  如果是单线程,则没有mutl

 (7)我们还可以分析一下 boost 库的命名特点

  • 以“lib”开头的是“link=static”版本(静态链接库版本,没有dll),而直接以“boost”开头的是“link=shared”版本(动态链接库版本,包含lib和dll)。
  • 所有的库都含有"boost"前缀。
  • 紧随其后的是boost库名称(比如date_time库)。
  • 然后是编译器的版本,与库名称之间以"-"而不是下划线"_"分隔(比如 -vc120)。
  • 有“mt”的为“threading=multi”版本,没有的则是“threading=single”版本。
  • 有“s”的为“runtime-link=static”版本,没有的则是“runtime-link=shared”版本。
  • 有“gd”的为debug版本,没有的则是release版本。
  • 所有的库都含有boost库的版本号结尾(比如1_56,其中的"."以下划线"_"代替)

 (8)link, runtime-link 组合分析

  假设一个库A依赖于库B,我们自己的程序client依赖于库A,即:

    boost安装详解

  那么,link指的是client->A,runtime-link指的是A -> B

link,与runtime-link的不同设置  连接过程分析 运行过程需要的文件

link=static

runtime-link=static

client通过A.a (A.lib)静态包含A;

A通过B.a (B.lib)静态包含B;

不关 .so .dll的事(这是动态库)

client

(源文件)

因为静态lib,已经在编译时候

加载到应用程序中了

(默认方式)

link=static

runtime-link=shared

client通过A.a (A.lib)静态包含A;

在运行时,client要动态调用B.so (B.dll)

(动态加载运行时库)

client

B.so (B.dll)

(源文件,与c/c++动态运行库)

link=shared

runtime-link=shared

client会包含A.a (A.lib);

A会包含 B.a (B.lib);

但都只保存动态库的真正实现的stub,

运行时通过stub去动态加载 A.so (A.dll), B.so (B.dll) 中的实现

client

A.so (A.dll)

B.so (B.dll)

(源文件,bootst的动态库,c/c++的动态库)

link=shared

runtime-link=static

没有这种使用方式  

 

综上:在根据boost的源码编译boost的何种库时,最好采用默认的形式:

  b2  stage --toolset=msvc-12.0  --stagedir="E:\boost_1_56_0_bin_SDK\msvc12" link=static runtime-link=shared threading=multi  debug  release

  至此,Boost的源码编译完毕!!!编译后的Boost 特定类型的库将会在E:\boost_1_56_0_bin_SDK\msvc12目录下产生lib的文件夹,然后在此文件夹下面产生debug,以及release两个版本的库文件。如下图

  boost安装详解

 4. 配置VS2013编译器,然后使用开发boost应用

主要的配置两个:

包含头文件的Include路径:E:\boost_1_56_0

包含库文件的链接路径:E:\boost_1_56_0_bin_SDK\msvc12_release\lib

4.1 只配置应用于此项目,而不适用于解决方案中的其他项目(仅应用于当前项目)。

(1)添加附加包含目录:把boost源文件中的boost的头文件添加进入

  选中当前project->Properties->Configuration Properties->C/C++->General: Additional Include Directories(附加包含目录): 设置 E:\eCode\boost_1_56_0

(2)添加booost生成的静态库文件,

  选中当前project->Properties->Configuration Properties->Linker->General: Additional LibraryDirectories(附加库目录): 设置 E:\eCode\boost_1_56_0\bin\vc12\lib

  boost安装详解

  boost安装详解

4.2 配置适应于解决方案中的所有项目(推荐,此应用于整个解决方案)

 

  选中当前project->Properties->Configuration Properties->VC++ Directories:

 

  Include Directories: 设置 E:\eCode\boost_1_56_0

 

  LibraryDirectories: 设置 E:\eCode\boost_1_56_0\bin\vc12\lib

 

  boost安装详解

4.3  其他情况

(3)可设置为OS当前用户下的VC++环境(当前用户下VC++所创建的所有Solution)

在某个已打开的工程下,切换到Property Manager 选项卡,然后然后展开当前工程的properties配置,打开Microsoft.Cpp.Win32.User

选择Common Properties->VC++ Directories:

Include Directories: 设置 E:\eCode\boost_1_56_0

LibraryDirectories: 设置 E:\eCode\boost_1_56_0\bin\vc12\lib

这样设置的仅在Win32编译选项下起作用,x64编译选项需要另外配置x64的properties sheet。

(4)可设置为OS所有用户下的VC++环境

可以编辑 Microsoft.Cpp.Default.props 、Microsoft.Cpp.props 。这里就不介绍了。

5  Boost库的应用测试

  date_time计时函数。创建一个Win32 console 工程

 

boost安装详解

//#define BOOST_DATE_TIME_SOURCE
#include <iostream>
#include <boost/date_time/gregorian/gregorian.hpp>
#include <boost/date_time/posix_time/posix_time.hpp>
using namespace std;
using namespace boost::gregorian;
using namespace boost::posix_time;

/************************************************************************
创建微秒级的计时器
************************************************************************/

template <class T = microsec_clock>
class MyTimer
{
private:
    ptime m_startTime;

public:
    MyTimer()
    {
        Restart();
    }

    void Restart()
    {
        m_startTime = T::local_time();
    }


    void Elapsed()
    {
        cout << T::local_time() - m_startTime << endl;
    }
};


int main()
{
    MyTimer<microsec_clock> t;
    for(int i = 0; i < 100; ++i)
    {
        cout << "hello" << endl;
    }
    t.Elapsed();
}

boost安装详解

 

注意开头的宏 “#define BOOST_DATE_TIME_SOURCE” 注掉了。

若启用这个宏定义,则默认由编译器重新编译嵌入的头文件;(源文件从新嵌入)

若不启用这个宏定义,则表示使用系统已编译好的date_time库(直接从boost库中引用即可,方便,GOOG)

说明:

(1)禁用#define BOOST_DATE_TIME_SOURCE 宏,然后将(静态lib) libboost_date_time-vc120-mt-gd-1_56.lib 从 E:\eCode\boost_1_56_0\bin\vc12\lib 中移除,编译debug版的程序时,提示连接错误,缺少libboost_date_time-vc120-mt-gd-1_56.lib。

  (所以,不能移除eg(debug)版本的lib,并且此lib已经包含在VS2013中了)

(2)启用#define BOOST_DATE_TIME_SOURCE 宏,编译debug版的程序时,可发现即使在缺少 libboost_date_time-vc120-mt-gd-1_56.lib的情况下,也能成功编译。(因为已经重新嵌入头文件)

 

 

References

【1】Boost下载安装编译配置使用指南(含Windows、Linux以及ARM Linux)(http://www.cnblogs.com/wondering/archive/2009/05/21/boost_setup.html

【2】link 和 runtime-link,搭配shared 和 static(http://blog.csdn.net/yasi_xi/article/details/8660549

【3】计时函数(二)(http://www.cnblogs.com/jerry19880126/archive/2013/02/20/2919718.html

【4】官方文档Getting Started on Windows(http://www.boost.org/doc/libs/1_56_0/more/getting_started/windows.html)

【5】bjam使用(http://blog.chinaunix.net/uid-22301538-id-3158997.html

 

 


 

关于Boost的其他说明

1. Boost库是一个可移植、提供源代码的C++库,作为标准库的后备,是C++标准化进程的开发引擎之一。 Boost库由C++标准委员会库工作组成员发起,其中有些内容有望成为下一代C++标准库内容。在C++社区中影响甚大,是不折不扣的“准”标准库。Boost由于其对跨平台的强调,对标准C++的强调,与编写平台无关。大部分boost库功能的使用只需包括相应头文件即可,少数(如正则表达式库,文件系统库等)需要链接库。但Boost中也有很多是实验性质的东西,在实际的开发中实用需要谨慎。

2.#编译bjam的认识

 

首先从SourceForge上下载Boost库的压缩包,此时的最新版为1.57.0,下载地址为http://nchc.dl.sourceforge.net/project/boost/boost/1.57.0/boost_1_57_0.7z;下载后,解压缩7z包。然后以管理员方式在命令提示符下运行bootstrap.bat批处理文件,运行后会在当前目录中出现bjam.exe文件。

 

3. 采用VS2013的工具编译Boost库文件

  boost安装详解

  32位编译: #从开始菜单启动Visual Studio 2013的vs2013 命令行,进入boost所在目录,运行bootstrap.bat

bjam.exe stage --toolset=msvc-12.0 --without-graph --without-graph_parallel --without-math --without-mpi --without-serialization --without-wave --without-test --without-program_options --without-serialization --without-signals --stagedir="vc12_x86" link=static runtime-link=sharedthreading=multi debug release

  #64位编译: 从开始菜单启动Visual Studio 2013的vs2013 x64兼容工具命令行,然后转到boost根文件夹,运行bootstrap.bat生成x64版的bjam.exe。

   在编译命令中加入address-model=64属性

 

4. #toolset:指定编译器

可选的(待补充)

borland、

gcc、

msvc(VC6)、

msvc-10.0(VS2010)

msvc-9.0 (vs2008 )

msvc-12.0(VS2012、VS2013)

5. #stagedir:表示编译生成文件的路径。

6. #build-dir:编译生成的中间文件的路径。这个本人这里没用到,默认就在根目录(D:\boost\boost_1_57_0)下,目录名为bin.v2(删掉),等编译完成后可将这个目录全部删除(没用了),所以不需要去设置

7. #without/with:选择不编译/编译哪些库。

8. #address-model:要有address-model=64属性,如果没有这个属性的话,会默认生成32位的平台库,加入这个选项才能生成64位的DLL

9. #threading:单/多线程编译。一般都写多线程程序,当然要指定multi方式了;如果需要编写单线程程序,那么还需要编译单线程库,可以使用single方式。

10. #静态库版link=shared,动态库link=shared #runtime-link:动态/静态链接C/C++运行时库。同样有shared和static两种方式,这样runtime-link和link一共可以产生4种组合方式,各人可以根据自己的需要选择编译。

  一般link只选static的话,只需要编译2种组合即可,即link=static runtime-link=shared和link=static runtime-link=static

11. #debug/release:编译debug/release版本。

  一般都是程序的debug版本对应库的debug版本,所以两个都编译。

12 .VS2013环境的设置

(在项目-->右键属性-->C/C++)

附加包含目录:如:F:/boost_1.57_0

链接器:附加库目录:(编译生成文件的路径)如:F:/boost_1.57_0/stage/bin

附加依赖项:(项目所需编译库),是静态lib库,可以指定

,然后在连接的时候,导入到程序中(如下图)。

如果编译成Debug则包含:libboost_regex-vc120-mt-gd-1_57.lib(举例)

如果编译成Release则包含:libboost_regex-vc120-mt-  1_57.lib

或者添加#pragma comment(lib, "libboost_regex-vc120-mt-gd-1_57.lib")附加链接库

  boost安装详解

13. 最后的应用程序中,只指定应用中采用的boost库,这样可以缩小应用程序的体积。

  #define BOOST_LIB_DIAGNOSTIC

  它可以让VC在编译时的output窗口中输出程序具体链接了哪些boost库以及链接顺序。

boost安装详解

#include "stdafx.h"
#include <boost/regex.hpp>
#include <boost/asio.hpp>
#include <iostream>
#pragma comment(lib, "libboost_date_time-vc120-mt-gd-1_57.lib")
#pragma comment(lib, "libboost_system-vc120-mt-gd-1_57.lib")

int _tmain(int argc, _TCHAR* argv[])
{
    boost::regex reg("[0-9]+");//lib库在项目附加依赖项中添加了
    std::cout << boost::regex_match("123", reg) << std::endl;
    boost::asio::io_service io;
    system("PAUSE");
    return 0;
}

boost安装详解

 

 最后的操作:

  为了在程序中(防止)修改源码:可以对Boost的头文件执行“可读”操作处理。

  boost安装详解

 

 

endl;

参考博客来源:http://www.cnblogs.com/cdma/p/4444801.html