Repository navigation
building FR
Instructions pour construire QElectroTech à partir du code source.
Avant de construire, assurez-vous d'avoir les bons outils et bibliothèques installés.
Qt6 est la version par défaut. Depuis
a1c090781(septembre 2026),CMakeLists.txtdéfinitQT_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.
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-devSur 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-develArch Linux :
sudo pacman -S base-devel cmake ninja git qt6-base qt6-svg qt6-tools \
sqlite libcupsQElectroTech 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.
-
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
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
Cloner le référentiel avec sous-modules :
git clone --recursive https://github.com/qelectrotech/qelectrotech-source-mirror.git
cd qelectrotech-source-mirrorLe drapeau --recursive est important pour obtenir toutes les dépendances.
git clone https://github.com/qelectrotech/qelectrotech-source-mirror.git
cd qelectrotech-source-mirrormkdir build && cd build
cmake ..cmake --build . --config ReleaseOu utiliser l'outil de construction de votre plateforme :
Linux/macOS :
make -j$(nproc)Windows (MSVC) :
cmake --build . --config Release --parallelcmake --install .Ou exécuter le binaire depuis le répertoire de construction.
cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build .cmake -DCMAKE_CXX_FLAGS="-fsanitize=address" ..
cmake --build .cmake -DCMAKE_CXX_FLAGS="-fsanitize=thread" ..
cmake --build .cd build
ctestOu exécuter avec verbosité :
ctest --verbose-- 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.
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 NinjaSolution :
cmake -S . -B build -DCMAKE_PREFIX_PATH=/chemin/vers/Qt/6.x.x/gcc_64Sur macOS avec Homebrew : export Qt6_DIR=$(brew --prefix qt)/lib/cmake/Qt6.
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.
Solution :
sudo chown -R $USER:$USER .Solutions :
- Utiliser Ninja à la place de Make :
cmake -GNinja .. - Augmenter parallélisation :
cmake --build . -j8 - Utiliser ccache :
cmake -DCMAKE_CXX_COMPILER_LAUNCHER=ccache ..
Après avoir construit QET :
-
Tester l'application :
./qelectrotech(ou exécutable Windows/macOS) -
Exécuter les tests :
ctest -
Lire le code : Explorez le répertoire
sources/ - Contribuer : Voir Contribuer à QET
- Contributing Guide — Comment contribuer du code
- Forum — Obtenir de l'aide de la communauté
- GitHub Issues — Bugs et demandes de fonctionnalités
- CMake Documentation — Référence CMake
🌐 Choisir la Langue — English · Français · Deutsch
