CPackIFW¶

3.1 版中添加。

此模块查找附带 Qt 安装程序框架 (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 的旧名称。

依赖依赖关系

3.8 版中添加。

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

3.21 版本中添加。

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

AUTO_DEPEND_ON

3.8 版中添加。

QtIFW 中本组件具有自动依赖关系的组件或组件组的标识符列表。

许可证

本组件许可证文本的 <<显示名称> 和 <文件路径> 对。您可以指定多个许可证。

默认值

3.8 版中添加。

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

用户界面

3.7 版本中添加。

是要加载的页面（“ui 文件”）的 <<文件路径> 列表。

翻译

3.8 版中添加。

是要加载的翻译（“.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() 命令后调用。

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 的旧名称。

依赖依赖关系

3.8 版中添加。

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

3.21 版本中添加。

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

AUTO_DEPEND_ON

3.8 版中添加。

QtIFW 中本组件组具有自动依赖关系的组件或组件组的标识符列表。

许可证

本组件组许可证文本的 <<显示名称> 和 <文件路径> 对。您可以指定多个许可证。

默认值

3.8 版中添加。

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

用户界面

3.7 版本中添加。

是要加载的页面（“ui 文件”）的 <<文件路径> 列表。

翻译

3.8 版中添加。

是要加载的翻译（“.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>])

此命令还会向变量 CPACK_IFW_REPOSITORIES_ALL 添加 <reponame> 资源库。

禁用: 如果已设置，那么此资源库将默认处于禁用状态。
网址: 指向可用组件列表。
用户名: 用作受保护资源库中的用户。
密码: 用作受保护资源库中的密码。
DISPLAY_NAME: 字符串，用于显示而不是网址。

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>])

此命令还会向变量 CPACK_IFW_REPOSITORIES_ALL 添加 <reponame> 资源库。

网址: 指向可用组件列表。
旧网址: 指向将被替换的列表。
新网址: 指向将被替换的列表。
用户名: 用作受保护资源库中的用户。
密码: 用作受保护资源库中的密码。
DISPLAY_NAME: 字符串，用于显示而不是网址。

cpack_ifw_add_package_resources¶

3.7 版本中添加。

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

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

此命令还会向变量 CPACK_IFW_PACKAGE_RESOURCES 添加指定的文件。

CPackIFW¶

命令¶

目录

前一个主题

下一个主题

此页