![]() |
建置 B2
後的安裝,只需將產生的執行檔複製到您的 PATH
環境變數中的某個位置即可。為了建置執行檔,有一組 build
開機指令碼以適應特定的環境。這些指令碼接受一個選用參數,即用於建置的工具組名稱。如果未提供工具組,則會嘗試偵測可用的工具組並使用它。建置指令碼接受以下參數
build [toolset]
在 Windows 平台上,從命令提示字元執行以下指令,成功的機率最高:
cd jam source location
.\build.bat
在 Unix 類型平台上,執行以下指令:
cd jam source location
sh ./build.sh
對於 Boost 發行版中包含的 Boost.Jam 原始碼,jam 原始碼位置 為 BOOST_ROOT/tools/build/v2/engine
。
如果指令碼無法偵測到適合您特定工具組的建置工具組,則您的工具組可能無法自動偵測。在這種情況下,您可以將工具組指定為第一個參數,這假設該工具組在 PATH
環境變數中可立即使用。
用於建置 Boost.Jam 的工具組與用於 Boost.Build 的工具組無關。只需要一個版本的 Boost.Jam 即可使用 Boost.Build。
支援的工具組,以及它們是否可自動偵測,如下所示:
表 A.1. 支援的工具組
指令碼 |
平台 |
工具組 |
偵測與注意事項 |
||
---|---|---|---|---|---|
|
Windows NT、2000 和 XP |
|
|
||
|
|||||
|
|||||
|
|||||
|
|
||||
|
|
||||
|
|
||||
|
|
||||
|
|
||||
|
偵測
注意事項
|
||||
|
Unix、Linux、Cygwin 等 |
|
|
||
|
|
||||
|
|
||||
|
|
||||
|
|
||||
|
|
||||
|
|
||||
|
|
||||
|
|
||||
|
|
||||
|
|
||||
MacOS X |
|
|
|||
Windows NT、2000 和 XP |
|
|
建置的可執行檔會放置在特定於您平台的子目錄中。例如,在執行於 Intel x86 相容晶片的 Linux 中,可執行檔會放置在:「bin.linuxx86
」中。=b2[.exe]= 可執行檔可用於叫用 Boost.Build。
建置腳本支援 Boost.Jam 開發人員使用的額外叫用參數,以及工具組的額外設定。額外參數位於工具組之後
--選項
」的參數會傳遞給 build.jam
建置腳本。build.jam
腳本的目標。build [toolset] [setup*] [--option+ target*]
工具組後面的參數會直接傳遞給工具組的設定腳本(如果可用且需要叫用的話)。這允許使用者根據需要設定工具組,以執行 b2
的非預設建置。例如,使用 vc8
建置 Win64 版本。請參閱上述的工具組說明,了解哪些特定工具組支援此功能。
以「--選項
」形式開頭的參數會傳遞給 build.jam
腳本,並用於進一步自訂建置的內容。build.jam
腳本支援的選項和目標
---
當只想指定目標時,使用空選項。
--release
預設值,建置最佳化的可執行檔。
--debug
建置可執行檔的除錯版本。建置完成後,它們會被放置在自己的目錄「bin./platform/.debug
」中。
--grammar
通常 Jam 語言語法解析檔案不會重新產生。這個選項會強制建置語法,但可能不會強制重新產生語法解析器。如果解析器過時,它將會被重新產生並隨後建置。
--with-python=路徑
啟用 Python 整合,指定 Python 函式庫的路徑。
--gc
啟用 Boehm 垃圾收集器。建置過程會在 b2
原始碼的「boehm_gc」子目錄中尋找 Boehm-GC 原始碼。
--duma
啟用 DUMA(偵測非預期記憶體存取)除錯記憶體配置器。建置過程預期在 b2
原始碼的「duma」子目錄中找到 DUMA 原始碼檔案。
--toolset-root=路徑
指示用於建置的工具集所在位置。此選項由啟動腳本(build.bat
或 build.sh
)傳入。
--show-locate-target
顯示建置完成的可執行檔將放置的位置,僅供參考。
--noassert
停用除錯斷言,即使建置的是可執行檔的除錯版本也一樣。
dist
如果可能,產生適用於在平台上發佈的套件(壓縮檔案)。
clean
移除所有已建置的可執行檔和物件。