Skip to content

Latest commit

 

History

History
272 lines (161 loc) · 11.2 KB

howtobuild.md

File metadata and controls

272 lines (161 loc) · 11.2 KB
Raw

Boostライブラリのビルド方法

ここではBoostライブラリのビルド方法について説明します。

Windowsとそれ以外に分けて説明します。また、LinuxではBoostライブラリがディストリビューションによって提供されていることがありますが、ここではビルド方法のみを扱います。

1.47.0からbjamだけではなく、b2も生成されるようになりました。また、公式がbjamからb2での説明に切り替わっています。なので、こちらもそれに合わせることにします。

ダウンロード

現在の最新バージョンは、以下からダウンロードできます：

開発バージョンは、Githubから取得できます：

Github から clone する場合、具体的には boostorg/boost を clone し、実際の Boost ライブラリ群は git submodule で扱います。新たに clone する場合は次のように --recursive オプションを付けて clone します。

git clone --recursive [email protected]:boostorg/boost.git

もし、 --recursive せずに clone した場合や、checkout に伴い必要な場合には次のようにします。

cd boost
git submodule --init --recursive

Windowsの場合

手順はここ(http://www.boost.org/doc/libs/release/more/getting_started/windows.html)に書かれていますのでそれを翻訳します。

解凍したディレクトリに移動します。

> cd (解凍したディレクトリ)

以下のコマンドを実行します。

> bootstrap.bat

すると、b2.exe,bjam.exeが生成されます。

単になんの指定もしないビルドでは：

> b2.exe install -j2 --prefix=(インストールしたいディレクトリ)

となります。これでビルドし、インストールされるのを待つだけです。

Vista/7以降のWindows OSを使っている場合は、--prefix=で指定するディレクトリにはProgram FilesのようなCドライブの管理者権限が必要になるディレクトリは避けてください。権限がない場合はインストールに失敗しますのでご注意を。

Windows以外、Linux/Macなどの場合

手順はここ(http://www.boost.org/doc/libs/release/more/getting_started/unix-variants.html)に書かれているのでそれを翻訳します。

解凍したディレクトリに移動します。

$ cd (解凍したディレクトリ)

以下のコマンドを実行します：

$ bootstrap.sh

これで実行可能ファイルのbjamおよびb2が生成されます。

単になんの指定もしないビルドでは：

$ ./b2 install -j2 --prefix=(インストールしたいディレクトリ)

となります。

Linuxを使っており、ディストリビューション提供のboostライブラリをインストールしている場合は、--prefixで/usr以外を必ず指定してください。--prefixを省略した場合/usr/localが選択されますが、多くの環境では$PATHの解決順序の関係上無条件で/usr/local上のBoostが選択されてしまうでしょう。

/usr以下を使用すると環境を壊すことになりかねないので、通常は$HOME/localや$HOME/boost_1_51_0といったディレクトリを用意するのが良いでしょう。

一部のディストリビューションでは$HOME/localを$PATHにデフォルトで登録しているものもあるので、複数人で共用している場合には便利です。

ヘッダーオンリーで使う場合

事前にビルドの必要の無い、またはマクロによりヘッダーオンリーで使用可能なライブラリーのみを使いたい場合には、 bootstrap を実行の後、b2 へ headers を引数として渡す事で、インクルード用のヘッダーファイル構造のみ構築できます。

./b2 headers

並列ビルド

一般的なmake同様に、複数CPUを使ってビルドできます。-j 8のように、-j Nと指定するとN個並列でビルド処理が実行されます。これを指定しないとビルドが非常に遅くなるので、基本的に常に指定することをおすすめします。

Nの数は、一般的にはCPUの物理コア数または物理コア数+1を指定することが多いようです。経験的に+1することでIO waitが隠蔽されるのを期待できます。

ノートPCだと熱が大変なことになるので、気になるようなら少し少なめにしても良いかもしれません。

※ここからは完全に蛇足です。

b2/bjamが受け取るコマンド

b2 --helpでは多くのユーザーが期待するヘルプを参照することはできません。

b2およびbjamに関するヘルプを参照するにはboostを解凍したディレクトリ上でb2 --helpを行なってください。

以下に紹介するb2/bjamへの引数に順序はありません。どのような順で指定しても正しく解釈されます。

コマンドラインの例:

./b2 toolset=msvc link=static,shared address-model=64 install

プロパティ

toolset

ひとつのマシンに複数種類のコンパイラがインストールされている場合はtoolsetコマンドで指定ができます。例えば、以下の指定が可能です。

コンパイラ指定 説明
borland Borland社のコンパイラ
dmc Digital Mars社のコンパイラ
darwin Apple社の手によるgccコンパイラ(Mac OS)
gcc GNU プロジェクトによるコンパイラ
intel Intel社によるコンパイラ
msvc Microsoft社によるコンパイラ

msvc-9.0 (Visual C++ 2008)、msvc-10.0 (Visual C++ 2010)のように、コンパイラのバージョン指定も可能です。

link

これはstatic, sharedライブラリを作るかどうかの指定をするコマンドです。以下のように指定して使用します。

link=static,shared

環境によって、以下のようなライブラリファイルを生成します。

Windows Mac OSX Other Systems
static .lib .a .a
shared .dll .dylib .so

threading

引数 説明
multi マルチスレッドなライブラリを生成します。
single シングルスレッドなライブラリを生成します。

筆者の環境ではsingleがエラーが出てコンパイルできなかった。 (#7105)

trunkで修正済み 1.53.0で修正されると思われる

variant

引数 説明
debug デバッグビルドを生成します。
release リリースビルドを生成します。

デフォルトプロパティ

Windows環境においてはデフォルトで以下のプロパティが使用されます。

link=static threading=multi variant=debug,release runtime-link=shared

Linux環境においてはデフォルトで以下のプロパティが使用されます。

link=static,shared threading=multi variant=release

その他の環境についてはアンドキュメントとなっているので注意してください。

アーキテクチャ

ターゲットアーキテクチャが異なる場合には、b2/bjamにarchitecture=<target-architecture>を指定すればよい。

<target-architecture>に指定できる値は以下のとおりです。

引数 説明
x86 IA-32/x86_64向け
ia64 IA-64向け
arm Arm向け
power Power-PC向け
sparc Sparc向け

ただしtoolsetによってはサポートされていない場合があります。

アドレスモデル

異なるアドレスモデルでビルドするにはb2/bjamに以下を指定する。

引数 説明
address-model=32 32ビットのライブラリを生成します。
address-model=64 64ビットのライブラリを生成します。

レイアウト

Boostをビルドする際にb2/bjamが生成するバイナリファイル名はデフォルトで環境によって異なります。

これは--layout=<layout>を渡すことで変更できます。<layout>に渡すことのできる値は以下のとおりです。

引数 説明
versioned バイナリファイル名にバージョンが入ります。Windowsではデフォルトでversionedが選択されます。
tagged ビルド時に指定したプロパティ（variantやthreading等）がバイナリファイル名に含まれます。ただし、コンパイラ名、コンパイラのバージョン、Boostのバージョンは入りません。
system システムへインテグレートするためにバージョン番号などは入りません。Unixではデフォルトでsystemが選択されます。

ビルドのクリーン

--cleanを渡すことでビルドをクリーンすることが可能です。

ただし、b2/bjamはプロパティなどの差から異なるビルドを生成します。その為クリーン対象のビルドと同一のプロパティを指定した上で--cleanを渡す必要があります。

コンパイラオプション、リンカオプション

ビルドする際にコンパイラやリンカにオプションを渡す必要がある場合は、b2/bjamの引数に以下を指定できます。

  • cflags=(Cコンパイラオプション)
  • cxxflags=(C++コンパイラオプション)
  • linkflags=(リンカオプション)
  • define=(プリプロセッサシンボル）
  • include=(追加インクルードパス）
  • library-path=(追加ライブラリパス）
  • library-file=(追加オブジェクトファイル）
  • find-static-library=(静的ライブラリ）
  • find-shared-library=(動的ライブラリ）

この他にも多くのオプションを指定することができますが、toolsetによってはサポートされていないものもあります。

特定のライブラリだけビルドする/ビルドしない

--with-library や --without-library と書くことで、特定のライブラリだけビルドする/ビルドしないを切り替えられます。

例えば --with-python とすれば、python ライブラリだけをビルドします。 --without-iostreams とすれば、iostreams ライブラリをビルドしません。

documented boost version is 1.53.0