Cmake Practice(二)

转载自 https://blog.csdn.net/xuewend/article/details/78228671  感谢作者:fishmov

上一节我们用一个实例简单地演示了cmake的用法,这一节我们将继续.

==》没看懂，先看下一章

四，更好一点的Hello World 
从本小节开始，后面所有的构建我们都将采用out-of-source外部构建，约定的构建目录是工程目录下的build自录

cd leran-cmake
mkdir build

本小节的任务是让前面的Hello World更像一个工程，我们需要作的是：

1，为工程添加一个子目录src，用来放置工程源代码; 
2，添加一个子目录doc，用来放置这个工程的文档hello.txt 
3，在工程目录添加文本文件COPYRIGHT, README； 
4，在工程目录添加一个runhello.sh脚本，用来调用hello二进制 
5，将构建后的目标文件放入构建目录的bin子目录； 
6，最终安装这些文件：将hello二进制与runhello.sh安装至/usr/bin，将doc目录的内容以及COPYRIGHT/README安装到/usr/share/doc/cmake/practice2

1，准备工作： 
在/leran-cmake/目录下新建子目录practice2 
将practice1工程的main.c和CMakeLists.txt拷贝到practice2目录中

2,添加子目录src:

cd practice2
mkdir src
mv main.c src

   进入子目录src，编写CMakeLists.txt如下：

ADD_EXECUTABLE(hello main.c)

 在 practice2/  新建 CMakeLists.txt

PROJECT(HELLO) 
ADD_SUBDIRECTORY(src bin)

=========》此时有两份 CMakeLists.txt 一份在practice2/src  一份在 practice2/

然后在build目录中进行构建       

cd ../build/
rm -rf *
cmake ../practice2/
make

构建完成后，你会发现生成的目标文件hello位于build/bin目录中。

语法解释: 
ADD_SUBDIRECTORY指令 
ADD_SUBDIRECTORY(source_dir [binary_dir] [EXCLUDE_FROM_ALL])这个指令用于向当前工程添加存放源文件的子目录，并可以指定中间二进制和目标二进制存放的位置。EXCLUDE_FROM_ALL参数的含义是将这个目录从编译过程中排除，比如，工程的example，可能就需要工程构建完成后，再进入example目录单独进行构建(当然，你也可以通过定义依赖来解决此类问题)。

上面的例子定义了将src子目录加入工程，并指定编译输出(包含编译中间结果)路径为bin目录。如果不进行bin目录的指定，那么编译结果(包括中间结果)都将存放在 build/src目录(这个目录跟原有的src目录对应)，指定bin目录后，相当于在编译时将src重命名为bin，所有的中间结果和目标二进制都将存放在bin目录。

这里需要提一下的是 SUBDIRS 指令,使用方法是: 
SUBDIRS(dir1 dir2…),但是这个指令已经不推荐使用。它可以一次添加多个子目录, 
并且,即使外部编译,子目录体系仍然会被保存。 
如果我们在上面的例子中将 ADD_SUBDIRECTORY (src bin)修改为 SUBDIRS(src)。 
那么在 build 目录中将出现一个 src 目录,生成的目标代码 hello 将存放在 src 目录中。

3,换个地方保存目标二进制 
不论是 SUBDIRS 还是 ADD_SUBDIRECTORY 指令(不论是否指定编译输出目录),我们都可 
以通过 SET 指令重新定义 EXECUTABLE_OUTPUT_PATH 和 LIBRARY_OUTPUT_PATH 变量 
来指定最终的目标二进制的位置(指最终生成的 hello 或者最终的共享库,不包含编译生成 
的中间文件) 
SET(EXECUTABLE_OUTPUT_PATH PROJECTBINARYDIR/bin)SET(LIBRARYOUTPUTPATHPROJECTBINARYDIR/bin)SET(LIBRARYOUTPUTPATH{PROJECT_BINARY_DIR}/lib)

在第一节我们提到了_BINARY_DIR 和 PROJECT_BINARY_DIR 变量,他 
们指的编译发生的当前目录,如果是内部编译,就相当于 PROJECT_SOURCE_DIR 也就是 
工程代码所在目录,如果是外部编译,指的是外部编译所在目录,也就是本例中的 build 
目录。

所以,上面两个指令分别定义了: 
可执行二进制的输出路径为 build/bin 和库的输出路径为 build/lib. 
本节我们没有提到共享库和静态库的构建,所以,你可以不考虑第二条指令。

问题是,我应该把这两条指令写在工程的 CMakeLists.txt 还是 src 目录下的 
CMakeLists.txt,把握一个简单的原则,在哪里 ADD_EXECUTABLE 或 ADD_LIBRARY, 
如果需要改变目标存放路径,就在哪里加入上述的定义。在这个例子里,当然就是指 src 下的 CMakeLists.txt 了。