cmake教程官方文档（cmake使用教程）



本文以 Windows 系统 开发环境下为基础，演示CMake 构建HelloWorld教程。

新建文件夹 HelloWorld，新建 C++ 源代码文件 HelloWorld.cpp，编写代码如下：HelloWorld.cpp

在与 HelloWorld.cpp 所在文件夹新建 CMake 脚本文件 CMakeLists.txt，编写代码如下：CMakeLists.txt

project（可选）

指定当前 CMake 工程名称，此名称并非 Visual Studio 的工程名，此名称不影响源代码工程名。如果使用  构建， 名称即解决方案（*.sln）名称。
此参数在复杂项目中能够一些非常便利的操作方式，以后的文章中会详细说明。
如果只是构建一个普通的简单项目，此语句可省略。

message（可选）

函数原型

常用参数

• FATAL_ERROR 致命错误，终止构建。当指定此参数输出消息时，说明遇到无法处理的错误，停止构建，告诉开发者发生错误的代码位置。
• WARNING 警告。输出警告消息，继续构建。
• STATUS 状态。常用类型之一，输出状态信息。
• (none) or NOTICE 消息。常用类型之一，输出消息。

set（可选）

声明变量，将一组值使用一个变量代替。

函数原型

使用方法
CMake 约定使用  的方式引用变量，如代码中声明变量  记录当前当前工程的源码文件，在构建可执行程序时使用  的方式引用变量。
可以使用 message(STATUS “${SRC_FILES}”) 的方式查看变量中定义的内容。

add_executable（必选）

根据指定的源码添加一个可执行程序，CMake 将根据当前指令构建源码工程，参数1  是工程名，是项目构建的关键参数，在复杂的项目中需要修改编译选项，指定链接库，设置构建事件都是通过  进行关联。

函数原型

本文只是从实用的角度介绍命令的基本含义和常用方法，如果想要全面了解命令的其他用法，请参见 CMake 的官方文档。

• 本地文档。CMake 安装目录doccmakehtmlindex.html
• 在线文档。CMake 文档中心（https://cmake.org/cmake/help/v3.15/）

创建存放工程文件文件夹 ，当前文件结构如下：

使用命令行提示符  切换至  目录，执行 ，输出构建信息如下：

从输出信息看到以下信息：

• 编译器版本：，当未指定编译器版本时，CMake 会自动从当前环境下选择一个可用的编译器进行构建，Windows 开发环境部署  时默认选择 ，当存在多个版本的  时默认选择最新版本。备注：因为本文构建环境安装 ，实际构建以当前开发环境的  版本为准。
• 命令输出的消息
• 工程文件存放目录：

构建命令中  表示指定源码的路径为上一级目录，也是  文件所在目录。

构建完成后，在  目录生成  项目，

指定参数构建

指定构建目录

指定编译器构建

• 构建 NMake 工程
• 构建 VS2012 工程，

本文只列举出两种常用的构建参数，CMake 支持构建参数详情请使用命令行提示符（）输入  查看详细内容。

本文使用  开发环境，故使用 VS 打开 HelloWorld.sln，编译源码生成可执行文件。

运行编译后程序，执行结果：

版权声明：

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如若内容造成侵权、违法违规、事实不符，请将相关资料发送至xkadmin@xkablog.com进行投诉反馈，一经查实，立即处理！

转载请注明出处，原文链接：https://www.xkablog.com/do-yfwjc/58256.html