KDDockWidgets est un framework avancé pour Qt permettant de gérer des interfaces à onglets et des fenêtres ancrables complexes. Pour intégrer cette bibliothèque dans vos projets, une compilation à partir des sources est souvent nécessaire afin de garantir la compatibilité avec votre kit de développement spécifique.

Prérequis système

Avant de démarrer le processus de build, assurez-vous que les outils suivants sont installés et accessibles dans votre terminal :

• CMake : L'outil de confiugration principal.
• Ninja : Recommandé comme générateur pour sa rapidité.
• Compilateur : MSVC (Visual Studio 2017 ou plus récent) sous Windows, ou GCC/Clang sous Linux/macOS.
• Qt Framework : Version 5.9 minimum pour les fonctionnalités de base, 5.12+ pour le support Python, et 5.15+ ou Qt 6 pour le support QtQuick.

Configuration de l'environnement

La cohérence de l'architecture est primordiale. Si vous ciblez une application 32 bits, tous vos outils (Qt, compilateur, chemins d'accès) doivent pointer vers des binaires x86. Pour une application 64 bits, utilisez exclusivement les versions x64.

Sous Windows, il est fortement conseillé d'initialiser l'environnement via le script batch fourni par Visual Studio. Ouvrez une invite de commande et exécutez :

# Pour une compilation en 64 bits
"C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvars64.bat"

# Pour une compilation en 32 bits
"C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvars32.bat"

Procédure de compilation via la ligne de commande

La méthode la plus fiable consiste à utiliser CMake avec le générateur Ninja. Voici la séquence de commandes pour configurer, compiler et installerr la bibliothèque dans un répertoire spécifique :

# Création d'un répertoire dédié au build
mkdir build_kddock && cd build_kddock

# Configuration du projet
cmake -G Ninja \
      -DCMAKE_BUILD_TYPE=Release \
      -DCMAKE_INSTALL_PREFIX="C:/KDDockWidgets_Install" \
      ../path/to/kddockwidgets_source

# Lancement de la compilation
cmake --build .

# Installation des fichiers (headers, libs, dlls)
cmake --build . --target install

Utilisation de Qt Creator

Il est également posssible de compiler la bibliothèque directement depuis l'IDE Qt Creator :

1. Ouvrez le fichier CMakeLists.txt situé à la racine des sources.
2. Sélectionnez un kit correspondant à votre version de Qt et à votre compilateur (ex: Desktop Qt 5.15.2 MSVC2019 64bit).
3. Configurez les arguments CMake si nécessaire (notamment CMAKE_INSTALL_PREFIX).
4. Lancez la compilation (Ctrl+B).

Compiler et tester les exemples

Pour vérifier la réussite de l'installation, vous pouvez compiler l'exemple minimal fourni dans le dépôt. Il permet de valider que les liaisons avec les bibliothèques Qt fonctionnent correctement.

cd path/to/kddockwidgets/examples/minimal
mkdir build && cd build

# Pointer vers l'installation de KDDockWidgets réalisée précédemment
cmake -G Ninja \
      -DCMAKE_PREFIX_PATH="C:/KDDockWidgets_Install" \
      ..

cmake --build .

# Exécution du binaire généré
./kddockwidgets_minimal_example

Notes techniques et dépannage

• Versions de Qt : Si vous utilisez une version ancienne de Qt (inférieure à 5.12), certaines macros ou fonctionnalités liées au module de docking pourraient ne pas compiler. Une mise à jour vers Qt 5.15 LTS est recommandée pour une stabilité optimale.
• Conflits de chemins : Assurez-vous que le dossier bin de votre installation Qt est bien présent dans la variable d'environnement PATH pour que l'exécutable puisse charger les DLL nécessaires au runtime.
• Génération de projet .pro : Bien que KDDockWidgets soit nativement conçu pour CMake, il est techniquement possible de générer un fichier .pro via qmake -project, mais cette méthode est déconseillée car elle ne gère pas automatiquement les dépendances complexes définies dans le script CMake d'origine.