CMake教程系列-02-使用cmake代码生成二进制

1.Cmake的安装

• 参考：Cmake安装以及升级（Ubuntu）

2.Win10下使用CMake GUI

Win10安装文件：

创建的目录以及代码如下：

• CMakeLists.txt

cmake_minimum_required(VERSION 3.0)
project(sample CXX)
add_library(sample sample.cpp)
add_executable(sample_exe sample_exe.cpp)

• sample.cpp

#include <iostream>

int print_hello_world()
{
    std::cout << "hello world!" << std::endl;

    return 0;
}

• 目录结构如下：注意多创建一个build目录存放中间文件和最终二进制文件
  

点击“Configure

• 我的的vs是2019，在Configure中选择了
  
  点击“Configure”右边的“Generate”。
  

点击“Generate”右边的“Open Projrct”。

• 可以看到针对于Visual Studio的配置已经完全生成，此时只需要构建 ALL_BUILD 即可生成库 sample 和可执行文件 sample_exe
  
  

2.win使用命令行生成项目

• 参考：cmake(1)

使用上面的代码文件，打开命令行，并输入以下命令：

E:\CmakeTest>cmake.exe -S E:\\CmakeTest -B E:\\CmakeTest\build -G "Visual Studio 16 2019" -A x64
-- Selecting Windows SDK version 10.0.19041.0 to target Windows 10.0.19044.
-- The CXX compiler identification is MSVC 19.29.30141.0
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: C:/Program Files (x86)/Microsoft Visual Studio/2019/BuildTools/VC/Tools/MSVC/14.29.30133/bin/Hostx64/x64/cl.exe - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Configuring done
-- Generating done
-- Build files have been written to: E:/CmakeTest/build

执行以下命令生成库文件以及二进制程序：

E:\CmakeTest>cmake --build  E:\\CmakeTest\build
用于 .NET Framework 的 Microsoft (R) 生成引擎版本 16.11.2+f32259642
版权所有(C) Microsoft Corporation。保留所有权利。

  Checking Build System
  sample_exe.cpp
  sample.vcxproj -> E:\CmakeTest\build\Debug\sample.lib
  sample_exe.cpp
  sample_exe.vcxproj -> E:\CmakeTest\build\Debug\sample_exe.exe
  Building Custom Rule E:/CmakeTest/CMakeLists.txt

3.几个重要的命令行参数

-S

• 顶级CMakeLists.txt（包含project声明）所在路径。

-B

• 存放临时编译的二进制文件（.obj、.ilk等）和编译器对应的配置文件路径。

-G

• 编译器名称

-A

• 架构名称

-D

• 使用该变量以向cmake传入各种参数。包括选项及覆盖cmake提供的各种默认变量值。

--toolchain

• cmake toolchain文件路径。

--install-prefix

• 安装的二进制存放路径。

--trace / --trace-expand

• 调试时使用，用于打印已执行的cmake代码及行号。否则仅输出函数message中的内容。

--build

• 使用cmake直接调用编译器编译项目。

--config

• 选择需要编译的项目配置类型。

--install

• 安装已编译好的二进制文件至 CMAKE_INSTALL_PREFIX 中。

-DCMAKE_VERBOSE_MAKEFILE=ON

• 看到编译和链接阶段的详细输出
  等价于

set( CMAKE_VERBOSE_MAKEFILE on )

• 参考：CMake教程系列-02-使用cmake代码生成二进制