CMake实例笔记

CMake 是一个跨平台的自动化建构系统,它使用一个名为 CMakeLists.txt 的文件来描述构建过程。本文件不介绍CMake的基本语法，直接从实例出发，并在CMakeLists.txt中进行注释说明各语法作用：

test1：单个源文件

利用cmake构建一个简单的比较大小的C++程序，只有一个main.cpp

#include <iostream>
#include <math.h>
using namespace std;
double myabs(double value_)
{
    return abs(value_);
}

void main()
{
    int myvalue;
    cout<<"Input value:";
    cin>>myvalue;
    cout<<"myabs:"<<myabs(myvalue)<<endl;
}

编写 CMakeLists.txt，有关语句大小写问题（只有变量区分大小写），个人编写习惯而定。

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)
# 项目信息，参数是 main，该命令表示项目的名称是 main 。
project (Test1)
# 指定生成目标，将名为 main.cpp 的源文件编译成一个名称为 Test1 的可执行文件。
add_executable(Test1 main.cpp)

test2多个源文件一个目录

将上面的源文件拆分成两个源文件一个头文件：
1. main.cpp

#include "myabs.h"
double myabs(double value_)
{
    return abs(value_);
}

1. myabs.h

#include <math.h>
double myabs(double value_);

1. myabs.cpp

#include "myabs.h"
double myabs(double value_)
{
    return abs(value_);
}

编写CMakeList.txt文件：

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)
# 项目信息
project (Test2)
# 查找当前目录下的所有源文件
# 并将名称保存到 SOURCE_FILES 变量
aux_source_directory(. SOURCE_FILES)
file(GLOB HEADER_FILES *.h)
source_group("Header Files" FILES ${HEADER_FILES})
source_group("Source Files" FILES ${SOURCE_FILES})
# 指定生成目标
add_executable(Test ${SOURCE_FILES} ${HEADER_FILES})

test3多个目录，多个源文件（不生成库）

现在将myabs.h&myabs.cpp移动到math目录中，修改根目录中CMakeLists.txt文件。此时子目录math中没有CMakeLists.txt文件。

project (Test2)
# 查找当前目录下的所有源文件
# 并将名称保存到 SOURCE_FILES 变量
aux_source_directory(. SOURCE_FILES)

#告诉CMake，源文件在哪里myabs.cpp
file(GLOB SOURCE_MATH "${CMAKE_SOURCE_DIR}/math/*.cpp")

#诉CMake头文件在哪里 myabs.h
include_directories("${CMAKE_SOURCE_DIR}/math/") 

# 指定生成目标
add_executable(Test ${SOURCE_FILES} ${SOURCE_MATH})

test4所有文件都在不同文件夹（不生成库）

将main.cpp移动到main目录，myabs.h移动到include目录，myabs.cpp移动到math目录中，修改根目录中CMakeLists.txt文件。此时子各目录中没有CMakeLists.txt文件。

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)
# 项目信息
project (Test2)

#告诉CMake，源文件在哪里main.cpp
file(GLOB SOURCE_MAIN "${CMAKE_SOURCE_DIR}/main/*.cpp")

#告诉CMake，源文件在哪里myabs.cpp
file(GLOB SOURCE_MATH "${CMAKE_SOURCE_DIR}/math/*.cpp")

#诉CMake头文件在哪里 myabs.h
include_directories("${CMAKE_SOURCE_DIR}/include/") 

# 指定生成目标
add_executable(Test ${SOURCE_MAIN} ${SOURCE_MATH})

test5不同目录，生成链接库

根目录中存放main.cpp文件，子目录math中存放myabs.h&myabs.cpp文件。
编写根目录CMakeLists.txt

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)
# 项目信息
project (Test2)
# 查找当前目录下的所有源文件
# 并将名称保存到 SOURCE_FILES 变量
aux_source_directory(. SOURCE_FILES)

# 添加 math 子目录
add_subdirectory(math)
# 指定生成目标 
add_executable(Test6 main.cpp)
# 添加链接库
#使用命令 target_link_libraries 指明可执行文件 main 需要连接一个名为 Myabs 的链接库 
target_link_libraries(Test6 Myabs)

子目录中CMakeList文件

# 查找当前目录下的所有源文件
# 并将名称保存到 Myabs_LIB_SRCS 变量
aux_source_directory(. Myabs_LIB_SRCS)
# 生成链接库
add_library (Myabs ${Myabs_LIB_SRCS})

test6写了这么多简单例子，下面来一个复杂些的工程

该工程由一个静态库和一个可执行文件组成，头文件和源文件都不在同一个目录，并且CMake也是独立在一个目录
cmake目录中每个子目录下都有一个CMakeLists.txt文件:test6->cmake->src->main&myabs
头文件在：test6->include
源文件在：test6->main&myabs
下面分别编写三个CMakeList.txt文件
test6->cmake:

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)
# 项目信息
project (Test6)

#工程的根目录，即test6
set(PROJECT_ROOT_PATH "${CMAKE_SOURCE_DIR}/../")
#可执行程序生成后存放的目录(CMAKE_SOURCE_DIR是cmake目录)
set(EXECUTABLE_OUTPUT_PATH "${CMAKE_SOURCE_DIR}/bin/")
#静态库生成后存放的目录
set(LIBRARY_OUTPUT_PATH "${CMAKE_SOURCE_DIR}/lib/")

#告诉CMake头文件在哪里
include_directories("${PROJECT_ROOT_PATH}/include/")

#告诉CMake静态库在哪里
link_directories("${CMAKE_SOURCE_DIR}/lib/")

#多目录，把src目录加进来
add_subdirectory(src)

test6->cmake->src:

add_subdirectory(main)
add_subdirectory(myabs)

test6->cmake->src->main:

#告诉CMake源文件在哪里
file(GLOB SOURCE "${PROJECT_ROOT_PATH}/main/*.cpp")

#告诉CMake生成一个main可执行文
add_executable(Test ${SOURCE})
#告诉CMake静态库在哪里
target_link_libraries(Test myabslib)

test6->cmake->src->myabs:

#源文件在哪里
file(GLOB SOURCE "${PROJECT_ROOT_PATH}/myabs/*.cpp")
#生成的是一个静态库
add_library(myabslib STATIC ${SOURCE})

（完）