CPackIFW

版本 3.1 新增。

此模块查找 Qt Installer Framework (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() 命令之后调用。

COMMON

如果设置,则组件将作为其所属组的一部分打包和安装。

ESSENTIAL

版本 3.6 新增。

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

VIRTUAL

版本 3.8 新增。

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

FORCED_INSTALLATION

版本 3.8 新增。

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

REQUIRES_ADMIN_RIGHTS

版本 3.8 新增。

如果组件需要以提升的权限安装,请设置此项。

NAME

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

DISPLAY_NAME

版本 3.8 新增。

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

DESCRIPTION

版本 3.8 新增。

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

UPDATE_TEXT

版本 3.8 新增。

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

VERSION

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

RELEASE_DATE

版本 3.8 新增。

保持为空以自动生成。

SCRIPT

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

SORTING_PRIORITY

版本 3.8 新增。

是组件在树中的优先级。

PRIORITY

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

DEPENDS, DEPENDENCIES

版本 3.8 新增。

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

版本 3.21 新增。

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

AUTO_DEPEND_ON

版本 3.8 新增。

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

LICENSES

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

DEFAULT

版本 3.8 新增。

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

USER_INTERFACES

版本 3.7 新增。

是要加载的页面,是 <file_path>('.ui' 文件)的列表。

TRANSLATIONS

版本 3.8 新增。

是要加载的翻译,是 <file_path>('.qm' 文件)的列表。

REPLACES

版本 3.10 新增。

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

CHECKABLE

版本 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() 命令之后调用。

VIRTUAL

版本 3.8 新增。

如果设置,则组将从安装程序中隐藏。 请注意,在根组件上设置此项不起作用。

FORCED_INSTALLATION

版本 3.8 新增。

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

REQUIRES_ADMIN_RIGHTS

版本 3.8 新增。

如果组件组需要以提升的权限安装,请设置此项。

NAME

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

DISPLAY_NAME

版本 3.8 新增。

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

DESCRIPTION

版本 3.8 新增。

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

UPDATE_TEXT

版本 3.8 新增。

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

VERSION

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

RELEASE_DATE

版本 3.8 新增。

保持为空以自动生成。

SCRIPT

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

SORTING_PRIORITY

是组件组在树中的优先级。

PRIORITY

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

DEPENDS, DEPENDENCIES

版本 3.8 新增。

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

版本 3.21 新增。

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

AUTO_DEPEND_ON

版本 3.8 新增。

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

LICENSES

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

DEFAULT

版本 3.8 新增。

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

USER_INTERFACES

版本 3.7 新增。

是要加载的页面,是 <file_path>('.ui' 文件)的列表。

TRANSLATIONS

版本 3.8 新增。

是要加载的翻译,是 <file_path>('.qm' 文件)的列表。

REPLACES

版本 3.10 新增。

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

CHECKABLE

版本 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

DISABLED

如果设置,则默认情况下禁用仓库。

URL

指向可用组件列表。

USERNAME

在受保护的仓库上用作用户。

PASSWORD

用于受保护仓库的密码。

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

URL

指向可用组件列表。

OLD_URL

指向将被替换的列表。

NEW_URL

指向将替换为的列表。

USERNAME

在受保护的仓库上用作用户。

PASSWORD

用于受保护仓库的密码。

DISPLAY_NAME

是要显示的字符串,而不是 URL。

cpack_ifw_add_package_resources

版本 3.7 新增。

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

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

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