linux-CMake
- 1.安装CMake工具
- 2.单个源文件
- 3.多个源文件
- 4.生成库文件
- 5.将源文件组织到不同的目录下
- 6.可执行文件和库文件放置到单独的目录下
- 7.常见的命令
CMake使用。
1.安装CMake工具
sudo apt-get install cmake
2.单个源文件
1.先在文件夹里创建两个文件:main.c,CMakeLists.txt。
2.在main.c文件里加入一段程序。
#include <stdio.h>
int main()
{
printf("Hello World!\n");
return 0;
}
3.在CMakeLists.txt文件里加入命令。
project(hello)
add_executable(hello ./main.c)
这两句的意思是:project(工程名称)设置工程的名称
add_executable(可执行文字名称,源代码) 设置生成的可执行文件的名字和要连接的源文件。
4.执行cmke命令
5.执行make命令
此时可以看到一个可执行文件hello生成
6.执行一下看是否和源文件一样
结果输出一样。
7.使用 out-of-source 方式构建
这时会发现目录比较杂乱,当我们需要清理 cmake 产生的文件时将变得非常麻烦。此时可以将构建过程生成的文件与源文件分离开来。
将cmake编译生成的文件全部清零下,只保留最开始的两个文件。然后在工程目录下创建一个build的目录,
这样 cmake 生成的中间文件以及 make 编译生成的可执行文件就全部在 build 目录下了,如果要清理工程,直接删除 build 目录即可,这样就方便多了。
3.多个源文件
1.创建三个文件hello.h hello.c main.c我们在main.c里调用hello.c里的函数
2.在这三个文件里填写以下函数
//hello.h
#ifndef __TEST_HELLO_
#define __TEST_HELLO_
void hello(const char *name);
#endif //__TEST_HELLO_
//hellow.c
#include <stdio.h>
#include "hello.h"
void hello(const char *name)
{
printf("Hello %s!\n", name);
}
//main.c
#include "hello.h"
int main(void)
{
hello("World");
return 0;
}
3.填写CMakeLists.txt
project(HELLO)
set(SRC_LIST main.c hello.c)
add_executable(hello ${SRC_LIST})
第一句同样是 设置工程名称。
第二句 设置了一个SRC_LIST 的变量,该变量是一个源文件列表,记录了生成可执行文件hello需要的源文件main.c hello.c。
第三句 设置可执行文件的名称和所用的源文件。
同样也可以直接写在add_executable里
add_executable(hello main.c hello.c)
4.生成库文件
除了生成可执行文件 hello 之外,我们还需要将 hello.c 编译为静态库文件或者动态库文件。在上一个的基础上对 CMakeLists.txt 文件进行修改,如下所示:
project(HELLO)
add_library(libhello hello.c)
add_executable(hello main.c)
target_link_libraries(hello libhello)
新加了两条新的语句:add_library(libhello hello.c) 意思是把hello.c文件编译为静态库。第一个参数为库文件的名字(不用加前缀和后缀),第二个位所有的源文件。静态库的前缀是lib,后缀为.a。动态库的后缀是.so。(add_library(libhello SHARED hello.c) 链接为动态库)
target_link_libraries(hello libhello) 意思是目标指定依赖库。将其链接进hello程序。
生成了liblibhello.a静态库,你会发现这个名字和我们填的libhello不一样还十分的不好看。造成这个情况的原因是,add_library()会自动的添加静态库的前缀lib。那如果将我们填写的libhello改成hello是不是就可以了。实际是不可以的因为hello我们在下面生成可执行文件使用的也是这个名称,两者不能一样。那该怎么更改名字,可以使用下面这个命令来。
set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello")
cmake_minimum_required(VERSION 3.5)
project(HELLO)
add_library(libhello hello.c)
set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello")
add_executable(hello main.c)
target_link_libraries(hello libhello)
除了添加 set_target_properties 命令之外,我们还加入了 cmake_minimum_required 命令,该命令用于设置当前工程的 cmake 最低版本号要求,当然这个并不是强制性的,但是最好还是加上。
这时生成的静态库就是我们想要的libhello.a了。
5.将源文件组织到不同的目录下
1.先将工程整理一下。
2.编写最外面的CMakeLists.txt文件
cmake_minimum_required(VERSION 3.5)
project(HELLO)
add_subdirectory(libhello)
add_subdirectory(src)
add_subdirectory()用来告诉cmke去子目录libhello,src中寻找新的CMakeLists.txt文件来解析它;
3.编写src 目录下的 CMakeLists.tx文件
include_directories(${PROJECT_SOURCE_DIR}/libhello)
add_executable(hello main.c)
target_link_libraries(hello libhello)
include_directories()用来指明头文件所在的路径,并且使用到了 PROJECT_SOURCE_DIR 变量,该变量指向了一个路径,从命名上可知,该变量表示工程源码的目录。
4.编写libhello目录下的CMakeLists.txt文件
add_library(libhello hello.c)
set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello")
5.最后到build文件里构建,编译,最终会得到可执行文件 hello(build/src/hello)和库文件 libhello.a(build/libhello/libhello.a)
6.可执行文件和库文件放置到单独的目录下
1.将 src 目录下的 CMakeList.txt 文件进行修改
include_directories(${PROJECT_SOURCE_DIR}/libhello)
add_executable(hello main.c)
target_link_libraries(hello libhello)
EXECUTABLE_OUTPUT_PATH 变量控制可执行文件的输出路径
2.然后再对 libhello 目录下的 CMakeList.txt 文件进行修改
set(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)
add_library(libhello hello.c)
set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello")
LIBRARY_OUTPUT_PATH 变量控制库文件的输出路径
7.常见的命令
command | 说明 |
---|---|
add_executable | 可执行程序目标 |
add_library | 库文件目标 |
add_subdirectory | 去指定目录中寻找新的 CMakeLists.txt 文件 |
aux_source_directory | 收集目录中的文件名并赋值给变量 |
cmake_minimum_required | 设置 cmake 的最低版本号要求 |
get_target_property | 获取目标的属性 |
include_directories | 设置所有目标需要链接的库 |
list | 列表相关的操作件 |
message | 用于打印、输出信息 |
project | 设置工程名字 |
set | 设置变量 |
set_target_properties | 设置目标属性 |
target_include_directories | 设置指定目标头文件的搜索路径 |
target_link_libraries | 设置指定目标库文件的搜索路径 |
target_sources | 设置指定目标所需的源文件 |