Boost下載安裝編譯配置使用指南(含Windows和Linux
理論上,本文適用于boost的各個版本,尤其是最新版本1.45.0;適用于各種C++編譯器,如VC6.0(部分庫不支持),VS2003,VS2005,VS2008,gcc,C++ Builder等。先總結一下Windows系統。
一、下載
首先從boost官方主頁附鏈接下載最新版boost安裝包(目前最新版是boost_1_45_0.7z)。
二、安裝
將boost安裝包解壓至本地目錄,如:E:\SDK\boost_1_45_0。因為boost一部分類是需要編譯成庫才能使用的,所以我們還需要準備好boost專用的編譯輔助工具bjam。在命令提示符(cmd.exe)中執行根目錄下的bootstrap.bat,編譯后的bjam.exe會自動拷貝到該目錄下(bjam必須與boost-build.jam在同級目錄)。
三、編譯
接下來就是最重要的編譯步驟了。需要打開命令提示符(cmd.exe)窗口并執行bjam,可以使用--help參數來查看命令幫助。這里詳細講解一下bjam的命令行參數,因為它非常重要。首先,它涉及到編程環境的搭建,你需要根據自己今后具體的使用環境來選擇合適的命令行參數;其次,它影響到你的硬盤空間,完全編譯的話據說在3G以上,如果你同時擁有2個以上的IDE(如VC6和VC9共存)而且都要用到boost,那么占用多少硬盤就自己算吧……雖說如今大家的硬盤空間都不成問題,但就像本人一樣崇尚合理利用資源不習慣鋪張浪費提倡節儉的童子應該大有人在。綜合以上兩點因素,本人使用的bjam命令如下:
bjam stage --toolset=msvc-9.0 --without-graph --without-graph_parallel --without-math --without-mpi --without-python --without-serialization --without-wave --stagedir="E:\SDK\boost_1_45_0\bin\vc9" link=static runtime-link=shared threading=multi debug release
下面詳細解釋一下每個參數的含義,請務必仔細看完:
stage/install:stage表示只生成庫(dll和lib),install還會生成包含頭文件的include目錄。本人推薦使用stage,因為install生成的這個include目錄實際就是boost安裝包解壓縮后的boost目錄(E:\SDK\boost_1_45_0\boost,只比include目錄多幾個非hpp文件,都很小),所以可以直接使用,而且不同的IDE都可以使用同一套頭文件,這樣既節省編譯時間,也節省硬盤空間。
toolset:指定編譯器,可選的如borland、gcc、msvc(VC6)、msvc-9.0(VS2008)等。
without/with:選擇不編譯/編譯哪些庫。因為python、mpi等庫我都用不著,所以排除之。另外,wave、graph、math、regex、test、program_options、serialization、signals這幾個庫編出的靜態lib都非常大,所以不需要的也可以without掉。這可以根據各人需要選擇,默認是全部編譯。但是需要注意,如果選擇編譯python的話,是需要python語言支持的,應該到python官方主頁附鏈接下載安裝。
stagedir/prefix:stage時使用stagedir,install時使用prefix,表示編譯生成文件的路徑。推薦給不同的IDE指定不同的目錄,如VS2008對應的是E:\SDK\boost_1_45_0\bin\vc9,VC6對應的是E:\SDK\boost_1_45_0\bin\vc6,否則都生成到一個目錄下面,難以管理。如果使用了install參數,那么還將生成頭文件目錄,vc9對應的就是E:\SDK\boost_1_45_0\bin\vc9\include\boost-1_45\boost,vc6類似(光這路徑都這樣累贅,還是使用stage好)。
build-dir:編譯生成的中間文件的路徑。這個本人這里沒用到,默認就在根目錄(E:\SDK\boost_1_45_0)下,目錄名為bin.v2,等編譯完成后可將這個目錄全部刪除(沒用了),所以不需要去設置。
link:生成動態鏈接庫/靜態鏈接庫。生成動態鏈接庫需使用shared方式,生成靜態鏈接庫需使用static方式。一般boost庫可能都是以static方式編譯,因為最終發布程序帶著boost的dll感覺會比較累贅。
runtime-link:動態/靜態鏈接C/C++運行時庫。同樣有shared和static兩種方式,這樣runtime-link和link一共可以產生4種組合方式,各人可以根據自己的需要選擇編譯。一般link只選static的話,只需要編譯2種組合即可,即link=static runtime-link=shared和link=static runtime-link=static。
threading:單/多線程編譯。一般都寫多線程程序,當然要指定multi方式了;如果需要編寫單線程程序,那么還需要編譯單線程庫,可以使用single方式。
debug/release:編譯debug/release版本。一般都是程序的debug版本對應庫的debug版本,所以兩個都編譯。
本人按以上方式分別編譯了靜態鏈接和動態鏈接兩個版本后,整個E:\SDK\boost_1_45_0目錄(包括安裝包解壓縮文件和編譯生成的庫文件)只有不到500MB。事實上編譯完成后安裝包解壓縮文件除了boost目錄之外其他目錄和文件已經可以刪除了,這樣還可以騰出150MB的空間來。不過我又研究了一下,其實libs這個目錄也很有用,它提供了所有Boost類的使用范例,平時可以作為參考;另外doc目錄是一個完整的boost使用幫助文檔,當然最好也不要刪了。這樣剩下的幾個目錄和文件加起來也就十多兆,索性都給它們留一條生路吧。
呵呵,一個完整而又完美的boost目錄就此誕生了。
如果圖省事,不想了解這么多,那么有簡單的方法,可以使用命令:
bjam --toolset=msvc-9.0 --build-type=complete
直接指定編譯器以完全模式編譯即可,這樣可以滿足今后的一切使用場合,但同時帶來的后果是:
1、占用3G以上的硬盤空間
2、占用若干小時的編譯時間
3、頭文件和庫文件存放于C:\Boost(個人非常反感)
4、生成的很多文件可以永遠也用不上
四、配置
include目錄:E:\SDK\boost_1_45_0
library目錄:E:\SDK\boost_1_45_0\bin\vc9
添加到IDE相應的路徑下面即可。
五、使用
使用舉例:
#include <boost\thread.hpp>
此時,不用包含庫文件,boost的auto-link機制將會自動幫我們包含對應的靜態lib。也就是說,boost默認是以靜態方式鏈接的,這樣我們的工程屬性最好也設為Multi-threaded (Debug)。如果想使用dll動態方式鏈接,需要預先定義宏:
#define BOOST_ALL_DYN_LINK
同樣,此時boost也會默認幫我們包含對應的lib。如果不想使用boost提供的auto-link機制,或者對它的自動鏈接不太放心的話(其實大可不必擔心),可以預先定義宏:
#define BOOST_ALL_NO_LIB
然后使用以下方法鏈接:
#pragma comment(lib, "boost_thread-vc90-mt-1_45.lib")
或
#pragma comment(lib, "boost_thread-vc90-mt.lib")
這兩個lib其實是一樣的,實在不明白boost編譯時為什么每個庫都要復制一份,難道是因為后者在升級boost版本后不用改代碼?另外還有一個比較有用的宏:
#define BOOST_LIB_DIAGNOSTIC
它可以讓VC在編譯時的output窗口中輸出程序具體鏈接了哪些boost庫以及鏈接順序。
關于boost的auto-link機制,詳細可以看看boost\config\auto_link.hpp里的代碼,很容易可以讀懂,并且值得我們學習。
六、Linux下編譯與配置的區別:
我的Linux與Windows使用了共享目錄,將Windows下的E:\SDK目錄映射成了Linux下的/mnt/hgfs/sdk目錄。
所以我的boost源文件根目錄就是/mnt/hgfs/sdk/boost_1_45_0,cd進去。
首先需要編譯bjam:
cd tools/jam
./build_dist.sh
我在虛擬機的Linux下編譯bjam的時候最后會卡住,屏幕顯示到mkdir的地方就不往下走了,不過其實這時候bajm已經編譯完成。
接下來將stage/bin.linuxx86目錄下生成的bjam拷貝到boost源文件根目錄boost_1_45_0下,cd進去,開始編譯boost:
./bjam stage --toolset=gcc --with-date_time --with-thread --with-filesystem --with-program_options --stagedir="/mnt/hgfs/sdk/boost_1_45_0/bin/gcc" link=static runtime-link=static threading=multi debug release
這些參數的意義與Windows下完全一樣,只不過編譯器改成gcc,其他選項根據自己的需要進行設置。
生成的庫文件就在bin/gcc/lib目錄下,與vc9編譯的一樣,lib目錄感覺是多余的,手動將庫文件拷貝到gcc目錄下,刪掉lib目錄,這屬于個人喜好問題。
然后把中間文件全部刪掉,包括bin.v2目錄和tools/jam/stage目錄。
關于boost庫的使用,為了不用每次寫makefile都把boost的頭文件和庫文件的路徑帶著,而且為了讓跨平臺程序公用一套代碼,
可以將boost的頭文件和庫文件路徑加到Linux的環境變量中。打開/etc/profile,加入以下gcc環境變量:
CPLUS_INCLUDE_PATH=$CPLUS_INCLUDE_PATH:"/mnt/hgfs/sdk/boost_1_45_0"
export CPLUS_INCLUDE_PATH
LIBRARY_PATH=$LIBRARY_PATH:"/mnt/hgfs/sdk/boost_1_45_0/bin/gcc"
export LIBRARY_PATH
這樣就可以直接使用boost的頭文件和庫文件了,并且與Windows共用一套代碼,非常方便。
七、可參考的網上流行的幾篇文章:
白話C++之安裝boost:附鏈接
Windows VC6編譯安裝Boost庫:附鏈接
boost編譯步驟:附鏈接
boost 1.35.0 Visual Studio 2008編譯指南:附鏈接
VS2008下安裝boost:http://www.cnblogs.com/xdotnet/archive/2008/03/22/boost_install_config.html