CMakeLists.txt 文件&范例

最新推荐文章于 2026-04-13 10:27:32 发布
转载 最新推荐文章于 2026-04-13 10:27:32 发布 · 778 阅读 · 1
本文详细介绍了如何通过CMakeLists.txt文件配置项目构建过程，包括项目目录结构、编译类型设置、源文件及库文件的添加等核心内容。
CMakeLists.txt 文件
 前的项目代码在src 目录。 src 下有子目录：server, utility, lib, bin, build

      server-----  存放项目的主功能类文件
      utility  -----  存放项目要用到相关库文件，便已成为库文件存放到子目录lib 中
      lib      -----  存放utility 生成的库
      bin     -----  存放association 生成的二进制文件
      build  -----  编译目录，存放编译生成的中间文件

 cmake 要求工程主目录和所有存放源代码子目录下都要编写CMakeLists.txt 文件，注意大小写（cm 大写，list中l 大写且落下s).

 src/CMakeLists.txt 文件如下：
      -------------------------------------------------------------------------------------------------------------
      #author:
      #created:
 
      CMAKE_MINIMUM_REQUIRED(VERSION 2.8)               #cmake 最低版本要求，低于2.6 构建过程会被终止。 
      PROJECT(server_project)                                             #定义工程名称
 
      MESSAGE(STATUS "Project: SERVER")                       #打印相关消息消息 
      MESSAGE(STATUS "Project Directory: ${PROJECT_SOURCE_DIR}")
 
      SET(CMAKE_BUILE_TYPE DEBUG)                             #指定编译类型
      SET(CMAKE_C_FLAGS_DEBUG "-g -Wall")                #指定编译器 
      ADD_SUBDIRECTORY(utility)                                      #添加子目录 
      ADD_SUBDIRECTORY(server)
    -------------------------------------------------------------------------------------------------------------

 相关解释：
      1. CMakeLists.txt 文件中不区分大小写
      2. PROJECT(project_name)    定义工程名称
          语法：project(projectname [cxx] [c] [java])
          可以指定工程采用的语言，选项分别表示：C++, C, java， 如不指定默认支持所有语言
      3. MESSAGE（STATUS, "Content")  打印相关消息
          输出消息，供调试CMakeLists.txt 文件使用。
      4. SET(CMAKE_BUILE_TYPE DEBUG)  设置编译类型debug 或者release。 debug 版会生成相关调试信息，可以使用GDB 进行 
          调试；release不会生成调试信息。当无法进行调试时查看此处是否设置为debug.
      5. SET(CMAKE_C_FLAGS_DEBUG "-g -Wall") 设置编译器的类型
          CMAKE_C_FLAGS_DEBUG            ----  C 编译器
          CMAKE_CXX_FLAGS_DEBUG        ----  C++ 编译器
       6. ADD_SUBDIRECTORY(utility) 添加要编译的子目录
           为工程主目录下的存放源代码的子目录使用该命令，各子目录出现的顺序随意。
       如上便是工程server_project 主目录src 下的CMakeLists.txt 文件，下一篇我们解释子目录utiltiy中的CMakeLists.txt 文件。


 子目录utility 下的CMakeLists.txt 文件如下：
--------------------------------------------------------------------------------------------------------------------
     #Cmake file for library utility.a
     #Author:  
     #Created: 

     SET(SOURCE_FILES                                  #设置变量，表示所有的源文件
             ConfigParser.cpp
             StrUtility.cpp
             )

     INCLUDE_DIRECTORIES(                          #相关头文件的目录
              /usr/local/include
              ${PROJET_SOURCE_DIR}/utility
     )

    LINK_DIRECTORIES(                                  #相关库文件的目录
             /usr/local/lib
    )

    ADD_LIBRARY(association ${SOURCE_FILES})           #生成静态链接库libassociation.a
    TARGET_LINK_LIBRARY(association core）                #依赖的库文件
    
    SET_TARGET_PROPERTIES(utility  PROPERTIES      #表示生成的执行文件所在路径
    RUNTIME_OUTPUT_DIRECTORY> "${PROJECT_SOURCE_DIR}/lib")

--------------------------------------------------------------------------------------------------------------------
    相关解释：
    1. SET(SOURCE_FILES .....)  
    表示要编译的源文件，所有的源文件都要罗列到此处。set 设置变量，变量名SOURCE_FILES自定义。
    2. INCLUDE_DIRECTORY(...)  
    include头文件时搜索的所有目录
    变量PROJECT_SOURCE_DIR 表示工程所在的路径，系统默认的变量
    3. LINK_DIRECTORIES(...)
     库文件存放的目录，在程序连接库文件的时候要再这些目录下寻找对应的库文件
    4. ADD_LIBRARY(...) 
     表示生成静态链接库libassociaiton.a，由${PROJECT_SOURCE_DIR}代表的文件生成。
     语法：ADD_LIBRARY(libname [SHARED|STATIC]
     SHARED 表示生成动态库， STATIC表示生成静态库。
    5. TARGET_LINK_LIBRARY(association core) 
     表示库association 依赖core库文件
     6. SET_TARGET_PROPERTIES
     设置编译的库文件存放的目录，还可用于其他属性的设置。如不指定，
     生成的执行文件在当前编译目录下的各子目录下的build目录下，好拗口！简单一点：
     如指定在： ./src/lib 下
     不指定在： ./src/build/utility/build 目录下
     生成的中间文件在./src/build/utilty/build 目录下，不受该命令额影响




     子目录server 下的CMakeLists.txt 文件：
    --------------------------------------------------------------------------------------------
     SET(SOURCE_FILES
             Gassociation.cpp
             ConfigurationHandler.cpp
     )

     INCLUDE_DIRECTORIES（
               /usr/local/include
              ${PROJECT_SOURCE_DIR}/utility
              ${PROJECT_SOURCE_DIR}/association
     )

     LINK_LIBRARIES(
                 /usr/local/lib
                 ${PROJECT_SOURCE_DIR}/lib
     )

     ADD_EXECUTABLE(server  ${SOURCE_FILES})

     TARGET_LINK_LIBRARIES(server
                                                 utility
     ）
     SET_TARGET_PROPERTIES(server  PROPERTIES    #表示生成的执行文件所在路径
     RUNTIME_OUTPUT_DIRECTORY  "${PROJECT_SOURCE_DIR}/bin")
     -------------------------------------------------------------------------------------------------------
     相关解释：
     1. ADD_EXECUTABLE()     #指定要生成的执行文件的名称server
        其他用法同utilty/CMakeLists.txt
     2. SET_TARGET_PROPERTIES
      设置生成的执行文件存放的路径，
      注意：
      执行文件server 依赖的子目录utility 子目录生成的静态库libutility.a,在指定的时候要写成：
      TARGET_LINK_LIBRARIES(server   utility）
      而不能写成：
      TARGET_LINK_LIBRARIES(server   libutility.a）
      否则编译总会提示找不到libutility库文件。
      但使用第三方的库却要指定成具体的库名，如：libACE-6.0.0.so
      这一点很诡异，暂时还没找到原因。

      完成对应的CMakeLists.txt 文件编写后，便可以进行编译了。
      编译：
            进入 ./src/build
            执行cmake ..
            make


Cmakelist范例
 SET(PROJECT_NAME Sophus)
 
PROJECT(${
PROJECT_NAME
})
CMAKE_MINIMUM_REQUIRED(VERSION 2.6)
 
SET (CMAKE_VERBOSE_MAKEFILE ON)
 
# Release by default
# Turn on Debug with "-DCMAKE_BUILD_TYPE=Debug"
IF( NOT CMAKE_BUILD_TYPE )
   SET( CMAKE_BUILD_TYPE Release )
ENDIF()
 
IF (CMAKE_COMPILER_IS_GNUCXX )
   SET(CMAKE_CXX_FLAGS_DEBUG  "-O0 -g")
   SET(CMAKE_CXX_FLAGS_RELEASE "-O3 -DNDEBUG ")
 
  ADD_DEFINITIONS("-Wall -Werror -Wno-unused-variable
                   -Wno-unused-but-set-variable -Wno-unknown-pragmas ")
ENDIF()
 
################################################################################
# Add local path for finding packages, set the local version first
set( CMAKE_MODULE_PATH "${
CMAKE_SOURCE_DIR
}/cmake_modules" )
list( APPEND CMAKE_MODULE_PATH "${
CMAKE_ROOT
}/Modules" )
 
################################################################################
# Create variables used for exporting in SophusConfig.cmake
set( Sophus_LIBRARIES "" )
set( Sophus_INCLUDE_DIR ${
PROJECT_SOURCE_DIR
} )
 
################################################################################
 
include(FindEigen3.cmake)
#find_package( Eigen3 REQUIRED )
INCLUDE_DIRECTORIES( ${
EIGEN3_INCLUDE_DIR
} )
SET( Sophus_INCLUDE_DIR ${
Sophus_INCLUDE_DIR
} ${
EIGEN3_INCLUDE_DIR
} )
 
SET (SOURCE_DIR "sophus")
 
SET (TEMPLATES tests
               so2
               se2
               so3
               se3
               rxso3
               sim3
)
 
SET (SOURCES ${
SOURCE_DIR
}/sophus.hpp)
 
FOREACH(templ ${
TEMPLATES
})
  LIST(APPEND SOURCES ${
SOURCE_DIR
}/${
templ
}.hpp)
ENDFOREACH(templ)
 
 
INCLUDE_DIRECTORIES(${
INCLUDE_DIRS
})
 
# Added ${
SOURCES
} to executables so they show up in QtCreator (and possibly
# other IDEs).
# ADD_EXECUTABLE(test_so2 sophus/test_so2.cpp ${
SOURCES
})
# ADD_EXECUTABLE(test_se2 sophus/test_se2.cpp ${
SOURCES
})
# ADD_EXECUTABLE(test_so3 sophus/test_so3.cpp ${
SOURCES
})
# ADD_EXECUTABLE(test_se3 sophus/test_se3.cpp ${
SOURCES
})
# ADD_EXECUTABLE(test_rxso3 sophus/test_rxso3.cpp ${
SOURCES
})
# ADD_EXECUTABLE(test_sim3 sophus/test_sim3.cpp ${
SOURCES
})
# ENABLE_TESTING()
#
# ADD_TEST(test_so2 test_so2)
# ADD_TEST(test_se2 test_se2)
# ADD_TEST(test_so3 test_so3)
# ADD_TEST(test_se3 test_se3)
# ADD_TEST(test_rxso3 test_rxso3)
# ADD_TEST(test_sim3 test_sim3)
 
################################################################################
# Create the SophusConfig.cmake file for other cmake projects.
CONFIGURE_FILE( ${
CMAKE_CURRENT_SOURCE_DIR
}/SophusConfig.cmake.in
    ${
CMAKE_CURRENT_BINARY_DIR
}/SophusConfig.cmake @ONLY IMMEDIATE )
export( PACKAGE Sophus )
 
INSTALL(DIRECTORY sophus DESTINATION ${
CMAKE_INSTALL_PREFIX
}/include
        FILES_MATCHING PATTERN "*.hpp" )

CMakeLists.txt详解
weixin_42301918的博客
05-14 7954
#声明使用的最低版本 cmake_minimum_required(VERSION 3.0) # 指定工程名 PROJECT (HELLO) # 现阶段，你只需要了解 SET 指令可以用来显式的定义变量即可 # 将 hello.cpp 赋值给 SRC_LIST 变量，也可以指定多个源文件，用空格隔开 # SET(SRC_LIST test01.cpp test02.cpp sub.cpp hello.cpp) SET(SRC_LIST hello.cpp) ##使用MESSAGE向屏幕输出信息，STA
CMakeLists.txt 完全详解
最新发布
fengzhan12138的博客
04-13 567
添加自定义命令# 添加自定义目标# 依赖关系。
ROS-CMakeLists.txt文件
weixin_51568145的博客
06-17 2532
CMakeLists.txt 是一个用于构建 CMake 项目的配置文件。CMake 是一个跨平台的构建系统生成工具，用于管理和构建软件项目。CMakeLists.txt 文件是在 CMake 中定义项目的基本配置和构建规则的文本文件。CMakeLists.txt 文件通常位于项目的根目录，并包含一系列的 CMake 命令和指令。这些命令和指令描述了项目的源代码文件、依赖项、编译选项、链接库、可执行文件等信息，以及项目的构建方式和生成目标。
CMakeLists.txt 文件详解
clayhell的博客
05-29 5847
命令时，指定 CMakeLists.txt 文件的路径，CMake 会读取该文件并根据其中的命令和配置生成相应的构建系统文件（如 Makefile、Visual Studio 解决方案等）。然后，使用生成的构建系统文件进行构建操作。这些只是 CMakeLists.txt 文件中的一些常见命令和配置选项，CMake 提供了更多的功能和灵活性，可以根据项目需求进行进一步的配置和定制。其他命令和配置：CMake 提供了许多其他命令和配置选项，可以根据具体需求进行配置，如设置输出路径、定义宏、配置测试等。
CMake是什么？有什么用？
热门推荐
The Best or Nothing.
05-19 10万+
CMakeCMake是一个跨平台的编译(Build)工具,可以用简单的语句来描述所有平台的编译过程。CMake能够输出各种各样的makefile或者project文件，能测试编译器所支持的C++特性,类似UNIX下的automake。假如我们有一个深度学习框架的部分工程列表，里面有超过40个互相调用的工程共同组成，一些用于生成库文件，一些用于实现逻辑功能。他们之间的调用关系复杂而严格，如果我想在这...
vscode+opencv3 windows下编译 调试cpp文件 json方法和CMakeLists.txt方法
zhulinmanbu114的博客
05-28 1825
windows下 vscode opencv C++配置 - json文件配置方法 - CMakeLists.txt配置方法 错误处理： >error: '::_hypot' has >not been declared using ::hypot; ^~~~~
C++程序从windows移植到linux后cmake脚本CMakeLists.txt的修改
左直拳的马桶_日用桶
03-20 1616
在 CMake 里，add_custom_command 是一个很实用的指令，能在构建过程里添加自定义的命令。# 将配置文件复制到构建目录VERBATIM)指定该自定义命令所关联的目标为 UnderwtConn。UnderwtConn 通常是通过 add_executable 或者 add_library 命令创建的可执行文件或库目标。这意味着该自定义命令会和 UnderwtConn 这个目标的构建过程相关联。POST_BUILD。
如何将Qt pro工程文件 改成CMakeLists.txt
qthello
05-23 2354
Qt pro工程管理文件，本人认为是很好用的，语法简洁易懂，但是只能在QtCreator中使用，想用使用其它IDE比如Clion或者vs，CMakeLists是种通用的选择，另外QtCreator的调试功能跟粑粑一样。C++ 中编译，无外乎代码本身的头文件，源文件。三方库的头文件，库文件。Qt本身自带了UI文件和qrc资源文件。CMake 无法像pro那样处理图标文件，需要先新建一个rc文件，rc文件中指明icon文件，然后加载rc文件。三，CMakeLists 文件。二，Qt pro文件。
CMakeLists.txt用法备忘
ivanwfy的专栏
10-05 289
是 CMake 构建系统的核心配置文件，它使用 CMake 语言来定义项目的构建过程。，你可以跨平台地管理 C、C++、Fortran 等项目的编译、链接、测试和安装。CMake通过CMakeLists.txt配置项目的构建系统，配合使用。cmakelists.txt会根据 系统变量找pcl相关路径。Pcl点云也可以在cmakelists.txt中设置。VScode 中使用CMakeLists.txt。Clion中使用（vscode也可以）生成构建系统并执行编译、测试。
【CMakeLists.txt】QtSvg 头文件包含配置详解
weixin_43219667的博客
10-24 465
QtSvg 在 LibreCAD 中的重要性🎨 矢量图形支持：高质量的 SVG 导入导出功能🖨️ 打印和输出：高分辨率打印和预览支持📱 界面现代化：可缩放的 SVG 图标和界面元素🔧 格式兼容性：与其他 CAD 工具的 SVG 交换配置建议对于现代 CMake 项目，推荐使用替代手动的，这样可以自动处理所有包含路径和编译定义，提高配置的可靠性和可维护性。当前配置虽然功能正常，但体现了从传统 CMake 向现代 CMake 实践的过渡状态。
CMakeList.txt
zhangna的博客
11-16 1230
一、Cmake 简介 cmake 是一个跨平台、开源的构建系统。它是一个集软件构建、测试、打包于一身的软件。它使用与平台和编译器独立的配置文件来对软件编译过程进行控制。 二、常用命令 1. 指定 cmake 的最小版本 cmake_minimum_required(VERSION 3.4.1) 这行命令是可选的，我们可以不写这句话，但在有些情况下，如果 CMakeLists.txt ...
CMake使用方法以及CMakeLists.txt 学习总结(1)
deer07的博客
06-24 3204
在一个目录下有多个cpp文件，和头文件main.cpphead.h。
CMakelists.txt简单介绍
Bobowen的博客
01-29 3520
先祝大家开工大吉，这篇策划一下CMakelists.txt，它依托在Cmake里，在大型工程、平台兼容方面非常好用的C++项目编译工具，再此先对它做一个简短的介绍。
【CMake】CMakeLists.txt的超详细教程,带你进入第一个项目
sunny哈哈的博客
09-28 9090
用了几次CMakeLists进行编译，下一次再用还是感觉乱乱的，这一次，把思路整理一下，认真学习一下CMakeLists应如何编写。
2.CMake介绍及CMakeLists.txt文件编写
c15901088098的博客
08-08 2250
如果我们的程序想要运行在不同的平台上，就需要根据不同平台的make工具规范编写对应的Makefile文件。CMake 则是一个跨平台的安装(编译)工具。CMakeList.txt是一个与平台无关的、用于定制编译流程的文件。CMake 靠的是 CMakeLists.txt 文件来生成Makefile文件。 本文将介绍CMake的使用及CMakeLists.txt文件编写实例。
CMakeLists.txt 详解
sunxiaoyan的博客
06-29 1万+
CMakeLists.txt 详解
CMakeLists.txt的创建和基本使用
qq_45428105的博客
04-08 4982
学习记录
CMakeLists.txt文件详解
weixin_42351754的博客
09-03 898
CMakeLists.txt 文件是用于描述 CMake 构建过程和项目配置的文件。它包含了一系列 CMake 命令、变量设置和流程控制结构，用于告诉 CMake 如何生成适合你的平台和编译器的构建系统文件。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值