CMake基礎 第10節 使用ninja構建

介紹

如前所述，CMake是一個元（meta）構建系統，可用於為許多其他構建工具創建構建文件。這個例子展示了如何讓CMake使用ninja構建工具。

本教程中的文件如下：

$ tree
.
├── CMakeLists.txt
├── main.cpp

• [CMakeLists.txt] - 包含要運行的CMake命令

  # Set the minimum version of CMake that can be used
  # To find the cmake version run
  # $ cmake --version
  cmake_minimum_required(VERSION 3.5)
  
  # Set the project name
  project (hello_cmake)
  
  # Add an executable
  add_executable(hello_cmake main.cpp)
  

• [main.cpp] - 一個簡單的“Hello World”CPP文件

  #include <iostream>
  
  int main(int argc, char *argv[])
  {
     std::cout << "Hello CMake!" << std::endl;
     return 0;
  }
  

概念

生成器

CMake生成器負責為底層構建系統編寫輸入文件(例如Makefile)。運行cmake--help將顯示可用的生成器。對於cmake v2.8.12.2，我的系統支持的生成器包括：

Generators

The following generators are available on this platform:
  Unix Makefiles              = Generates standard UNIX makefiles.
  Ninja                       = Generates build.ninja files (experimental).
  CodeBlocks - Ninja          = Generates CodeBlocks project files.
  CodeBlocks - Unix Makefiles = Generates CodeBlocks project files.
  Eclipse CDT4 - Ninja        = Generates Eclipse CDT 4.0 project files.
  Eclipse CDT4 - Unix Makefiles
                              = Generates Eclipse CDT 4.0 project files.
  KDevelop3                   = Generates KDevelop 3 project files.
  KDevelop3 - Unix Makefiles  = Generates KDevelop 3 project files.
  Sublime Text 2 - Ninja      = Generates Sublime Text 2 project files.
  Sublime Text 2 - Unix Makefiles
                              = Generates Sublime Text 2 project files.Generators

正如本文所述，CMake包括不同類型的生成器，如命令行生成器、IDE生成器和其他生成器。

命令行生成工具生成器

這些生成器用於命令行構建工具，如Make和Ninja。在使用CMake生成構建系統之前，必須配置所選的工具鏈。

支持的生成器包括：

• Borland Makefiles
• MSYS Makefiles
• MinGW Makefiles
• NMake Makefiles
• NMake Makefiles JOM
• Ninja
• Unix Makefiles
• Watcom WMake

IDE構建工具生成器

這些生成器用於集成開發環境，其中包括它們自己的編譯器。例如Visual Studio和Xcode，它們本身就包含一個編譯器。

支持的生成器包括：

• Visual Studio 6
• Visual Studio 7
• Visual Studio 7 .NET 2003
• Visual Studio 8 2005
• Visual Studio 9 2008
• Visual Studio 10 2010
• Visual Studio 11 2012
• Visual Studio 12 2013
• Xcode

其他生成器

這些生成器創建配置並與其他IDE工具共同工作，並且必須包含在IDE或命令行生成器中。

支持的生成器包括：

• CodeBlocks
• CodeLite
• Eclipse CDT4
• KDevelop3
• Kate
• Sublime Text 2

Note	在本例中，ninja是通過命令sudo apt-get install ninja-build安裝的。

調用生成器

要調用CMake生成器，可以使用-G命令行開關，例如：

cmake .. -G Ninja

完成上述操作后，CMake將生成所需的Ninja構建文件，這些文件可以通過使用Ninja命令運行。

$ cmake .. -G Ninja

$ ls
build.ninja  CMakeCache.txt  CMakeFiles  cmake_install.cmake  rules.ninja

構建示例

下面是構建此示例的示例輸出。

$ mkdir build.ninja

$ cd build.ninja/

$ cmake .. -G Ninja
-- The C compiler identification is GNU 4.8.4
-- The CXX compiler identification is GNU 4.8.4
-- Check for working C compiler using: Ninja
-- Check for working C compiler using: Ninja -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working CXX compiler using: Ninja
-- Check for working CXX compiler using: Ninja -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Configuring done
-- Generating done
-- Build files have been written to: /home/matrim/workspace/cmake-examples/01-basic/J-building-with-ninja/build.ninja

$ ninja -v
[1/2] /usr/bin/c++     -MMD -MT CMakeFiles/hello_cmake.dir/main.cpp.o -MF "CMakeFiles/hello_cmake.dir/main.cpp.o.d" -o CMakeFiles/hello_cmake.dir/main.cpp.o -c ../main.cpp
[2/2] : && /usr/bin/c++      CMakeFiles/hello_cmake.dir/main.cpp.o  -o hello_cmake  -rdynamic && :

$ ls
build.ninja  CMakeCache.txt  CMakeFiles  cmake_install.cmake  hello_cmake  rules.ninja

$ ./hello_cmake
Hello CMake!