Android之性能监控框架
[TOC]
概述
在很多时候,需要在cmake
中创建一些目标,如clean
、copy
等等,这就需要通过add_custom_target
来指定。同时,add_custom_command
可以用来完成对add_custom_target
生成的target
的补充。
本文实例源码github地址:https://github.com/yngzMiao/yngzmiao-blogs/tree/master/2019Q4/20191029。
add_custom_target
如果你写过MakeFile
,那么一定知道,可以设定很多的目标来make
,如:
1 | target ... : prerequisites ... |
其中:
target是下面的命令的目标,即下面命令是为了target而生的。这个目标可以是*.o文件,也可以是可执行文件;
prerequisites则是生成该目标所依赖的文件,如果找不到依赖的文件,下面的命令就不会执行且会中断make;
command就是生成目标文件的命令,一般就是编译命令。
那么,如果使用CMakeLists.txt
如何也生成一个目标来make
呢?
这就是add_custom_target
的用处:增加一个没有输出的目标,使得它总是被构建。
1 | add_custom_target(Name [ALL] [command1 [args1...]] |
乍一看,该命令有很多的参数,但其实我们并不需要全部了解,甚至一般情况下只需要用到其中的两三个。
例如:
1 | cmake_minimum_required(VERSION 3.0) |
运行该CMakeLists.txt:
1 | mkdir build && cd build |
运行结果为:
1 | yngzmiao@yngzmiao-virtual-machine:~/test/build$ rm -r *;cmake .. |
命令行的打印信息看不出什么东西,但是如果根目录下有config
文件夹,或者有log.txt
文件,那么文件夹内的文件和log.txt
会被拷贝到etc
文件夹下。
初始目录结构,如下:
1 | |---build |
运行后目录结构,如下:
1 | |---build |
其实可以看出,这段代码的目的就是将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
按照官方资料翻译的话,这个命令的用途是:将自定义构建规则添加到生成的构建系统。
什么鬼!我猜,你一定和我一样蒙,完全不太能够理解是什么意思。既然无法理解它的语言版本的解释,那就在具体的例子中进行熟悉。
该命令主要用于两种场景下:
生成文件
这种场景是:添加定制命令来生成文件。它的命令内容为:
1 | add_custom_command(OUTPUT output1 [output2 ...] |
例如:
1 | cmake_minimum_required(VERSION 3.0) |
add_custom_target
生成一个目标CopyTask
,该目标依赖于COPY_RES
。而对于COPY_RES
而言,它实际上是用来复制文件夹或者复制文件的!也就是COMMAND
中定义的操作。
该命令的其他一些参数的含义:
- OUTPUT:指定命令预期产生的输出文件。如果输出文件的名称是相对路径,即相对于当前的构建的源目录路径;
- COMMAND:指定要在构建时执行的命令行;
- DEPENDS:指定命令所依赖的文件;
- COMMENT:在构建时执行命令之前显示给定消息;
- WORKING_DIRECTORY:使用给定的当前工作目录执行命令。如果它是相对路径,它将相对于对应于当前源目录的构建树目录;
- DEPFILE:为生成器指定一个.d depfile .d文件保存通常由自定义命令本身发出的依赖关系;
- MAIN_DEPENDENCY:指定命令的主要输入源文件;
- BYPRODUCTS:指定命令预期产生的文件。