Si vous souhaitez compiler Computree à partir du code source, voici la procédure à suivre.

Pré-requis

Sur votre système, les éléments suivants doivent être installés :

Un Compilateur C++

Sous Windows, il faut installer le compilateur C++ de Microsoft Visual Studio 2022 64bits (MSVC2022), disponible dans Visual Studio Community. Il faut choisir le composant Développement Desktop en C++, en activant a minima :

  • Kit de développement logiciel (SDK) Windows 11 (10.xxx)
  • MSVC v143 – VS 2022 C++

Sous Linux, le compilateur GCC (version >= 9.3) est normalement déjà disponible par défaut. Sinon, l’installer avec la commande :

sudo apt-get install build-essential

Sous MacOS X, il faut installer Apple Xcode, puis les outils de développement en lançant depuis un terminal :

command xcode-select --install

QtCreator et Qt

Il faut installer Qt version 5.15.2, disponible en version open-source ici

Un client Subversion (SVN)

Il faut installer un client Subversion (SVN), comme par exemple :

  • TortoiseSVN sous Windows
  • ou le paquet subversion sous Linux ou MacOS X :
sudo apt install subversion

Récupération des codes sources

Pour mettre en place l’environnement de dévleloppement Computree, il faut d’abord créer un dossier racine pour Computree, classiquement nommé « computree » (mais ce nom est libre). C’est dans ce dossier que seront récupérés les dépôts de code source de la plateforme et de ses plugins.

Pour récupérer les codes sources de la plateforme et des plugins distribués en standard (checkout SVN), il faut exécuter, dans le dossier racine computree, les commandes suivantes :

    svn checkout http://rdinnovation.onf.fr/svn/computreev6/            computreev6
    svn checkout http://rdinnovation.onf.fr/svn/plugin-onf/dev_v6/      pluginonf
    svn checkout http://rdinnovation.onf.fr/svn/plugin-mk/dev_v6/       pluginmk
    svn checkout http://rdinnovation.onf.fr/svn/plugin-toolkit/dev_v6/  plugintoolkit
    svn checkout http://rdinnovation.onf.fr/svn/segma/dev_v6/           pluginsegma
    svn checkout http://rdinnovation.onf.fr/svn/plugin-generate/dev_v6/ plugingenerate
    svn checkout http://rdinnovation.onf.fr/svn/plugin-onf-dev/dev_v6/  pluginonfdev
    svn checkout http://rdinnovation.onf.fr/svn/plugin-ign-lif/dev_v6/  pluginignlif

Cela va créer un sous-dossier principal computreev6 contenant tous les éléments du coeur de la plateforme. Ce dossier ne doit pas être renommé. Ensuite un sous-dossier est créé pour chaque plugin Computree. Seul le dépôt computreev6 est strictement indispensable. Les autres dépôts à récupérer dépendent des plugins que l’on souhaite compiler.

Il faut ensuite exécuter le script create_plugins_pro.bat (sous Windows) ou create_plugins_pro.sh (sous Linux ou MacOS X), situé dans le dossier computree/computreev6. Ce script créée le fichier projet Qt plugins.pro qui servira pour la compilation.

N.B. : A ce stade (ou ultérieurement dans QtCreator), vous pouvez retirer (en commentant les lignes correspondantes) ou ajouter des dossiers plugins à compiler dans le fichier plugins.pro créé.

Installation des dépendances

Sous Windows, il faut télécharger le fichier 3rdparty.zip, et décompresser son contenu dans un dossier computree/computreev6/3rdparty.

Sous Linux, il faut installer les paquets suivants :

sudo apt install libeigen3-dev
sudo apt install libmuparser-dev
sudo apt install libgdal-dev gdal-bin
sudo apt install libopencv-dev python3-opencv
sudo apt install libpcl-dev
sudo apt install libboost-all-dev
sudo apt install libgsl-dev gsl-bin
sudo apt install libqhull-dev
sudo apt install libflann-dev

Sous MacOS X, il faut installer Brew puis installer les paquets suivants :

brew install eigen
brew install muparser
brew install gdal
brew install opencv
brew install pcl
brew install boost
brew install gsl
brew install qhull
brew install flann

Compilation des traductions

Pour compiler les traductions (et donc pouvoir bénéficier d’une interface entièrement en Anglais ou entièrement en Français), il faut excécuter le script lrelease.bat (sous Windows) ou lrelease.sh (sous Linux ou MacOS X) situé dans le répertoire computree/computreev6. Ce script peut être ajusté en fonction des plugins à compiler.

N.B. : Un autre script lupdate.bat / lupdate.sh permet de mettre à jour les fichiers de traduction si le code a été modifié localement (à utiliser avant le script lrelease).

Configuration du projet Qt et compilation

La première étape consiste à ouvrir le fichier computree.pro, situé dans computree/computreev6, dans QtCreator. A l’ouverture QtCreator propose de configurer le projet : il faut choisir la bonne version de Qt et du compilateur, c’est à dire Qt 5.15.2 et, sous Windows, prendre la version MSVC 2022 64bits

Il faut ensuite aller dans l’onglet Projet de QtCreator pour configurer les options de compiltation :

  1. Décocher « Shadow Build » pour le mode Debug et pour le mode Release
  2. Laisser le mode Release sélectionné
  3. Dans la configuration de Run (à gauche) ajouter une étape du type « Make », et avec l’argument « install »
  4. Sous Windows, ajouter les chemins vers les librairies et plugins pour que Computree puisse se lancer à la fin de la compilation. Pour cela, toujours dans la configuration Run, dans Environnement, compléter la variable PATH avec les chemins séparés par des points virgules.

Exemple d’ajout de chemins au PATH QtCreator sous Windows (Run / Environnement / PATH, sans les sauts de lignes) :

C:\computree\ComputreeInstallRelease\plugins;
C:\computree\ComputreeInstallRelease\libraries\core;
C:\computree\ComputreeInstallRelease\libraries\gdal;
C:\computree\ComputreeInstallRelease\libraries\pcl;
C:\computree\ComputreeInstallRelease\libraries\Qt;
C:\computree\ComputreeInstallRelease\libraries\opencv;

Remplacer C:\computree par le chemin du dossier racine Computree sur votre système.

N.B. : le dossier computree/ComputreeInstallRelease est créé lors de la compilation.

Enfin, revenir sur l’onglet Editer et :

  1. Faire un clic droit sur le projet computree.pro, et cliquer sur Exécuter Qmake
  2. Lancer la compilation, avec le bouton Marteau en bas à gauche (ou clic droit, Compilation)
  3. Une fois la compilation terminée, lancer Computree, à l’aide du bouton Play.

N.B. : Ultérieurement, si des changements majeurs ont eu lieu dans le code source, il peut être nécessaire de refaire un Excécuter Qmake, puis Recompiler sur le projet computree.pro. Cette manipulation est à essayer si des problèmes commencent à survenir juste après une mise à jour du code source (update SVN).