CMake学习

时间 2019-12-12

标签 cmake 学习繁體版

原文原文链接

CMake学习

本篇分享一下有关CMake的一些学习心得以及相关使用。html

做者：AlphaGL。版权全部，欢迎保留原文连接进行转载 :)java

本文目录以下：express

一、CMake介绍
二、CMake安装与使用
* 2.1 CMake的安装
* 2.2 CMake-gui的使用
* 2.3 CMake命令行的使用
* 2.4 CMake命令行说明
三、CMake语法及CMakeLists.txt编写
* 3.1 CMake语法
* 3.1.1 经常使用的命令
* 3.1.2 经常使用的变量
* 3.2 CMakeLists.txt编写
* 3.2.1 将cJSON构建为静态库
* 3.2.1 将cJSON外部依赖库连接进可执行文件中
* 3.2.2 将cJSON库改成可选

一、CMake介绍

CMake全称为“cross platform make”，是一个开源的跨平台自动化构建系统。使用指定名为CMakeLists.txt的配置文件能够控制软件的构建、测试和打包等流程。同时，经过编写平台无关的CMakeLists.txt文件和须要简单的配置，CMake就能生成对应目标平台的构建文件，例如：类Unix系统的makefile文件、Windows的Visual Studio工程或者Mac的Xcode工程，大大简化了跨平台和交叉编译方面的工做。编程

固然，相似的make工具也不少，Autocof、JAM、QMake、SCons甚至ANT，目的都是指定一套规则来简化整个构建编译流程。CMake工具链简单、灵活，且跨平台，不少知名项目都在使用CMake构建。适合以C、C++或者java等编译语言的项目。json

二、CMake安装与使用

2.1 CMake的安装

CMake下载地址为：
https://cmake.org/download/缓存

2.2 CMake-gui的使用

CMake的安装过程很简单，这里就再也不赘述了。其中CMake提供带GUI界面的工具cmake-gui。本文主要是以命令行的形式来说述CMake的使用，这里就稍微提一下cmake-gui的使用。原理都是差很少的。app

简述操做步骤以下：
一、在本地目录新建cmake文件夹(例如：个人目录为E:\workplace\cmake)，并在cmake目录中建立bin目录用于存放构建过程当中产生的临时文件和目标文件(例如：个人目录为E:\workplace\cmake\bin)。编程语言

二、在cmake目录中新建hello_cmake.c与CMakeLists.txt文件，内容以下：
hello_cmake.c：ide

#include <stdio.h>

int main() {
    printf("Hello CMake\n");
    return 0;
}

CMakeLists.txt：函数

cmake_minimum_required (VERSION 2.8)
project (HelloCMake)
add_executable(HelloCMake hello_cmake.c)

三、运行cmake-gui，会打开以下界面：

(1)源码所在的路径，即CMakeLists.txt所在的路径。本例为E:\workplace\cmake
(2)构建过程当中产生的文件的路径。本例为：E:\workplace\cmake\bin，注意这个路径能够与(1)路径相同，但若项目很大产生的文件不少要执行清理等操做时会比较麻烦。
(3)执行configure。

这里指定生成的构建工程为VS2012的项目工程。点击Finish便可自动编译，并生成对应的*.sln的项目文件。

在Visual Studio中打开该项目，并执行。能够看到正确输出了"Hello CMake"。

2.3 CMake命令行的使用

这里，依然使用刚才的示例来讲明下CMake命令行的方式的使用(清理bin目录下的文件便可)，使用步骤以下：
(1)将CMake安装路径添加到Path环境变量中。Mac版本能够终端中输入命令：export PATH=/Applications/CMake.app/Contents/bin:$PATH便可。

(2)在Windows命令行中执行以下命令：

在当前构建的路径，执行cmake，cmake后面参数为CMakeLists.txt所在路径，-G用来指定构建生成目标平台的项目工程。分别对应上面的GUI的操做。

(3)在类Unix的操做系统中，能够执行以下操做。这里我仍是用的上面的示例代码，我用Cygwin模拟下对应的cmake操做，如图：

在Cygwin中新版的CMake会报警告(在32位Windows系统上则会报错)。

因而可知，在Unix系列的操做系统上，使用CMake步骤分为：

编写CMakeLists.txt配置文件。
执行cmake命令生成makefile文件。
执行make命令编译执行，生成最终的目标文件。
运行最终生成的可执行文件便可，这步可选。

2.4 CMake命令行说明

CMake命令行的选项能够在命令行终端上，输入cmake --help查看。更详尽的解释能够查看CMake的官方手册。

cmake帮助手册

CMake命令行格式为：

(1) cmake [<options>] (<path-to-source> | <path-to-existing-build>)  
(2) cmake [(-D <var>=<value>)...] -P <cmake-script-file>  
(3) cmake --build <dir> [<options>...] [-- <build-tool-options>...]  
(4) cmake -E <command> [<options>...]  
(5) cmake --find-package <options>...

常见的使用方式是第一种。这里也主要介绍这种方式。
(1)[<options>]，表示option为可选的。path-to-source和path-to-existing-build二选一，分别表示一个CMakeLists.txt所在的路径和一个已存在的构建工程所在的路径。例如：

cmake .

这里option为空，构建的路径为用户所在的当前路径。

其中option经常使用的有：
-G <generator-name>：
指定构建系统生成器，当前平台所支持的generator-name能够经过帮助手册查看。例如： cmake -G "Visual Studio 11 2012" E:\workplace\cmake，生成VS2012的构建工程。

-D <var>:<type>=<value>, -D <var>=<value>：
添加变量及值到CMakeCache.txt中。例如：cmake -D EXECUTABLE_OUTPUT_PATH="bin" .，会在CMakeCache.txt中添加一条

//No help, variable specified on the command line.
EXECUTABLE_OUTPUT_PATH:UNINITIALIZED=bin

这样，能够在CMakeLists.txt文件中读取该变量的值。例如：message(${EXECUTABLE_OUTPUT_PATH})

-U <globbing_expr>：
此选项可用于从CMakeCache.txt文件中删除一个或多个变量，支持使用*和？的匹配。与-D对应，使用是须谨慎，可能会致使CMakeCache.txt不工做。

-i：
以向导的方式运行CMake。此选项会弹出一系列的提示，要求用户回答关于工程配置的一些问题。这些结果会被用来设置cmake的缓存值。注意，新版的CMake可能再也不支持此选项。

-E：
CMake命令行模式。CMake提供了一系列与平台无关的命令。例如：copy，make_directory，echo等，更多详细参见cmake -E help。

三、CMake语法及CMakeLists.txt编写

用CMake构建一个项目工程，是经过一个或多个CMakeLists.txt文件来控制的。CMakeLists.txt中包含一系列命令来描述须要执行的构建。

3.1 CMake语法

在CMakeLists.txt中的命令的语法，都是形以下面这种格式：

command (args...)

command：是命令的名字。
args：是参数的列表。多个参数使用空格隔开。

3.1.1 经常使用的命令

cmake_minimum_required：
设置项目要求的CMake最低版本号，若是当前版本的CMake低于所需的值，它将中止处理项目并报告错误。注意在project以前调用该命令，通常在CMakeLists.txt文件开头调用。命令格式为：

cmake_minimum_required(VERSION major.minor[.patch[.tweak]]
                       [FATAL_ERROR])

使用示例：

cmake_minimum_required(VERSION 2.8.5)

add_custom_command：
该命令能够为生成的构建系统添加一条自定义的构建规则。这里又包含两种使用方式，一种是经过自定义命令在构建中生成输出文件，另一种是向构建目标添加自定义命令。命令格式分别为：
(1)生成文件

add_custom_command(OUTPUT output1 [output2 ...]
                   COMMAND command1 [ARGS] [args1...]
                   [COMMAND command2 [ARGS] [args2...] ...]
                   [MAIN_DEPENDENCY depend]
                   [DEPENDS [depends...]]
                   [BYPRODUCTS [files...]]
                   [IMPLICIT_DEPENDS <lang1> depend1
                                    [<lang2> depend2] ...]
                   [WORKING_DIRECTORY dir]
                   [COMMENT comment]
                   [DEPFILE depfile]
                   [VERBATIM] [APPEND] [USES_TERMINAL])

参数介绍：
OUTPUT：
指定命令预期产生的输出文件。若是输出文件的名称是相对路径，即相对于当前的构建的源目录路径。输出文件能够指定多个output1,output2(可选)等。

COMMAND：
指定要在构建时执行的命令行。若是指定多个COMMAND，它们讲按顺心执行。ARGS参数是为了向后兼容，为可选参数。args1和args2为参数，多个参数用空格隔开。

MAIN_DEPENDENCY：
可选命令，指定命令的主要输入源文件。

DEPENDS：
指定命令所依赖的文件。

BYPRODUCTS：
可选命令，指定命令预期产生的文件，但其修改时间可能会比依赖性更新，也可能不会更新。

IMPLICIT_DEPENDS：
可选命令，请求扫描输入文件的隐式依赖关系。给定的语言指定应使用相应的依赖性扫描器的编程语言。目前只支持C和CXX语言扫描器。必须为IMPLICIT_DEPENDS列表中的每一个文件指定语言。从扫描中发现的依赖关系在构建时添加到自定义命令的依赖关系。请注意，IMPLICIT_DEPENDS选项目前仅支持Makefile生成器，而且将被其余生成器忽略。

WORKING_DIRECTORY：
可选命令，使用给定的当前工做目录执行命令。若是它是相对路径，它将相对于对应于当前源目录的构建树目录。

COMMENT：
可选命令，在构建时执行命令以前显示给定消息。

DEPFILE：
可选命令，为Ninja生成器指定一个.d depfile。 .d文件保存一般由自定义命令自己发出的依赖关系。对其余生成器使用DEPFILE是一个错误。

使用实例：

add_executable(MakeTable MakeTable.cxx) 
add_custom_command (
  OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/Table.h
  COMMAND MakeTable ${CMAKE_CURRENT_BINARY_DIR}/Table.h
  DEPENDS MakeTable
  COMMENT "This is a test"
  )

(2)自定义构建事件

add_custom_command(TARGET <target>
                   PRE_BUILD | PRE_LINK | POST_BUILD
                   COMMAND command1 [ARGS] [args1...]
                   [COMMAND command2 [ARGS] [args2...] ...]
                   [BYPRODUCTS [files...]]
                   [WORKING_DIRECTORY dir]
                   [COMMENT comment]
                   [VERBATIM] [USES_TERMINAL])

参数介绍：
TARGET：
定义了与构建指定相关联的新命令。当已经存在是，相应的command将再也不执行。

PRE_BUILD：
在目标中执行任何其余规则以前运行。这仅在Visual Studio 7或更高版本上受支持。对于全部其余生成器PRE_BUILD将被视为PRE_LINK。

PRE_LINK：
在编译源以后运行，但在连接二进制文件或运行静态库的库管理器或存档器工具以前运行。

POST_BUILD：
在目标中的全部其余规则都已执行后运行。

使用实例：

add_custom_command(TARGET ${APP_NAME} 
             PRE_BUILD
                     COMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_CURRENT_SOURCE_DIR}/Resources ${CMAKE_CURRENT_BINARY_DIR})

add_custom_target：
该命令能够给指定名称的目标执行指定的命令，该目标没有输出文件，并始终被构建。命令的格式为：

add_custom_target(Name [ALL] [command1 [args1...]]
                  [COMMAND command2 [args2...] ...]
                  [DEPENDS depend depend depend ... ]
                  [BYPRODUCTS [files...]]
                  [WORKING_DIRECTORY dir]
                  [COMMENT comment]
                  [VERBATIM] [USES_TERMINAL]
                  [SOURCES src1 [src2...]])

参数介绍(上面介绍过含义相同的参数，这里就再也不赘述了)：
Name：
指定目标的名称。

ALL：
代表此目标应添加到默认构建目标，以便每次都将运行（该命令名称不能为ALL）

SOURCES：
指定要包括在自定义目标中的其余源文件。指定的源文件将被添加到IDE项目文件中，以方便编辑，即便它们没有构建规则。

使用示例：

add_custom_target(APP ALL
      DEPENDS ${APP_NAME} # 依赖add_custom_command输出的jar包
      COMMENT "building cassdk_jni.jar"
    )

add_definitions：
为源文件的编译添加由-D引入的宏定义。命令格式为：

add_definitions(-DFOO -DBAR ...)

使用示例：

add_definitions(-DWIN32)

add_dependencies：
使顶级目标依赖于其余顶级目标，以确保它们在该目标以前构建。这里的顶级目标是由add_executable，add_library或add_custom_target命令之一建立的目标。
使用示例：

add_custom_target(mylib DEPENDS ${MYLIB})
add_executable(${APP_NAME} ${SRC_LIST})
add_dependencies(${APP_NAME} mylib)

add_executable：
使用指定的源文件给项目添加一个可执行文件。命令格式为：

add_executable(<name> [WIN32] [MACOSX_BUNDLE]
               [EXCLUDE_FROM_ALL]
               source1 [source2 ...])

参数介绍：
name：
该命令调用列出的源文件来构建的可执行目标。对应于逻辑目标名称，在项目中必须是全局惟一的。构建的可执行文件的实际文件名是基于本机平台的约定。

WIN32：
若是给出WIN32，则在建立的目标上设置属性WIN32_EXECUTABLE。

MACOSX_BUNDLE:
若是给定MACOSX_BUNDLE，将在建立的目标上设置相应的属性。

EXCLUDE_FROM_ALL：
若是给定EXCLUDE_FROM_ALL，将在建立的目标上设置相应的属性。

source：
源码列表。

使用示例：

add_executable(HelloCMake hello_cmake.c)

add_library：
使用指定的源文件给项目添加一个库。命令格式为：

add_library(<name> [STATIC | SHARED | MODULE]
            [EXCLUDE_FROM_ALL]
            source1 [source2 ...])

参数介绍：
name：
该命令调用列出的源文件来构建的库目标。对应于逻辑目标名称，在项目中必须是全局惟一的。

STATIC：
静态库，在连接其余目标时使用。

SHARED：
动态连接库，运行时加载。

MODULE：
不会被连接到其它目标中，可是可能会在运行时使用dlopen-系列的函数动态连接。

使用示例：

add_library(HelloCMake hello_cmake.c)

add_subdirectory:
向构建中添加子目录。命令格式为：

add_subdirectory(source_dir [binary_dir]
                 [EXCLUDE_FROM_ALL])

使用示例：

add_subdirectory(${SRC_ROOT})

aux_source_directory：
查找目录中的全部源文件。命令格式为：

aux_source_directory(<dir> <variable>)

查找指定目录dir中全部源文件的名称，并将列表存储在提供的variable中。

使用示例：

aux_source_directory(. DIR_SRCS)
add_executable(${APP_NAME} ${DIR_SRCS})

configure_file：
将文件复制到其余位置并修改其内容。命令格式为：

configure_file(<input> <output>
               [COPYONLY] [ESCAPE_QUOTES] [@ONLY]
               [NEWLINE_STYLE [UNIX|DOS|WIN32|LF|CRLF] ])

使用示例：

configure_file (
  "${PROJECT_SOURCE_DIR}/Config.h.in"
  "${PROJECT_BINARY_DIR}/Config.h"
  )

file：
文件操做相关的命令。命令格式为：

file(WRITE <filename> <content>...)
file(APPEND <filename> <content>...)
file(READ <filename> <variable>
     [OFFSET <offset>] [LIMIT <max-in>] [HEX])
file(STRINGS <filename> <variable> [<options>...])
file(<MD5|SHA1|SHA224|SHA256|SHA384|SHA512> <filename> <variable>)
file(GLOB <variable>
     [LIST_DIRECTORIES true|false] [RELATIVE <path>]
     [<globbing-expressions>...])
file(GLOB_RECURSE <variable> [FOLLOW_SYMLINKS]
     [LIST_DIRECTORIES true|false] [RELATIVE <path>]
     [<globbing-expressions>...])
file(RENAME <oldname> <newname>)
file(REMOVE [<files>...])
file(REMOVE_RECURSE [<files>...])
file(MAKE_DIRECTORY [<directories>...])
file(RELATIVE_PATH <variable> <directory> <file>)
file(TO_CMAKE_PATH "<path>" <variable>)
file(TO_NATIVE_PATH "<path>" <variable>)
file(DOWNLOAD <url> <file> [<options>...])
file(UPLOAD   <file> <url> [<options>...])
file(TIMESTAMP <filename> <variable> [<format>] [UTC])
file(GENERATE OUTPUT output-file
     <INPUT input-file|CONTENT content>
     [CONDITION expression])
file(<COPY|INSTALL> <files>... DESTINATION <dir>
     [FILE_PERMISSIONS <permissions>...]
     [DIRECTORY_PERMISSIONS <permissions>...]
     [NO_SOURCE_PERMISSIONS] [USE_SOURCE_PERMISSIONS]
     [FILES_MATCHING]
     [[PATTERN <pattern> | REGEX <regex>]
      [EXCLUDE] [PERMISSIONS <permissions>...]] [...])
file(LOCK <path> [DIRECTORY] [RELEASE]
     [GUARD <FUNCTION|FILE|PROCESS>]
     [RESULT_VARIABLE <variable>]
     [TIMEOUT <seconds>])

以上都是文件相关的操做，这里就不详细解释。
使用示例为：

# 查找src目录下全部以hello开头的文件并保存到SRC_FILES变量里
file(GLOB SRC_FILES "src/hello*")
# 递归查找
file(GLOB_RECURSE SRC_FILES "src/hello*")

find_file：
查找一个文件的完整路径。命令格式为：

find_file (<VAR> name1 [path1 path2 ...])

使用示例：

find_file(HELLO_H hello.h)

find_library：
查找一个库文件。命令格式为：

find_library (<VAR> name1 [path1 path2 ...])

使用示例：

find_library(LUA lua5.1 /usr/lib /lib)

find_package：
查找并加载外部项目的设置。命令格式为：

find_package(<package> [version] [EXACT] [QUIET] [MODULE]
             [REQUIRED] [[COMPONENTS] [components...]]
             [OPTIONAL_COMPONENTS components...]
             [NO_POLICY_SCOPE])

使用示例为：

find_package(Protobuf)

find_path：
查找包含某个文件的路径。命令格式为：

find_path (<VAR> name1 [path1 path2 ...])

使用示例：

find_path(DIR_SRCS hello.h .)

include_directories：
将给定的目录添加到编译器用于搜索包含文件的目录。相对路径则相对于当前源目录。命令格式为：

include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])

使用示例：

include_directories(
  ${CMAKE_CURRENT_SOURCE_DIR}
  ${CMAKE_CURRENT_SOURCE_DIR}/cocos
  ${CMAKE_CURRENT_SOURCE_DIR}/cocos/platform
  ${CMAKE_CURRENT_SOURCE_DIR}/extensions
  ${CMAKE_CURRENT_SOURCE_DIR}/external
)

include：
包含其余目录的CMakeLists.txt文件。命令格式为：

include(<file|module> [OPTIONAL] [RESULT_VARIABLE <VAR>]
                      [NO_POLICY_SCOPE])

使用示例：

include(platform/CMakeLists.txt)

link_directories：
指定连接器查找库的路径。命令格式为：

link_directories(directory1 directory2 ...)

使用示例：

link_directories(${PROJECT_SOURCE_DIR}/lib)

list：
列表相关的操做。命令格式为：

list(LENGTH <list> <output variable>)
list(GET <list> <element index> [<element index> ...]
     <output variable>)
list(APPEND <list> [<element> ...])
list(FILTER <list> <INCLUDE|EXCLUDE> REGEX <regular_expression>)
list(FIND <list> <value> <output variable>)
list(INSERT <list> <element_index> <element> [<element> ...])
list(REMOVE_ITEM <list> <value> [<value> ...])
list(REMOVE_AT <list> <index> [<index> ...])
list(REMOVE_DUPLICATES <list>)
list(REVERSE <list>)
list(SORT <list>)

使用示例：

list(APPEND SRC_LIST
    ${PROTO_SRC}
)

message：
向用户显示消息。命令格式为：

message([<mode>] "message to display" ...)

参数说明：
mode：
可选的值为none，STATUS，WARNING，AUTHOR_WARNING，SEND_ERROR，FATAL_ERROR，DEPRECATION。
使用示例：

message(STATUS "This is BINARY dir " ${HELLO_BINARY_DIR})

option：
提供用户能够选择的选项。命令格式为：

option(<option_variable> "help string describing option"
       [initial value])

使用示例：

option (USE_MYMATH "Use tutorial provided math implementation" ON)

project：
为整个工程设置一个工程名。命令格式为：

project(<PROJECT-NAME> [LANGUAGES] [<language-name>...])
project(<PROJECT-NAME>
        [VERSION <major>[.<minor>[.<patch>[.<tweak>]]]]
        [LANGUAGES <language-name>...])

使用示例：

project (HelloCMake)

set：
将一个CMAKE变量设置为给定值。命令格式为：

set(<variable> <value>... [PARENT_SCOPE])

使用示例：

set(COCOS2D_ROOT ${CMAKE_SOURCE_DIR}/cocos2d)

set_target_properties：
设置目标的一些属性来改变它们构建的方式。命令格式为：

set_target_properties(target1 target2 ...
                      PROPERTIES prop1 value1
                      prop2 value2 ...)

使用示例为：

set_target_properties(cocos2d
    PROPERTIES
    ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib"
    LIBRARY_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib"
    VERSION "${COCOS2D_X_VERSION}"
)

string：
字符串相关操做。命令格式为：

string(FIND <string> <substring> <output variable> [REVERSE])
string(REPLACE <match_string>
       <replace_string> <output variable>
       <input> [<input>...])
string(REGEX MATCH <regular_expression>
       <output variable> <input> [<input>...])
string(REGEX MATCHALL <regular_expression>
       <output variable> <input> [<input>...])
string(REGEX REPLACE <regular_expression>
       <replace_expression> <output variable>
       <input> [<input>...])
string(APPEND <string variable> [<input>...])
string(CONCAT <output variable> [<input>...])
string(TOLOWER <string1> <output variable>) 
string(TOUPPER <string1> <output variable>)
string(LENGTH <string> <output variable>)
string(SUBSTRING <string> <begin> <length> <output variable>)
string(STRIP <string> <output variable>)
string(GENEX_STRIP <input string> <output variable>)  
string(COMPARE LESS <string1> <string2> <output variable>)
string(COMPARE GREATER <string1> <string2> <output variable>)
string(COMPARE EQUAL <string1> <string2> <output variable>)
string(COMPARE NOTEQUAL <string1> <string2> <output variable>)
string(COMPARE LESS_EQUAL <string1> <string2> <output variable>)
string(COMPARE GREATER_EQUAL <string1> <string2> <output variable>)
string(<MD5|SHA1|SHA224|SHA256|SHA384|SHA512>
       <output variable> <input>)
string(ASCII <number> [<number> ...] <output variable>)
string(CONFIGURE <string1> <output variable>
       [@ONLY] [ESCAPE_QUOTES])
string(RANDOM [LENGTH <length>] [ALPHABET <alphabet>]
       [RANDOM_SEED <seed>] <output variable>)
string(TIMESTAMP <output variable> [<format string>] [UTC])
string(MAKE_C_IDENTIFIER <input string> <output variable>)
string(UUID <output variable> NAMESPACE <namespace> NAME <name>
       TYPE <MD5|SHA1> [UPPER])

使用示例：

string(REPLACE "${PROJECT_SOURCE_DIR}/hello.c" "" DIR_SRCS "${DIR_ROOT}")

target_link_libraries：
将给定的库连接到一个目标上。命令格式为：

target_link_libraries(<target> ... <item>... ...)

使用示例：

target_link_libraries(luacocos2d cocos2d)

3.1.2 经常使用的变量

使用${}进行变量的引用。例如：message(${Hello_VERSION})，Hello为工程名。CMake提供了不少有用的变量。如下仅列举经常使用的变量：

CMAKE_BINARY_DIR：
构建树的顶层路径

CMAKE_COMMAND：
指向CMake可执行文件的完整路径

CMAKE_CURRENT_BINARY_DIR：
当前正在被处理的二进制目录的路径。

CMAKE_CURRENT_SOURCE_DIR：
指向正在被处理的源码目录的路径。

CMAKE_HOME_DIRECTORY：
指向源码树顶层的路径。

CMAKE_PROJECT_NAME：
当前工程的工程名。

CMAKE_ROOT：
CMake的安装路径。

CMAKE_SOURCE_DIR：
源码树的顶层路径。

CMAKE_VERSION：
cmake的完整版本号。

PROJECT_BINARY_DIR：
指向当前编译工程构建的全路径。

<PROJECT-NAME>_BINARY_DIR：
指向当前编译工程构建的全路径。

<PROJECT-NAME>_SOURCE_DIR：
指向构建工程的全路径。

PROJECT_SOURCE_DIR：
指向构建工程的全路径。

PROJECT_NAME：
project命令传递的工程名参数。

<PROJECT-NAME>_VERSION：
项目的完整版本号。

3.2 CMakeLists.txt编写

有了上面的基础，再编写CMakeLists.txt天然会事半功倍。下面，以几个小实例来讲下经过CMakeLists.txt的来构建项目。

这里cJSON库为例来讲明下CMakeLists.txt的写法。固然，这里的代码并严谨，仅用来演示CMakeList的用法。

3.2.1 将cJSON构建为静态库

(1)在本地创建cJSONdemo1的目录工程，并将cJSON库源代码拷贝到目录中，并在该目录新建CMakeLists.txt文件。目录结构以下：

cJSONdemo1  
├── cJSON_Utils.h  
├── cJSON_Utils.c  
├── cJSON.h
├── cJSON.c
└── CMakeLists.txt

CMakeLists.txt文件内容以下：

cmake_minimum_required(VERSION 2.8.5)
project(cJSON-lib)
set(CJSON_SRC cJSON.c cJSON_Utils.c)
add_library(cjson STATIC ${CJSON_SRC})

在终端下执行以下操做：

(2)自动搜索目录源码
在上面cJSONdemo1的基础上作一些改进。前面提过set(<variable> <value>...)，能够预见在cJSON库源码愈来愈多的状况下，会变成这样：

set(CJSON_SRC cJSON.c cJSON1.c cJSON2.c cJSON3.c cJSON4.c cJSON5.c)

这样，源文件越多，须要添加次数就越多。并且，每增长一个源文件就须要修改CMakeLists.txt文件，“耦合性”太大。这里，可使用aux_source_directory来自动查找源文件。CMakeLists.txt文件最终以下：

cmake_minimum_required(VERSION 2.8.5)
project(cJSON-lib)
aux_source_directory(. CJSON_SRC)
add_library(cjson STATIC ${CJSON_SRC})

(3)递归搜索目录源码
若将cJSONdemo改为包含子目录，子目录中又包含源码的形式，有多级目录。以下

cJSONdemo1  
  │── cJSON_Utils.h  
  │── cJSON_Utils.c  
  │── cJSON.h
  │── cJSON.c
  │── CMakeLists.txt 
  └── foo 
      ├── cJSON1.h
      ├── cJSON1.c
      ├── cJSON2.h
      ├── cJSON2.c
      └── goo 
          ├── cJSON3.h
          ├── cJSON3.c
          ├── cJSON4.h
          └── cJSON4.c

可使用file命令，来自动递归查找相应的源文件。CMakeLists.txt文件最终以下：

cmake_minimum_required(VERSION 2.8.5)
project(cJSON-lib)
file(GLOB_RECURSE CJSON_SRC ${CMAKE_CURRENT_SOURCE_DIR}/*.c)
add_library(cjson STATIC ${CJSON_SRC})

(4)指定构建库的名字，路径和前缀。CMakeLists.txt文件最终以下：

cmake_minimum_required(VERSION 2.8.5)
project(cJSON-lib)
file(GLOB_RECURSE CJSON_SRC ${CMAKE_CURRENT_SOURCE_DIR}/*.c)
add_library(cjson STATIC ${CJSON_SRC})
set_target_properties(cjson PROPERTIES OUTPUT_NAME "json")
set(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/static)
set(CMAKE_STATIC_LIBRARY_PREFIX "")

最终效果如图：

会生成cJSONdemo1/static/json.a。

3.2.1 将cJSON外部依赖库连接进可执行文件中

经过上面过程了解了将cJSON库构建文件静态库的过程。下面，再添加测试代码来调用cJSON库，并最终构建为可执行文件。目录以下：

cJSONdemo2  
  │── test.c
  │── CMakeLists.txt 
  └── lib 
      ├── cJScJSON_UtilsON1.h
      ├── cJSON_Utils.c
      ├── cJSON.h
      ├── cJSON.c
      └── CMakeLists.txt

test.c：

#include <stdio.h>
#include <stdlib.h>
#include "lib/cJSON.h"

void parser(char* text) {
    char *out;
    cJSON *json;

    json = cJSON_Parse(text);
    if (!json) {
        printf("Error before: [%s]\n", cJSON_GetErrorPtr());
    }else {
        out = cJSON_Print(json);
        cJSON_Delete(json);
        printf("%s\n", out);
        free(out);
    }
}

int main(int argc, char * argv[]) {
    char text[]="[\"Sunday\", \"Monday\", \"Tuesday\", \"Wednesday\", \"Thursday\", \"Friday\", \"Saturday\"]";
    parser(text);

    return 0;
}

cJSONdemo2/CMakeLists.txt：

cmake_minimum_required(VERSION 2.8.5)

project(cjson-example)

aux_source_directory(. CJSON_EXAMPLE_SRC)

add_subdirectory(./lib)

add_executable(cjson-example ${CJSON_EXAMPLE_SRC})

target_link_libraries(cjson-example cjson)

cJSONdemo2/lib/CMakeLists.txt：

cmake_minimum_required(VERSION 2.8.5)

aux_source_directory(. CJSON_SRC)

add_library(cjson STATIC ${CJSON_SRC})

在终端下执行以下操做：

3.2.2 将cJSON库改成可选

在上面cJSONdemo2的基础上，新建cJSONConfig.h.in并相应修改test.c。目录以下：

cJSONdemo3  
  │── test.c
  │── cJSONConfig.h.in
  │── CMakeLists.txt 
  └── lib 
      ├── cJScJSON_UtilsON1.h
      ├── cJSON_Utils.c
      ├── cJSON.h
      ├── cJSON.c
      └── CMakeLists.txt

cJSONConfig.h.in：

#cmakedefine USE_CJSON

test.c：

#include <stdio.h>
#include <stdlib.h>
#ifdef USE_MYMATH
#include "lib/cJSON.h"

void parser(char* text) {
    char *out;
    cJSON *json;

    json = cJSON_Parse(text);
    if (!json) {
        printf("Error before: [%s]\n", cJSON_GetErrorPtr());
    }else {
        out = cJSON_Print(json);
        cJSON_Delete(json);
        printf("%s\n", out);
        free(out);
    }
}

#endif

int main(int argc, char * argv[]) {
    char text[]="[\"Sunday\", \"Monday\", \"Tuesday\", \"Wednesday\", \"Thursday\", \"Friday\", \"Saturday\"]";
    #ifdef USE_MYMATH
        parser(text);
    #else
        printf("use other json library\n");
    #endif

    return 0;
}

最终效果以下：

以上只是经过一些简单的示例来讲明了CMake基础及相关应用。更多高级功能须要平常的实践及查询CMake官方文档。

技术交流QQ群：528655025
做者：AlphaGL
出处：http://www.cnblogs.com/alphagl/ 版权全部，欢迎保留原文连接进行转载 :)

1. CMake学习（一）
2. CMake 学习CMakeLists.txt
3. CMake学习
4. cmake 学习-cmakelists.txt
5. cmake学习（1）
6. ubuntu16.04 Cmake学习二
7. CMake学习笔记
8. CMake学习总结
9. cmake学习之- set
10. Cmake学习笔记
更多相关文章...
• 您已经学习了 XML Schema，下一步学习什么呢？ - XML Schema 教程
• 我们已经学习了 SQL，下一步学习什么呢？ - SQL 教程
• Tomcat学习笔记（史上最全tomcat学习笔记）
• 适用于PHP初学者的学习线路和建议