Випуск утиліти для розгортання додатків C++/Qt і QML CQtDeployer версії 1.4.0 (двійкова коробка)

с++, Installer, cqtdeployer, deployment, самодостаточные установщики, qml

Майже півроку вийшло велике оновлення утиліти розгортання CQtDeployer.
У цьому оновленні багато нововведень, але основний акцент робиться на створення пакетів.

CQtDeployer 1.4.0

Виправлення

• Виправлено виведення довідки в консоль, перед виведенням перераховується реальний розмір консолі, що дозволяє коректно передавати текст.
• Виправлено роботу з деплоєм плагінів Qt. Тепер плагіни отримують не всі системні залежності, а тільки qt. Вилучення системних залежностей призводило до збою додатків через несумісні бібліотеки плагінів.
• Дрібні виправлення помилок та покращення.

Нові особливості

• Додана підтримка пошуку qmake із системного середовища.
• Додана можливість ініціалізувати репозиторій для подальшого пакування, аналогічно git init.
• Додана підтримка пакетів Qt Install Framework. Тепер можна запакувати дистрибутив у установник.
• Додана можливість розбивати кінцевий дистрибутив на кілька пакетів.
• Додано можливість уніфікувати створення пакетів для фінальної роздачі.
• Додана підтримка додавання скриптів користувача в скрипти запуску додатків.
• Додано підтримку вилучення системних залежностей для Windows.
• Додана підтримка RPATH для Linux. Тепер cqtdeployer може самостійно визначити необхідний qmake для розгортання програми.
• Додана підтримка пошуку потрібної залежності на ім'я бібліотеки.
• Додана підтримка бібліотек Qt із репозиторіїв дистрибутивів Linux.
• Доданий новий псевдонім для команди запуску (cqt та cqtdeployer.cqt) для швидкого розгортання програм.
• Додано підтримку нативного імені команди для windows. Тепер можна запустити cqtdeployer з команди cqtdeployer в cmd і powershell.

Нові опції

• init – ініціалізує файл cqtdeployer.json (файл конфігурації). Наприклад: cqtdeployer init — для ініціалізації конфігурації базового пакета. cqtdeployer -init multi - для ініціалізації конфігурації декількох пакетів.
• noCheckRPATH - відключає автоматичний пошук шляхів до qmake у файлах (тільки для Linux).
• noCheckPATH - відключає автоматичний пошук шляхів до qmake у системному оточенні.
• ExtractPlugins – примусово витягує всі залежності плагінів.
  -qif - Створює установник в кінці розгортання.
• extraLibs - додає шаблон для додаткової бібліотеки, яка має бути включена до дистрибутиву.
• customScript - додає скрипт користувача в скрипт запуску програми.
  --targetPackage [пакет; tar1, пакет; tar2] - використовується для формування пакетів, позначає списки цільових файлів для конкретних пакетів.
  — recOut — вказує, до якої папки буде додано ресурси після розгортання.
• name – задає ім'я пакета.
• description - встановлює опис пакету
• deployVersion – встановлює версію пакету
• releaseDate – встановлює дату випуску пакета.
• icon - задає піктограму пакета.
• publisher – встановлює видавця пакета.
• qifStyle - Задає шлях до файлу стилів CSS або задає стиль за промовчанням. Доступні стилі: квазар
• qifBanner - Встановлює шлях до png-файлу банера.
• qifLogo - Встановлює шлях до png-файлу логотипу.

Посилання для скачування

Установник:

Інсталятор можна завантажити на соціальній сторінці github

Знімок

Увага

У снап-версії обов'язково дайте програмі доступ до читання інших процесів. Тому що це необхідно для створення установника та коректного пошуку qt.

Детальний розбір найцікавіших змін.

Перше, на що слід звернути увагу, це те, що CQtDeployer навчився працювати з RPATH (лише для Linux) та PATH. Це означає, що якщо ваша програма зібрана за допомогою RPATH (а RPATH в qt включений за замовчуванням) або ваш qmake прописаний в PATH, то вам не потрібно вказувати шлях до qmake. CQtDeployer сам знайде qmake.

Перевіримо практично.
Я створив простий консольний додаток за допомогою Qt.

#include <QString>
#include <QDebug>
int main(int, char *[])
{
    QString str = "hello CQtDeployer 1.4";
    qInfo() << str;
    return 0;
}

Я використовуватиму систему складання cmake, тому що вона більш актуальна, ніж qmake.

andrei@HP:~/Hello$ tree 
.
├── CMakeLists.txt
├── CMakeLists.txt.user
└── main.cpp

0 directories, 3 files

Створіть папку для збирання.

andrei@HP:~/Hello$ mkdir build 

Запустіть cmake у створеній папці.

andrei@HP:~/Hello/build$ cmake .. -DCMAKE_PREFIX_PATH=~/Qt/5.14.1/gcc_64
-- Configuring done
-- Generating done
-- Build files have been written to: /home/andrei/Hello/build

створення проекту

andrei@HP:~/Hello/build$ make 
Scanning dependencies of target Hello_autogen
[ 25%] Automatic MOC and UIC for target Hello
[ 25%] Built target Hello_autogen
Scanning dependencies of target Hello
[ 50%] Building CXX object CMakeFiles/Hello.dir/Hello_autogen/mocs_compilation.cpp.o
[ 75%] Building CXX object CMakeFiles/Hello.dir/main.cpp.o
[100%] Linking CXX executable Hello
[100%] Built target Hello

Перевіряємо нашу програму.

andrei@HP:~/Hello/build$ ls
CMakeCache.txt  CMakeFiles  cmake_install.cmake  Hello  Hello_autogen  Makefile

І запускаємо cqtdeployer минаючи його програму без qmake.

andrei@HP:~/Hello/build$ cqtdeployer -bin Hello 
Deploy ...
flag targetDir not  used. use default target dir : "/home/andrei/Hello/build/DistributionKit"
target deploy started!!
copy : "/home/andrei/Hello/build/Hello"
extract lib : "/home/andrei/Hello/build/DistributionKit//bin//Hello"
copy : "/home/andrei/Qt/5.14.1/gcc_64/lib/libQt5Core.so.5"
copy : "/home/andrei/Qt/5.14.1/gcc_64/lib/libicuuc.so.56"
copy : "/home/andrei/Qt/5.14.1/gcc_64/lib/libicui18n.so.56"
copy : "/home/andrei/Qt/5.14.1/gcc_64/lib/libicudata.so.56"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_ar.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_bg.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_ca.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_cs.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_da.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_de.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_en.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_es.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_fi.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_fr.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_gd.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_he.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_hu.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_it.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_ja.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_ko.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_lv.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_pl.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_ru.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_sk.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_uk.qm"
copy : "/home/andrei/Qt/5.14.1/gcc_64/translations/qtbase_zh_TW.qm"
try deploy msvc
deploy done!

О диво, тепер наша програма повністю автономна.
Перевірте це.

andrei@HP:~/Hello/build$ cd DistributionKit/
andrei@HP:~/Hello/build/DistributionKit$ tree 
.
├── bin
│   ├── Hello
│   └── qt.conf
├── Hello.sh
├── lib
│   ├── libicudata.so.56
│   ├── libicui18n.so.56
│   ├── libicuuc.so.56
│   └── libQt5Core.so.5
└── translations
    ├── qtbase_ar.qm
    ├── qtbase_bg.qm
    ├── qtbase_ca.qm
    ├── qtbase_cs.qm
    ├── qtbase_da.qm
    ├── qtbase_de.qm
    ├── qtbase_en.qm
    ├── qtbase_es.qm
    ├── qtbase_fi.qm
    ├── qtbase_fr.qm
    ├── qtbase_gd.qm
    ├── qtbase_he.qm
    ├── qtbase_hu.qm
    ├── qtbase_it.qm
    ├── qtbase_ja.qm
    ├── qtbase_ko.qm
    ├── qtbase_lv.qm
    ├── qtbase_pl.qm
    ├── qtbase_ru.qm
    ├── qtbase_sk.qm
    ├── qtbase_uk.qm
    └── qtbase_zh_TW.qm

3 directories, 29 files
andrei@HP:~/Hello/build/DistributionKit$ 

Корінь програми:

Бібліотеки, необхідні для роботи програми:

Як видно з прикладу, програма повністю зібрана.

Каркас установника Qt

Друга новація, про яку варто знати, - це можливість формувати QIF-установники з коробки. Все, що потрібно для прикладу, це додати опцію qif в команду упаковки.

Приклад використання.

andrei@HP:~/Hello/build$ cqtdeployer -bin Hello qif 

Всього одна проста команда і програма набуває презентабельного вигляду.

Цей установник підтримує мінімальну інтеграцію дистрибутивів Linux та Windows. А саме: створення ярликів, та реєстрація програми в ОС.
Якщо вас з якоїсь причини не влаштовує зовнішній вигляд цього установника, ви можете змінити його за допомогою qifStyle прапора. На момент версії 1.4 cqtdeployer підтримує лише 2 стилі (native та quasar).

Приклад стилю квазара:

Ви також можете використовувати власну таблицю стилів qss. Для цього передайте шлях до файлу qss або css замість імені стилю.
Наприклад, розглянемо таку таблицю стилів qss.

Style.qss:

QWidget
{
    color: white;
    background-color: rgb(65, 65, 65);
}

QPushButton
{
    background: qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 rgba(150, 150, 150, 60%), stop:1 rgba(50, 50, 50, 60%));
    border-color: rgb(60, 60, 60);
    border-style: solid;
    border-width: 2px;
    border-radius: 9px;
    min-height: 20px;
    max-height: 20px;
    min-width: 60px;
    max-width: 60px;
    padding-left: 15px;
    padding-right: 15px;
}

QPushButton:pressed, QPushButton:checked
{
    background: qlineargradient(x1:0, y1:0, x2:0, y2:1, stop:0 rgba(50, 50, 50, 60%), stop:1 rgba(150, 150, 150, 60%));
}

Перевіримо, що ми отримуємо в цьому випадку.

cqtdeployer -bin Hello qif -qifStyle ./../style.qss

Ось, власне, і темна тема інсталятора.

Розбивка на пакети

І, напевно, останнє важливе оновлення, про яке варто знати, це можливість розбивати великий мультибінарний проект на підпроекти.

Ця функція найскладніша з усіх перерахованих, тому що для її використання потрібно багато тексту. Тому я рекомендую використовувати конфігураційний файл.

Для початку ускладнимо наш проект, додавши в нього ще 2 виконувані файли. Я не став морочитися і просто зробив дві копії своєї утиліти Hello.

Для полегшення роботи з пакетами необхідно ініціалізувати каталог.

cqtdeployer init

Це ще одна нова функція, яка створює файл CQtDeployer.json, в який ми будемо писати наші конфігурації замість того, щоб передавати параметри утиліті.

{
    "binDir": ".",
    "clear": true,
    "libDir": "./",
    "recursiveDepth": 5
}

Тепер зробимо 2 пакети з трьох наших програм. Для цього вкажіть:

{
    "binDir": ".",
    "clear": true,
    "libDir": "./",
    "recursiveDepth": 5,
    "targetPackage": [
        ["Dstro1", "Hello1"],
        ["Dstro2", "Hello2"],
        ["Dstro2", "Hello3"]
    ]
}

Зверніть увагу, що мені довелося явно вказати прив'язку Dstro2 Hello2 Hello3. На жаль, під час версії 1.4 cqtdeployer було неможливо аналізувати цільові перерахування. Зверніть увагу, що якщо я напишу замість Hello1 Hello, то відбір буде проводитись за всіма збігами та будуть обрані всі 3 програми.
Тож давайте подивимося, що сталося.

cqtdeployer

.
├── Dstro1
│   ├── bin
│   │   ├── Hello1
│   │   └── qt.conf
│   ├── Hello1.sh
│   ├── lib
│   │   ├── libicudata.so.56
│   │   ├── libicui18n.so.56
│   │   ├── libicuuc.so.56
│   │   └── libQt5Core.so.5
│   └── translations
│       ├── qtbase_ar.qm
│       ├── qtbase_bg.qm
│       ├── qtbase_ca.qm
│       ├── qtbase_cs.qm
│       ├── qtbase_da.qm
│       ├── qtbase_de.qm
│       ├── qtbase_en.qm
│       ├── qtbase_es.qm
│       ├── qtbase_fi.qm
│       ├── qtbase_fr.qm
│       ├── qtbase_gd.qm
│       ├── qtbase_he.qm
│       ├── qtbase_hu.qm
│       ├── qtbase_it.qm
│       ├── qtbase_ja.qm
│       ├── qtbase_ko.qm
│       ├── qtbase_lv.qm
│       ├── qtbase_pl.qm
│       ├── qtbase_ru.qm
│       ├── qtbase_sk.qm
│       ├── qtbase_uk.qm
│       └── qtbase_zh_TW.qm
└── Dstro2
    ├── bin
    │   ├── Hello2
    │   ├── Hello3
    │   └── qt.conf
    ├── Hello2.sh
    ├── Hello3.sh
    ├── lib
    │   ├── libicudata.so.56
    │   ├── libicui18n.so.56
    │   ├── libicuuc.so.56
    │   └── libQt5Core.so.5
    └── translations
        ├── qtbase_ar.qm
        ├── qtbase_bg.qm
        ├── qtbase_ca.qm
        ├── qtbase_cs.qm
        ├── qtbase_da.qm
        ├── qtbase_de.qm
        ├── qtbase_en.qm
        ├── qtbase_es.qm
        ├── qtbase_fi.qm
        ├── qtbase_fr.qm
        ├── qtbase_gd.qm
        ├── qtbase_he.qm
        ├── qtbase_hu.qm
        ├── qtbase_it.qm
        ├── qtbase_ja.qm
        ├── qtbase_ko.qm
        ├── qtbase_lv.qm
        ├── qtbase_pl.qm
        ├── qtbase_ru.qm
        ├── qtbase_sk.qm
        ├── qtbase_uk.qm
        └── qtbase_zh_TW.qm

8 directories, 60 files

Як видно з дерева результатів, у нас вийшло 2 дистрибутиви.
1. Dstro1 - містить додаток Hello1
2. Dstro2 - містить 2, що залишилися.

Тепер перевіримо, що буде, якщо це запакувати установщиком. Додайте для параметра qif значення true у CQtDeployer.json: qif: true, .

{
    "binDir": ".",
    "clear": true,
    "qif": true,
    "libDir": "./",
    "recursiveDepth": 5,
    "targetPackage": [
        ["Dstro1", "Hello1"],
        ["Dstro2", "Hello2"],
        ["Dstro2", "Hello3"]
    ]

Як видно зі скріншота, тепер у нас 2 пакети при встановленні.

Нові псевдоніми

І останнє невелике, але приємне доповнення: тепер до cqtdeployer додані нові команди.

• сqt — це швидкий спосіб розгорнути вашу програму. Це полегшує виклик розгортання.

• Приклад:
  cqt myApp — це те саме, що cqtdeployer -bin myApp .

• cqtdeployer.cqt - те саме, що і cqt, але для пакета snap.

• У windows-версії тепер не потрібно додавати знак % для виклику утиліти.

• У версії для windows тепер немає потреби додавати знак % для виклику утиліти.
  Тепер виклик виглядає як у Linux. (cqtdeployer)