# CMake 学习笔记 3 code-generation 之 configure-files

从零开始 CMake 学习笔记 3 code-generation 之 configure-files

开始前先默念三遍口诀：

• Declare a target
• Declare target’s traits
• It’s all about targets

本系列主要根据GitHub上的 cmake-examples 项目进行翻译总结，同时对于不清晰的概念及函数进行查阅理解记录形成。

1 介绍

代码生成可用于从通用描述文件创建不同语言的源代码。这可以减少手动编写代码的数量并增加互操作性。
什么意思呢？ 假如我需要在项目中注明一些依赖的版本号、编译时间等等，但我在编写 CMakeLists.txt 的时候我暂时还不知道，这时这种途径就可以找到这些信息，将其写到头文件中，再编译到可执行文件中。 具体怎么做呢，我们可以创建一个通用的文件，这个文件通过编译之后就会生成 头文件 ，我们只需要包含它的路径即可，这就是 configure_file() 函数。

1.1 文件树

configure-files $ tree
.
├── CMakeLists.txt
├── main.cpp
├── path.h.in
├── ver.h.in

1.2 文件简介

• CMakeLists.txt - 包含了你希望运行的 CMake 命令

cmake_minimum_required(VERSION 3.5)

// 设置项目名
project (cf_example)

// 设置项目版本
set (cf_example_VERSION_MAJOR 0)
set (cf_example_VERSION_MINOR 2)
set (cf_example_VERSION_PATCH 1)
set (cf_example_VERSION "${cf_example_VERSION_MAJOR}.${cf_example_VERSION_MINOR}.${cf_example_VERSION_PATCH}")

// configure_file()函数输入ver.h.in，通过编译就可以在  ${PROJECT_BINARY_DIR} 目录下生成ver.h
// ver.in.h文件中将 版本号赋值给 常量ver
configure_file(ver.h.in ${
   PROJECT_BINARY_DIR}/ver.h)

// configure_file()函数输入path.h.in，通过编译就可以在  ${PROJECT_BINARY_DIR} 目录下生成path.h
configure_file(path.h.in ${
   PROJECT_BINARY_DIR}/path.h @ONLY