В предыдущей статье мы рассмотрели создание msi-установщика с помощью CMake. При создании ПО, как продукта, одной из важных частей является размещение узнаваемых логотипов как на стартовом экране программы, так и в самом установщике. Сегодня мы рассмотрим изменение фона первой страницы установщика, а так же верхнего баннера, а так же добавим текст лицензионного соглашения.

Настройка проекта

Начнем мы с проекта, размещенного в git-репозитории. Мы продолжим настройку проекта из прошлой статьи.

Если папка:

c:\project\colortable_msi_custom

уже существует, переместите или удалите её:

cd c:\projects
rmdir /q/s colortable_msi_custom

Мы будем использовать проект из git-репозитория:

cd c:\projects
rmdir /q/s articles_blog_altuninvv_ru
git clone https://gitflic.ru/project/vasiliyaltunin/articles_blog_altuninvv_ru.git --depth 1

Скопируем папку с проектом:

xcopy /y/e .\articles_blog_altuninvv_ru\qt6\colortable_msi_custom\ .\colortable_msi_custom\

Добавляем лицензионное соглашение

При установке программы первое что видит пользователь это - окно в котором должно располагаться лицензионное соглашение. Давайте добавим текст для этого соглашения.

Откроем проект

cd c:\projects\colortable_msi_custom
code .

Создадим папку для хранения файлов, используемых WIX для сборки msi-файла:

mkdir cmake\wix

Создадим файл для текста с лицензией:

type nul > cmake\wix\license.rtf

Откроем файл в wordpad:

"%ProgramFiles%\Windows NT\Accessories\wordpad.exe" .\cmake\wix\license.rtf

Скопируем текст с лицензией с сайта по ссылке:

https://www.gnu.org/licenses/gpl-3.0.txt

Вставим текст в Wordpad, сохраним и закроем редактор.

Обратите внимание! Текст лицензии обязательно должен быть в формате RTF для нормального отображения текста в окне запроса принятия лицензии!

Откроем файл cmake\wix.cmake.in

Раскомментируем строку:

# Путь к файлу с лицензией
set(CPACK_RESOURCE_FILE_LICENSE ${PROJECT_SOURCE_DIR}/cmake/wix/license.rtf)

Запустим сборку:

rmdir /q/s .\build
cmake -S . -B build 
cmake --build build

Запустим сборку дистрибутива:

cmake --build build --target package

Запустим установку:

.\build\colortable-0.1-win64.msi

Теперь в окне мы видим текст лицензии из файла rtf:

Изменяем фон установщика и баннеров

Изменяем фон начальной страницы

Для примера я подготовил картинку:

Вы можете просто сохранить её из браузера и использовать.

Обратите внимание, размер изображения должен быть строго - 493x312px

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

Сохраним изображение как файл в папку:

c:\projects\colortable_msi_custom\cmake\wix\welcome.png

Откроем файл cmake\wix.cmake.in и раскомментируем:

# Баннер отображаемый на странице приветствия и на последней странице установщика. Обязательные размеры 493x312px
set(CPACK_WIX_UI_DIALOG "${PROJECT_SOURCE_DIR}/cmake/wix/welcome.png")

Запустим сборку дистрибутива:

cmake --build build --target package

Запустим установщик:

.\build\colortable-0.1-win64.msi

Теперь у нас страница приветствия заполнена нашим фоном:

Выглядит не очень красиво, поэтому давайте используем другую картинку:

Обратите внимание, пустая должна быть прозрачной!

Заменим старый файл на новый. Запустим сборку дистрибутива:

cmake --build build --target package

Запустим установщик:

.\build\colortable-0.1-win64.msi

Теперь всё выглядит намного аккуратнее

Изменяем фон верхнего баннера страницы

Для верхнего баннера мы будем использовать вот это изображение:

Сохраните его как:

c:\projects\colortable_msi_custom\cmake\wix\top_bg.png

Обратите внимание, размер изображения должен быть строго - 493x58px

Откроем файл cmake\wix.cmake.in и раскомментируем:

# Баннер отображаемый вверху каждой страницы установщика. Обязательные размеры 493x58 px
set(CPACK_WIX_UI_BANNER "${PROJECT_SOURCE_DIR}/cmake/wix/top_bg.png") 

Запустим сборку дистрибутива:

cmake --build build --target package

Запустим установщик:

.\build\colortable-0.1-win64.msi

Теперь верхний баннер выглядит намного лучше:

После всех изменений весь процесс установки выглядит следующим образом:

Заключение

Сегодня мы рассмотрели изменение фона стартовой страницы и верхнего баннера в msi-установщике с помощью CMake, а так же добавили текст лицензионного соглашения:

Добавили файл с лицензионным соглашением в формате RTF;

Добавили опцию с указанием пути к фалу;

Изменили первой страницы msi-установщика;

Изменили верхний баннер установщика.