Ninja は、スピードを重視した小規模なビルド システムです。 https://ninja-build.org/
背景や詳細については、配布物に含まれるマニュアルまたはdoc/manual.asciidoc
を参照してください。
Linux、Mac、Windows のバイナリは GitHub で入手できます。 Ninja のヘルプを表示するには、 ./ninja -h
を実行します。
必要なファイルは生成された ninja バイナリだけであるため、インストールは必要ありません。ただし、Bash 補完や Emacs および Vim 編集モードなどの機能を有効にするには、misc/ 内の一部のファイルを適切な場所にコピーする必要があります。
Ninja に変更を加えることに興味がある場合は、まず COTRIBUTING.md を読んでください。
Ninja は、Python で書かれたカスタム ジェネレーター スクリプトまたは CMake を介してビルドできます。詳細については wiki を参照してください。
./configure.py --bootstrap
これにより、 ninja
バイナリとbuild.ninja
ファイルが生成され、Ninja 自体をビルドするために使用できるようになります。
GoogleTest ソース ディレクトリがある場合は、 --gtest-source-dir=PATH
オプション、またはGTEST_SOURCE_DIR
環境変数を使用してそのパスを渡すことでテストをビルドできます。例:
./configure.py --bootstrap --gtest-source-dir=/path/to/googletest ./ninja all # build ninja_test and other auxiliary binaries ./ninja_test` # run the unit-test suite.
ライブラリのプレインストールされたバイナリ バージョンを使用する場合は、以下の CMake ビルドを使用してください。
cmake -Bbuild-cmake cmake --build build-cmake
これで、 ninja
バイナリがbuild-cmake
ディレクトリ内に配置されます (他の任意の名前を選択できます)。
単体テストを実行するには:
./build-cmake/ninja_test
PATH にasciidoc
とxsltproc
が含まれている必要があり、次の操作を実行します。
./configure.py ninja manual doc/manual.pdf
これによりdoc/manual.html
が生成されます。
マニュアルの PDF バージョンを生成するには、PATH にdblatext
含まれている必要があります。その後、次の操作を実行します。
./configure.py # only if you didn't do it previously. ninja doc/manual.pdf
これによりdoc/manual.pdf
が生成されます。
doxygen
がインストールされている場合は、コードの操作に役立つ C++ 宣言とコメントから抽出されたドキュメントを構築できます。 Ninja はライブラリではなくスタンドアロンの実行可能ファイルであるため、パブリック API はなく、ここで公開される詳細はすべて内部的なものであることに注意してください。
./configure.py # if needed ninja doxygen
次に、ブラウザでdoc/doxygen/html/index.html
開いて確認します。