CMakeLists.txt的写法

本文介绍了 CMake 的基本用法,包括如何使用 CMake 构建可执行文件和库文件,如何设置编译选项,如何指定链接库等。此外还提供了一些调试技巧和平台相关的配置方法。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

参考:http://blog.youkuaiyun.com/cust_hf/article/category/345853

CMakeListserv.txt的写法

(1):要求CMake根据指定的源文件生成可执行文件

Demo1:

add_executable(hello main.cpp)

    这将从main.cpp源码文件创建一个叫“hello”(Windows下叫“hello.exe”)的可执行文件。你可以根据自己的需要将C和C++文件混合。在同一个CMakeLists.txt可以有多个可执行文件和库。同一个源码文件可以用于不同的目的,源码可以从其他目标中为每个目的独立的编译。 

Demo2:

add_executable(demo main.cpp main.h main.rc)

    这奖使用main.cpp源文件,main.h文件,main.rc文件构造可执行文件。至于如何使用这些文件,CMake比我们都清楚。

 

(2):调试CMakeLists.txt的办法
这个是调试CMakeLists.txt的一个手段啦。不得不学习哦。 

演示1如下:
MESSAGE("俺们正在生成项目文件")
会显示一个警告框。

演示2如下:
MESSAGE(STATUS "俺们正在创建项目文件")
遇到这条指令,会把文字显示在状态栏里面(一闪而过,不容易发现)。

演示3如下:
MESSAGE(FATAL_ERROR "严重错误,俺们搞不定啦")
这条指令会提示出错,并退出。

(3):使用标准模块
cmake提供了很多标准模块,扩展名都是txt.我们可以直接包含进来。就像使用C语言的#include指令一般。比如:
INCLUDE(FindBoost)
一句话,就告诉了CMake“我们的程序需要Boost”。

(4):使用变量 .
SET( MY_SOURCES main.cpp widget.cpp)
MESSAGE(STATUS "my sources: ${MY_SOURCES}")使用SET()命令来为变量设置值。如果你列出了一个以上的字符串,变量将是串列表。列表是一列由分号隔开的字符串。如果只设置个一项,那么这项只有一个值。可以通过${VAR}获得变量的值。可以使用FOREACH()来迭代一份列表:

FOREACH(next_ITEM ${MY_SOURCES})
   MESSAGE(STATUS "next item: ${next_ITEM}")
ENDFOREACH(next_ITEM ${MY_SOURCES})

CMake中的命令是大小写无关的。变量名和参数名是大小写相关的。

(5):测试平台相关信息 .
办法一(这个代码没有检验过哦)
IF (UNIX)
   MESSAGE("这个是UNIX操作系统")
ENDIF (UNIX)
 
IF (MSVC)
   MESSAGE("这个需要做VC的项目文件")
ENDIF (MSVC)

办法二(这个测试过)

IF (${CMAKE_SYSTEM_NAME} STREQUAL "Windows")
 SET(option WIN32)
 SET(win32_LIBRARIES comctl32.lib shlwapi.lib shell32.lib odbc32.lib odbccp32.lib  kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib)
 #SET(defs -DUNICODE -D_UNICODE)
ENDIF (${CMAKE_SYSTEM_NAME} STREQUAL "Windows")

(6):要求CMake根据指定的源文件生成库文件 .
ADD_LIBRARY: Add a library to the project using the specified source files.


•  ADD_LIBRARY(libname [SHARED | STATIC | MODULE] [EXCLUDE_FROM_ALL]              source1 source2 ... sourceN)Adds a library target. SHARED, STATIC or MODULE keywords are used to set the library type. If the keyword MODULE appears, the library type is set to MH_BUNDLE on systems which use dyld. On systems without dyld, MODULE is treated like SHARED. If no keywords appear as the second argument, the type defaults to the current value of BUILD_SHARED_LIBS. If this variable is not set, the type defaults to STATIC.


If EXCLUDE_FROM_ALL is given the target will not be built by default. It will be built only if the user explicitly builds the target or another target that requires the target depends on it.

(7):添加查找头文件的路径 .
INCLUDE_DIRECTORIES: Add include directories to the build.


  INCLUDE_DIRECTORIES([AFTER|BEFORE] [SYSTEM] dir1 dir2 ...)Add the given directories to those searched by the compiler for include files. By default the directories are appended onto the current list of directories. This default behavior can be changed by setting CMAKE_INCLUDE_DIRECTORIES_BEFORE to ON. By using BEFORE or AFTER you can select between appending and prepending, independent from the default. If the SYSTEM option is given the compiler will be told that the directories are meant as system include directories on some platforms. 

(8):添加库文件的搜索路径 .
分类: CMake相关 2007-11-04 00:50 421人阅读 评论(0) 收藏 举报
LINK_DIRECTORIES: Specify directories in which to search for libraries.

  LINK_DIRECTORIES(directory1 directory2 ...)

(9):显式指定链接时需要的库文件 .
分类: CMake相关 2007-11-04 00:54 491人阅读 评论(0) 收藏 举报
为每个目标分别指定需要链接的库文件(指定部分目标专用的库文件)
 TARGET_LINK_LIBRARIES: Link a target to given libraries.

  TARGET_LINK_LIBRARIES(target library1                        <debug | optimized> library2                        ...)Specify a list of libraries to be linked into the specified target. The debug and optimized strings may be used to indicate that the next library listed is to be used only for that specific type of build

为所有目标统一指定需要的库文件(指定所有目标都用的库文件)
LINK_LIBRARIES: Link libraries to all targets added later.


  LINK_LIBRARIES(library1 <debug | optimized> library2 ...)This is an old CMake command for linking libraries. Use TARGET_LINK_LIBRARIES unless you have a good reason for every target to link to the same set of libraries.


Specify a list of libraries to be linked into any following targets (typically added with the ADD_EXECUTABLE or ADD_LIBRARY calls). This command is passed down to all subdirectories. The debug and optimized strings may be used to indicate that the next library listed is to be used only for that specific type of build.

(10):显式实施宏定义 .
分类: CMake相关 2007-11-04 00:58 496人阅读 评论(0) 收藏 举报
用法演示一(文本宏):

ADD_DEFINITIONS(-DDEBUG) 

用法演示二(常量宏)

ADD_DEFINITIONS(-DVERSION=1) 

 ADD_DEFINITIONS: Adds -D define flags to the command line of C and C++ compilers.
  ADD_DEFINITIONS(-DFOO -DBAR ...)Adds flags to command line of C and C++ compilers. This command can be used to add any flag to a compile line, but the -D flag is accepted most C/C++ compilers. Other flags may not be as portable.

 

 

在检查 CMakeLists.txt 文件的代码风格时,可以使用一些专门的工具来帮助完成这一任务。这些工具可以帮助开发者发现潜在的错误、不符合最佳实践的写法以及不一致的代码风格问题。以下是一些常用的工具和方法: ### 使用 `cmake-lint` `cmake-lint` 是一个用于检查 CMakeLists.txt 文件风格的工具,它类似于 Python 中的 `pylint`。它能够检测出不符合 CMake 编码规范的地方,并提供相应的建议。 #### 安装 `cmake-lint` 可以通过 Python 的 `pip` 安装 `cmake-lint`: ```bash pip install cmake-lint ``` #### 使用 `cmake-lint` 安装完成后,可以直接在包含 CMakeLists.txt 文件的目录中运行以下命令: ```bash cmake-lint CMakeLists.txt ``` 该命令会输出所有发现的风格问题及其位置,帮助开发者进行修正。 ### 使用 `cmake-format` `cmake-format` 是一个用于格式化 CMakeLists.txt 文件的工具,它可以自动调整代码格式以符合一定的风格指南。这对于统一团队内部的代码风格非常有用。 #### 安装 `cmake-format` 同样,`cmake-format` 也可以通过 `pip` 安装: ```bash pip install cmake-format ``` #### 使用 `cmake-format` 运行以下命令来格式化 CMakeLists.txt 文件: ```bash cmake-format -i CMakeLists.txt ``` 此命令会直接修改原文件,将其格式化为符合默认或自定义配置的风格。 ### 集成到 IDE 或编辑器 许多现代的 IDE 和文本编辑器(如 VSCode、CLion)支持通过插件或扩展集成上述工具。例如,在 VSCode 中,可以通过安装 CMake Tools 插件来获得更好的 CMake 支持,包括代码风格检查和格式化功能。 ### 自定义规则 对于 `cmake-lint` 和 `cmake-format`,用户还可以通过配置文件来自定义规则。这允许团队根据自己的需求定义特定的编码标准,从而确保所有成员遵循一致的代码风格。 ### 持续集成(CI)集成 为了确保每次提交的代码都符合预定的风格指南,可以将这些工具集成到持续集成流程中。例如,在 GitHub Actions 或 GitLab CI 中添加一个步骤来运行 `cmake-lint` 或 `cmake-format`,并在构建失败时通知开发者。 ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值