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

Новое в версии 3.6.

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

VIRTUAL

Новое в версии 3.8.

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

FORCED_INSTALLATION

Новое в версии 3.8.

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

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

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

DEFAULT

Новая в версии 3.8.

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

USER_INTERFACES

Новая в версии 3.7.

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

TRANSLATIONS

Новая в версии 3.8.

список <путей_к_файлам> (файлы '.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.