cpack(1)¶
概要¶
cpack [<options>]
描述¶
The cpack 可执行文件是 CMake 打包程序。它以多种格式生成安装程序和源代码包。
对于每种安装程序或软件包格式,cpack 都有一个特定的后端,称为“generator”(生成器)。生成器负责生成所需的输入并调用特定的软件包创建工具。这些安装程序或软件包生成器不应与 cmake
命令的 makefile 生成器混淆。
所有受支持的生成器都在 cpack-generators
手册中指定。cpack --help
命令会打印目标平台支持的生成器列表。要使用哪些生成器可以通过 CPACK_GENERATOR
变量或通过命令行选项 -G
来选择。
cpack 程序由使用 CMake language
编写的配置文件来引导。除非通过命令行选项 --config
另行选择,否则将使用当前目录中的 CPackConfig.cmake
文件。
在标准的 CMake 工作流程中,CPackConfig.cmake
文件由 cmake
可执行文件生成,前提是项目中的 CMakeLists.txt
文件包含了 CPack
模块。
选项¶
- -G <generators>¶
<generators>
是生成器名称的分号分隔列表。cpack 将遍历此列表,并根据CPackConfig.cmake
配置文件中提供的详细信息,以该生成器的格式生成软件包。如果未提供此选项,则CPACK_GENERATOR
变量确定将使用的默认生成器集。
- -C <configs>¶
指定要打包的项目配置(例如,
Debug
、Release
等),其中<configs>
是一个分号分隔列表。当 CMake 项目使用多配置生成器(如 Xcode 或 Visual Studio)时,需要此选项来告诉 cpack 要在软件包中包含哪些已构建的可执行文件。用户负责确保在调用 cpack 之前,列出的配置已构建完成。
- -D <var>=<value>¶
设置一个 CPack 变量。这将覆盖 cpack 读取的输入文件中为
<var>
设置的任何值。
- --config <configFile>¶
指定由 cpack 读取的配置文件,以提供打包详细信息。默认情况下,将使用当前目录中的
CPackConfig.cmake
。
- -V, --verbose¶
以 verbose 输出运行 cpack。这可以用于显示来自软件包生成工具的更多详细信息,并且适合项目开发人员。
- --debug¶
以 debug 输出运行 cpack。此选项主要供 cpack 本身的开发人员使用,项目开发人员通常不需要它。
- --trace¶
将底层 cmake 脚本置于 trace 模式。
- --trace-expand¶
将底层 cmake 脚本置于 expanded trace 模式。
- -P <packageName>¶
覆盖/定义用于打包的
CPACK_PACKAGE_NAME
变量的值。在CPackConfig.cmake
文件中为此变量设置的任何值都将被忽略。
- -R <packageVersion>¶
覆盖/定义用于打包的
CPACK_PACKAGE_VERSION
变量的值。它将覆盖在CPackConfig.cmake
文件中设置的值,或从CPACK_PACKAGE_VERSION_MAJOR
、CPACK_PACKAGE_VERSION_MINOR
和CPACK_PACKAGE_VERSION_PATCH
自动计算的值。
- -B <packageDirectory>¶
覆盖/定义
CPACK_PACKAGE_DIRECTORY
,它控制 CPack 将执行打包工作的目录。默认情况下,生成的软件包将在此位置创建,并且还将在该目录下创建一个_CPack_Packages
子目录,用作软件包创建期间的工作区。
- --vendor <vendorName>¶
覆盖/定义
CPACK_PACKAGE_VENDOR
。
- --preset <presetName>¶
使用来自
cmake-presets(7)
的预设。
- --list-presets¶
列出来自
cmake-presets(7)
的预设。
- -version [<file>], --version [<file>], /V [<file>]¶
显示程序名称/版本横幅并退出。如果给定,输出将打印到指定的
<file>
。
- -h, -H, --help, -help, -usage, /?¶
打印用法信息并退出。
用法描述了基本的命令行界面及其选项。
- --help <keyword> [<file>]¶
打印一个 CMake 关键字的帮助。
<keyword>
可以是属性、变量、命令、策略、生成器或模块。The relevant manual entry for
<keyword>
的相关手册条目以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。在 3.28 版本中变更: 在 CMake 3.28 之前,此选项仅支持命令名称。
- --help-full [<file>]¶
打印所有帮助手册并退出。
所有手册都以人类可读的文本格式打印。如果给定,输出将打印到指定的
<file>
。
- --help-manual <man> [<file>]¶
打印一个帮助手册并退出。
指定的手册以人类可读的文本格式打印。如果给定,输出将打印到指定的
<file>
。
- --help-manual-list [<file>]¶
列出可用的帮助手册并退出。
该列表包含所有可以使用
--help-manual
选项后跟手册名称来获取帮助的手册。如果给定,输出将打印到指定的<file>
。
- --help-command <cmd> [<file>]¶
打印一个命令的帮助并退出。
<cmd>
的cmake-commands(7)
手册条目以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。
- --help-command-list [<file>]¶
列出提供帮助的命令并退出。
该列表包含所有可以使用
--help-command
选项后跟命令名称来获取帮助的命令。如果给定,输出将打印到指定的<file>
。
- --help-commands [<file>]¶
打印 cmake-commands 手册并退出。
cmake-commands(7)
手册以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。
- --help-module <mod> [<file>]¶
打印一个模块的帮助并退出。
<mod>
的cmake-modules(7)
手册条目以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。
- --help-module-list [<file>]¶
列出提供帮助的模块并退出。
该列表包含所有可以使用
--help-module
选项后跟模块名称来获取帮助的模块。如果给定,输出将打印到指定的<file>
。
- --help-modules [<file>]¶
打印 cmake-modules 手册并退出。
cmake-modules(7)
手册以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。
- --help-policy <cmp> [<file>]¶
打印一个策略的帮助并退出。
<cmp>
的cmake-policies(7)
手册条目以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。
- --help-policy-list [<file>]¶
列出提供帮助的策略并退出。
该列表包含所有可以使用
--help-policy
选项后跟策略名称来获取帮助的策略。如果给定,输出将打印到指定的<file>
。
- --help-policies [<file>]¶
打印 cmake-policies 手册并退出。
cmake-policies(7)
手册以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。
- --help-property <prop> [<file>]¶
打印一个属性的帮助并退出。
<prop>
的cmake-properties(7)
手册条目以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。
- --help-property-list [<file>]¶
列出提供帮助的属性并退出。
该列表包含所有可以使用
--help-property
选项后跟属性名称来获取帮助的属性。如果给定,输出将打印到指定的<file>
。
- --help-properties [<file>]¶
打印 cmake-properties 手册并退出。
cmake-properties(7)
手册以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。
- --help-variable <var> [<file>]¶
打印一个变量的帮助并退出。
<var>
的cmake-variables(7)
手册条目以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。
- --help-variable-list [<file>]¶
列出提供帮助的变量并退出。
该列表包含所有可以使用
--help-variable
选项后跟变量名称来获取帮助的变量。如果给定,输出将打印到指定的<file>
。
- --help-variables [<file>]¶
打印 cmake-variables 手册并退出。
cmake-variables(7)
手册以人类可读的文本格式打印。如果给定,输出将打印到指定的<file>
。
参见¶
以下资源可用于获取使用 CMake 的帮助
- 首页
-
学习 CMake 的主要起点。
- 在线文档和社区资源
https://cmake.com.cn/documentation
可用文档和社区资源的链接可以在此网页上找到。
- Discourse 论坛
-
Discourse 论坛托管关于 CMake 的讨论和问题。