cmake cpp构造项目

Posted 2022-12-01 同皆无穷小

1.需求

[1].使用第三方动/静太库

[2].本身代码部分编译为动/静态库

[3]多项目管理

2.构建一个单独的项目

[1]目的：这个项目将生成可执行文件，动态和静态库。

先在workspace(or anywhere you like)下建立项目的目录(文件)结构:

workspace

        |—— HelloWorld

                            |—— CMakeLists.txt

                            |—— include     Hello.h

                            |—— src             Hello.cpp, test.cpp, CMakeLists.txt

                            |—— build          （CMake外部构建时的使用的目录, 可任意指定）

 [2]HelloWorld根目录下的CMakeLists.txt

view plain

1. # 声明CMake的最低要求版本  
2. cmake_minimum_required(VERSION 2.8)  
3. # 定义项目(工程)名称,  
4. # 同时定义了以下默认变量:  
5. # PROJECT_SOURCE_DIR 或 HELLO_SOURCE_DIR, 代指CMake开始构建的根目录(通常是项目根目录)  
6. # PROJECT_BINARY_DIR 或 HELLO_BINARY_DIR, 代指CMake的编译目录(即执行cmake命令的目录)  
7. PROJECT(HELLO)  
8. # 添加参与编译的子目录  
9. ADD_SUBDIRECTORY(src)  

[3]Hello.h

• #ifndef HELLO_H  
• #define HELLO_H  
• class Hello  
•   
• public:  
•     Hello()  
•     void sayHello();  
• ;  
• #endif  
  

  [4]Hello.cpp

  1. #include <iostream>  
  2. #include "Hello.h"  
  3. void Hello::sayHello()  
  4.   
  5.     std::cout << "Hello CMake!" << std::endl;  
  6.  
  [5]test.cpp
  1. #include "Hello.h"  
  2. int main(int arg, char** argv)  
  3.   
  4.     Hello h;  
  5.     h.sayHello();  
  6.  
  [6]src 下的CMakeLists.txt
  
  1. # 添加头文件的查找目录  
  2. INCLUDE_DIRECTORIES($PROJECT_SOURCE_DIR/include)  
  3. ## 生成各种目标(target)文件: 可执行文件、动态库、静态库  
  4. # 指定可执行文件的输出目录，输出到bin下面  
  5. SET(EXECUTABLE_OUTPUT_PATH $PROJECT_SOURCE_DIR/bin)  
  6. # 指定可执行文件名(hello)和相关源文件   
  7. ADD_EXECUTABLE(hello test.cpp Hello.cpp)  
  8. # 指定库文件输出路径  
  9. SET(LIBRARY_OUTPUT_PATH $PROJECT_SOURCE_DIR/lib)  
  10. # 生成动态库  
  11. # 注意，前面已经使用target文件名hello，这里不能再用。  
  12. ADD_LIBRARY(hello_so SHARED Hello.cpp)  
  13. # 设置库输出名为 hello => libhello.so  
  14. SET_TARGET_PROPERTIES(hello_so PROPERTIES OUTPUT_NAME "hello")  
  15. # 生成静态库  
  16. # 注意，前面已经使用target文件名hello，这里不能再用。  
  17. ADD_LIBRARY(hello_a STATIC Hello.cpp)  
  18. # 设置输库出名为 hello => libhello.a  
  19. SET_TARGET_PROPERTIES(hello_a PROPERTIES OUTPUT_NAME "hello")  

  最后，进入build目录执行命令: cmake <项目根目录>

  如果执行cmake命令的目录与项目根目录相同，称为内部编译，这时CMake生成的中间文件会与项目代码混合，不推荐。

  否则，称为外部编译，所有中间文件会生成在执行cmake命令的目录下。

  cmake执行完后，会生成Makefile, 直接make， 会在项目下生成bin和lib目录及目标文件。

  view plain
  1. cmake ..  
  2. make  

   

  通常我们不需要生成所有类型的目标文件，构建时根据需要选择。

  3. 构建多个项目，使用外部项目提供的库文件。
  

  在前面的HelloWorld项目中，生成了lib文件，就可以通过头文件和lib文件发布给其他项目了。

  我们创建一个Test项目来使用HelloWorld的生成的库，如下:
  

  workspace

         |—— HelloWorld

         |—— Test

                       |—— CMakeLists.txt

                       |—— src        main.cpp CMakeLists.txt

                       |—— build

  （1）Test目录下的CMakeLists.txt

  view plain
  1. cmake_minimum_required(VERSION 2.8)  
  2. PROJECT(TEST)  
  3. ADD_SUBDIRECTORY(src)  

  2) main.cpp

  view plain
  1. #include "Hello.h"  
  2. int main(int arg, char** argv)  
  3.   
  4.     Hello h;  
  5. 链接 Yaml-cpp 和 Armadillo 共享库的 CMake 项目

     CMake - 静态 yaml-cpp 作为 git 子模块的链接器错误

     CMake - 链接器错误与静态yaml-cpp作为git子模块

     如何在没有 CMake 的情况下构建 yaml-cpp

     CMake/Ninja 试图编译已删除的“.cpp”文件

     在cmake的所有cpp文件中包含c ++标头[重复]