CPackIFW

Документация генератора CPack IFW перенесена сюда: CPack IFW Generator

Этот модуль ищет расположение утилит командной строки, поставляемых с Qt Installer Framework (QtIFW).

Модуль также определяет несколько команд для управления поведением генератора CPack IFW.

Команды

Модуль определяет следующие команды:

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

если установлено, то компонент должен всегда быть установлен. Это эквивалентно параметру REQUARED команды 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.