Modern CMake文档
例如：cmake -G \"Visual Studio 15 2017\" ../ 使用vs2017构建工程
-
添加变量到Cache文件中：-D
cmake_minimum_required(VERSION 3.1\...3.12)该命令表示支持3.1至3.12之间的版本 - 判断CMake版本：if(\${CMAKE_VERSION} VERSION_LESS 3.12) cmake_policy(VERSION \${CMAKE_MAJOR_VERSION}.\${CMAKE_MINOR_VERSION}) endif()- 该命令表示：如果CMake版本小于3.12，则if块将为true，然后将设置为当前CMake版本；如果CMake版本高于3.12，if块为假，cmakeminimumrequired将被正确执行 - 注意：如果需要支持非命令行Windows版本则需在上面的if判断加上else分支，如下：cmake_minimum_required(VERSION 3.1) if(${CMAKE_VERSION} VERSION_LESS 3.12) cmake_policy(VERSION ${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION}) else() cmake_policy(VERSION 3.12) endif()- 设置生成项目名称 - 使用的命令：project（MyProject） - 表示我们生成的工程名字叫做：MyProject - 命令还可以标识项目支持的语言，写法：project（MyProject[C] [C++]）,不过通常将后面的参数省掉，因为默认支持所有语言 - 使用该指令之后系统会自动创建两个变量：\<projectname>_BINARYDIR:二进制文件保存路径、\<projectname>_SOURCEDIR：源代码路径 - 执行：project(MyProject)，就是定义了一个项目的名称为：MyProject，对应的就会生成两个变量：_BINARYDIR和SOURCEDIR，但是cmake中其实已经有两个预定义的变量：PROJECTBINARYDIR和PROJECTSOURCR_DIR - 关于两个变量是否相同，涉及到是内部构建还是外部构建 - 内部构建\ > cmake ./\ > make - 外部构建\ > mkdir build\ > cd ./build\ > cmake ../\ > make - 内部构建和外部构建的不同在于：cmake 的工作目录不同。内部构建会将cmake生成的中间文件和可执行文件放在和项目同一目录；外部构建的话，中间文件和可执行文件会放在build目录。 - PROJECTSOURCEDIR和SOURCEDIR无论内部构建还是外部构建，指向的内容都是一样的，都指向工程的根目录 - PROJECTBINARYDIR和BINARYDIR指向的相同内容，内部构建的时候指向CMakeLists.txt文件的目录，外部构建的，指向target编译的目录 - 生成可执行文件 - 语法：add_executable(exename srcname)\ > exename:生成的可执行文件的名字\ > srcname:以来的源文件 - 该命令指定生成exe的名字以及指出需要依赖的源文件的文件名 - 获取文件路径中的所有源文件 - 命令：auxsourcrdirectory(\<dir> \<variable>) - 例子：auxsourcrdirectory(. DIRSRCS)，将当前目录下的源文件名字存放到变量DIRSRCS里面 ，如果源文件比较多，直接用DIR_SRCS变量即可 - 生成可执行文件：addexecutable(Demo \${DIRSRCS})，将生成的可执行文件命名为：Demo.exe - 生成lib库 - 命令：addlibrary(libname [SHARED\|STATIC\|MODULE] [EXCLUDEFROM_ALL] source1 source2 ... sourceN)\ > libname:生成的库文件的名字\ > [SHARED\|STATIC\|MODULE]：生成库文件的类型（动态库\|静态库\|模块）\ > [EXCLUDEFROMALL]：有这个参数表示该库不会被默认构建\ > source2 ... sourceN：生成库依赖的源文件，如果源文件比较多，可以使用auxsourcrdirectory命令获取路径下所有源文件，具体章节参见：CMake基础知识简介->生成可执行文件->获取路径中所有源文件 - 例子：add_library(ALib SHARE alib.cpp) - 添加头文件目录 - 命令1：targetincludedirectories(\<target> [SYSTEM] [BEFORE] \<INTERFACE\|PUBLIC\|PRIVATE> [items1...] [\<INTERFACE\|PUBLIC\|PRIVATE> [items2...] ...])\ > 当我们添加子项目之后还需要设置一个include路径，例子：\ > eg:targetincludedirectories(RigelEditor PUBLIC ./include/rgeditor)，表示给RigelEditor 这个子项目添加一个库文件的路径 - 命令2：include_directories([AFTER\|BEFORE] [SYSTEM] dir1 [dir2 …])\ > 参数解析：\ > [AFTER\|BEFORE]：指定了要添加路径是添加到原有列表之前还是之后\ > [SYSTEM]：若指定了system参数，则把被包含的路径当做系统包含路径来处理\ > dir1 [dir2 …]把这些路径添加到CMakeLists及其子目录的CMakeLists的头文件包含项目中\ > 相当于g++选项中的-l的参数的作用\ > 举例：\ > include_directories(\"/opt/MATLAB/R2012a/extern/include\") - 两条指令的作用都是讲将include的目录添加到目标区别在于includedirectories是CMake编译所有目标的目录进行添加，targetinclude_directories是将CMake编译的指定的特定目标的包含目录进行添加 - 添加需要链接的库文件路径 - 命令1:targetlinklibraries(\<target> [item1 [item2 [...]]] [[debug\|optimized\|general] \<item>] ...) - 作用：为给定的目标设置链接时使用的库（设置要链接的库文件的名称） - eg:targetlinklibraries(MyProject a b.a [c.so]{.underline}) 将若干库文件链接到hello中，targetlinklibraries里的库文件的顺序符合gcc/g++链接顺序规则，即：被依赖的库放在依赖他的库的后面，如果顺序有错，链接将会报错
-
CMake基本控制语法
> COMMAND1(ARGS \...)\ > COMMAND2(ARGS \...)\ > \...\ > else (expression)\ > COMMAND1(ARGS \...)\ > COMMAND2(ARGS \...)\ > \...\ > endif (expression)\ > 注意：ENDIF要和IF对应
> 例：\ > IF (\"hello\" MATCHES \"ell\") \ > MESSAGE(\"true\") \ > ENDIF (\"hello\" MATCHES \"ell\")
> WHILE(condition)\ > COMMAND1(ARGS \...)\ > COMMAND2(ARGS \...)\ > \...\ > ENDWHILE(condition)
> FOREACH(loop_var arg1 arg2 \...)\ > COMMAND1(ARGS \...)\ > COMMAND2(ARGS \...)\ > \...\ > ENDFOREACH(loop_var)
> eg:\ > AUX_SOURCE_DIRECTORY(. SRC_LIST)\ > FOREACH(F \${SRC_LIST})\ > MESSAGE(\${F})\ > ENDFOREACH(F)
> FOREACH(loop_var RANGE total)\ > COMMAND1(ARGS \...)\ > COMMAND2(ARGS \...)\ > \...\ > ENDFOREACH(loop_var)
> eg:\ > FOREACH(VAR RANGE 100)\ > MESSAGE(\${VAR})\ > ENDFOREACH(VAR)\ >
> FOREACH(loop_var RANGE start stop \[step\])\ > COMMAND1(ARGS \...)\ > COMMAND2(ARGS \...)\ > \...\ > ENDFOREACH(loop_var)
> eg:\ > FOREACH(A RANGE 0 100 10)\ > MESSAGE(\${A})\ > ENDFOREACH(A)
-
构建规范以及构建属性 - 用于指定构建规则以及程序使用要求的指令：targetincludedirectories(), targetcompiledefinitions(), targetcompileoptions() - 指令格式 - targetincludedirectories(\<target> [SYSTEM] [BEFORE]\<INTERFACE\|PUBLIC\|PRIVATE> [items1...] [\<INTERFACE\|PUBLIC\|PRIVATE> [items2...] ...])\ > Include的头文件的查找目录，也就是Gcc的[-Idir...]选项 - targetcompiledefinitions(\<target> \<INTERFACE\|PUBLIC\|PRIVATE> [items1...][\<INTERFACE\|PUBLIC\|PRIVATE> [items2...] ...])\ > 通过命令行定义的宏变量 - targetcompileoptions(\<target> [BEFORE] \<INTERFACE\|PUBLIC\|PRIVATE> [items1...] [\<INTERFACE\|PUBLIC\|PRIVATE> [items2...] ...]\ > gcc其他的一些编译选项指定，比如-fPIC\ > - -fPIC选项说明\ > 说明：-fPIC 作用于编译阶段，告诉编译器产生与位置无关代码(Position-Independent Code)，\ > 则产生的代码中，没有绝对地址，全部使用相对地址，故而代码可以被加载器加载到内存的任意\ > 位置，都可以正确的执行。这正是共享库所要求的，共享库被加载时，在内存的位置不是固定的。 - -ldir选项说明\ > 说明：在你是用 [#include]{.underline} \"file\" 的时候, gcc/g++ 会先在当前目录查找你所制定的头文件, 如果没有找到, 他会到缺省的头文件目录找, 如果使用 -I 制定了目录,他会先在你所制定的目录查找, 然后再按常规的顺序去找。 - 以上的额三个命令会生成INCLUDEDIRECTORIES, COMPILEDEFINITIONS, COMPILEOPTIONS变量的值,。或者 INTERFACEINCLUDEDIRECTORIES,INTERFACECOMPILEDEFINITIONS, INTERFACECOMPILE_OPTIONS的值. - 这三个命令都有三种可选模式: PRIVATE, PUBLIC。 INTERFACE. PRIVATE模式仅填充不是接口的目标属性; INTERFACE模式仅填充接口目标的属性.PUBLIC模式填充这两种的目标属性。 - - 宏和函数 - CMake里面可以定义自己的函数（function）和宏（macro） - 区别1：范围。函数是有范围的，而宏没有。如果希望函数设置的变量在函数的外部也可以看见，就需要使用PARENT_SCOPE来修饰，但是函数对于变量的控制会比较好，不会有变量泄露 - 例子 - 宏（macro）\ > eg:\ > macro( [arg1 [arg2 [arg3 ...]]])\ > COMMAND1(ARGS ...)\ > COMMAND2(ARGS ...)\ > ...\ > endmacro() - 函数（function）\ > eg:\ > function( [arg1 [arg2 [arg3 ...]]])\ > COMMAND1(ARGS ...)\ > COMMAND2(ARGS ...)\ > ...\ > endfunction() - 函数和宏的区别还在于，函数很难将计算结果传出来，使用宏就可以将一些值简单的传出来 - 例子\ > eg:\ > macro(macroTest)\ > set(test1 \"aaa\")\ > endmacro()\ > \ > function(funTest)\ > set(test2 \"bbb\")\ > endfunction()\ > \ > macroTest()\ > message(\"\${test1}\")\ > \ > funTest()\ > message(\"\${test2}\")\ > - 运行上面这个代码，就会显示"aaa"，因为函数里面的test1是局部的，出了这个函数就出了他的作用域 - 和其他文件的交互 - 在代码中使用CMake中定义的变量 - 命令：configure_file - 作用：让普通文件也能使用CMake中的变量。 - 语法\ > configurefile(\<input> \<output>\ > [COPYONLY] [ESCAPEQUOTES] [[\@ONLY]{.underline}]\ > [NEWLINE_STYLE [UNIX\|DOS\|WIN32\|LF\|CRLF] ])\ > 解释：拷贝一个 \<input>（输入文件） 文件到 \<output> （输出文件），并且替换输入文件中被 \@VAR@ 或者 \${VAR} 引用的变量值。每一个变量将被替换成当前的变量值 - 参数解析 - COPYONLY：只拷贝文件，不进行任何的变量替换。这个选项在指定了 NEWLINE_STYLE 选项时不能使用（无效）。 - ESCAPE_QUOTES：躲过任何的反斜杠(C风格)转义。\ > 注：躲避转义，比如你有个变量在CMake中是这样的 set(FOOSTRING \"\\\"foo\\\"\") 那么在没有 ESCAPEQUOTES 选项的状态下，通过变量替换将变为 \"\"foo\"\"，如果指定了 ESCAPE_QUOTES 选项，变量将不变。 - [\@ONLY]{.underline}：限制变量替换，让其只替换被 \@VAR@ 引用的变量（那么 \${VAR} 格式的变量将不会被替换）。这在配置 \${VAR} 语法的脚本时是非常有用的。 - NEWLINE_STYLE \<style>：指定输出文件中的新行格式。UNIX 和 LF 的新行是 \\n ，DOS 和 WIN32 和 CRLF 的新行格式是 \\r\\n 。 这个选项在指定了 COPYONLY 选项时不能使用（无效）。 - 在CMake对文件的操作 - file命令 - file(WRITE filename \"message to write\"... ) - 解释：WRITE选项会写一条消息到名为filename中，如果文件存在，则会覆盖原文件，如果文件不存在，他将创建该文件 - file(APPEND filename \"message to write\"... ) - 解释：APPEND选项和WRITE选项一样，只是APPEND会写到文件的末尾 - file(READ filename variable [LIMIT numBytes] [OFFSET offset] [HEX]) - 解释：READ选项会将读取的文件内容存放到变量variable ，读取numBytes个字节，从offset位置开始，如果指定了[HEX]参数，二进制代码就会转换为十六进制的转换方式 - file(STRINGS filename variable [LIMITCOUNT num] [LIMITINPUT numBytes] [LIMITOUTPUT numBytes] [LENGTHMINIMUM numBytes] [LENGTHMAXIMUM numBytes] [NEWLINECONSUME] [REGEX regex] [NOHEXCONVERSION]) - 解释：STRINGS标志，将会从一个文件中将ASCII字符串的list解析出来，然后储存在variable 变量中，文件中的二进制数据将会被忽略，回车换行符会被忽略（可以设置NOHEXCONVERSION选项来禁止这个功能）。LIMITCOUNT：设定了返回字符串的最大数量；LIMITINPUT：设置了从输入文件中读取的最大字节数；LIMITOUTPUT：设置了在输出变量中允许存储的最大字节数；LENGTHMINIMUM：设置了返回字符串的最小长度，小于该长度的字符串将会被忽略；LENGTHMAXIMUM设置了返回字符串的最大长度，大于该长度的字符串将会被忽略；NEWLINECONSUME：该标志允许新行被包含到字符串中，而不是终止他们；REGEX：指定了返回的字符串必须满足的正则表达式 - 典型的使用方式：file(STRINGS myfile.txt myfile) - 该命令在变量myfile中储存了一个list,该list每一项是myfile.txt中的一行文本 - file(GLOB variable [RELATIVE path] [globbing expressions]...) - 解释：GLOB：该选项将会为所有匹配表达式的文件生成一个文件list，并将该list存放在variable 里面，文件名的查询表达式和正则表达式类似， - 查询表达式的例子：①*.cpp -匹配所有后缀是.cpp的文件②*.vb? -匹配文件后缀是.vba——.vbz的文件③f[3-5].txt ：匹配f3.txt,f4.txt,f5.txt文件 - file(GLOBRECURSE variable [RELATIVE path] [FOLLOWSYMLINKS] [globbing expressions]...) - 解释：GLOB_RECURSE会生成一个类似于通常GLOB选项的list，不过该选项可以递归查找文件中的匹配项 - 比如：/dir/*.py -就会匹配所有在/dir文件下面的python文件， - file(RENAME \<oldname> \<newname>) - 解释：RENAME选项对同一个文件系统下的一个文件或目录重命名 - file(REMOVE [file1 ...]) - 解释：REMOVE选项将会删除指定的文件，包括在子路径下的文件 - file(REMOVE_RECURSE [file1 ...]) - 解释：REMOVE_RECURSE选项会删除给定的文件以及目录，包括非空目录 - file(MAKE_DIRECTORY [directory1 directory2 ...]) - 解释：MAKE_DIRECTORY选项将会创建指定的目录，如果它们的父目录不存在时，同样也会创建 - file(RELATIVE_PATH variable directory file) - 解释：RELATIVE_PATH选项会确定从direcroty参数到指定文件的相对路径，然后存到变量variable中 - file(TOCMAKEPATH path result) - 解释：TOCMAKEPATH选项会把path转换为一个以unix的 / 开头的cmake风格的路径 - file(TONATIVEPATH path result) - 解释：TONATIVEPATH选项与TOCMAKEPATH选项很相似，但是它会把cmake风格的路径转换为本地路径风格 - file(DOWNLOAD url file [TIMEOUT timeout] [STATUS status] [LOG log] [EXPECTEDMD5 sum] [SHOWPROGRESS]) - 解释：DOWNLOAD将给定的url下载到指定的文件中，如果指定了LOG log，下载的日志将会被输出到log中，如果指定了STATUS status选项下载操作的状态就会被输出到status里面，该状态的返回值是一个长度为2的list，list第一个元素是操作的返回值，是一个数字 ，第二个返回值是错误的字符串，错误信息如果是0，就表示没有错误；如果指定了TIMEOUT time选项，time秒之后，操作就会推出。如果指定了EXPECTEDMD5 sum选项，下载操作会认证下载的文件的实际MD5和是否与期望值相匹配，如果不匹配，操作将返回一个错误；如果指定了SHOWPROGRESS，进度信息会被打印出来，直到操作完成 - source_group命令 - 使用该命令可以将文件在VS中进行分组显示 - sourcegroup(\"Header Files\" FILES \${HEADERFILES}) - 以上命令是将变量HEADER_FILES里面的文件，在VS显示的时候都显示在"Header Files"选项下面 - 如何构建项目 - 工程文件结构 - lib文件夹 - libA.c - libB.c - CMakeLists.txt - include文件夹 - includeA.h - inclueeB.h - CMakeLists.txt - main.c - CMakeLists.txt - 第一层CMakeLists\ > 内容如下：\ > [#项目名称]{.underline}\ > project(main)\ > \ > [#需要的cmake最低版本]{.underline}\ > cmakeminiumrequired(VERSION 2.8)\ > \ > [#将当前目录下的源文件名都赋给DIRSRC目录]{.underline}\ > auxsourcedirectories(. DIRSRC)\ > \ > [#添加include目录]{.underline}\ > includedirectories(include)\ > \ > [#生成可执行文件]{.underline}\ > addexecutable(main \${DIRSRC})\ > \ > [#添加子目录]{.underline}\ > addsubdirectories(lib)\ > \ > [#将生成的文件与动态库相连]{.underline}\ > targetlinklibraries(main test)\ > [#test是lib目录里面生成的]{.underline} - lib目录下的CMakeLists\ > 内容如下：\ > [#将当前的源文件名字都添加到DIRLIB变量下]{.underline}\ > auxsourcedirector(. DIRLIB)\ > \ > [#生成库文件命名为test]{.underline}\ > addlibraries(test \${DIRLIB}) - include目录的CMakeLists可以为空，因为我们已经将include目录包含在第一层的文件里面 - 运行其他程序 - 在配置时运行命令 - 指令：execute_process\ > 参数：\ > executeprocess(COMMAND \<cmd1> [args1...]]\ > [COMMAND \<cmd2> [args2...] [...]]\ > [WORKINGDIRECTORY \<directory>]\ > [TIMEOUT \<seconds>]\ > [RESULTVARIABLE \<variable>]\ > [OUTPUTVARIABLE \<variable>]\ > [ERRORVARIABLE \<variable>]\ > [INPUTFILE \<file>]\ > [OUTPUTFILE \<file>]\ > [ERRORFILE \<file>]\ > [OUTPUTQUIET]\ > [ERRORQUIET]\ > [OUTPUTSTRIPTRAILINGWHITESPACE]\ > [ERRORSTRIPTRAILINGWHITESPACE]) - 作用：这条指令可以执行系统命令，将输出保存到cmake变量或文件中去，运行一个或多个给定的命令序列，每一个进程的标准输出通过管道流向下一个进程的标准输入。 - 参数解析 - COMMAND：子进程的命令行，CMake使用操作系统的API直接执行子进程，所有的参数逐字传输，没有中间脚本参与，像">"的输出重定向也会被直接的传输到子进程里面，当做普通的参数进行处理。 - WORKING_DIRECTORY：指定的工作目录将会设置为子进程的工作目录 - TIMEOUT：子进程如果在指定的秒数之内没有结束就会被中断 - RESULT_VARIABLE：变量被设置为包含子进程的运算结果，也就是命令执行的最后结果将会保存在这个变量之中，返回码将是来自最后一个子进程的整数或者一个错误描述字符串 - OUTPUTVARIABLE、ERRORVARIABLE：输出变量和错误变量
- ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - COMPONENTS选项，有些库不是一个整体比如Qt，其中还包含QtOpenGL和QtXml组件，当我们需要使用库的组件的时候，就使用COMPONENTS这个选项 - find_package(Qt COMPONENTS QtOpenGL QtXml REQUIRED) - ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - 找到之后给一些预定义的变量赋值 - 无论哪一种查找模式，只要找到包之后，就会给以下变量赋值：\<NAME>_FOUND,\<NAME>_INCLUDE_DIRS或者\<NAME>_INCLUDES,\<NAME>_LIBRARIES,\<NAME>_DEFINITIONS。这些变量都在Find\<NAME>.cmake文件中。 - 我们可以在CMakeLists.txt中使用\<NAME>_FOUND变量来检测摆包是否被找到， - ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - find_package的本质是执行一个.cmake文件，相当于cmake的内置的脚本，这个脚本将设置我们之前提到的相关的变量，相当于根据传进来的参数来使用一个查找模块，每一个常用的库在cmake里面就有一个对应的查找模块。 - ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ - find模块的编写流程： - 首先使用：findpath和findlibrary查找模块的头文件以及库文件，然后将结果放到\<NAME>_INCLUDE_DIR和\<NAME>_LIBRARY里面 - find_path()： - find_path(\<VAR> name1 [path1 path2 ...]) - 该命令搜索包含某个文件的路径，用于给定名字的文件所在路径， - 一条名为：\<VAR>的变量的Cache将会被创建。 - 如果在某个文件下面发现了该文件，路径就会被储存到变量里面，除非变量被清除，否则搜搜将不会进行。 - 如果没有发现该文件，\<VAR>里面储存的就是\<VAR>-NOTFOUND - find_library(): - find_library(\<VAR> name1 [path1 path2 ...]) - 查找一个库文件 - 设置：\<NAME>_INCLUDEDIRS为\<NAME>_INCLUDEDIR\<dependency1>_INCLUDE_DIRS ... - 设置 \<name>_LIBRARIES 为 \<name>_LIBRARY \<dependency1>_LIBRARIES ... - 调用宏 findpackagehandlestandardargs() 设置 \<name>_FOUND 并打印或失败信息 - ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ - 我们以Cmake里面自带的bzip2库为例，Cmake的module目录里面有一个：FindBZip.cmake模块，我们使用find_package（BZip2），然后CMake就会给相关的变量赋值，我们就可以调用这个模块，就可以使用模块里面的变量，模块里面的变量有哪些，我们可以使用命令： cmake --help-module FindBZip2来查看，最后面的参数就是带上Find前缀之后的模块的名字。 - 假如一个程序需要使用BZip2库，编译器需要知道bzlib.h的位置，链接器需要知道bzip2库（动态链接：.so或者.dll） -
- 添加库的指令：find_package(BZip2 REQUIRED) - CMake里面又很多内置的库，当我们使用findpackage查找包的时候CMake首先会去CMAKEMODULE_PATH这个变量存放的路径里面去寻找 - 注意：CMAKEMODULEPATH的路径设置需要在顶层的CMakeLists.txt里面去设置。 - findpackage之后，变量：BZIPINCLUDEDIRS以及BZIP2LIBRARIES就会被设置，然后我们使用includedirectories以及targetlink_libraries来使用即可 - ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ - 使用一个cmake里面没有带的库 - cmake的/share/cmake-X.XX/Modules里面带的都是一些常用的库，如果我们现在需要使用一个cmake里面没有提供给我们find模块的库，做法如下： - 首先模拟生成一个生成lib文件 - 创建工程，名为：ThirdLIB - 生成一个lib文件，名为：ThirdDLL.lib - lib文件里面只提供了一个求和的add函数，返回两个int值的和 - 在CMakeLists.txt里面设置CMAKEMODULEPATH，这里设置的是本地的路径，这个路径存放的find模块 -
- 编写自己的find模块 - 注意：cmake使用find_package查找使用的库，当我们把库名字传进去之后，cmake会在按照指定的模式查找一个：Find\<NAME>.cmake的文件，常用的库，cmake都会提供对应的.cmake文件，但是现在我们使用的是自己编写的库，所以cmake是没有提供的，需要自己编写 - 编写大致流程已经给出，我们编写的文件名必须是：Find\<Name>.cmake,现在就是"FindThidrDLL.cmake" - FindThirDLL.cmake内容如下 -
- 修改CMakeLists.txt文件，在里面使用find_package命令添加模块、 -
- 完成之后，打开生成的工程，查看工程的依赖项，就会有ThirdLIB.lib的选项 -
- ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ - 当我们在CMake里面使用一个库时候，如何在网上查找，比如现在需要查找：apr库，在goole里面搜索：find package apr cmake，就可以直接找到对应的CMake脚本。然后复制粘贴，创建.cmake文件，放在工程根目录下面的modules目录，没有则创建之 - ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ -
- addcustomcommand：（1）为某一个工程添加一个自定义的命令\ > addcustomcommand(TARGET target\ > PREBUILD \| PRELINK\| POSTBUILD\ > COMMAND command1[ARGS] [args1...]\ > [COMMAND command2[ARGS] [args2...] ...]\ > [WORKINGDIRECTORYdir]\ > [COMMENT comment][VERBATIM])\ > 作者：drybeans\ > 链接：[https://www.jianshu.com/p/66df9650a9e2]{.underline}\ > 來源：简书\ > 简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。 - 执行命令的时间由第二个参数决定\ > 1.PREBUILD - 命令将会在其他依赖项执行前执行\ > 2.PRELINK - 命令将会在其他依赖项执行完后执行\ > [3.POST]{.underline}_BUILD - 命令将会在目标构建完后执行。 - 例子1：\ > addcustomcommand (\ > TARGET \${PROJECTNAME}\ > POSTBUILD\ > COMMAND \${CMAKECOMMAND} -E sleep 5\ > )\ > [#目标就是TARGET后面跟的工程]{.underline}，当PROJECTNAME被生成的时候就会执行COMMAND后面的命令 - 例子2：\ > addcustomcommand(TARGET testelf\ > PREBUILD\ > COMMAND\ > move E:/cfg/start.o \${CMAKEBINARYDIR}/. &&\ > )\ > [#在test_el执行依赖之前]{.underline}，将start.o文件复制到编译目录 - addcustomcommand：（2）添加自定义命令来产生一个输出\ > addcustomcommand(OUTPUT output1 [output2 ...]\ > COMMAND command1[ARGS] [args1...]\ > [COMMAND command2 [ARGS] [args2...] ...]\ > [MAINDEPENDENCYdepend]\ > [DEPENDS[depends...]]\ > [IMPLICITDEPENDS\<lang1> depend1 ...]\ > [WORKING_DIRECTORYdir]\ > [COMMENT comment] [VERBATIM] [APPEND]) - 其中ARGS选项 是为了向后兼容，MAIN_DEPENDENCY选项是针对Visual Studio给出一个建议，这两选项可以忽略 - COMMAND：指定一些在构建阶段执行的命令。如果指定了多于一条的命令，他会按照顺序去执行。如果指定了一个可执行目标的名字（被add_executable()命令创建），他会自动被在构建阶段创建的可执行文件的路径替换， - DEPENDS:指定目标依赖的文件，如果依赖的文件是和CMakeLists.txt相同目录的文件，则命令就会在CMakeLists.txt文件的，目录执行。如果没有指定DEPENDS，则只要缺少OUTPUT，该命令就会执行。如果指定的位置和CMAkeLists.txt不是同一位置，会先去创建依赖关系，先去将依赖的目标或者命令先去编译。 - WORKING_DIRECTORY：使用给定的当前目录执行命令，如果是相对路径，则相对于当前源目录对应的目录结构进行解析 - 例子\ > [#首先生成creator的可执行文件]{.underline}\ > addexecutable(creator creator.cxx)\ > \ > [#获取EXELOC的LOCATION属性存放到creator里面]{.underline}\ > gettargetproperty(creator EXELOC LOCATION)\ > \ > [#生成created]{.underline}.c文件\ > addcustomcommand (\ > OUTPUT \${PROJECTBINARYDIR}/created.c\ > DEPENDS creator\ > COMMAND \${EXELOC}\ > ARGS \${PROJECTBINARYDIR}/created.c\ > )\ > \ > [#使用上一步生成的created]{.underline}.c文件来生成Foo可执行文件\ > addexecutable(Foo \${PROJECTBINARY_DIR}/created.c) - 注意：不要再多个相互独立的文件中使用该命令产生相同的文件，防止冲突。 - addcustomtarget：增加定制目标\ > addcustomtarget(Name [ALL] [command1 [args1...]]\ > [COMMAND command2 [args2...] ...]\ > [DEPENDS depend depend depend ... ]\ > [BYPRODUCTS [files...]]\ > [WORKINGDIRECTORY dir]\ > [COMMENT comment]\ > [VERBATIM] [USESTERMINAL]\ > [SOURCES src1 [src2...]]) - 命令 addcustomtarget 可以增加定制目标，常常用于编译文档、运行测试用例等。 - addcustomcommand和addcustomtarget的区别 - 命令命名里面的区别就在于：command和target，前者是自定义命令，后者是自定义目标 - 目标：一般来说目标是调用：addlibrary或者addexecutable生成的exe或者库，他们具有许多属性集，这些就是所谓目标，而使用addcustomtarget定义的叫做自定义目标，因此这些"目标"区别于正常的目标，他们不生成exe或者lib，但是仍然会具有一些正常目标相同的属性，构建他们的时候，只是调用了为他们设置的命令，如果自定义目标对于其他目标有依赖，那么就会优先生成依赖的那些目标 - 自定义命令：自定义命令不是一个"可构建"的对象，并且没有可以设置的属性，自定义命令是一个在构建依赖目标之前被调用的命令，自定义命令的依赖可以通过addcustomcommand(TARGET target …)形式显式设置，也可以通过addcustomcommand(OUTPUT output1 …)生成文件的形式隐式设置。显示执行的时候，每次构建目标，首先会执行自定义的命令，隐式执行的时候，如果自定义的命令依赖于其他文件，则在构建目标的时候先去执行生成其他文件。 - 如何添加C++项目中的常用选项 > 如：如何支持C++11、如何支持IDE等 - 如何激活C++11功能 > 语法：targetcompilefeatures(\<target> \<PRIVATE\|PUBLIC\|INTERFACE> \<feature> [...]) - targetcompilefeatures(\<projectname> PUBLIC cxxstd_11) - 参数target必须是由：addexecutable或者addlibrary生成的目标 - 另外一种支持C++标准的方法 > #设置C++标准级别 > set(CMAKECXXSTANDARD 11) > > [#告诉CMake使用他]{.underline}它 > set(CMAKECXXSTANDARDREQUIRED ON) > > #（可选）确保-std=C++11 > set(CMAKECXX_EXTENSIONS OFF) - CMake的过程间优化 - 如果编译器不支持，就会将设置的过程间优化标记为错误，可以使用命令：checkiposupported()来查看 > [#检测编译器是否支持过程间优化]{.underline} > checkiposupported(RESULT result) > > [#如果不支持]{.underline}，判断进不去 > if(result) > [#为工程foo设置]{.underline}过程间优化 > settargetproperties(foo PROPERTIES INTERPROCEDURAL_OPTIMIZATION TRUE) > endif() - CMake的option简介 - option命令可以设置默认值 > option(address \"this is path for value\" ON) - 命令表示，当用户没有设置address的时候，默认值就是ON，当用户显示的设置address的时候，address里面就是用户设置的值 - 注意：加入有一些变量依赖了address，但是这些变量的使用在option语句之前，此时对于这些变量来说，address还是属于没有定义的。 - 在用户没有提供ON或者OFF的时候，默认是OFF。如果option有改变，一定要清理CMakeCache.txt文件和CMakeFiles文件夹 - CMake编译选项的管理 - 在工程的根目录，编写CMakeLists.txt，另外单独创建option.txt文件，专门管理编译选项 - 在CMakeLists.txt中加入： > include option.txt - 在option.txt中添加： > /*USEMYMATH 为编译开关，中间的字符串为描述信息，ON/OFF 为默认选项*/\ > option (USEMYMATH \ > \"Use tutorial provided math implementation\" ON) - 在编译之前，执行ccmake . 就会弹出cmake GUI，进行配置所有的编译开关，配置结束之后会生成一个CMakeCache.txt，配置后的编译选项会保存在这个文件中\ > [https://blog.csdn.net/haima1998/article/details/23352881]{.underline} - 怎么生成依赖于其他option的option > [#设置option]{.underline}：USECURL > option(USECURL \"use libcurl\" ON) > > [#设置option]{.underline}：USEMATH > option(USEMATH \"use libm\" ON) > > [#设置一个option]{.underline}：DEPENTUSECURL,第二个参数是他的说明，ON后面的参数是一个表达式，当"USECURL"且"USEMATH"为真的时候，DEPENTUSECURL取ON，为假取OFF\ > cmakedependentoption(DEPENTUSECURL \"this is dependent on USECURL\" ON \"USECURL;NOT USE_MATH\" OFF) - 属性调试模块（CMakePrintHelpers） > CMAKEPRINTPROPERTIES([TARGETS target1 .. targetN]\ > [SOURCES source1 .. sourceN] > [DIRECTORIES dir1 .. dirN] > [TESTS test1 .. testN] > [CACHE_ENTRIES entry1 .. entryN] > PROPERTIES prop1 .. propN ) - 如果要检查foo目标的INTERFACEINCLUDEDIRS和LOCATION的值，则执行： > cmakeprintproperties （ TARGETS foo > PROPERTIES > INTERFACEINCLUDEDIRS > LOCATION ） - CMake3.8以上叫做Modern CMake