举例:
先编写代码及CMakeLists.txt
先简单的写一个cpp文件,在include文件夹下放置test.h和test.cpp文件;LearnCmake.cpp主要包含main函数,test.h和test.cpp的主要内容是:
//test.h的内容
#pragma once
#include <iostream>
void fun();
//test.cpp的内容
#include "test.h"
void fun()
{
std::cout << "测试函数" << std::endl;
}
#include <iostream>
#include "test.h"
using namespace std;
int main()
{
fun();
cout << "输出结果" << endl;
system("pause");
return 0;
}
MyProject/
|── CMakeLists.txt
|── LearnCmake.cpp
|── include/
| |──test.h
| └──test.cpp
#所需的最低版本
cmake_minimum_required(VERSION 3.0)
#本CMakeLists.txt的project名称,用于生成learnCmake.sln
project(learnCmake)
#设置生成文件的路径,这将会把生成的可执行文件放置在 ${CMAKE_BINARY_DIR}/bin 文件夹中
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
#设置include文件夹路径,可以理解为附加包含目录
include_directories(include)
#先添加test.cpp文件到一个名为test_lib的库
add_library(test_lib include/test.cpp)
#将.cpp/.c/.cc文件生成可执行文件,a就是a.exe
add_executable(a LearnCMake.cpp)
# 将test_lib链接到a.exe,一定是先add_executable,再target_link_libraries
target_link_libraries(a test_lib)
首先,先将test.cpp编译成一个静态库,同时生成一个a.exe,再将静态库链接到a.exe内;顺序不能错了,不能先链接到exe(因为此时exe还未生成),再生成exe;这样从cmake里就能看到源码编译的过程,也是上面我说的第二条,也能更好地理解编译的过程。
使用cmake-gui将源码目录一生成Visual Studio项目
项目源码写好之后,不同的平台,不同的编译器会根据CMakeLists.txt里的指令生成各自的项目文件,在Windows平台上,可以使用cmake-gui根据CMakeLists.txt里的指令,生成你电脑上安装好的Visual Studio项目
生成的项目
打开learnCmake.sln项目,可以看到解决方案有
其中,ALL_BUILD用于编译整个项目的工程。ALL_BUILD相当于makefile里面的默认目标,构建整个项目,但不包括install和单元测试等。ZERO_CHECK监视CMakeLists.txt,如果CMakeLists.txt发生变化,则告诉编译器重新构建整个工程环境。ZERO_CHECK是首先执行的构建目标,会检查生成出的VS项目相比CMakeLists.txt是否过期,如果过期会首先重新生成VS项目。所有其它目标都会依赖这个ZERO_CHECK,于是构建别的目标都会先走一下ZERO_CHECK,保证了所生成项目的即时性。