Boost C++ Libraries

PrevUpHomeNext

附錄 A. Boost.Jam 文件

目錄

建置 B2
語言
其他
歷史

建置 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. 支援的工具組

指令碼

平台

工具組

偵測與注意事項

build.bat

Windows NT、2000 和 XP

borland
Borland C++Builder (BCC 5.5)

  • 常見安裝位置:「C:\Borland\BCC55
  • BCC32.EXE 位於 PATH

como
Comeau Computing C/C++

gcc
GNU GCC

gcc-nocygwin
GNU GCC

intel-win32
適用於 Windows 的 Intel C++ 編譯器

  • ICL.EXE 位於 PATH

metrowerks
MetroWerks CodeWarrior C/C++ 7.x、8.x、9.x

  • 已設定 CWFolder 變數
  • MWCC.EXE 位於 PATH

mingw
GNU GCC 作為 MinGW 設定

  • 常見安裝位置:「C:\MinGW

msvc
Microsoft Visual C++ 6.x

  • 已設定 VCVARS32.BAT
  • 環境中存在 %MSVCDir%
  • 常見安裝位置:「%ProgramFiles%\Microsoft Visual Studio」、
  • CL.EXE 位於 PATH

vc7
Microsoft Visual C++ 7.x

  • 已設定 VCVARS32.BATVSVARS32.BAT
  • 環境中存在 %VS71COMNTOOLS%
  • 環境中存在 %VCINSTALLDIR%
  • 常見安裝位置:「%ProgramFiles%\Microsoft Visual Studio .NET」、
  • CL.EXE 位於 PATH

vc8vc9
Microsoft Visual C++ 8.x 和 9.x

偵測

  • 已設定 VCVARSALL.BAT
  • 環境中存在 %VS90COMNTOOLS%
  • 常見安裝位置:「%ProgramFiles%\Microsoft Visual Studio 9
  • 環境中存在 %VS80COMNTOOLS%
  • 常見安裝位置:「%ProgramFiles%\Microsoft Visual Studio 8
  • CL.EXE 位於 PATH

注意事項

  • 如果呼叫 VCVARSALL.BAT 來設定工具組,它會被傳遞所有額外的參數,請參閱下方說明這些參數的用途。例如,這可以用於建置 b2 的 Win64 特定版本。有關 VCVARSALL.BAT 可能的參數值,請查閱 Visual Studio 文件。

build.sh

Unix、Linux、Cygwin 等

acc
HP-UX aCC

  • aCC 位於 PATH
  • uname 為「HP-UX」

como
Comeau Computing C/C++

  • como 位於 PATH

gcc
GNU GCC

  • gcc 位於 PATH

intel-linux
適用於 Linux 的 Intel C++

  • icc 位於 PATH
  • 常見安裝位置:「/opt/intel/cc/9.0」、「/opt/intel_cc_80」、「/opt/intel/compiler70」、「/opt/intel/compiler60」、「/opt/intel/compiler50

kcc
Intel KAI C++

  • KCC 位於 PATH

kylix
Borland C++Builder

  • bc++ 位於 PATH 中

mipspro
SGI MIPSpro C

  • uname 為「IRIX」或「IRIX64

sunpro
Sun Workshop 6 C++

  • 標準安裝位置:「/opt/SUNWspro

qcc
QNX Neutrino

  • uname 為「QNX」且 qcc 位於 PATH

true64cxx
適用於 True64 UNIX 的 Compaq C++ 編譯器

  • uname 為「OSF1

vacpp
IBM VisualAge C++

  • xlc 位於 PATH

MacOS X

darwin
Apple MacOS X GCC

  • uname 為「Darwin

Windows NT、2000 和 XP

mingw
GNU GCC 作為使用 MSYS shell 的 MinGW 設定

  • 常見安裝位置:「/mingw


建置的可執行檔會放置在特定於您平台的子目錄中。例如,在執行於 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.batbuild.sh)傳入。

--show-locate-target

顯示建置完成的可執行檔將放置的位置,僅供參考。

--noassert

停用除錯斷言,即使建置的是可執行檔的除錯版本也一樣。

dist

如果可能,產生適用於在平台上發佈的套件(壓縮檔案)。

clean

移除所有已建置的可執行檔和物件。


PrevUpHomeNext