网站建设工作室小俊哥,横栏建设网站,广州一网通办注册公司流程,哪里培训网站开发好编译工具#xff1a;CMake#xff08;三#xff09;| 最简单的实例升级 前言过程语法解释ADD_SUBDIRECTORY 指令 如何安装目标文件的安装普通文件的安装#xff1a;非目标文件的可执行程序安装(比如脚本之类)目录的安装 修改 Helloworld 支持安装测试 前言
本篇博客的任务… 编译工具CMake三| 最简单的实例升级 前言过程语法解释ADD_SUBDIRECTORY 指令 如何安装目标文件的安装普通文件的安装非目标文件的可执行程序安装(比如脚本之类)目录的安装 修改 Helloworld 支持安装测试 前言
本篇博客的任务是让前面的 Hello World 更像一个工程我们需要作的是
为工程添加一个子目录 src用来放置工程源代码;添加一个子目录 doc用来放置这个工程的文档 hello.txt在工程目录添加文本文件 COPYRIGHT, README在工程目录添加一个 runhello.sh 脚本用来调用 hello 二进制将构建后的目标文件放入构建目录的 bin 子目录最终安装这些文件将 hello 二进制与 runhello.sh 安装至/usr/bin将 doc 目录的内容以及 COPYRIGHT/README 安装到/usr/share/doc/cmake/test2
过程
在/Compilation_tool/cmake/目录下建立 test2 目录。 将 test1 工程的 main.c 和 CMakeLists.txt 拷贝到 test2 目录中。
添加子目录 src 将main.c文件移动到src文件夹
mkdir src
mv main.c src现在的工程是这个样子 一个子目录 src一个 CMakeLists.txt。 CMake要求为任何子目录建立一个CMakeLists.txt
所以进入src子目录编写CMakeLists.txt如下
ADD_EXECUTABLE(hello main.c)将test2工程的CMakeLists.txt修改为
PROJECT(HELLO)
ADD_SUBDIRECTORY(src bin)然后建立 build 目录进入 build 目录进行外部编译。
mkdir build
cd 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 目录。
换个地方保存目标二进制 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)projectname_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 了。
如何安装
安装的需要有两种一种是从代码编译后直接 make install 安装一种是打包时的指定目录安装。
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 定义的路径举个简单的例子
INSTALL(TARGETS myrun mylib mystaticlibRUNTIME DESTINATION binLIBRARY DESTINATION libARCHIVE DESTINATION libstatic)上面的例子会将 可执行二进制 myrun 安装到${CMAKE_INSTALL_PREFIX}/bin 目录 动态库 libmylib 安装到${CMAKE_INSTALL_PREFIX}/lib 目录 静态库 libmystaticlib 安装到${CMAKE_INSTALL_PREFIX}/libstatic 目录
特别注意的是不需要关心 TARGETS 具体生成的路径只需要写上 TARGETS 名称就可以了。
普通文件的安装
INSTALL(FILES files... DESTINATION dir[PERMISSIONS permissions...][CONFIGURATIONS [Debug|Release|...]][COMPONENT component][RENAME name] [OPTIONAL])可用于安装一般文件并可以指定访问权限文件名是此指令所在路径下的相对路径。如果默认不定义权限 PERMISSIONS安装后的权限为OWNER_WRITE, OWNER_READ,GROUP_READ,和 WORLD_READ即 644 权限。
非目标文件的可执行程序安装(比如脚本之类)
INSTALL(PROGRAMS files... DESTINATION dir
[PERMISSIONS permissions...]
[CONFIGURATIONS [Debug|Release|...]]
[COMPONENT component]
[RENAME name] [OPTIONAL])跟上面的 FILES 指令使用方法一样唯一的不同是安装后权限为: OWNER_EXECUTE, GROUP_EXECUTE, 和 WORLD_EXECUTE即 755 权限
目录的安装
INSTALL(DIRECTORY dirs... DESTINATION dir[FILE_PERMISSIONS permissions...][DIRECTORY_PERMISSIONS permissions...][USE_SOURCE_PERMISSIONS][CONFIGURATIONS [Debug|Release|...]][COMPONENT component][[PATTERN pattern | REGEX regex][EXCLUDE] [PERMISSIONS permissions...]] [...])这里主要介绍其中的 DIRECTORY、PATTERN 以及PERMISSIONS参数。 DIRECTORY 后面连接的是所在 Source 目录的相对路径但务必注意 abc 和 abc/有很大的区别。如果目录名不以/结尾那么这个目录将被安装为目标路径下的 abc如果目录名以/结尾 代表将这个目录中的内容安装到目标路径但不包括这个目录本身。PATTERN用于使用正则表达式进行过滤PERMISSIONS 用于指定 PATTERN 过滤后的文件权限。
修改 Helloworld 支持安装
添加 doc 目录及文件:
cd /Compilation_tool/cmake/test2
mkdir doc
vi doc/hello.txt随便填写一些内容并保存
在工程目录添加 runhello.sh 脚本内容为
hello添加工程目录中的 COPYRIGHT 和 README touch COPYRIGHT touch README
下面改写各目录的 CMakeLists.txt 文件。
1、安装 COPYRIGHT/README直接修改主工程文件 CMakelists.txt加入以下指令
INSTALL(FILES COPYRIGHT README DESTINATION share/doc/cmake/t2)2、安装 runhello.sh直接修改主工程文件 CMakeLists.txt加入如下指令
INSTALL(PROGRAMS runhello.sh DESTINATION bin)3、安装 doc 中的 hello.txt 因为 hello.txt 要安装到//share/doc/cmake/t2所以我们不能直接安装整个 doc 目录这里采用的方式是安装 doc 目录中的内容也就是使用 ” doc/” 在工程文件中添加
INSTALL(DIRECTORY doc/ DESTINATION share/doc/cmake/t2)测试
现在进入 build 目录进行外部编译注意使用 CMAKE_INSTALL_PREFIX 参数这里我们将它安装到了/tmp/t2 目录
cmake -DCMAKE_INSTALL_PREFIX/tmp/t2/usr ..然后运行
make
make install这时候在计算机的 tmp路径下就多了 t2 文件夹 t2的目录为
如果你要直接安装到系统可以使用如下指令
cmake -DCMAKE_INSTALL_PREFIX/usr ..如果没有定义CMAKE_INSTALL_PREFIX会安装到什么地方 CMAKE_INSTALL_PREFIX 的默认定义是/usr/local
