cmake使用等(转)

转自http://tzc.is-programmer.com/show/476.html

CMake 简介

CMake(cross platform make)是一个跨平台的安装(编译)工具,可以编译源代码、制作程式库,可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件,能测试编译器所支持的C++特性,类似UNIX下的automake。


CMake 使用方法

    CMake的所有的语句都写在一个叫:CMakeLists.txt的文件中。当CMakeLists.txt文件确定后,可以用ccmake命令对相关的变量值进行配置。这个命令必须指向CMakeLists.txt所在的目录。配置完成之后,应用cmake命令生成相应的makefile(在Unix like系统下)或者 project文件(指定用window下的相应编程工具编译时)。

其基本操作流程为:

  1. $> ccmake directory
  2. $> cmake directory
  3. $> make

其中directory为CMakeList.txt所在目录;

  • 第一条语句用于配置编译选项,如VTK_DIR目录 ,一般这一步不需要配置,直接执行第二条语句即可,但当出现错误时,这里就需要认为配置了,这一步才真正派上用场;
  • 第二条命令用于根据CMakeLists.txt生成Makefile文件;
  • 第三条命令用于执行Makefile文件,编译程序,生成可执行文件;

CMake的执行就是这么简单,其难点在于如何编写CMakeLists.txt文件,下面结合例子简单介绍CMakeLists.txt的编写,看下面这个CMakeLists.txt

  1. #project name
  2. PROJECT (test_math )
  3. #head file path
  4. INCLUDE_DIRECTORIES (
  5. include
  6. )
  7. #source directory
  8. AUX_SOURCE_DIRECTORY (src DIR_SRCS )
  9. #set environment variable
  10. SET (TEST_MATH
  11. $ {DIR_SRCS }
  12. )
  13. #set extern libraries
  14. SET (LIBRARIES
  15. libm. so
  16. )
  17. #add executable file
  18. ADD_EXECUTABLE (../bin/bin $ {TEST_MATH } )
  19. #add link library
  20. TARGET_LINK_LIBRARIES (../bin/bin $ {LIBRARIES } )
  21.  

这是一个测试数学函数的程序的CMakeLists.txt,"#"后面为注释的内容,CMake的命令全部为大写

第2行指定生成的工程名为test_math

第4行指定头文件目录为include

第8行指定源文件目录为src,并将其赋值给环境变量DIR_SRCS

第10行设定环境变量TEST_MATH的值为环境变量DIR_SRCS的值,此处用于显示如何用环境变量对环境变量进行赋值

第14行将数学函数库赋值给环境变量LIBRARIES,当然,可以不用这个环境变量,而在后面直接使用该库名

第18行用于指定生成文件,将环境变量TEST_MATH目录下的所有文件编译生成../bin目录下的可执行文件bin

第20行指定../bin/bin执行时的链接库为环境变量LIBRARIES的值-libm.so

下面给出源文件
/src/main.c:

  1. #include<stdio.h>
  2. #include"../include/a.h"
  3. int main ( )
  4. {
  5.      double b= 25.0;
  6.      double a= 0.0;
  7.     a=get_sqrt (b );
  8.  
  9.      printf ( "a is %lf, b is %lf\n",a,b );
  10.      return  0;
  11. }
  12.  

/src/a.c

  1. #include"../include/a.h"
  2. double get_sqrt ( double var1 )
  3. {
  4.      return sqrt (var1 );
  5. }
  6.  

 

/include/a.h

 #ifndef  A_FILE_HEADER_INC

  1.  
  2. #define  A_FILE_HEADER_INC
  3. #include<math.h>
  4.  
  5. double get_sqrt ( double var1 );
  6.  
  7. #endif

将CMakeLists.txt放在当前目录下,执行CMakeLists.txt

  1. $> cmake .
  2. $> make

即可生成可执行文件,在目录/bin下的bin文件,好了运行看其效果是否和所想一样。



<think>首先,用户的问题是:“我想查找CMake使用教程请问CMake使用教程|CMake入门指南|CMake配置详解”。这是一个查找CMake教程的请求。在系统级指令中,我需要:-所有行内数学表达式使用$...$格式(但在这个上下文中,CMake教程可能不涉及数学,所以可能不需要)。-独立公式使用$$...$$格式,并单独成段(同样,可能不适用)。-LaTeX语法正确。-使用中文回答。-生成相关问题。-回答中引用的段落末尾自然地添加引用标识,例如[^1].用户提供了站内引用:-引用[1]:讨论了CMake_SOURCE_DIR和基本构建步骤。-引用[2]:是关于CMake入门教程,包括Helloworld示例和命令详解。-引用[3]:提到了CMake帮助手册的使用。用户说:“上述引用仅供参考,并不是用户真正的需求,请尽可能多的参考用户上一次的问题和你的回答。”但在这个对话中,这是第一个用户消息,所以没有“上一次的问题”。系统指令提到“参考用户上一次的问题和你的回答”,但这里没有历史。所以,我应该直接回应用户的查询。关键点是:用户想要CMake使用教程。所以,我需要提供CMake入门指南、配置详解的摘要或指导。响应结构:-基于系统指令,回答应结构清晰,帮助用户逐步解决问题。-使用中文。-在末尾生成相关问题。-如果有引用,末尾添加引用标识;但由于用户说引用仅供参考,我应该主要基于自己的知识提供可靠信息,但可以参考提供的引用。制定响应:1.**介绍CMake**:简述CMake是什么,为什么有用。2.**入门步骤**:提供基本的CMake使用教程,类似于引用[2]中的内容。3.**配置详解**:解释CMakeLists.txt的基本结构、常用命令如project(),add_executable(),等。4.**构建过程**:描述如何创建构建目录、运行cmake、make等。5.**参考提供的引用**:自然地融入引用。例如,在描述命令时,可以提到引用[2]中的例子。生成相关问题:在末尾,创建几个相关问题,比如基于教程的扩展问题。确保LaTeX:CMake教程不涉及数学,所以可能不需要数学表达式。如果出现变量等,可能需要使用$...$,但这里不太可能。最终响应结构:-开头解释CMake。-逐步讲解入门教程(HelloWorld示例)。-详细解释配置(CMakeLists.txt中的命令)。-总结如何编译安装。-添加引用标识,如果使用了参考信息。-§§相关问题§§部分:列出相关问题。问题用中文。相关问题示例:1.CMake如何管理多文件项目?2.CMake的缓存机制是什么?3.如何添加外部库依赖?引用:用户提供了引用标签[^1],[^2],[^3],所以如果我引用,就用这些。例如:在描述project()命令时,可以引用引用[2]。保持自然。</think> ### CMake 入门教程和配置详解 CMake是一个跨平台的构建工具,广泛用于管理C++等语言的软件编译过程。它能生成标准的构建文件(如Makefile或Visual Studio项目),简化了从源代码到可执行文件的换。本教程将逐步介绍CMake的基本使用方法,从最简单的Hello World项目开始,扩展到配置详解。内容基于通用知识和最佳实践,同时参考您提供的引用信息[^1][^2][^3]进行补充。 #### 1. **CMake 基础入门:Hello World 项目** 这是最基础的CMake项目,适合学习基本命令和构建流程。 - **步骤1: 创建项目文件** 在您的项目根目录下,创建一个名为`CMakeLists.txt`的文件。这个文件定义了项目的构建规则。以下是一个Hello World示例的完整内容(参考引用[^2]): ```cmake # 指定最小CMake版本,确保兼容性(建议至少3.10) cmake_minimum_required(VERSION 3.10) # 设置项目名称(如“HelloWorld”) project(HelloWorld) # 创建可执行文件:目标名称为HelloWorld,源码文件为helloworld.cpp add_executable(HelloWorld helloworld.cpp) ``` 同时,创建一个源码文件`helloworld.cpp`: ```cpp #include <iostream> int main() { std::cout << "Hello, CMake World!" << std::endl; return 0; } ``` - **步骤2: 构建项目** 在命令行中,执行以下命令(参考引用[^1][^2])。这包括: - 创建并进入`build`目录(隔离构建文件,保持源码整洁)。 - 运行`cmake`生成构建文件(如Makefile)。 - 编译并运行。 ```bash # 创建build目录(推荐方式) mkdir build cd build # 使用cmake生成构建文件(.. 表示上一级目录的CMakeLists.txt) cmake .. # 编译项目(在Linux/Unix使用make,Windows会生成VS工程) make # 运行可执行文件 ./HelloWorld ``` 输出应该为:`Hello, CMake World!` **注意**: 在Windows上,`cmake ..`会生成Visual Studio解决方案,可使用`cmake --build .`代替`make`。 这些步骤展示了CMake的最小工作流程,其中`cmake_minimum_required()`指定版本,`project()`定义项目属性,`add_executable()`添加编译目标[^2]。 #### 2. **CMake 配置详解:常用命令和功能** 理解CMakeLists.txt的配置是关键。以下是核心命令的解释和使用场景(参考引用[^2][^3])。 - **基本命令详解**: - `cmake_minimum_required(VERSION x.y)`: 设置最低CMake版本,避免兼容性问题(如VERSION 3.10)。必须放在文件开头。 - `project(项目名 [VERSION 版本号] [LANGUAGES CXX])`: 定义项目名称,可添加版本和语言(CXX表示C++)。这会设置变量如`PROJECT_NAME`,在后续配置中可用。 - `add_executable(target名 源码文件)`: 创建一个可执行文件目标。例如,`add_executable(MyApp main.cpp)`。如果源码文件有多个,直接列出(如`main.cpp util.cpp`)。 - `add_library(target名 STATIC/SHARED 源码文件)`: 创建静态库或动态库(如`add_library(mylib STATIC lib.cpp)`)。 - **管理多文件项目**(参考引用[^1]): 当项目包含多个源文件时,使用`file(GLOB ...)`或手动列出文件: ```cmake cmake_minimum_required(VERSION 3.10) project(MultiFileExample) # 方式1: 手动添加所有源码文件 add_executable(App main.cpp file1.cpp file2.cpp) # 方式2: 使用file命令自动搜集 file(GLOB SOURCES "src/*.cpp") add_executable(App ${SOURCES}) ``` **注意**: 使用`file(GLOB)`时需谨慎,因为它可能导致构建不稳定(新增文件时需重新运行cmake)。 - **添加编译器选项和依赖**: - `add_compile_options(...)`: 添加编译器标志(如`add_compile_options(-Wall -O2)`开启警告和优化)。查看帮助手册:`cmake --help-commands add_compile_options`[^3]。 - `find_package(库名 REQUIRED)`: 自动查找系统依赖库(如OpenCV),需配合`target_link_libraries()`。 - `target_link_libraries(target名 库名)`: 链接库到目标(如`target_link_libraries(MyApp mylib)`)。 - **变量和路径设置**: - CMake定义了内置变量,如`CMAKE_SOURCE_DIR`(项目根目录)、`CMAKE_BINARY_DIR`(构建目录)。例如,`CMAKE_SOURCE_DIR`指向定义了顶级CMakeLists.txt的文件夹[^1]。 - 自定义变量:`set(变量名 值)`,如`set(COMPILE_FLAGS "-std=c++11")`。 #### 3. **进阶功能:安装和自定义目标** 在入门后,扩展功能能提升项目管理: - **安装程序**: 在CMakeLists.txt中添加: ```cmake # 安装可执行文件到系统目录(默认/usr/local/bin) install(TARGETS HelloWorld DESTINATION bin) ``` 运行安装:在构建目录执行`make install`(或Windows的`cmake --build . --target install`)[^1]。 - **使用帮助手册**: CMake提供了完整的命令行帮助: - `cmake --help`: 查看基本用法。 - `cmake --help-command <命令>`: 获取命令详情(如`cmake --help-command add_executable`[^3])。 - `cmake --help-variable <变量名>`: 查看变量解释。 - **跨平台提示**: - 在Windows上,cmake可能生成Visual Studio项目;在macOS,使用Xcode工具链。统一命令行:`cmake -G "Generator Name" ..`(如`-G "Visual Studio 17 2022"`)。 #### 4. **总结和推荐资源** 这个教程覆盖了从入门到配置的核心内容。实际项目中,建议: - 从简单项目开始练习。 - 使用官方文档或在线教程(如CMake官网)深化学习(参考引用[^2][^3])。 - 在构建时始终使用隔离的`build`目录(最佳实践[^1])。 如果您有特定项目问题(如添加外部库),请提供更多细节!我会进一步协助。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值