cmake commandall CMake2.8.3 主索引 • 命令名称 • 用法 • 描述 •

文件名称: cmake command

所属分类: C++

开发工具:

文件大小: 484kb

下载次数: 0

上传时间: 2019-01-11

提供者: w13752******

下载 (484kb)

不能下载？报告错误

详细说明：all cmake command CMake2.8.3 主索引 • 命令名称 • 用法 • 描述 • 命令选项 • 生成器 • 命令 • 属性 • 全局域属性 • 目录属性 • 目标属性 • 测试属性 • 源代码属性 • Cache Entries属性 • 兼容性命令 • CMake 标准模块 • CMake策略 • 变量 • 改变行为的变量 • 描述系统的变量 • 语言变量 • 控制构建的变量 • 提供信息的变量 • 版权 • 其他参考资料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 regy, delete regv comspec, create symlink i:以向导模式运行 CMake 向导模式是在没有GUI时,交互式地运行 cmake的模式。 cmake会弹出一系列的提示,要求用户回答关于工程配置的一行问题。这些答复会被用来设置 cmake的缓存值。 -L[A][H]:列出缓存的变量中的非高级的变量 L选项会列出缓存变量会运行 CMake,并列出所有 CMake的内有被标记为 INTERNAL或者 ADVANCED的缓存变量。这会显示当前的 CMake配置信息,然后你可以用D选项改变这些选项。修改一些变量可能会引起更多的变量被创建出来。如果指定了A选项,那么命令也会显示高级变量。如果指定了H选项,那么命令会显示每个变量的帮助信息。 -- build:构建由 CMake生成的工程的二进制树。(这个选项的含义我不是很清楚一译注) 该选项川以下的选项概括∫内置构建工具的命令行荞面 ,而不是默认目标 config=对于多重配置工具,选择配置〈cfg>。 -- clean- first=首先构建目标的 clean伪目标,然后再构建。 (如果仅仅要 clean掉,使用 target' clean’选项。) 向内冒工具( native tools)传递剩余的选项。运行不带选项的 cmake- - build来获取快速帮助信息 -N:查看模式。仅仅加载缓存信息,并不实际运行配置和生成步骤。 ●-P:处理脚本模式。将给定的 cmake文件按照 CMake语言编写的脚本进行处理。不执行配置和生成步骤,不修改缓存信息。如果要使用-D选项定乂变量,-D选项必须在→P选项之前。 graphviz=[file]:生成依赖的 graphviz图生成一个 graphviz软件的输入文件,其中包括了项目中所有库和可执文件之间的依赖关系。 system- information[file]:输出与该系统相关的信息输出范围比较广的、与当前使用的系统有关的信息。如果在一个 CMake 工程的二进制构建树的顶端运行该命令,它还会打印一些附加信息,例如缓存,日志文件等等 - debug- trycompile:不删除“尝试编译”路径。不刖除那些为 try compile调用生成的路径。这在调试失败的 try compile文件时比较有用。不过,因为上一次“尝试编译”生成的旧的垃圾输出文件也许会导致一次不正确通过/不通过,且该结果与上次测试的结果不同,所以该选项可能会改变“尝试编译”的结果。对于某一次 “尝试编译”,该选项最好只用一次;并且仅仅在调试时使用。 debug- output:将 cmake设置为调试模式。在cake运行时,打印额外的信息:比如使用 message( send error)调用得到的栈跟踪信息。 trace:将 cmake设置为跟踪模式。用 message( send error)调用,打印所有调用生成的跟踪信息,以及这些调用发生的位置。(这句话含义不是很确定一译注。) help-command cmd[file]:打印单个命令cmd的帮助信息,然后退出。显示给定的命令的完整的文档。如果指定了[file参数,该文档会写入该文件,其输岀格式由该文件的后缀名确定。支持的文件类型有: man page, HTⅦL, DocBook以及纯文本。 help-command-1 ist [ file]:列出所有可用命令的清单,然后退出。该选项列出的信息含有所有命令的名字;其中,每个命令的帮助信息可以使用--help- command选项后跟一个命令名字得到。如果指定了[fi1e参数,帮助信息会写到ile中,输出格式依赖于文件名后缀。支持的文件格式包括: man page,HTML, DocBook以及纯文本。 help- commands[file]:打印所有命令的帮助文件,然后退出显示所有当前版木的命令的完整文档。如果指定了[ile参数,帮助信息会写到file中,输出格式依赖于文件名后缀。支持的文件格式包括:man page,HTML, DocBook以及纯文本。 help- compatcommands[file]:打印兼容性命令(过时的命令一译注) 的帮助信息。显示所有关于兼容性命令的完整文档。如果指定了[fi1e]参数,帮助信息会写到file中,输出格式依赖于文件名后缀。支持的文件格式包括:man page,HTML, Doc Book以及纯文本。 --help- module module [file]:打印某单一模块的帮助信息,然后退出打印关于给定模块的完整信息。如果指定了[fie]参数,帮助信息会写到 rile中,且输出格式依赖于文件名后缀。支持的文件格式包括: Inan page, HTⅦL, DocBook以及纯文本。 help-module-list[file]:列出所有可用模块名,然后退出。列出的清单包括所冇模块的名字;其中,每个模块的帮助信息可以使用 help-module选项,后跟模块名的方式得到。如果指定」[file]参数, 帮助信息会写到file中,且输岀格式依赖于文件名后缀。攴持的文件格式包括: man page,HTML, DocBook以及纯文本。 help-modules[file]:打印所有模块的帮助信息,然后退出。显示关于所有模块的完整文档。如果指定了[file参数,帮助信息会写到 rile中,且输出格式依赖于文件名后缀。支持的文件格式包括: man page, HTⅦ, DocBook以及纯文本。 -help- cus tom- modules[file]:打印所有自定义模块名,然后退出。显示所冇自定义模块的完整文档。如果指定了[file]参数,帮助信息会写刭file中,且输岀格式依赖于文件名后缀。支持的文件格式包括:manηpage, HTⅦL, DocBook以及纯文本。 help- policy cmp[file]:打印单个策略的帮助信息,然后退出显小给定的策略的完整文档。如果指定∫[file]参数,帮助信息会写到 file中,且输出格式依赖于文件名后缀。支持的文件格式包括: man page, HTⅦL, DocBook以及纯文本。 -help- policies[file]:打印所有策略的帮助信息,然后退出。显示所有策略的完整文档。如果指定了 File」参数,帮助信息会写到file 中,且输出格式依赖于文件名后缀。攴持的文件格式包括: man page,ITM, DocBook以及纯文本。 -help- property prop[file]:打印单个属性的帮助信息,然后退出。显示指定属性的完整文档。如果指定了[file参数,帮助信息会写到file 中,且输出格式依赖于文件名后缀。支持的文件格式包括: man page,HTIM, Doc Book以及纯文本。 - help- property-1 ist [file]:列出所有可用的属性,然后退出。该命令列出的清单包括所有属性的名字:其中,每个属性的帮助信息都可以通过--help- property选项后跟一个属性名的方式获得。如果指定了 [file]参数,帮助信息会写到file中,且输出格式依赖于文件名后缀支持的文件格式包括: man page,HTM, DocBook以及纯文本 help- properties file」:打印所有属性的帮助信息,然后退出。显示所有属性的完整文档。如果指定了[file参数,帮助信息会写到file 中,且输出格式依赖于文件名后缀。支持的文件格式包括: man page,HTML, DocBook以及纯文本。 help-variable var[file]:打印单个变量的帮助信息,然后退出。显示指定变量的完整文档。如果指定了[file]参数,帮助信息会写到file 中,且输出格式依赖于文件名后缀。支持的文件格式包括:maηpage,HTM, Doc Book以及纯文本。 help-variable-list[file]:列出文档中有记录的变量,然后退出。该命令列出的清单包括所有变量的名字;其中,每个变量的帮助信息都可以通过- help-variable选项后跟一个变量名的方式获得。如果指定了 [file]参数,帮助信息会写到file中,且输出格式依赖于文件名后缀支持的文件格式包括: man page,HTM, DocBook以及纯文本。 -help- variables file」:打印所有变量的帮助信息,然后退出。显小所有变量的完整帮助文档。如果指定∫[file]参数,帮助信息会写到 file中,且输出格式依赖于文件名后缀。支持的文件格式包括: man page, HTⅦL, DocBook以及纯文本。 - copyright[file:打印 CMake的版权信息,然后退出。如果指定了 File」参数,版权信息会写到这个文件中 --help:打印用法信息,然后退出。用法信息描述了基本的命令行界面及其选项。 --help-full[file:打印完整的帮助信息,然后退出。示大多数 UNIX man page提供的帮助信息。该选项是为非UⅥIX平台提供的;但是如果man手册页没有安装,它也能提供便利。如果制定了[file 参数,帮助信息会写到这个文件中。 -help- html File:以HTML格式打印完整的帮助信息,然后退出。 CMake的作者使用该选来帮助生成web页面。如果指定了[file]参数,帮助信息会写到这个文件中。 --help-man[file]:以UNIX的man于册页格式打印完整的帮助信息,然后退出。 cmake使用该选生成UNIX的man手册页。如果指定了[file]参数,帮助信息会写到这个文件中 -- version[file]:显示程序名/版本信息行,然后退出如果指定了[file]参数,版本信息会写到这个文件中二二二二二二二二二二二三二二二二三二二二二二对于 CMake的语言要素,比如命令,属性和变量,帮助命令选项也是很有规律的一般是用--help-xxx-1ist查看所有值的名字,找出感兴趣的项,然后用 help-xxx name查看该名字的详细信息;也可以用-help-xxs获得相关语言要素的完整帮助信息下一章将介绍“生成器” 生成器这节确实没有很多料,纯粹的流水账;不过为了完整,也还是给它点篇幅吧。卜·章将廾始我们真正的主题:-) 生成器在 CMake2.8.3平台上, CMake支持下列生成器: Borland makefiles:生成 Borland makefile。 MSYS Makefiles:生成 MSYS makefile 生成的 makefile用use/bin/sh作为它的shel1。在运行 CMake的机器上需要安装msys Mingw makefiles:生成供 mIngw32-make使用的 make file 生成的 makefile使用cmd.exe作为它的 shell。生成它们不需要mss或者 unix she1l。 NMake makefiles:生成 NMake makefile。 NMake Makefiles jom:生成 JO.M makefile Unix Makefiles:生成标准的 UNIX makefile。在构建树上牛成分层的 UNIX makefile。任何标准的UNIX风格的make程序都可以通过默认的make目标构建工程。生成的 makefile也提供了 insta11目标 Visual studio10:生成 Visual studio10工程文件。 Visual studio10Win64:生成 Visual studio10Win64工程文件。 Visual studio6:生成 Visual studio6工程文件。 Visual studio7:生成 Visual studio.NET2002工程文件。 ● Visual studio7.NET2003:生成 Visual studio.NET2003工程文件 Visual studio82005:生成 Visual studio.NET2005工程文件。 Visual Studio 8 2005 Win64: EE Visual Studio. net 2005 Win64 工程文件。 Visual studio92008:生成 Visual studio92008工程文件 Visual studio92008win64:生成 Visual studio92008Win64工程文件。 Watcom MAke:生成 Watcom Make makefiles Codeblocks- Mingw Makefiles:生成 Codeblock工程文件。在顶层目录以及每层子目录下为 Codeblocks生成工程文件,生成的 CMakelist.txt的特点是都包含一个 PROJECT(调用。除此之外还会在构建树上生成·套层次性的 makefile。通过默认的make目标,正确的make 程序可以构建这个工程。 makefile还提供∫ insta11日标。 Codeblocks- NMake makefiles:生成 Codeblocks工程文件在顶层目录以及每层子目录下为 Codeblocks生成工程文件,生成的 CMakelist.txt的特点是都包含一个 PROJECT(调用。除此之外还会在构建树上生成一套层次性的 makefile。通过默认的make目标,正确的mdke 程序可以构建这个工程。 makefile还提供了 insta11目标 Codeblocks- Unix makefiles:生成 Codeblocks工程文件。在顶层目录以及每层子目录下为 Codeblocks生成工程文件,生成的 CMakelist.txt的特点是都包含一个 PROJECT O调川。除此之外还会在构建树上生成一套层次性的 makefile。通过默认的make目标,正确的make 程序可以构建这个工程。 makefile还提供了 install目标。 Eclipse cdt4- Mingw makefiles:生成 Eclipse cdt4.0工程文件。在顶层目录下为 Eclipse生成工程文件。在运行源码外构建时,一个连接到顶层源码路径的资源文件会被创建。除此之外还会在构建树上生成一套层次性的 makefile。通过默认的make日标,正确的make程序可以构建这个工程。 makefile还提供了 insta11目标 Eclipse CDt4- NMake makefiles:生成 Eclipse cdt4.0工程文件。在顶层目录下为 Eclipse生成工程文件。在运行源码外构建时,一个连接到顶层源码路径的资源文件会被创建。除此之外还会在构建树上生成一套层次性的 makefile。通过默认的make目标,正确的make程序可以枃建这个工程。 makefile还提供∫ insta11日标。 Eclipse CDt4- Unix Makefiles:生成 Eclipse cdt4.0工程文件。在顶层目录下为 Eclipse生成工程文件。在运行源码外构建时,一个连接到顶层源码路径的瓷源文件会被创建。除此之外还会在构建树上生成一套层次性的 makefile。通过默认的make目标,正确的make程序可以构建这个工程。 makefile还提供了 ins ta11目标。 Make手册的客套话总算说完了,廾始进入止题。第一部分是 CMake命令, 命令就相当于命令行下操作系统提供的各种命令,重要性不言而喻;可以说,这些命令是 CMake构建系统的骨架。CMke2.8.3共有80条命令,分别是 add custom command, add custom target, add definitions, add dependencies, add executable, add library, add subdirectory add test, aux source directory break, build command cmake minimum required, cmake policy, configure file, create test sourcelist, define property, else, elseif, enable language enable testing, endforeach, endfunction, endif, endmacro, endwhile, execute process, export, file, find file, find library, find package lind path, find program, flik wrap ui, foreach, function, get cmake property, get directory property, get filename component, get property, get source file property, get target property, get test property, if, include, include directories include external sproject, include regular expression, install, link directories, list. load cache. load command. macro mark as advanced, math, message, option, output required files, project, at wrap cpp gt wrap ui, remove definitions, return, separate arguments set, set directory properties, set property set source files properties, set target properties set tests properties, site name, source group, string, target link libraries, try compile, try run, unset, variable watch while。这些命令在手册中是字典序排列的:为了便于查找,翻译也按照字典序来组织。但是在翻译结束后,会对命令进行小结,与大家讨论一下这些命令的使用方法和使用吋机 CMD#1: add cus tom comnand为生成的构建系统添加一条自定义的构建规则 add custom command命令冇两种主要的功能;第种是为了生成输出文件,添加一·条自定义命令, add cus tc conmnand(OUTPUT output loutput2 .. COMMAND command1「 ARGS T「args1...1 [COMMAND d2 [ARGS I [MAIN DEPENDENCY depend] L DEPENDS [depends..I [IMPLICIT DEPENDS derend1 ⊥NGD⊥ RECTO ORY C. COMMFNT comment] [VERBATTM] [APPEN)1) 这种命令格式定义了一条生成指定的文件(文件组)的生成命令。在相同路径下创建的目标( CMakelists.txt文件)—一任何自定义命令的输出都作为它的源文件一一被设置了一条规则:在构建的时候,使用指定的命令来生成这些文件。如果一个输出文件名是相对路径,它将被解释成相对于构建树路径的相对路径,并且与当前源码路径是对应的。注意, MAIN DEPENDENCY完全是可选的,它用来向 visual studio建议在何处停止自定义命令。对于各种类型的 makefile 而言,这条命令创建了一个格式如下的新目标: OUTPUT: MAIN DEPENDENCY DEPENDS COMMAND 如果指定了多于一条的命令,它们会按顺序执行。ARGS参数是可选的,它的存在是为了保持问后兼容,以后会被忽略掉

(系统自动生成,下载前可以参看下载内容)