CPackIFW

Этот модуль ищет расположение утилит командной строки, поставляемых с 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

если установлено, то менеджер пакетов остаётся отключённым до тех пор, пока этот компонент не будет обновлён.

VIRTUAL

если установлено, то компонент будет скрыт от установщика. Это эквивалентно параметру HIDDEN команды cpack_add_component().

FORCED_INSTALLATION

если установлено, то компонент всегда должен быть установлен. Это эквивалентно параметру REQUIRED команды cpack_add_component().

REQUIRES_ADMIN_RIGHTS

установите это значение, если для компонента требуется установка с повышенными привилегиями.

NAME

используется для создания идентификации, похожей на домен, для этого компонента. По умолчанию используется имя исходного компонента.

DISPLAY_NAME

установите это значение, чтобы перезаписать исходное имя, настроенное командой cpack_add_component().

DESCRIPTION

установите это значение, чтобы перезаписать исходное описание, настроенное командой cpack_add_component().

UPDATE_TEXT

будет добавлено к описанию компонента, если это обновление компонента.

VERSION

является версией компонента. По умолчанию используется CPACK_PACKAGE_VERSION.

RELEASE_DATE

оставьте пустым для автоматического генерации.

SCRIPT

является относительным или абсолютным путём к скрипту операций для этого компонента.

PRIORITY | SORTING_PRIORITY

является приоритетом компонента в дереве. Параметр PRIORITY устарел и будет удалён в будущих версиях CMake. Используйте вместо него параметр SORTING_PRIORITY.

DEPENDS | DEPENDENCIES

список идентификаторов зависимых компонентов или групп компонентов в стиле QtIFW.

AUTO_DEPEND_ON

список идентификаторов компонентов или групп компонентов в стиле QtIFW, от которых у этого компонента есть автоматическая зависимость.

LICENSES

пара <название_для_отображения> и <путь_к_файлу> текста лицензии для этого компонента. Вы можете указать более одной лицензии.

DEFAULT

Возможные значения: TRUE, FALSE и SCRIPT. Установите FALSE, чтобы отключить компонент в установщике, или SCRIPT, чтобы он разрешался во время выполнения (не забудьте добавить файл скрипта в качестве значения параметра SCRIPT).

USER_INTERFACES

является списком <путь_к_файлу> (файлы «.ui»), представляющих страницы для загрузки.

TRANSLATIONS

является списком <путь_к_файлу> (файлы «.qm»), представляющих переводы для загрузки.

REPLACES

список идентификаторов компонентов или групп компонентов для замены.

CHECKABLE

Возможные значения: 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

если установлено, то группа будет скрыта от установщика. Обратите внимание, что установка этого параметра для корневого компонента не работает.

FORCED_INSTALLATION

если установлено, то группа всегда должна быть установлена.

REQUIRES_ADMIN_RIGHTS

установите это значение, если группе компонентов требуется установка с повышенными привилегиями.

NAME

используется для создания идентификации, похожей на домен, для этой группы компонентов. По умолчанию используется имя исходной группы компонентов.

DISPLAY_NAME

установите это значение, чтобы перезаписать исходное имя, настроенное командой cpack_add_component_group().

DESCRIPTION

установите это значение, чтобы перезаписать исходное описание, настроенное командой cpack_add_component_group().

UPDATE_TEXT

будет добавлено к описанию группы компонентов, если это обновление группы компонентов.

VERSION

является версией группы компонентов. По умолчанию используется CPACK_PACKAGE_VERSION.

RELEASE_DATE

оставьте пустым для автоматического генерации.

SCRIPT

является относительным или абсолютным путём к скрипту операций для этой группы компонентов.

PRIORITY | SORTING_PRIORITY

является приоритетом группы компонентов в дереве. Параметр PRIORITY устарел и будет удалён в будущих версиях CMake. Используйте вместо него параметр SORTING_PRIORITY.

DEPENDS | DEPENDENCIES

список идентификаторов зависимых компонентов или групп компонентов в стиле QtIFW.

AUTO_DEPEND_ON

список идентификаторов компонентов или групп компонентов в стиле QtIFW, от которых у этой группы компонентов есть автоматическая зависимость.

LICENSES

пара <название_для_отображения> и <путь_к_файлу> текста лицензии для этой группы компонентов. Вы можете указать более одной лицензии.

DEFAULT

Возможные значения: TRUE, FALSE и SCRIPT. Установите TRUE, чтобы предварительно выбрать группу в установщике (это действует только на группы без видимых дочерних компонентов), или SCRIPT, чтобы он разрешался во время выполнения (не забудьте добавить файл скрипта в качестве значения параметра SCRIPT).

USER_INTERFACES

является списком <путь_к_файлу> (файлы «.ui»), представляющих страницы для загрузки.

TRANSLATIONS

является списком <путь_к_файлу> (файлы «.qm»), представляющих переводы для загрузки.

REPLACES

список идентификаторов компонентов или групп компонентов для замены.

CHECKABLE

Возможные значения: 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

Обновляет репозиторий, специфичный для 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

Добавить дополнительные ресурсы в установочный бинарник.

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

Эта команда также добавит указанные файлы в переменную CPACK_IFW_PACKAGE_RESOURCES.