27 січня 2020 р. 13:52

Складання плагінів Qt Creator з GitHub Actions

Зміст

1. Дії GitHub
2. Передумови
3. Складання плагіна
4. Запуск GitHub Actions
5. Це працює?

Qt Creator - це кросплатформна високомодульна програма Qt C++.

Щоб зібрати плагін Qt Creator, вам потрібно:

компілятор C++
• Qt SDK
• Qt Creator SDK

Небагато розробників плагінів знають, що Qt Creator випускає SDK. Вам не потрібно компілювати Qt Creator для розробки Qt Creator плагіна. Також наявність доступу до всіх трьох платформ (Windows, Linux, macOS) не є звичайним явищем для більшості розробників C++.

Дії GitHub

GitHub Actions - це інфраструктура CI/CD, що надається GitHub, яка дає доступ до всіх трьох платформ!

GitHub також містить кілька репозиторіїв плагінів Qt Creator, тому розробники вирішили спробувати створити плагін Doxygen.

В даний час GitHub Actions пропонує такі віртуальні машини (бігуни):

• Ubuntu 16.04 LTS
• Ubuntu 18.04 LTS
• Windows Server 2016
• Windows Server 2019
• macOS 10.15

Qt SDK не є частиною програмного забезпечення, встановленого на бігунах. Це не проблема, тому що розробники хочуть зібрати з тією ж версією Qt, що і Qt Creator.

Можна побудувати платформу одночасно або кілька паралельно (матричний режим).

Передумови

Оскільки GitHub надає віртуальні машини та компілятори C++, потрібно просто отримати Qt та Qt Creator SDK, а потім «скомпілювати».

Щоб завантажити файли, витягти їх та почати компіляцію, розробники вирішили використовувати мову сценаріїв, яка встановлена на всіх трьох з них: CMake (у режимі сценаріїв через аргумент командного рядка -P).

Складання плагіна

Для того, щоб налаштувати плагін, потрібно просто запустити:

qmake doxygen.pro CONFIG+=release QTC_SOURCE="$ENV{GITHUB_WORKSPACE}/qtcreator" QTC_BUILD="$ENV{GITHUB_WORKSPACE}/qtcreator"

Складання так само проста, як запуск make -j<number-of-cores> or jom

Наприкінці буде спільна бібліотека (.dll, .so, .dynlib), яка поширюватиметься серед користувачів.

Запуск GitHub Actions

При git push плагін буде зібраний, а артефакти збережені при кожній збірці. Це виглядає так:

Якщо помічаємо коміт за допомогою git tag -a v0.4.7-qtc-4.11 -m "Release v0.4.7-qtc-4.11", а потім git push origin v0.4.7-qtc-4.11 запустить створення релізу, і завантажить артефакти в цей Випуск. Це виглядає так: