Qt6 est la version par défaut. Depuis a1c090781 (septembre 2026), CMakeLists.txt définit QT_VERSION_MAJOR à 6 lorsque rien n'est spécifié, et la branche Qt5 a été abandonnée. Qt 5.15 a atteint sa fin de vie en 2025. Ne construisez avec Qt5 que si vous avez une raison précise, en passant -DQT_VERSION_MAJOR=5.

Linux

Ubuntu/Debian :

sudo apt update
sudo apt install build-essential cmake ninja-build git pkg-config

# Qt6
sudo apt install qt6-base-dev qt6-base-private-dev libqt6svg6-dev \
                 libqt6sql6-sqlite qt6-tools-dev qt6-tools-dev-tools \
                 qt6-l10n-tools libqt6pdf6 qt6-pdf-dev

# SQLite, et CUPS — voir la note ci-dessous
sudo apt install libsqlite3-dev libcups2-dev

Sur Ubuntu 22.04, libgl1-mesa-dev et libegl1-mesa-dev peuvent également être nécessaires.

Fedora/RHEL :

sudo dnf groupinstall "Development Tools"
sudo dnf install cmake ninja-build git qt6-qtbase-devel qt6-qtsvg-devel \
                 qt6-qttools-devel sqlite-devel cups-devel

Arch Linux :

sudo pacman -S base-devel cmake ninja git qt6-base qt6-svg qt6-tools \
               sqlite libcups

Pourquoi CUPS est nécessaire

QElectroTech n'utilise pas CUPS lui-même. Par défaut, la construction compile également deux bibliothèques KDE Frameworks (KF6CoreAddons, KF6WidgetsAddons) à partir des sources, et celles-ci nécessitent CUPS pour la prise en charge des boîtes de dialogue d'impression. Sans les en-têtes de développement, la configuration échoue avant même la moindre compilation :

-- Could NOT find Cups (missing: CUPS_LIBRARIES CUPS_INCLUDE_DIR)
CMake Error at .../FeatureSummary.cmake:869 (message):
  feature_summary() Error: REQUIRED package(s) are missing, aborting CMake

Deux solutions : installer le paquet de développement CUPS comme ci-dessus, ou installer les paquets KDE Frameworks fournis par votre distribution et configurer avec -DBUILD_KF=NO afin que la construction les utilise au lieu de compiler les siens.

macOS

Installer Xcode Command Line Tools :
```
xcode-select --install
```

Installer dépendances via Homebrew :

brew install cmake ninja git qt
# ou pour Qt6 :
brew install cmake git qt

Définir chemin Qt (si nécessaire) :

export Qt6_DIR=$(brew --prefix qt)/lib/cmake/Qt6
# ou pour Qt6 :
export Qt_DIR=$(brew --prefix qt)/lib/cmake/Qt6

Windows

Option 1 : Visual Studio (Recommandé)

Installer Visual Studio Community (gratuit)
- Sélectionner "Desktop development with C++"
- Inclut compilateur MSVC
Installer CMake depuis cmake.org
Installer Qt5 ou Qt6 depuis qt.io
- Choisir "MSVC 2019 64-bit" (ou 2022)

Option 2 : MinGW (Alternative)

Installer MinGW avec support C++
Installer CMake
Installer Qt5 (build MinGW)

Option 3 : WSL (Windows Subsystem for Linux)

Activer WSL2
Installer Ubuntu dans WSL
Suivre instructions Linux ci-dessus

Git et Code Source

Cloner le référentiel avec sous-modules :

git clone --recursive https://github.com/qelectrotech/qelectrotech-source-mirror.git
cd qelectrotech-source-mirror

Le drapeau --recursive est important pour obtenir toutes les dépendances.

Construire à Partir de la Source

Étape 1 : Cloner le Référentiel

git clone https://github.com/qelectrotech/qelectrotech-source-mirror.git
cd qelectrotech-source-mirror

Étape 2 : Configurer la Construction

mkdir build && cd build
cmake ..

Étape 3 : Compiler

cmake --build . --config Release

Ou utiliser l'outil de construction de votre plateforme :

Linux/macOS :

make -j$(nproc)

Windows (MSVC) :

cmake --build . --config Release --parallel

Étape 4 : Installer (Optionnel)

cmake --install .

Ou exécuter le binaire depuis le répertoire de construction.

Variantes de Construction

Construction de Débogage

cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build .

Avec AddressSanitizer (ASAN)

cmake -DCMAKE_CXX_FLAGS="-fsanitize=address" ..
cmake --build .

Avec ThreadSanitizer (TSan)

cmake -DCMAKE_CXX_FLAGS="-fsanitize=thread" ..
cmake --build .

Tests

Exécuter les Tests

cd build
ctest

Ou exécuter avec verbosité :

ctest --verbose

Dépannage

Problème : `Could NOT find Cups`

-- Could NOT find Cups (missing: CUPS_LIBRARIES CUPS_INCLUDE_DIR)
CMake Error at .../FeatureSummary.cmake:869 (message):
  feature_summary() Error: REQUIRED package(s) are missing, aborting CMake

Solution : la construction compile par défaut deux bibliothèques KDE Frameworks à partir des sources, et elles nécessitent CUPS. Installez le paquet de développement (libcups2-dev, cups-devel ou libcups selon la distribution), ou configurez avec -DBUILD_KF=NO pour utiliser les paquets KDE Frameworks de votre distribution.

Problème : `The following REQUIRED packages have not been found: Qt6`

Il s'agit généralement d'un cache de dépendances obsolète plutôt que d'un paquet manquant — cela survient le plus souvent après le passage à Qt6 par défaut, sur une arborescence précédemment configurée pour Qt5.

Solution : les dépendances téléchargées sont mises en cache en dehors du répertoire de construction, dans ~/.cache/qet-deps. Supprimer uniquement le répertoire de construction ne vide pas ce cache : les Extra CMake Modules en cache restent configurés pour l'ancienne version de Qt et échouent en réclamant la nouvelle.

rm -rf ~/.cache/qet-deps build/
cmake -S . -B build -G Ninja

Problème : CMake ne trouve pas Qt

Solution :

cmake -S . -B build -DCMAKE_PREFIX_PATH=/chemin/vers/Qt/6.x.x/gcc_64

Sur macOS avec Homebrew : export Qt6_DIR=$(brew --prefix qt)/lib/cmake/Qt6.

Problème : mélange de versions de Qt

INTERFACE_QT_MAJOR_VERSION of "Qt5::Core" does not agree with QT_MAJOR_VERSION signifie qu'une partie de la construction a trouvé Qt5 et une autre Qt6.

Solution : configurez depuis un répertoire de construction vierge et passez -DQT_VERSION_MAJOR pour que le choix soit explicite.