CMake手册详解:(一)开始篇

前言

CMake是目前比较流行的跨平台构建工具,接触过跨平台项目的小伙伴应该都对他很熟悉。为了能更好的学习CMake,我打算从CMake官网的开发手册入手,系统的学习 CMake。CMake的版本也在不停更新,有些新的命令和变量会随着版本更新添加进来,,这是后事了,暂且不管;现在锁定CMake 2.8.12作为手册翻译的版本。(因为目前ubuntu系统的最新版本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生成工具的职责是生成特定的构建系统。可能的生成工具的名称将在生成工具一节给出。

-T [toolset-name]: 指定支持的特殊的生成工具   在具体平台上,CMake支持选择编译器给原生的构建系统,这项功能目前只在特殊的生成器环境下才支持:Visual Studio >= 10或Xcode >= 3.0 具体的工具名称请参见原生构建系统文档。

-Wno-dev: 抑制开发者警告。   抑制那些为CMakeLists.txt文件的作者准备的警告信息。

-Wdev: 使能开发者警告信息输出功能。   允许那些为CMakeLists.txt文件的作者准备的警告信息。    -E: CMake命令行模式。

-i: 以向导模式运行CMake。   向导模式是在没有GUI时,交互式地运行cmake的模式。cmake会弹出一系列的提示,要求用户回答关于工程配置的一行问题。这些答复会被用来设置cmake的缓存值。    -L[A][H]: 列出缓存的变量中的非高级的变量。

–build [dir]: 构建由CMake生成的工程的二进制树。   该选项用以下的选项概括了内置构建工具的命令行界面   [dir]= 待创建的工程二进制路径。   –target [tgt] = 构建[tgt],而不是默认目标。   –config [cfg] = 对于多重配置工具,选择配置[cfg]。   –clean-first = 首先构建目标的clean伪目标,然后再构建。   (如果仅仅要clean掉,使用–target ‘clean’选项。)   –= 向内置工具(native tools)传递剩余的选项。   运行不带选项的cmake –build来获取快速帮助信息。    -N: 查看模式。   仅仅加载缓存信息,并不实际运行配置和生成步骤。    -P [file]: 处理脚本模式。

–find-package: 运行pkg-config模式。   使用find_package()搜索一个软件包并且把结果打印出来。可以使用 CMake来代替pkg-config来查找安装的二进制软件包,在Makefile-based的工程或autoconf-based工程。    –graphviz=[file]: 生成依赖的graphviz图。   生成一个graphviz软件的输入文件,其中包括了项目中所有库和可执行文件之间的依赖关系。    –system-information [file]: 输出与该系统相关的信息。

–debug-trycompile: 不删除“尝试编译”路径。   不删除那些为try_compile调用生成的路径。这在调试失败的try_compile文件时比较有用。不过,因为上一次“尝试编译”生成的旧的垃圾输出文件也许会导致一次不正确通过/不通过,且该结果与上次测试的结果不同,所以该选项可能会改变“尝试编译”的结果。对于某一次“尝试编译”,该选项最好只用一次;并且仅仅在调试时使用。    –debug-output: 将cmake设置为调试模式。   在cmake运行时,打印额外的信息;比如使用message(send_error)调用得到的栈跟踪信息。    –trace: 将cmake设置为跟踪模式。   用message(send_error )调用,打印所有调用生成的跟踪信息,以及这些调用发生的位置。

–warn-uninitialized: 警告没有初始化的变量。   如果有未初始化的变量,则打印警告信息。

–warn-unused-vars: 警告没有使用的变量。   找到那些声明或赋值的,但是没有使用的变量。    –no-warn-unused-cli: 不警告在命令行声明但未使用的变量。   不找那些在命令行声明的,但是没有使用的变量。    –check-system-vars: 在系统文件目录里也检测有问题的变量。   通常,未使用和没有初始化的变量都是在CMAKE_SOURCE_DIR和CMAKE_BINARY_DIR目录下查找。这个标志让CMake在其他文件查找也能发出警告。    –help-command cmd [file]: 打印单个命令cmd的帮助信息,然后退出。   显示给定的命令的完整的文档。如果指定了[file]参数,该文档会写入该文件,其输出格式由该文件的后缀名确定。支持的文件类型有:man page,HTML,DocBook以及纯文本。    –help-command-list [file]: 列出所有可用命令的清单,然后退出。   该选项列出的信息含有所有命令的名字;其中,每个命令的帮助信息可以使用–help-command选项后跟一个命令名字得到。如果指定了[file]参数,帮助信息会写到file中,输出格式依赖于文件名后缀。支持的文件格式包括:man page,HTML,DocBook以及纯文本。

前有阻碍,奋力把它冲开,运用炙热的激情,

CMake手册详解:(一)开始篇

相关文章:

你感兴趣的文章:

标签云: