文档章节

CMake 手册详解(一)

小代码2016
 小代码2016
发布于 2015/01/19 14:47
字数 1386
阅读 42
收藏 0

CMake 手册详解(一)

      公司的一个项目使用CMake作为跨平台构建工具;业务有需求,当然要好好研读一下官方的技术手册。目前的计划是先把官方手册翻译一下,了解清楚CMake中的各种命令、属性和变量的用法。同时在工作中也会阅读CMake的真实源码,后续会基于此陆续写一些工程中使用CMake的心得。CMake的版本也在不停更新,有些新的命令和变量会随着版本更新添加进来,这是后事了,暂且不管;现在锁定CMake 2.8.3作为手册翻译的版本。

      作为园子里的新丁,文章在术语和表达等等方面会有欠缺的地方,还请大侠们慷慨指点。另外,罗马不是一天建成的,长长的手册翻译完也不知道要经历多少日升月落;不过还是希望自己能够坚持下去:-)。

 CMake2.8.3 主索引

  • 命令名称
  • 用法
  • 描述
  • 命令选项
  • 生成器
  • 命令
  • 属性
  • 全局域属性
  • 目录属性
  • 目标属性
  • 测试属性
  • 源代码属性
  • Cache Entries属性
  • 兼容性命令
  • CMake 标准模块
  • CMake策略
  • 变量
  • 改变行为的变量
  • 描述系统的变量
  • 语言变量
  • 控制构建的变量
  • 提供信息的变量
  • 版权
  • 其他参考资料

命令名称

     cmake - 跨平台Makefile生成工具。

用法

  cmake [选项] <源码路径>

  cmake [选项] <现有构建路径>

描述

  cmake可执行程序是CMake的命令行界面。它可以用脚本对工程进行配置。工程配置设置可以在命令行中使用-D选项指定。使用-i选项,cmake将通过提示交互式地完成该设置。

  CMake是一个跨平台的构建系统生成工具。它使用平台无关的CMake清单文件CMakeLists.txt,指定工程的构建过程;源码树的每个路径下都有这个文件。CMake产生一个适用于具体平台的构建系统,用户使用这个系统构建自己的工程。

选项

 

-C <initial-cache>: 预加载一个脚本填充缓存文件。
  当cmake在一个空的构建树上第一次运行时,它会创建一个CMakeCache.txt文件,然后向其中写入可定制的项目设置数据。-C选项可以用来指定一个文件,在第一次解析这个工程的cmake清单文件时,从这个文件加载缓存的条目(cache entries)信息。被加载的缓存条目比项目默认的值有更高的优先权。参数中给定的那个文件应该是一个CMake脚本,其中包含有使用CACHE选项的SET命令;而不是一个缓存格式的文件。

-D <var>:<type>=<value>: 创建一个CMake的缓存条目。

  当cmake第一次运行于一个空的构建数时,它会创建一个CMakeCache.txt文件,并且使用可定制的工程设置来填充这个文件。这个选项可以用来指定优先级高于工程的默认值的工程设置值。这个参数可以被重复多次,用来填充所需要数量的缓存条目(cache entries)。

-U <globbing_expr>: 从CMake的缓存文件中删除一条匹配的条目。
  该选项可以用来删除CMakeCache.txt文件中的一或多个变量。文件名匹配表达式(globbing expression)支持通配符*和?的使用。该选项可以重复多次以删除期望数量的缓存条目。使用它时要小心,你可能因此让自己的CMakeCache.txt罢工。

-G <generator-name>: 指定一个makefile生成工具。

  在具体的平台上,CMake可以支持多个原生的构建系统。makefile生成工具的职责是生成特定的构建系统。可能的生成工具的名称将在生成工具一节给出。

-Wno-dev: 抑制开发者警告。

  抑制那些为CMakeLists.txt文件的作者准备的警告信息。

-Wdev: 使能开发者警告信息输出功能。

  允许那些为CMakeLists.txt文件的作者准备的警告信息。

-E: CMake命令行模式。
  为了真正做到与平台无关,CMake提供了一系列可以用于所有系统上的的命令。以-E参数运行CMake会帮助你获得这些命令的用法。可以使用的命令有:chdir, copy, copy_if_different copy_directory, compare_files, echo, echo_append, environment, make_directory, md5sum, remove_directory, remove, tar, time, touch, touch_nocreate, write_regv, delete_regv, comspec, create_symlink。

-i: 以向导模式运行CMake。

  向导模式是在没有GUI时,交互式地运行cmake的模式。cmake会弹出一系列的提示,要求用户回答关于工程配置的一行问题。这些答复会被用来设置cmake的缓存值。

-L[A][H]: 列出缓存的变量中的非高级的变量。
  -L选项会列出缓存变量会运行CMake,并列出所有CMake的内有被标记为INTERNAL或者ADVANCED的缓存变量。这会显示当前的CMake配置信息,然后你可以用-D选项改变这些选项。修改一些变量可能会引起更多的变量被创建出来。如果指定了A选项,那么命令也会显示高级变量。如果指定了H选项,那么命令会显示每个变量的帮助信息。

=========================================================================

好了,今天先翻到这里。开饭喽~~

<<<------------- 欢迎转载;转载请标明出处。 ------------->>>

本文转载自:http://www.cnblogs.com/coderfenghc/archive/2012/06/16/CMake_ch_01.html

小代码2016
粉丝 45
博文 328
码字总数 153495
作品 0
安阳
程序员
私信 提问
DuiLib在VS2012下的编译

DuiLib在VS2012下的编译 DuiLib在VS2012下的编译 一. 直接修改*.vcxproj 1.修改vcxproj文件 2.使用VS2012打开工程 3.修改对应Plamtform Toolset 3.编译报错 error C2065 ;代码加一回车,编译...

MtrS
05/08
0
0
cmake命令 安装、用法简介

前言: cmake是kitware公司以及一些开源开发者在开发几个工具套件(VTK)的过程中所产生的衍生品。后来经过发展,最终形成体系,在2001年成为一个独立的开放源代码项目。其官方网站是www.cmake...

烦恼的大胖
2011/05/25
0
4
在 linux 下使用 CMake 构建应用程序

CMake 是一个跨平台的自动化建构系统,它使用一个名为 CMakeLists.txt 的文件来描述构建过程,可以产生标准的构建文件,如 Unix 的 Makefile 或Windows Visual C++ 的 projects/workspaces 。文...

红薯
2009/02/06
872
0
使用Cmake生成跨极速赛车平台出租平台项目编译解决方案

项目最近有需求在windows下面运行,我花了几周时间将linux的服务器移植到windows下面,目前已经能够正常运行服务器,目前又有了新需求,两边的代码结构和组织是分开的,因此为了两边能够同步...

inuuns
2018/07/10
0
0
CentOS下编译安装MySQL5.5.x的版本需使用Cmake编译器

PS:在以往的工作中,公司线上的服务器90%都使用MySQL数据库,性能也相当的稳定;所以一直都在用MySQL5.0.x、5.1.x、5.2.x之间的版本,前天朋友突然问我使用过Mysql5.5.X版本的没有,才发现源...

晨风微凉
2018/06/28
0
0

没有更多内容

加载失败,请刷新页面

加载更多

智慧酒店方案能给酒店带来什么?

酒店在升级的过程中,智慧酒店在品牌升级最后的归属。那么智慧酒店方案可以为酒店带来怎么样的经济效益呢?智慧酒店主要是可以降低运营成本。此外,智慧酒店也能提高客人体验度。 那什么叫智慧...

非思丸FaceTo
17分钟前
5
0
金融壹账通黄润中:“5G到来将使金融科技取得突破性颠覆”

最近一个月,伴随着气温的升高,5G的热度也在不断提升。6月初,5G商用牌照正式发布,5G手机紧随其后在各地亮相。5G技术也给金融领域带来了深远影响,金融机构如何抓住5G时代的机遇和挑战,实...

IFTNews
27分钟前
7
0
怎么才能在远程桌面让电脑不休眠

  想要在使用远程桌面时,不然电脑休眠,那么,按照下面的操作去进行就可以了。   在建立连接之前,进入控制面板,找到电源选项,把所有关闭显示器等方面的功能全部调成“从不”,然后开...

takethelas
30分钟前
4
0
android opencv实现人脸检测 以及 年龄和性别识别

支持技术分享,转载或复制,请指出文章来源此博客作者为Jack__0023 1、背景 因为面对的场景不同,所以我上次使用 android 提供的人脸检测 已经不能满足我的使用,因为长时间开启,他会出现各...

jack__0023
39分钟前
9
0
JDK动态代理[4]----ProxyGenerator生成代理类的字节码文件解析

通过前面几篇的分析,我们知道代理类是通过Proxy类的ProxyClassFactory工厂生成的,这个工厂类会去调用ProxyGenerator类的generateProxyClass()方法来生成代理类的字节码。ProxyGenerator这个...

xiaomin0322
40分钟前
6
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部