linux下cmake基础操作

参考链接：手把手教你写cmake

1、查看某个.c文件

cat 文件目录下文件名

2、运行代码

g++ a.cpp - o a  //a为自定义文件名，生成可执行文件a
g++ a.cpp //只编译，不生成可执行文件

3、当前目录下执行

./a

4、删除生成的可执行文件

rm a

5、指定版本：

g++ -std=c++17 a.cpp -o a

6、-g 编译带调试信息的可执行文件

g++ -g a.cpp -o a

7、-O 优化源代码

//-O 告诉g++对源代码进行基本优化。这些优化大多使程序执行的更快
-O1 同时产生尽可能小和尽可能快的代码
-O0 表示不优化
-O2 除了完成-O1之外，还进行一些额外的调整工作，如指令调整等。（一般常使用这个）
-O3 包括循环展开和其他一些与处理特征相关的优化工作.

g++ -O2 a.cpp // 使用-O2优化源代码，并输出可执行文件

8、跨文件直接编译（main函数中要调用swap函数，swap.h和swap.cpp分别在两个不同的文件夹下） 

        

//如果swap.cpp和swap.h在同一个文件目录下 ：
g++ main.cpp swap所在的文件名/swap.cpp -o main
比如这里：g++ main.cpp src/swap.cpp -o main

//如果swap.cpp和swap.h不在同一个文件目录下 ：
g++ main.cpp swap所在文件名/wap.cpp -I头文件所在文件名 -o main
比如这里：g++ main.cpp src/swap.cpp -Iinclude -o main

9、生成库文件并编译

链接静态库生成可执行文件：

#1、进入swap.cpp所在文件目录下，这里是src
cd src(这个是目录名字)
#2、汇编，生成swap.o文件
g++ swap.cpp(这个是文件名字) -c -I (include所在目录)/include
#3、生成静态库libswap.a
ar rs libswap.a(这个是生成的静态库名字) swap.o(由.o文件生成.a文件)  //静态库文件以.a结尾

#4、返回上级目录
cd..
#5、链接，生成可执行文件：staticmain
g++ main.cpp -Iinclude(include是.h文件所在目录) -Lsrc -lswap -o staticmain

#6、运行可执行文件
./staticmain

链接动态库生成可执行文件：

1#进入src目录下
cd src

2#生成动态库libswap.so
g++ swap.cpp -I ../include -fPIC -shared -o libswap.so  //-shared代表生成动态文件,动态文件扩展名.so

3#回到上级目录
cd..

4#链接，生成可执行文件：sharemain
g++ main.cpp -Iinclude -Lsrc -lswap -o sharemain

5#运行动态库可执行文件
LD_LIBRARY_PATH=src ./sharemain   //指定搜索范围在src文件内，src可以换成自己的动态文件所在位置

10、GDB调试器 

常用调试命令参数：

Tips:

1. 编译程序时需要加上-g，之后才能用gdb进行调试：gcc -g main.c -o main

2. 回车键：重复上一命令

调试开始：执行gdb exefilename 进入gdb调试程序，其中exefilename为要调试的可执行文件名
退出调试：quit
#一下命令括号内为简化使用，如run（r），直接输入r就代表着命令run
help(h) //查看命令帮助
run(r)  //重新开始运行文件（run-text：加载文本文件，run-bin：加载二进制文件）
start   //单步执行，运行程序，停在第一行执行语句
list(l) //查看源代码(list-n,从第n行开始查看代码，list+函数名：查看具体函数)
set     //设置变量的值
next(n) //单步调试(逐过程，函数直接执行)
step(s) //单步调试(逐语句：跳入自定义函数内部执行)
backtrace(bt)//查看函数的调用的栈帧和层级关系
frame(f)//切换函数的栈帧
info(i) //查看函数内部局部变量的数值
finish  //结束当前函数，返回函数的调用点
continue(c)    # 继续运行
print(p)       # 打印值及地址
quit(q)        # 退出gdb
break+num(b)   # 在第num行设置断点
info breakpoints(i b)    # 查看当前设置的所有断点
delete breakpoints num(d b 数字)     # 删除第num个断点
display i                     # 追踪查看具体变量i的值值
undisplay                    # 取消追踪观察变量
watch                        # 被设置观察点的变量发生修改时，打印显示
i watch                      # 显示观察点
enable breakpoints           # 启用断点
disable breakpoints          # 禁用断点
run argv[1] argv[2]          # 调试时命令行传参
set follow-fork-mode child   # Makefile项目管理：选择跟踪父子进程（fork()）

11、cmake语法特性及指令

基本语法格式：指令（参数1 参数2....）

注意：参数使用括号括起；指令是大小写无关的，参数和变量是大小写相关的

例如：

set(HELLO hello.cpp) //指令是set，变量是HELLO,变量的参数是hello.cpp
add_executable(hello main.cpp hello.cpp)
ADD_EXECUTABLE(hello main.cpp ${HELLo})
//这里的add_executable和ADD_EXECUTABLE两种写法都适用${HELLO}等价与hello.cpp

变量使用${}方式取值，但是在IF控制语句中，直接使用变量名字。

重要指令：

1、cmake_minimum_required - 指定CMake的最小版本要求

• 语法：cmake_minimum_required(VERSION versionNumber [FATAL_ERROR])

# CMake最小版本要求为2.8.3
cmake_minimum_required(VERSION 2.8.3)

2、project - 定义工程名称，并可指定工程支持的语言

• 语法：project(projectname [CXX] [C] [Java])

  # 指定工程名为HELLOWORLD
  project(HELLOWORLD)

3、 set - 显式的定义变量  

• 语法：set(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])

  # 定义SRC变量，其值为main.cpp hello.cpp
  set(SRC main.cpp hello.cpp)

4、include_directories - 向工程添加多个特定的头文件搜索路径  --->相当于指定g++编译器的-I参数

• 语法：include_directories([AFTER|BEFORE] [SYSTEM] dir1 dir2 …)

# 将/usr/include/myincludefolder 和 ./include 添加到头文件搜索路径
include_directories(/usr/include/myincludefolder ./include)

5、link_directories - 向工程添加多个特定的库文件搜索路径  --->相当于指定g++编译器的-L参数

• 语法：link_directories(dir1 dir2 …)  

  # 将/usr/lib/mylibfolder 和 ./lib 添加到库文件搜索路径
  link_directories(/usr/lib/mylibfolder ./lib)

6、 add_library - 生成库文件

• 语法：add_library(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL] source1 source2 … sourceN)  //SHARED表示动态库，STATIC表示静态库

  # 通过变量 SRC 生成 libhello.so 共享库
  add_library(hello SHARED ${SRC}) //库的名字是hello

7、 add_compile_options - 添加编译参数

• 语法：add_compile_options(<option>...)

  # 添加编译参数 -Wall -std=c++11
  add_compile_options(-Wall -std=c++11 -O2)//-wall表示输出所有警告信息，-O2表示代码优化

8、 add_executable - 生成可执行文件

• 语法：add_library(exename source1 source2 … sourceN)

  # 编译main.cpp生成可执行文件main
  add_executable(main main.cpp)

9、 target_link_libraries - 为 target 添加需要链接的共享库  --->相同于指定g++编译器-l参数

• 语法：target_link_libraries(target library1library2…)

  # 将hello动态库文件链接到可执行文件main
  target_link_libraries(main hello)

10、add_subdirectory - 向当前工程添加存放源文件的子目录，并可以指定中间二进制和目标二进制存放的位置

• 语法：add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])

  # 添加src子目录，前提：确保src中有一个CMakeLists.txt
  add_subdirectory(src)

11、aux_source_directory - 发现一个目录下所有的源代码文件并将列表存储在一个变量中，这个指令临时被用来自动构建源文件列表

• 语法：aux_source_directory(dir VARIABLE)

• # 定义SRC变量，其值为当前目录下所有的源代码文件
  aux_source_directory(. SRC) //.代表当前目录
  # 编译SRC变量所代表的源代码文件，生成main可执行文件
  add_executable(main ${SRC})

重要变量 ：

1、CMAKE_C_FLAGS   gcc编译选项

CMAKE_CXX_FLAGS  g++编译选项

# 在CMAKE_CXX_FLAGS编译选项后追加-std=c++11

set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")

2、CMAKE_BUILD_TYPE  编译类型(Debug, Release)

# 设定编译类型为debug，调试时需要选择debug
set(CMAKE_BUILD_TYPE Debug) 
# 设定编译类型为release，发布时需要选择release
set(CMAKE_BUILD_TYPE Release) 

3、 

• CMAKE_BINARY_DIR

  PROJECT_BINARY_DIR

  <projectname>__BINARY_DIR

  1. 这三个变量指代的内容是一致的。

  2. 如果是 in source build，指的就是工程顶层目录。

  3. 如果是 out-of-source 编译,指的是工程编译发生的目录。

  4. PROJECT_BINARY_DIR 跟其他指令稍有区别，不过现在，你可以理解为他们是一致的。

• 4、CMAKE_SOURCE_DIR

  PROJECT_SOURCE_DIR
  <projectname>__SOURCE_DIR

1. 这三个变量指代的内容是一致的,不论采用何种编译方式,都是工程顶层目录。

2. 也就是在 in source build时,他跟 CMAKE_BINARY_DIR 等变量一致。

3. PROJECT_SOURCE_DIR 跟其他指令稍有区别,现在,你可以理解为他们是一致的。

 5、

• CMAKE_C_COMPILER：指定C编译器

• CMAKE_CXX_COMPILER：指定C++编译器

• EXECUTABLE_OUTPUT_PATH：可执行文件输出的存放路径

• LIBRARY_OUTPUT_PATH：库文件输出的存放路径

 编译流程：

CMake目录结构：项目主目录存在一个CMakeLists.txt文件

两种方式设置编译规则：

1. 包含源文件的子文件夹包含CMakeLists.txt文件，主目录的CMakeLists.txt通过add_subdirectory添加子目录即可；

2. 包含源文件的子文件夹未包含CMakeLists.txt文件，子目录编译规则体现在主目录的CMakeLists.txt中；

在 linux 平台下使用 CMake 构建C/C++工程的流程如下:

• 手动编写 CmakeLists.txt。

• 执行命令 cmake PATH生成 Makefile ( PATH 是顶层CMakeLists.txt 所在的目录 )。

• 执行命令make 进行编译。

• # important tips
  .          # 表示当前目录
  ./         # 表示当前目录
  
  ..      # 表示上级目录
  ../     # 表示上级目录

  两种构建方式

• 内部构建(in-source build)：不推荐使用

  内部构建会在同级目录下产生一大堆中间文件，这些中间文件并不是我们最终所需要的，和工程源文件放在一起会显得杂乱无章。

• ## 内部构建
  
  # 在当前目录下，编译本目录的CMakeLists.txt，生成Makefile和其他文件
  4cmake .
  # 执行make命令，生成target
  make

  外部构建(out-of-source build)：==推荐使用==

  将编译输出文件与源文件放到不同目录中

• ## 外部构建
   
   # 1. 在当前目录下，创建build文件夹
   mkdir build 
   # 2. 进入到build文件夹
   cd build
   # 3. 编译上级目录的CMakeLists.txt，生成Makefile和其他文件
   cmake ..
   # 4. 执行make命令，生成target
  make

  构建CMakelists.txt总体语句如下：

• cmake_minimum_required(VERSION 3.0)
  
  project(MYEXE)
  
  //set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -O2 -std=c++11")#添加一些c++编译方式
  set(CMAKE_BUILD_TYPE Debug)#添加可以debug的cmake文件
  
  include_directories(${CMAKE_SOURCE_DIR}/include)//${CMAKE_SOURCE_DIR}表示当前CMakeList.txt所在的路径
  
  add_executable(myexe_cmake main.cpp src/Gun.cpp src/Solider.cpp)

  目录结构如下：

• 

  

   

  set(ALG_NET_POSTPROCESSING src/alg_net_postprocessing_od.cpp)
  
  include_directories(./include)
  include_directories(./src)
  
  add_library(alg_net_postprocessing SHARED ${ALG_NET_POSTPROCESSING})
  
  target_include_directories(alg_net_postprocessing PUBLIC ./include)
  
  这段CMake代码的作用是：
  
  设置变量ALG_NET_POSTPROCESSING为src/alg_net_postprocessing_od.cpp，即算法网络后处理源文件的路径。
  使用include_directories函数添加./include和./src目录到头文件搜索路径中。
  使用add_library函数创建名为alg_net_postprocessing的动态链接库（Shared Library），其中${ALG_NET_POSTPROCESSING}表示源文件列表。
  使用target_include_directories函数为alg_net_postprocessing库添加./include目录到其公共头文件搜索路径中。