使用CMake构建项目的简明示例（1）

1.  构建一个单独的项目

 

这个项目将生成可执行文件，动态和静态库。

 

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

workspace

        |—— HelloWorld

                            |—— CMakeLists.txt

                            |—— include     Hello.h

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

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

 

（1） HelloWorld根目录下的CMakeLists.txt

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

 

（2）Hello.h

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

(3) Hello.cpp

#include <iostream> #include "Hello.h" void Hello::sayHello() { std::cout << "Hello CMake!" << std::endl; }

(4) test.cpp

#include "Hello.h" int main(int arg, char** argv) { Hello h; h.sayHello(); }

(5) src 下的CMakeLists.txt

# 添加头文件的查找目录 INCLUDE_DIRECTORIES(${PROJECT_SOURCE_DIR}/include) ## 生成各种目标(target)文件: 可执行文件、动态库、静态库 # 指定可执行文件的输出目录，输出到bin下面 SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin) # 指定可执行文件名(hello)和相关源文件 ADD_EXECUTABLE(hello test.cpp Hello.cpp) # 指定库文件输出路径 SET(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib) # 生成动态库 # 注意，前面已经使用target文件名hello，这里不能再用。 ADD_LIBRARY(hello_so SHARED Hello.cpp) # 设置库输出名为 hello => libhello.so SET_TARGET_PROPERTIES(hello_so PROPERTIES OUTPUT_NAME "hello") # 生成静态库 # 注意，前面已经使用target文件名hello，这里不能再用。 ADD_LIBRARY(hello_a STATIC Hello.cpp) # 设置输库出名为 hello => libhello.a SET_TARGET_PROPERTIES(hello_a PROPERTIES OUTPUT_NAME "hello")

 

 

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

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

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

 

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

cmake .. make

 

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

 

 

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

 

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

 

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

 

workspace

       |—— HelloWorld

       |—— Test

                     |—— CMakeLists.txt

                     |—— src        main.cpp CMakeLists.txt

                     |—— build

 

（1）Test目录下的CMakeLists.txt

cmake_minimum_required(VERSION 2.8) PROJECT(TEST) ADD_SUBDIRECTORY(src)

(2) main.cpp

#include "Hello.h" int main(int arg, char** argv) { Hello h; h.sayHello(); }

(3) src下的CMakeLists.txt

# 显示系统的HOME环境变量的值 MESSAGE(STATUS $ENV{HOME}) # 指定头文件查找目录 # 注意，这里指定绝对路径。 INCLUDE_DIRECTORIES($ENV{HOME}/workspace/HelloWorld/include) # 指定库文件查找目录（不能只指定头文件，也需要连接到库文件） # 注意，这里指定绝对路径, 也可通过设置系统环境变量LD_LIBRARY_PATH来指定。 LINK_DIRECTORIES($ENV{HOME}/workspace/HelloWorld/lib) # 生成可执行文件到项目的bin目录 SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin) ADD_EXECUTABLE(main main.cpp) # 制定链接的外部Lib TARGET_LINK_LIBRARIES(main libhello.a)

 

最后，进入build目录执行:

cmake .. make

 

到bin目录下测试可执行文件:

$ ./main $ Hello CMake!

 

注：转载请注明出处。