CuteCI
CuteCI is a simple tool allowing you to install Qt framework with desired packages in headless mode. Qt installers are using Qt Installer Framework which provides scripting ability, CuteCI takes advantage of this.
Requirements
Python3
pip3
cuteci
is in Python but has only been tested on Ubuntu (+docker).cuteci
is tested with latest patch version of Qt5.9
5.12
5.13
,5.14
(5.10
5.11
are not online anymore).
Installation
pip3 install cuteci
Principle
cuteci
does few things:
- Download Qt installer if you pass an url
- Make installer executable
- Install Qt with desired packages in the directory you choose
cuteci
can also only lists packages available in the installer.
Usage
Common options:
--installer
(required): path or url to Qt installer. If url, choose an official one fromdownload.qt.io/official_releases/qt/
, this is becausemd5sums.txt
is retrieved implicitely from it.--ui
: if set, Qt installer UI is shown (useful for debugging).--rm
: if set, Qt installer is removed at the end.--timeout
: duration in seconds to wait for the operation to be finished.
List packages
cuteci \
--installer <path or official url> \
[--ui] [--rm] \
list
Will output:
===LIST OF PACKAGES===
qt Qt
qt.qt5.5122 Qt 5.12.2
qt.tools Developer and Designer Tools
qt.installer.changelog Qt Installer Changelog
qt.license.lgpl Qt License LGPL
qt.license.thirdparty Qt 3rd Party Licenses
qt.license.python Python Software Foundation License Version 2
qt.license.gplv3except License GPL3-EXCEPT
qt.qt5.5122.gcc_64 Desktop gcc 64-bit
qt.qt5.5122.android_x86 Android x86
qt.qt5.5122.android_arm64_v8a Android ARM64-v8a
qt.qt5.5122.android_armv7 Android ARMv7
...
===END OF PACKAGES===
Install
cuteci \
--installer <path or official url> \
[--ui] [--rm] \
install \
--destdir /opt/Qt \
--packages qt.qt5.5122.gcc_64,qt.qt5.5122.android_x86 \
[--verbose] [--keep-tools]
Notes
destdir
should not contain a previous Qt installation (unless it has been installed withcuteci
), otherwise installer will complain and script does not handle it.- If
--keep-tools
is set, QtCreator, Maintenance Tools, samples and doc will be kept, but you will not be able to install another version of Qt indestdir
.
Docker integration
Here is the sample of a minimalist Dockerfile using cuteci
to install Qt 5.12.2:
FROM ubuntu:18.04
RUN apt-get update && apt-get install -y --no-install-recommends \
libdbus-1-3 \
xvfb \
libfontconfig \
python3 \
python3-pip
# For some reason Qt installer 5.12 requires:
libxrender1 \
libxkbcommon-x11-0
RUN pip3 install cuteci && \
cuteci \
--rm \
--installer http://download.qt.io/official_releases/qt/5.12/5.12.2/qt-opensource-linux-x64-5.12.2.run \
install \
--destdir /opt/Qt \
--packages qt.qt5.5122.gcc_64
ENTRYPOINT ["/bin/bash"]