【CMake】cmake的add_custom_command和add_custom_target指令
在很多时候,需要在cmake
中创建一些目标,如clean
、copy
等等,这就需要通过add_custom_target
来指定。同时,add_custom_command
可以用来完成对add_custom_target
生成的target
的补充。
add_custom_target
如果你写过MakeFile
,那么一定知道,可以设定很多的目标来make
,如:
target ... : prerequisites ... command
其中:
- target是下面的命令的目标,即下面命令是为了
target
而生的。这个目标可以是*.o
文件,也可以是可执行文件; - prerequisites则是生成该目标所依赖的文件,如果找不到依赖的文件,下面的命令就不会执行且会中断
make
; - command就是生成目标文件的命令,一般就是编译命令。
那么,如果使用CMakeLists.txt
如何也生成一个目标来make
呢?
这就是add_custom_target
的用处:增加一个没有输出的目标,使得它总是被构建。
add_custom_target(Name [ALL] [command1 [args1...]][COMMAND command2 [args2...] ...][DEPENDS depend depend depend ... ][BYPRODUCTS [files...]][WORKING_DIRECTORY dir][COMMENT comment][JOB_POOL job_pool][VERBATIM] [USES_TERMINAL][COMMAND_EXPAND_LISTS][SOURCES src1 [src2...]])
乍一看,该命令有很多的参数,但其实我们并不需要全部了解,甚至一般情况下只需要用到其中的两三个。
例如:
cmake_minimum_required(VERSION 3.0)
project(test)add_custom_target(CopyTaskCOMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_CURRENT_SOURCE_DIR}/config ${CMAKE_CURRENT_SOURCE_DIR}/etcCOMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/log.txt ${CMAKE_CURRENT_SOURCE_DIR}/etc)
运行该CMakeLists.txt:
mkdir build && cd build
cmake ..
make CopyTask
运行结果为:
yngzmiao@yngzmiao-virtual-machine:~/test/build$ rm -r *;cmake ..
-- The C compiler identification is GNU 5.4.0
-- The CXX compiler identification is GNU 5.4.0
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Configuring done
-- Generating done
-- Build files have been written to: /home/yngzmiao/test/build
yngzmiao@yngzmiao-virtual-machine:~/test/build$ make CopyTask
Scanning dependencies of target CopyTask
Built target CopyTask
命令行的打印信息看不出什么东西,但是如果根目录下有config
文件夹,或者有log.txt
文件,那么文件夹内的文件和log.txt
会被拷贝到etc
文件夹下。
初始目录结构,如下:
|---build
|---config|---log.log
|---CMakeLists.txt
|---log.txt
运行后目录结构,如下:
|---build
|---config|---log.log
|---etc|---log.log|---log.txt
|---CMakeLists.txt
|---log.txt
其实可以看出,这段代码的目的就是将config
文件夹的内容和log.txt
文件复制到新的etc
文件夹内。
add_custom_target
生成一个目标CopyTask
,该目标是用来复制文件夹或者复制文件的!也就是COMMAND
中定义的操作。
其中:${CMAKE_COMMAND}是CMake的路径,-E使CMake运行命令而不是构建,copy_directory和copy是cmake_command_line,再后面两个就是command_line的参数。
当然,生成文件不仅仅只能是复制,还可以是其他的操作。而这些COMMAND操作,都在command_line中规定了。
至于cmake_command_line
的内容,可参考cmake
的官方资料:Run a Command-Line Tool。
该命令的其他一些参数的含义:
- ALL:表明该目标会被添加到默认的构建目标,使得它每次都被运行;
- COMMAND:指定要在构建时执行的命令行;
- DEPENDS:指定命令所依赖的文件;
- COMMENT:在构建时执行命令之前显示给定消息;
- WORKING_DIRECTORY:使用给定的当前工作目录执行命令。如果它是相对路径,它将相对于对应于当前源目录的构建树目录;
- BYPRODUCTS:指定命令预期产生的文件。
add_custom_command
按照官方资料翻译的话,这个命令的用途是:将自定义构建规则添加到生成的构建系统。
什么鬼!我猜,你一定和我一样蒙,完全不太能够理解是什么意思。既然无法理解它的语言版本的解释,那就在具体的例子中进行熟悉。
该命令主要用于两种场景下:
生成文件
这种场景是:添加定制命令来生成文件。它的命令内容为:
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][JOB_POOL job_pool][VERBATIM] [APPEND] [USES_TERMINAL][COMMAND_EXPAND_LISTS])
例如:
cmake_minimum_required(VERSION 3.0)
project(test)add_custom_command(OUTPUT COPY_RESCOMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_CURRENT_SOURCE_DIR}/config ${CMAKE_CURRENT_SOURCE_DIR}/etcCOMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/log.txt ${CMAKE_CURRENT_SOURCE_DIR}/etc)add_custom_target(CopyTask ALL DEPENDS COPY_RES)
add_custom_target
生成一个目标CopyTask
,该目标依赖于COPY_RES
。而对于COPY_RES
而言,它实际上是用来复制文件夹或者复制文件的!也就是COMMAND
中定义的操作。
该命令的其他一些参数的含义:
- OUTPUT:指定命令预期产生的输出文件。如果输出文件的名称是相对路径,即相对于当前的构建的源目录路径;
- COMMAND:指定要在构建时执行的命令行;
- DEPENDS:指定命令所依赖的文件;
- COMMENT:在构建时执行命令之前显示给定消息;
- WORKING_DIRECTORY:使用给定的当前工作目录执行命令。如果它是相对路径,它将相对于对应于当前源目录的构建树目录;
- DEPFILE:为生成器指定一个.d depfile .d文件保存通常由自定义命令本身发出的依赖关系;
- MAIN_DEPENDENCY:指定命令的主要输入源文件;
- BYPRODUCTS:指定命令预期产生的文件。
构建事件
这种场景是:为某个目标(如库或可执行程序)添加一个定制命令。
这种定制命令可以设置在,构建这个目标过程中的某些时机。也就是就,这种场景可以在目标构建的过程中,添加一些额外执行的命令。这些命令本身将会成为该目标的一部分。注意,仅在目标本身被构建过程才会执行。如果该目标已经构建,命令将不会执行。
那么这些时机是什么呢?如下表所示:
参数 | 含义 |
---|---|
PRE_BUILD | 在目标中执行任何其他规则之前运行 |
PRE_LINK | 在编译源代码之后,链接二进制文件或库文件之前运行 |
POST_BUILD | 在目标内所有其他规则均已执行后运行 |
其中,PRE_BUILD
只被Visual Studio 7
及之后的版本支持,其他情况下PRE_BUILD
都被视为PRE_LINK
。
此时的命令为:
add_custom_command(TARGET <target>PRE_BUILD | PRE_LINK | POST_BUILDCOMMAND command1 [ARGS] [args1...][COMMAND command2 [ARGS] [args2...] ...][BYPRODUCTS [files...]][WORKING_DIRECTORY dir][COMMENT comment][VERBATIM] [USES_TERMINAL])
使用方式和第一种场景类似:
cmake_minimum_required(VERSION 3.0)
project(test)add_custom_target(CopyTask)add_custom_command(TARGET CopyTaskPOST_BUILDCOMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_CURRENT_SOURCE_DIR}/config ${CMAKE_CURRENT_SOURCE_DIR}/etcCOMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/log.txt ${CMAKE_CURRENT_SOURCE_DIR}/etc)
这段代码的功能和上一段是一样的,将config
文件夹的内容和log.txt
文件复制到新的etc
文件夹内。
需要注意的是,此时add_custom_command需要写在add_custom_target之后,否则将cmake不通过。
该命令的其他一些参数的含义:
- TARGET:指定命令运行的目标;
- COMMAND:指定要在构建时执行的命令行;
- COMMENT:在构建时执行命令之前显示给定消息;
- WORKING_DIRECTORY:使用给定的当前工作目录执行命令。如果它是相对路径,它将相对于对应于当前源目录的构建树目录;
- BYPRODUCTS:指定命令预期产生的文件。
add_custom_command总结
其实,可以看出尽管官方给了两种的使用情景,但是本质上没有什么区别,区别在于:
- 如果使用OUTPUT参数,需要在目标的构建中指定依赖于该OUTPUT;
- 如果使用TARGET参数,直接指定目标就可以了。
add_custom总结
其实,可以发现,add_custom_command
有时候略显鸡肋,因为我们可以将所有的COMMAND
都写到add_custom_target
中,不需要add_custom_command
来进行补充。
相关阅读
cmake整理:在编译时拷贝文件之add_custom_comand 和 add_custom_target
【CMake】cmake的add_custom_command和add_custom_target指令相关推荐
- CMake命令之add_custom_comand 和 add_custom_target
一.背景 在很多时候,需要在cmake中创建一些目标,如clean.copy等等,这就需要通add_custom_target来指定.而add_custom_command则可以用来完成对add_cu ...
- 现代 cmake (cmake 3.x) 操作大全
cmake 是一个跨平台编译工具,它面向各种平台提供适配的编译系统配置文件,进而调用这些编译系统完成编译工作.cmake 进入3.x 版本,指令大量更新,一些老的指令开始被新的指令集替代,并加入了 ...
- 《cmake practice》总结 | cmake的构建过程与基本指令
cmake 〇.基本语法规则 0.1 变量 0.2 指令规则 0.3 基本构建过程 一.基本指令 1. PROJECT指令 2. SET指令 3. MESSAGE指令 4. ADD_EXECUTABL ...
- CMake笔记:add_custom_command不执行
0x00. 前言 在网上看别人做一些手工教程视频,经常能看到这样的评论: 脑子:我感觉我会了. 手:你行你来. 之前一直通过编译脚本去寻找代码入口,感觉我已经懂得CMake的语法了,直到今天寄己要写一 ...
- 使用CMake 结合VisualStudio工程使用LINK_DIRECTORIES指令发生LNK1104 “无法打开文件xxx.lib”问题踩坑
这样的 我有一个库工程,已经编译好,生成了lib库. 这是 我又建立了一个app工程,想要链接库工程生成的lib库. 我在app工程的源码目录编辑了一个CMakeLists.txt文件 如图 内容如下 ...
- CMake | CMake模块
目录 一.CMake相关命令 1.CMAKE_MODULE_PATH 2.include 二.源码 1.CMake模块 2.CMakeLists.txt 三.构建 为了防止CMakeLists.txt ...
- cmake / cmake --build 如何理解
对于 cmake ,一直理解为项目构建工具,知道遇到 --build 才发现,cmake 还统一了各个平台的编译阶段.下面摘抄知乎上大神的理解: 简单说一下cmake项目构建过程: 1.首先,使用命令 ...
- cmake linux 交叉编译,[CMake]CMake设置arm-linux-gcc交叉编译器
标签: cmake 交叉编译器 arm-linux-gcc 分类: 开发工具/开发环境 主机:Ubuntu18.04 交叉编译器:arm-linux-gcc CMake在ubuntu系统下默认使用系统 ...
- 关于 CMake“cmake is not able to compile a simple test program”错误 的解决方法
若该文为原创文章,转载请注明原文出处 本文章博客地址:https://blog.csdn.net/qq21497936/article/details/110680001 长期持续带来更多项目与技术分 ...
最新文章
- JS获取div滚动条距离实现弹出标签位置动态移动
- linux php curl 安装包下载,linux中php如何安装CURL扩展方法
- python与人工智能编程-最适合人工智能开发的5种编程语言,Python排第一
- python成长之路【第七篇】:面向对象
- 八、K8s 密码管理
- 合并两个数组的两种方式的异同
- ISO27001测试题
- java超链接大全_JavaFX超链接
- 数据库表文档生成工具screw (螺丝钉)
- java 字母大小写的转换_Java字母大小写转换的方法
- 配置错误 访问被拒绝 解决方案
- cython编译python_cython编译报错
- 计算机网络知识点总结——第三章数据链路层
- 国家信息安全水平考试NISP考试经验分享
- Matlab中stft函数的使用与原理
- 入过滤(Ingress Filtering)
- 如何下载Hbuilder,而不是下载Hbuilder X?
- 学校学生计算机教室解决方案,学校学生计算机教室解决方案设计.docx
- 光眼图和电眼图_直调光模块中ER和OMA
- 专 业 学 习 成 果