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.