☰
【cmake】CMake实践二:hello world(v2.0) 第一部分
2026/10/23 3:34:48 网站建设 项目流程

1.建立t2目录

在~/cmake目录下建立t2目录。将实践一中t1工程中的main.c和CMakeLists.txt拷贝到t2目录中。

先要把握一个宗旨,需要为任何一个子目录建立一个CMakeLists.txt

2.添加子目录src

mkdir src mv main.c src cd CMakeLists.txt touch CMakeLists.txt

上面是ubuntu终端中新建文件夹和移动文件的代码,感兴趣的小伙伴可以自行查看一下ubuntu terminal的一些简单命令。

上述操作后的src文件夹中应该有两个文件

两个文件的内容分别是:

~/cmake/t2/src/CMakeLists.txt

add_executable(hello main.c)#set(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)set(EXECUTABLE_OUTPUT_PATH ${CMAKE_INSTALL_PREFIX}/bin)set(LIBRART_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)

~/cmake/t2/src/main.c

#include <stdio.h>intmain(){printf("Hello world from t1 Main! \n");return0;}

2.主目录下的CMakeLists.txt

~/cmake/t2/CMakeLists.txt

cmake_minimum_required(VERSION2.6)project(HELLO)add_subdirectory(srcbin)set(SRC_LIST main.c)message(STATUS ${SRC_LIST})message(STATUS"This is Binary dir"${PROJECT_BINARY_DIR})message(STATUS"This is Source dir"${PROJECT_SOURCE_DIR})install(FILES COPYRIGHT README DESTINATION share/doc/cmake/t2)install(PROGRAMS runhello.sh DESTINATIONbin)install(DIRECTORY doc/DESTINATION share/d oc/cmake/t2)

按照工程习惯,可以按照如下的模板建立文件,但是文件夹内容并不固定。

runhello.sh文件内容:

hello#用来调用hello二进制

上面是直接把构建好的代码给小伙伴了,下面是整个代码的搭建过程,也是参考了Cmake practice,如果小伙伴感兴趣建议还是自己按照下面的步骤自行构建一遍,如果产生问题在回过来对比一下LZ的代码。

Hello World(v2.0)

没有最好,只有更好!

从本小节开始,后面所有的构建我们都将采用 out-of-source 外部构建,约定的构建目录是工程目录下的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/t2

1、准备工作:
在/backup/cmake/目录下建立t2目录。将t1工程的main.c和CMakeLists.txt拷贝到t2目录中。

2、添加子目录src:

mkdir src mv main.c src

现在的工程看起来是这个样子:一个子目录src,一个CMakeLists.txt。

上一节我们提到,需要为任何子目录建立一个CMakeLists.txt,进入子目录src,编写CMakeLists.txt如下:

ADD_EXECUTABLE(hello main.c)

将t2工程的CMakeLists.txt修改为:

PROJECT(HELLO)ADD_SUBDIRECTORY(srcbin)

然后建立build目录,进入build目录进行外部编译。

cmake..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 ${PROJECT_BINARY_DIR}/bin)
SET(LIBRARY_OUTPUT_PATH ${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了。

4、如何安装

安装的需要有两种,一种是从代码编译后直接make install安装,一种是打包时的指定目录安装。所以,即使最简单的手工编写的Makefile,看起来也是这个样子的:

DESTDIR=install:mkdir-p $(DESTDIR)/usr/bininstall-m755hello $(DESTDIR)/usr/bin

你可以通过:

make install

将hello直接安装到/usr/bin目录,也可以通过make install DESTDIR=/tmp/test将他安装在/tmp/test/usr/bin目录,打包时这个方式经常被使用。

稍微复杂一点的是还需要定义PREFIX,一般autotools工程,会运行这样的指令:

./configure –prefix=/usr 或者 ./configure --prefix=/usr/local 来指定PREFIX.比如上面的Makefile就可以改写成:

DESTDIR=PREFIX=/usr install:mkdir-p $(DESTDIR)/$(PREFIX)/bininstall-m755hello $(DESTDIR)/$(PREFIX)/bin

那么我们的HelloWorld应该怎么进行安装呢?

这里需要引入一个新的cmake 指令 INSTALL和一个非常有用的变量
CMAKE_INSTALL_PREFIX
CMAKE_INSTALL_PREFIX变量类似于configure脚本的 –prefix,常见的使用方法看起来是这个样子:

cmake-DCMAKE_INSTALL_PREFIX=/usr.

INSTALL指令用于定义安装规则,安装的内容可以包括目标二进制、动态库、静态库以及文件、目录、脚本等。
INSTALL指令包含了各种安装类型,我们需要一个个分开解释:
目标文件的安装:

INSTALL(TARGETS targets...[[ARCHIVE|LIBRARY|RUNTIME][DESTINATION<dir>][PERMISSIONS permissions...][CONFIGURATIONS[Debug|Release|...]][COMPONENT<component>][OPTIONAL]][...])

参数中的TARGETS后面跟的就是我们通过ADD_EXECUTABLE或者ADD_LIBRARY定义的目标文件,可能是可执行二进制、动态库、静态库。目标类型也就相对应的有三种,ARCHIVE特指静态库,LIBRARY特指动态库,RUNTIME特指可执行目标二进制。

DESTINATION定义了安装的路径,如果路径以/开头,那么指的是绝对路径,这时候CMAKE_INSTALL_PREFIX其实就无效了。如果你希望使用CMAKE_INSTALL_PREFIX来定义安装路径,就要写成相对路径,即不要以/开头,那么安装后的路径就是

${CMAKE_INSTALL_PREFIX}/<DESTINATION定义的路径>

未完待续。。。O(∩_∩)O

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询