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 запустить створення релізу, і завантажить артефакти в цей Випуск. Це виглядає так:
Нещодавно створений реліз виглядає так:
Це працює?
GitHub Actions має деякі відмінності в платформах і компіляторах, коли йдеться про те, як створюються Qt і Qt Creator:
• Visual C++ 2019 проти Visual C++ 2017
• Red Hat 7.2 проти Ubuntu 18.04
Як виявилось, Qt Creator зміг завантажити плагін на всіх трьох платформах!
