当前位置: 首页 > news >正文

CMake教程 - basic point

CMake教程 - basic point

1 - Building a Basic Project

最基本的CMake项目是由单个源代码文件构建的可执行文件。对于像这样简单的项目,只需要一个带有三个命令的CMakeLists.txt文件。

注意:尽管CMake支持大写、小写和混合大小写命令,但小写命令是首选,并将在整个教程中使用。

任何项目的顶级CMakeLists.txt都必须从使用cmake_minimum_required()命令指定一个最小的CMake版本开始。这将建立策略设置,并确保以下CMake功能使用兼容版本的CMake运行。要启动一个项目,我们使用project()命令来设置项目名称。这个调用对于每个项目都是必需的,并且应cmake_minimum_required()之后不久就被调用。我们将看到,此命令还可以用于指定其他项目级别信息,如语言或版本号。最后,add_executable()命令告诉CMake使用指定的源代码文件创建一个可执行文件。

语法说明

设置项目cmake最低版本要求

cmake_minimum_required(VERSION <min>[...<policy_max>] [FATAL_ERROR])

设置项目名称,同时也设定了几个环境变量

project(<PROJECT-NAME> [<language-name>...])
project(<PROJECT-NAME>[VERSION <major>[.<minor>[.<patch>[.<tweak>]]]][DESCRIPTION <project-description-string>][HOMEPAGE_URL <url-string>][LANGUAGES <language-name>...])
PROJECT_SOURCE_DIR    当前source code 路径
PROJECT_BINARY_DIR    当前source bin路径

使用指定的souce file 向项目中添加一个可执行文件

add_executable(<name> [WIN32] [MACOSX_BUNDLE][EXCLUDE_FROM_ALL][source1] [source2 ...])

demo

main.c

#include <stdio.h>int main(int argc, char **argv)
{printf("hello world\n");return 0;
}

CMakeLists.txt

#cmake version
cmake_minimum_required(VERSION 3.2)#project name
project(basic_demo)message("echo project dir is ${PROJECT_SOURCE_DIR}")
message("echo project bin is ${PROJECT_BINARY_DIR}")
#add executable
add_executable(basic_demo main.c)

编译

可以创建一个文件夹用于存放cmake产生的文件,然后执行 cmake . , 编译文件cmake --build .

2 - Specifying the C++ Standard

CMake有一些特殊的变量,这些变量要么是在幕后创建的,要么是在项目代码中设置的。许多这些变量都以CMAKE开头。在为项目创建变量时避免这种命名约定。其中两个特殊的用户可设置变量是CMAKE_CXX_STANDARD和CMAKE_CXX_STANDARD_REQUIRED。它们可以一起用于指定构建项目所需的c++标准。

变量说明

CMAKE_CXX_STANDARD

如果在创建目标器时设置了CXX STANDARD目标器属性的默认值,c++标准,其特性被要求构建此目标。此属性指定构建此目标所要求的c++标准的特性。对于某些编译器,这会导致在编译行中添加一个标志,如-std=gnu++11。对于没有标准级别概念的编译器,例如2015 Update 3之前的Microsoft Visual c++,这没有影响。支持的值有:

CMAKE_CXX_STANDARDversion
98C++98
11C++11
14C++14
17C++17
20C++20
23C++23
CXX_STANDARD_REQUIRED

如果在创建目标器时设置了CXX_STANDARD_REQUIRED目标器属性,则该属性为默认值。

描述CXX STANDARD的值是否是必需的。如果此属性设置为ON,则CXX_STANDARD目标属性的值被视为需求。如果此属性为OFF或未设置,则CXX_STANDARD目标属性被视为可选属性,并且如果所请求的不可用,则可能“衰减”到以前的标准。对于没有标准级别概念的编译器,例如MSVC 1800 (Visual Studio 2013)和更低的版本,这没有影响。

demo

main.cpp

#include <iostream>int main(int argc, char **argv)
{std::string var = "3.14156";const double input_value = std::stod(var);  //stod是c11 中有的 ,如果不设定cxx version 就会报错std::cout << input_value << std::endl;std::cout << "hello world " << std::endl;return 0;
}

CMakeLists.txt

#set cmake version
cmake_minimum_required(VERSION 3.2)#project name
project(basic_demo2)#set CXX version
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED true)#add executable
add_executable(basic_demo2 main.cpp)

3 - Adding a Version Number and Configured Header File

有时,在CMakelists.txt文件中定义的变量在源代码中也有,这可能很有用。在这种情况下,我们希望打印项目版本。实现这一点的一种方法是使用已配置的头文件。我们创建了一个包含一个或多个变量要替换的输入文件。这些变量具有特殊的语法,看起来像@VAR@。然后,我们使用coffet_file()命令将输入文件复制到给定的输出文件中,并将这些变量替换为CMakelists.txt文件中VAR的当前VAR值。虽然我们可以直接在源代码中编辑版本,但使用这个特性是首选,因为它创建了一个单一的真相来源,并避免了重复。

变量说明

<PROJECT_NAME>_VERSION_MAJOR

项目的主版本号

<PROJECT_NAME>_VERSION_MINOR

项目的次版本号

拷贝文件到另外一个位置并且修改内容

configure_file(<input> <output>[NO_SOURCE_PERMISSIONS | USE_SOURCE_PERMISSIONS |FILE_PERMISSIONS <permissions>...][COPYONLY] [ESCAPE_QUOTES] [@ONLY][NEWLINE_STYLE [UNIX|DOS|WIN32|LF|CRLF] ])

input file和outfile对比

inputfile					outfile
#cmakedefine VAR			#define VAR or #undef VAR
#cmakedefine VAR 1			#define VAR 01
#cmakedefine01 VAR			#define VAR 1 or #define VAR 0input file中的变量使用@var@  or ${var} $CACHE{VAR} $ENV{VAR}

加入头文件路径

target_include_directories(<target> [SYSTEM] [AFTER|BEFORE]<INTERFACE|PUBLIC|PRIVATE> [items1...][<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

demo

main.cpp

#include <iostream>
#include "basicconfig.h"int main(int argc, char **argv)
{std::cout << "verson major" << basic_demo_VERSION_MAJOR << "version minor" << basic_demo_VERSION_MINOR << std::endl;std::cout << "hello world " <<std::endl;return 0;
}

CMakeLists.txt

cmake_minimum_required(VERSION 3.2)project(basic_demo VERSION 1.2)
configure_file(basicconfig.h.in basicconfig.h)add_executable(basicdemo main.cpp)
target_include_directories(basicdemo PRIVATE  ${PROJECT_SOURCE_DIR})           

basicconfig.h.in

#define basic_demo_VERSION_MAJOR @basic_demo_VERSION_MAJOR@
#define basic_demo_VERSION_MINOR @basic_demo_VERSION_MINOR@
http://www.lryc.cn/news/208411.html

相关文章:

  • day52--动态规划11
  • Jenkins入门级安装部署
  • tcpdump 异常错误
  • 如何绘制【逻辑回归】中threshold参数的学习曲线
  • 4.1 数据库安全性概述
  • tftp服务的搭建
  • c语言简介
  • OpenLayers.js 入门教程:打造互动地图的入门指南
  • 黑马头条:app端文章查看
  • 常见使用总结篇(一)
  • 【软考系统架构设计师】2023年系统架构师冲刺模拟习题之《数据库系统》
  • 北邮22级信通院数电:Verilog-FPGA(7)第七周实验(1):带使能端的38译码器全加器(关注我的uu们加群咯~)
  • SIT3491ISO具有隔离功能,256 节点,全双工 RS422/RS485 芯片
  • 在windows服务器上部署一个单机项目以及前后端分离项目
  • 使用jdbc技术,在数据库中存储大数据对象(使用字节IO流读取图片等给blob等二进制类型数据赋值)
  • 统计学习方法 支持向量机(下)
  • 【python】如何注释
  • C++——C++入门(二)
  • 容联七陌百度营销通BCP解决方案,让营销更精准
  • Transformer模型 | 用于目标检测的视觉Transformers训练策略
  • 贪心区间类题目
  • npm改变npm缓存路径和改变环境变量
  • string到QString出现中文乱码
  • 【Linux精讲系列】——yum软件包管理
  • 浅谈一下Vue3的TreeShaking特性
  • 【牛牛送书 | 第二期】《ChatGPT 驱动软件开发:AI 在软件研发全流程中的革新与实践》
  • Qt基础之三十九:Qt Creator调试技巧
  • Docker Nginx安装使用以及踩坑点总结
  • 单位建数字档案室的意义和作用
  • JavaWeb——关于servlet种mapping地址映射的一些问题