CMake中文手册.docx

CMake手册本文来源:erfenghc/目录:CMD#CMake用法导览 Preface:本文是CMake官方文档CMakeTutorial(ke/help/)的翻译。通过一个样例工程从简单到复杂的完善过程,文档介绍了CMake主要模块(cmake,ctest,cpack)的功能和使用环境;从中可以一窥cmake的大体形貌。正文如下:    本文下述内容是一个手把手的使用指南;它涵盖了CMake需要解决的公共构建系统的一些问题。这些主题中的许多主题已经在MasteringCMake一书中以单独的章节被介绍过,但是通过一个样例工程看一看它们如何工作也是非常有帮助的。本指南可以在CMake源码树的Tests/Tutorial路径下找到。每一步都有它自己的子路径,其中包含该步骤的一个完整的指南。作为基础的起始点(步骤1) 最基本的工程是一个从源代码文件中构建可执行文件的例子。对于简单工程,只要一个两行的CMakeLists文件就足够了。这将会作为我们指南的起点。这份CMakeLists文件看起来像是这样:?123cmake_minimum_required()project(Tutorial)add_executable() 注意到这个例子在CMakeLists文件中使用了小写。CMake支持大写、小写、混合大小写的命令。,并且它的第一版非常简单,如下所示:?//putesthesquarerootofanumber//计算一个数的平方根的简单程序#include<>#include<>#include<>intmain(intargc,char*argv[]){  if(argc<2)    {    fprintf(stdout,"Usage:%snumber\n",argv[0]);    return1;    }  doubleinputValue=atof(argv[1]);  doubleoutputValue=sqrt(inputValue);  fprintf(stdout,"Thesquarerootof%gis%g\n",          inputValue,outputValue);  return0;}     我们添加的第一个特性用来为工程和可执行文件指定一个版本号。虽然你可以在源代码中唯一指定它,但是你在CMakeLists文件中指定它可以提供更好的灵活性。如下所示,我么可以通过添加一个版本号来修改CMakeLists文件:?cmake_minimum_required()project(Tutorial)#版本号set(Tutorial_VERSION_MAJOR1)set(Tutorial_VERSION_MINOR0)#配置一个头文件,通过它向源代码中传递一些CMake设置。configure_file(  "${PROJECT_SOURCE_DIR}/"  "${PROJECT_BINARY_DIR}/"  )#将二进制文件树添加到包含文件的搜索路径中,("${PROJECT_BINARY_DIR}")#添加可执行文件add_executable()     由于配置过的文件将会被写到二进制文件目录下,我们必须把该目录添加到包含文件的搜索路径清单中。然后,:?123//与tutorial相关的配置好的选项与设置;#utorial_VERSION_******@Tutorial_VERSION_MAJOR@#utorial_VERSION_******@Tutorial_VERSION_MINOR@     当CMake配置这份头文件时,***@Tutorial_VERSION_MAJOR@和***@Tutorial_VERSION_MINOR@的值将会被从CMakeLists文件中传递过来的值替代。下一步,。修改过的源代码展列于下:?12345678910111213141516171819202122//计算平方根的简单程序。#include<>#include<>#include<>#includ