ninja

忍者

Ninja 是一個注重速度的小型建造系統。 https://ninja-build.org/

請參閱發行版中包含的手冊或doc/manual.asciidoc以了解背景資訊和更多詳細資訊。

適用於 Linux、Mac 和 Windows 的二進位檔案可在 GitHub 上找到。運行./ninja -h以獲得 Ninja 幫助。

不需要安裝，因為唯一需要的檔案是產生的 ninja 二進位。但是，要啟用 Bash 補全以及 Emacs 和 Vim 編輯模式等功能，必須將 Misc/ 中的某些檔案複製到適當的位置。

如果您有興趣對 Ninja 進行更改，請先閱讀 CONTRIBUTING.md。

建構忍者本身

您可以透過用 Python 編寫的自訂生成器腳本或透過 CMake 來建置 Ninja。有關更多詳細信息，請參閱維基百科。

Python

./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

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 文檔

如果安裝了doxygen ，您可以建立從 C++ 聲明和註解中提取的文件來幫助您導覽程式碼。請注意，Ninja 是一個獨立的可執行文件，而不是一個庫，因此沒有公共 API，此處公開的所有細節都是內部的。

./configure.py   # if needed
ninja doxygen

然後在瀏覽器中開啟doc/doxygen/html/index.html看一下。