CPackIFW¶

在 3.1 版本加入.

此模块查找随“Qt 安装程序框架 <http://doc.qt.io/qtinstallerframework/index.html>”(QtIFW) 一起提供的命令行实用程序的位置。

该模块还定义了几个命令来控制 CPack IFW Generator 的行为。

命令¶

该模块定义了以下命令：

cpack_ifw_configure_component¶

设置特定于 CPack IFW 生成器的参数。

cpack_ifw_configure_component(<compname> [COMMON] [ESSENTIAL] [VIRTUAL]
                    [FORCED_INSTALLATION] [REQUIRES_ADMIN_RIGHTS]
                    [NAME <name>]
                    [DISPLAY_NAME <display_name>] # Note: Internationalization supported
                    [DESCRIPTION <description>] # Note: Internationalization supported
                    [UPDATE_TEXT <update_text>]
                    [VERSION <version>]
                    [RELEASE_DATE <release_date>]
                    [SCRIPT <script>]
                    [PRIORITY|SORTING_PRIORITY <sorting_priority>] # Note: PRIORITY is deprecated
                    [DEPENDS|DEPENDENCIES <com_id> ...]
                    [AUTO_DEPEND_ON <comp_id> ...]
                    [LICENSES <display_name> <file_path> ...]
                    [DEFAULT <value>]
                    [USER_INTERFACES <file_path> <file_path> ...]
                    [TRANSLATIONS <file_path> <file_path> ...]
                    [REPLACES <comp_id> ...]
                    [CHECKABLE <value>])

此命令应在 cpack_add_component() 命令之后调用。

常见

如果已设置，则该组件将作为其所属组的一部分进行打包和安装。

基本

在 3.6 版本加入.

如果设置，则包管理器将保持禁用状态，直到更新该组件。

虚拟

在 3.8 版本加入.

如果设置，则该组件将对安装程序隐藏。它等同于 cpack_add_component() 命令中的 HIDDEN 选项。

强制安装

在 3.8 版本加入.

如果设置，则必须始终安装该组件。它等效于 cpack_add_component() 命令中的 REQUIRED 选项。

REQUIRES_ADMIN_RIGHTS

在 3.8 版本加入.

如果组件需要以提升的权限安装，请设置它。

名字

用于为此组件创建类似域的标识。默认情况下使用原始组件名称。

DISPLAY_NAME

在 3.8 版本加入.

设置重写由 cpack_add_component() 命令配置的原始名称。

描述

在 3.8 版本加入.

设置重写由 cpack_add_component() 命令配置的原始描述。

更新文本

在 3.8 版本加入.

如果这是对组件的更新，则将添加到组件描述中。

版本

是组件的版本。默认使用 CPACK_PACKAGE_VERSION。

发布日期

在 3.8 版本加入.

留空自动生成。

脚本

是此组件的操作脚本的相对或绝对路径。

SORTING_PRIORITY

在 3.8 版本加入.

是树中组件的优先级。

优先级

自 3.8 版本弃用: SORTING_PRIORITY 的旧名称。

取决于，依赖

在 3.8 版本加入.

QtIFW 样式的依赖组件或组件组标识符列表。

在 3.21 版本加入.

作为依赖项列出的组件或组名称可能包含连字符。这需要 QtIFW 3.1 或更高版本。

AUTO_DEPEND_ON

在 3.8 版本加入.

此组件具有自动依赖性的 QtIFW 样式的组件或组件组的标识符列表。

许可证

此组件的一对 <display_name> 和 <file_path> 许可文本。您可以指定多个许可证。

默认

在 3.8 版本加入.

可能的值为：TRUE、FALSE 和 SCRIPT。设置为 FALSE 以禁用安装程序中的组件或设置为 SCRIPT 以在运行时解析（不要忘记将脚本文件添加为 SCRIPT 选项的值）。

用户界面

在 3.7 版本加入.

是代表要加载的页面的 <file_path>（'.ui' 文件）列表。

翻译

在 3.8 版本加入.

是代表要加载的翻译的 <file_path>（'.qm' 文件）列表。

替换

在 3.10 版本加入.

要替换的组件或组件组的标识符列表。

可检查

在 3.10 版本加入.

可能的值是：TRUE、FALSE。如果要隐藏项目的复选框，请设置为 FALSE。当只应选择几个子组件而不是全部时，这很有用。

cpack_ifw_configure_component_group¶

设置特定于 CPack IFW 生成器的参数。

cpack_ifw_configure_component_group(<groupname> [VIRTUAL]
                    [FORCED_INSTALLATION] [REQUIRES_ADMIN_RIGHTS]
                    [NAME <name>]
                    [DISPLAY_NAME <display_name>] # Note: Internationalization supported
                    [DESCRIPTION <description>] # Note: Internationalization supported
                    [UPDATE_TEXT <update_text>]
                    [VERSION <version>]
                    [RELEASE_DATE <release_date>]
                    [SCRIPT <script>]
                    [PRIORITY|SORTING_PRIORITY <sorting_priority>] # Note: PRIORITY is deprecated
                    [DEPENDS|DEPENDENCIES <com_id> ...]
                    [AUTO_DEPEND_ON <comp_id> ...]
                    [LICENSES <display_name> <file_path> ...]
                    [DEFAULT <value>]
                    [USER_INTERFACES <file_path> <file_path> ...]
                    [TRANSLATIONS <file_path> <file_path> ...]
                    [REPLACES <comp_id> ...]
                    [CHECKABLE <value>])

此命令应在 cpack_add_component_group() 命令之后调用。

虚拟

在 3.8 版本加入.

如果设置，则该组将对安装程序隐藏。请注意，在根组件上设置此设置不起作用。

强制安装

在 3.8 版本加入.

如果设置，则必须始终安装该组。

REQUIRES_ADMIN_RIGHTS

在 3.8 版本加入.

如果组件组需要以提升的权限安装，请设置它。

名字

用于为此组件组创建类似域的标识。默认情况下使用原始组件组名称。

DISPLAY_NAME

在 3.8 版本加入.

设置重写由 cpack_add_component_group() 命令配置的原始名称。

描述

在 3.8 版本加入.

设置重写由 cpack_add_component_group() 命令配置的原始描述。

更新文本

在 3.8 版本加入.

如果这是对组件组的更新，将被添加到组件组描述中。

版本

是组件组的版本。默认使用 CPACK_PACKAGE_VERSION。

发布日期

在 3.8 版本加入.

留空自动生成。

脚本

是此组件组的操作脚本的相对或绝对路径。

SORTING_PRIORITY

是树中组件组的优先级。

优先级

自 3.8 版本弃用: SORTING_PRIORITY 的旧名称。

取决于，依赖

在 3.8 版本加入.

QtIFW 样式的依赖组件或组件组标识符列表。

在 3.21 版本加入.

作为依赖项列出的组件或组名称可能包含连字符。这需要 QtIFW 3.1 或更高版本。

AUTO_DEPEND_ON

在 3.8 版本加入.

该组件组具有自动依赖性的 QtIFW 样式的组件或组件组的标识符列表。

许可证

此组件组的一对 <display_name> 和 <file_path> 许可证文本。您可以指定多个许可证。

默认

在 3.8 版本加入.

可能的值为：TRUE、FALSE 和 SCRIPT。设置为 TRUE 以预选安装程序中的组（这仅对没有可见子组件的组有效）或设置为 SCRIPT 以在运行时解析（不要忘记将脚本文件添加为 ``SCRIPT 的值``选项）。

用户界面

在 3.7 版本加入.

是代表要加载的页面的 <file_path>（'.ui' 文件）列表。

翻译

在 3.8 版本加入.

是代表要加载的翻译的 <file_path>（'.qm' 文件）列表。

替换

在 3.10 版本加入.

要替换的组件或组件组的标识符列表。

可检查

在 3.10 版本加入.

可能的值是：TRUE、FALSE。如果要隐藏项目的复选框，请设置为 FALSE。当只应选择几个子组件而不是全部时，这很有用。

cpack_ifw_add_repository¶

将 QtIFW 特定的远程存储库添加到二进制安装程序。

cpack_ifw_add_repository(<reponame> [DISABLED]
                    URL <url>
                    [USERNAME <username>]
                    [PASSWORD <password>]
                    [DISPLAY_NAME <display_name>])

此命令还将 <reponame> 存储库添加到变量 CPACK_IFW_REPOSITORIES_ALL。

禁用: 如果设置，则默认情况下将禁用存储库。
网址: 是指向可用组件的列表。
用户名: 在受保护的存储库上用作用户。
密码: 是在受保护的存储库上使用的密码。
DISPLAY_NAME: 是要显示的字符串而不是 URL。

cpack_ifw_update_repository¶

在 3.6 版本加入.

从远程存储库更新 QtIFW 特定存储库。

cpack_ifw_update_repository(<reponame>
                    [[ADD|REMOVE] URL <url>]|
                     [REPLACE OLD_URL <old_url> NEW_URL <new_url>]]
                    [USERNAME <username>]
                    [PASSWORD <password>]
                    [DISPLAY_NAME <display_name>])

此命令还将 <reponame> 存储库添加到变量 CPACK_IFW_REPOSITORIES_ALL。

网址: 是指向可用组件的列表。
旧网址: 是指向将被替换的列表。
新网址: 是指向将替换为的列表。
用户名: 在受保护的存储库上用作用户。
密码: 是在受保护的存储库上使用的密码。
DISPLAY_NAME: 是要显示的字符串而不是 URL。

cpack_ifw_add_package_resources¶

在 3.7 版本加入.

在安装程序二进制文件中添加其他资源。

cpack_ifw_add_package_resources(<file_path> <file_path> ...)

此命令还将指定的文件添加到变量 CPACK_IFW_PACKAGE_RESOURCES。

CPackIFW¶

命令¶

目录

上一主题

下一主题

本页