Boost下載安裝編譯配置使用指南
理論上,本文適用于boost的各個版本,尤其是最新版本1.46.0;適用于各種C++編譯器,如VC6.0,VS2003,VS2005,VS2008,gcc,C++ Builder等。
一、下載
首先從boost官方主頁http://www.boost.org下載最新版boost安裝包(目前最新版是1.46.0)。因為boost一部分類是需要編譯成庫才能使用的,所以我們還需要準備好boost專用的編譯輔助工具bjam。網上很多人都提倡直接使用boost安裝包中附帶的bjam源碼來編譯出bjam,但是之前需要修改若干配置腳本才能編譯成功。個人認為真沒什么必要,費這勁毫無意義。boost官方網站在提供boost安裝包下載鏈接的同時也提供與該版本安裝包對應的bjam的下載,只有200多KB,可以一同下載下來。
二、安裝
將boost安裝包解壓至本地目錄,如:E:\SDK\boost_1_39_0,然后將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-python –stagedir=”E:\SDK\boost_1_39_0\vc9″ link=shared runtime-link=shared threading=multi debug release
下面詳細解釋一下每個參數的含義,請務必仔細看完:
stage/install:stage表示只生成庫(dll和lib),install還會生成包含頭文件的include目錄。本人推薦使用stage,因為install生成的這個include目錄實際就是boost安裝包解壓縮后的boost目錄(E:\SDK\boost_1_39_0\boost,只比include目錄多幾個非hpp文件,都很小),所以可以直接使用,而且不同的IDE都可以使用同一套頭文件,這樣既節省編譯時間,也節省硬盤空間。
toolset:指定編譯器,可選的如borland、gcc、msvc(VC6)、msvc-9.0(VS2008)等。
without/with:選擇不編譯/編譯哪些庫。本人不需要編譯python庫,所以排除之,可以根據各人需要選擇,默認是全部編譯。但是需要注意,如果選擇編譯python的話,是需要python語言支持的,應該到python官方主頁http://www.python.org下載安裝。
stagedir/prefix:stage時使用stagedir,install時使用prefix,表示編譯生成文件的路徑。推薦給不同的IDE指定不同的目錄,如VS2008對應的是E:\SDK\boost_1_39_0\vc9\lib,VC6對應的是E:\SDK\boost_1_39_0\vc6\lib,否則都生成到一個目錄下面,難以管理。如果使用了install參數,那么還將生成頭文件目錄,vc9對應的就是E:\SDK\boost_1_39_0\vc9\include\boost-1_39\boost,vc6類似(光這路徑都這樣累贅,還是使用stage好)。
build-dir:編譯生成的中間文件的路徑。這個本人這里沒用到,默認就在根目錄(E:\SDK\boost_1_39_0)下,目錄名為bin.v2,等編譯完成后可將這個目錄全部刪除(沒用了),所以不需要去設置。
link:生成動態鏈接庫/靜態鏈接庫。生成動態鏈接庫需使用shared方式,生成靜態鏈接庫需使用 static方式。這里需要注意的是,static方式下,最終生成的很多靜態鏈接庫大小都在幾兆、幾十兆,甚至接近百兆。這么大的庫我們一般是不會采用靜態鏈接方式的,所以這些庫不推薦以static方式編譯(without掉);如果已經編譯了趕快刪,肯定沒用,否則將占用近1G的硬盤空間。以下是巨型庫黑名單:wave、graph、math、regex、test、program_options、serialization、signals。
runtime-link:動態/靜態鏈接C/C++運行時庫。同樣有shared和static兩種方式,這樣runtime-link和link一共可以產生4種組合方式。雖然它和link屬性沒有直接關系,但我們習慣上,一個工程如果用動態鏈接那么所有庫都用動態鏈接,如果用靜態鏈接那么所有庫都用靜態鏈接。所以這樣其實只需要編譯2種組合即可,即link=shared runtime-link=shared和link=static runtime-link=static。
threading:單/多線程編譯。一般都寫多線程程序,當然要指定multi方式了;如果需要編寫單線程程序,那么還需要編譯單線程庫,可以使用single方式。
debug/release:編譯debug/release版本。一般都是程序的debug版本對應庫的debug版本,所以兩個都編譯。
本人按以上方式分別編譯了靜態鏈接和動態鏈接兩個版本后,整個E:\SDK\boost_1_39_0目錄(包括安裝包解壓縮文件和編譯生成的庫文件)只有250MB。事實上編譯完成后安裝包解壓縮文件除了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_39_0
library目錄:E:\SDK\boost_1_39_0\vc9\lib
添加到IDE相應的路徑下面即可。
五、使用
使用舉例:
#include
此時,不用包含庫文件,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_39.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里的代碼,很容易可以讀懂,并且值得我們學習。
六、不推薦的網上流行的幾篇參考文章:
Windows VC6編譯安裝Boost庫:http://blog.csdn.net/weekly123/archive/2007/11/23/1899188.aspx
boost編譯步驟:http://blog.csdn.net/aheroofeast/archive/2009/03/22/4015458.aspx
boost 1.35.0 Visual Studio 2008編譯指南:http://blog.csdn.net/benjiamen/archive/2008/07/12/2643705.aspx
VS2008下安裝boost:http://www.cnblogs.com/xdotnet/archive/2008/03/22/boost_install_config.html
白話C++之安裝boost:http://www.d2school.com/bhcpp_book/2_5.php