一个简单的CMake工程示例

ゝ一世哀愁。 2022-06-15 12:11 369阅读 0赞

在工程目录下，构建目录src,include,lib,bin。在src目录下存放源代码文件，include目录下存放头文件，lib目录用于存放生成的库（动态库或者静态库），bin目录存放最终生成的可执行文件。

src目录存放main.cpp和lib\_demo.cpp的源文件：

main.cpp

#include <iostream>
    #include "main.h"
    #include "lib_demo.h"
    
    using namespace std;
    
    int main()
    {
    	print_project_msg();
    
    	lib_demo();
    
    	return 0;
    }
    
    void print_project_msg()
    {
    	cout << "################ CMake Project Demo ################" << endl;
    }

lib\_demo.cpp

#include <iostream>
    #include "lib_demo.h"
    
    using namespace std;
    
    void lib_demo()
    {
    	cout << "lib demo ..." << endl;
    }

include 目录下的头文件为：

main.h

#ifndef __MAIN_H__
    #define __MAIN_H__
    
    
    void print_project_msg();
    
    
    
    #endif /*__MAIN_H__*/

lib\_demo.h

#ifndef __lib_demo__
    #define __lib_demo__
    
    void lib_demo();
    
    #endif /*__lib_demo__*/

在工程的根目录和src目录下各有有一个CMakeLists.txt文件：

工程根目录CMakeLists.txt

#CMake最低版本号要求
    cmake_minimum_required(VERSION 2.8)
    
    #指定项目名称
    project(CMakeDemo)
    
    #指定版本信息
    set(CMAKE_SYSTEM_VERSION 1)
    
    #若是需要指定编译器路径
    #set(CROSS_TOOLCHAIN_PREFIX "/path/arm-linux-")
    #指定编译器
    #set(CMAKE_C_COMPILER   "${CROSS_TOOLCHAIN_PREFIX}gcc")
    #set(CMAKE_CXX_COMPILER "${CROSS_TOOLCHAIN_PREFIX}g++")
    
    #使用默认路径的g++指定编译器  
    set(CMAKE_CXX_COMPILER "g++") 
    
    #指定编译选项
    set(CMAKE_BUILD_TYPE Debug )
    
    #指定编译目录
    set(PROJECT_BINARY_DIR ${PROJECT_SOURCE_DIR}/build)
    
    #添加子目录,这样进入源码文件src目录可以继续构建  
    add_subdirectory(${PROJECT_SOURCE_DIR}/src)

src目录下的CMakeLists.txt:

#查找当前目录下的所有源文件，
    #并将名称保存到DIR_LIB_SRCS目录
    #aux_source_directory(. DIR_LIB_SRCS)
    
    #指定头文件目录,PROJECT_SOURCE_DIR为工程的根目录  
    include_directories(${PROJECT_SOURCE_DIR}/include)
    
    #指定可执行文件的输出目录，输出到bin下面  
    set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
    
    #生成动态库    
    add_library(shared_demo SHARED lib_demo.cpp)
    #设置库输出名为 shared => libshared.so  
    set_target_properties(shared_demo PROPERTIES OUTPUT_NAME "shared") 
     
    #生成静态库  
    add_library(static_demo STATIC lib_demo.cpp)  
    #设置输库出名为 static => libstatic.a  
    set_target_properties(static_demo PROPERTIES OUTPUT_NAME "static") 
    
    #指定库文件输出路径  
    set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)
    
    #在指定目录下查找库，并保存在LIBPATH变量中
    find_library(LIBPATHS  shared ${PROJECT_SOURCE_DIR}/lib)  
    
    #指定生成目标
    add_executable(main main.cpp)
    
    #链接共享库
    target_link_libraries(main ${LIBPATHS})

整个工程的目录文件架构如下：

![Center][]

在项目根目录新建目录build,进入build，执行cmake ..命令，若没有错误，在执行make命令。

在bin目录下产生可执行文件，lib中生成库文件。

另外：

AUX\_SOURCE\_DIRECTORY(directory VAR)

将指定的directory目录下的所有源文件保存到VAR变量中，

例如：AUX\_SOURCE\_DIRECTORY(src SRC\_CPP)将src目录下的源文件保存到SRC\_CPP目录中。

[Center]: /images/20220615/c3f64a97ceb94057a062f03e8309d897.png