windows下編譯安裝BOOST

boost的編譯和使用，通過蒐集資料和總結，記錄成文。感謝文後所列參考資料的做者。

1 下載

地址：http://sourceforge.net/projects/boost/files/boost/1.56.0/

能夠選擇 boost_1_56_0.7z 下載。

2 編譯

2.1 生成boost的自用的編譯工具bjam.exe

解壓後，使用VS2013編譯。首先打開「VS2013 開發人員命令提示」，cd 到boost解壓後的根目錄：E:\XXX\boost_1_56_0，執行bootstrap.bat。會在boost根目錄生成 b2.exe 、bjam.exe 、project-config.jam 、bootstrap.log四個文件。

其中，b2.exe 、bjam.exe 這兩個exe做用是同樣的，bjam.exe 是老版本，b2是bjam的升級版本。

2.2 使用bjam(或b2)來編譯boost

1. bjam命令參數分析

咱們以文章【1】中的命令來分析一下各個參數的做用（原做者解壓後的boost根目錄爲E:\SDK\boost）。

bjam stage --toolset=msvc-9.0 --without-python --stagedir="E:\SDK\boost\bin\vc9" link=static runtime-link=shared runtime-link=static threading=multi debug release

（1）stage/install：

stage表示只生成庫（dll和lib），install還會生成包含頭文件的include目錄。本人推薦使用stage，由於install生成的這個include目錄實際就是boost安裝包解壓縮後的boost目錄（E:\SDK\boost\boost，只比include目錄多幾個非hpp文件，都很小），因此能夠直接使用，並且不一樣的IDE均可以使用同一套頭文件，這樣既節省編譯時間，也節省硬盤空間。

（2）toolset：

指定編譯器，可選的如borland、gcc、msvc（VC6）、msvc-9.0（VS2008）等。

（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好）。

（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版本，因此兩個都編譯。

2. 編譯boost

編譯boost的命令比較複雜，尤爲是 link, runtime-link 這兩個選項的功能分不太清楚，他們共有4種相互組合，這些相互組合各有什麼含義呢？

因此首先作個實驗，僅編譯date_time庫，觀察一下這兩個選項的做用。

分別使用下面的命令行編譯，

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存放）

所獲得的結果以下表所示：

序號	link	runtime-link	生成物	備註
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	與5結果相同
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結果相同 而且在省略debug release時，debug release版本都編譯
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	--build-type=complete時，能夠看到link，runtime-link的 3種組合下debug， release的多線程版本都生成出來了， 除此以外，還生成了link=static，runtime-link=static的debug， release的單線程版本

從上面的結果能夠看到，link和runtime-link的缺省配置是 link=static runtime-link=shared，因此咱們可使用 (b2 stage --toolset=msvc-12.0 --with-date_time --stagedir="E:\eCode\boost_1_56_0\bin\vc12_2")命令行來編譯boost。

另外，咱們還能夠分析一下 boost 庫的命名特色：【2】

（1）以「lib」開頭的是「link=static」版本（靜態連接庫版本，沒有dll），而直接以「boost」開頭的是「link=shared」版本（動態連接庫版本，包含lib和dll）。

（2）全部的庫都含有"boost"前綴。

（3）緊隨其後的是boost庫名稱（好比date_time庫）。

（4）而後是編譯器的版本，與庫名稱之間以"-"而不是下劃線"_"分隔（好比 -vc120）。

（5）有「mt」的爲「threading=multi」版本，沒有的則是「threading=single」版本。

（6）有「s」的爲「runtime-link=static」版本，沒有的則是「runtime-link=shared」版本。

（7）有「gd」的爲debug版本，沒有的則是release版本。

（8）全部的庫都含有boost庫的版本號結尾（好比1_56，其中的"."如下劃線"_"代替）

3. link, runtime-link 組合分析

文章【2】給出了link，runtime-link的具體做用分析。

假設一個庫A依賴於庫B，咱們本身的程序client依賴於庫A，即：

那麼，link指的是client->A，runtime-link指的是A -> B

配置	連接過程	運行時須要的文件
link=static runtime-link=static	client經過A.a (A.lib)靜態包含A； A經過B.a (B.lib)靜態包含B； 不關 .so .dll的事	client
link=static runtime-link=shared	client經過A.a (A.lib)靜態包含A； 在運行時，client要動態調用B.so (B.dll)	client B.so (B.dll)
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)
link=shared runtime-link=static	client會包含A.a (A.lib)，但只包含真正實現的stub； A經過B.a (B.lib)靜態包含B； 運行時，client會動態調用A.so (A.dll)	client A.so (A.dll)

3. 配置

包含頭文件的Include路徑：E:\eCode\boost_1_56_0

包含庫文件的連接路徑：E:\eCode\boost_1_56_0\bin\vc12\lib

（1）能夠設置爲僅用於當前project：

選中當前project->Properties->Configuration Properties->C/C++->General: Additional Include Directories: 設置 E:\eCode\boost_1_56_0

選中當前project->Properties->Configuration Properties->Linker->General: Additional LibraryDirectories: 設置 E:\eCode\boost_1_56_0\bin\vc12\lib

（2）可設置爲僅用於當前Solution：

選中當前project->Properties->Configuration Properties->VC++ Directories:

Include Directories: 設置 E:\eCode\boost_1_56_0

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

（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 。這裏就不介紹了。

4. 測試

使用文章【3】中date_time計時函數。建立一個Win32 console 工程，而後copy下面代碼

//#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();
}

注意開頭的宏 「#define BOOST_DATE_TIME_SOURCE」 注掉了。若啓用這個宏定義，則默認由編譯器從新編譯嵌入的頭文件；若不啓用這個宏定義，則表示使用系統已編譯好的date_time庫。

（1）禁用#define BOOST_DATE_TIME_SOURCE 宏，而後將 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。

（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）