CompileOnUnix/fr

Sous les distributions GNU/Linux récentes, FreeCAD est généralement facile à compiler, puisque toutes les dépendances sont fournies par le gestionnaire de paquets. Cela se fait en 3 étapes :
 * 1) Obtenir le code source de FreeCAD
 * 2) Obtenir les dépendances (les paquets desquels FreeCAD dépend)
 * 3) Configurer avec "cmake" et compiler avec "make"

Vous trouverez ci-dessous des instructions détaillées du processus complet, quelques scripts de compilation et des particularités que vous pourriez rencontrer. Si vous constatez des informations erronées ou désuètes (les distributions Linux changent régulièrement), ou si vous utilisez une distribution qui n'est pas listée, votre aide pour corriger le tout sera appréciée.

Obtenir le code source
Avant de compiler FreeCAD, vous avez besoin du code source. Vous pouvez le cloner en utilisant git ou le télécharger sous forme d'archive.

Git
La méthode la meilleure et la plus rapide d'obtenir le code est de « cloner » le dépôt Git en lecture seule (il vous faut le paquet git installé):

Ceci crééra une copie de la dernière version du code source de FreeCAD dans un nouveau répertoire nommé "freecad-code".

Paquets source
Sinon vous pouvez télécharger la source sous forme d'archive.

Obtenir les dépendances
Pour compiler FreeCAD sous Linux, vous devez d'abord installer toutes les bibliothèques mentionnées dans la page Bibliothèques externes. Notez que les noms et la disponibilité des bibliothèques dépendra de votre distribution. Si vous n'utilisez pas la version la plus récente de votre distribution, certains des paquets ci-dessous pourraient être absents de vos dépôts. Dans ce cas, consultez la section Anciennes distributions et distributions non-conventionnelles ci-dessous.

Passer directement à la Compilation de FreeCAD

Debian et Ubuntu
Sous les systèmes basés sur Debian (Debian, Ubuntu, LinuxMint, etc...), il est très facile d'installer toutes les dépendances requises. La plupart des bibliothèques sont disponibles via apt-get, le gestionnaire de paquets Synaptic, ou le gestionnaire de paquets de votre choix.

Si vous avez déjà installé FreeCAD depuis les dépôts officiels, vous pouvez installer ses dépendances de compilation à l'aide de cette unique ligne de commande dans un terminal : sudo apt build-dep freecad

soit :
 * build-essential
 * cmake
 * python
 * python-matplotlib
 * libtool
 * libcoin80-dev (Debian jessie, stretch, Ubuntu 16.04 à 18.10)

ou :
 * libcoin-dev (Debian buster, Ubuntu 19.04 et ultérieures, ainsi que Ubuntu 18.04/18.10 avec l'un ou l'autre des dépôts PPA freecad-stable/freecad-daily ajouté à vos sources de logiciels)

avec Qt4 et Python 2 (pour Debian jessie, stretch, Ubuntu 16.04):
 * libboost-dev
 * libboost-date-time-dev
 * libboost-filesystem-dev
 * libboost-graph-dev
 * libboost-iostreams-dev
 * libboost-program-options-dev
 * libboost-python-dev
 * libboost-regex-dev
 * libboost-signals-dev
 * libboost-serialization-dev
 * libboost-thread-dev
 * libeigen3-dev
 * libopencv-dev | libcv-dev
 * libgts-bin
 * libgts-dev
 * libkdtree++-dev
 * libmedc-dev
 * libproj-dev
 * libvtk6-dev | libvtk7-dev
 * libx11-dev
 * libxerces-c-dev
 * libzipios++-dev
 * lsb-release
 * swig
 * libqt4-dev
 * libqt4-opengl-dev
 * libqtwebkit-dev
 * libshiboken-dev
 * libpyside-dev
 * python-dev
 * python-pivy
 * python-ply
 * python-pyside
 * pyside-tools
 * qt4-dev-tools

ou avec Qt5 et Python 3 (Debian buster, Ubuntu 19.04 et ultérieures, ainsi que Ubuntu 18.04/18.10 avec l'un ou l'autre des dépôts PPA freecad-stable/freecad-daily ajouté à vos sources de logiciels) :
 * libqt5opengl5-dev
 * libqt5svg5-dev
 * libqt5webkit5-dev or qtwebengine5-dev
 * libqt5x11extras5-dev
 * libpyside2-dev
 * libshiboken2-dev
 * pyside2-tools
 * python3-dev
 * python3-pivy
 * python3-ply
 * python3-pyside2.qtcore
 * python3-pyside2.qtgui
 * python3-pyside2.qtsvg
 * python3-pyside2.qtwidgets
 * python3-pyside2uic
 * qtbase5-dev
 * qttools5-dev

soit :
 * libocct*-dev (version officielle opencascade à jour, disponible sous Debian buster et Ubuntu 18.10 et ultérieures, ainsi que Ubuntu 18.04 avec l'un ou l'autre des dépôts PPA freecad-stable/freecad-daily ajouté à vos sources de logiciels)
 * occt-draw

ou :
 * liboce*-dev (opencascade community edition, désuète, disponible sous Debian jessie, stretch, Ubuntu 16.04 et ultérieures)
 * oce-draw

Notez que liboce*-dev/libocct*-dev inclusent les bibliothèques suivantes (substituez oce par occt) : Vous pourriez devoir installer ces paquets par leur nom individuel :
 * liboce-foundation-dev
 * liboce-modeling-dev
 * liboce-ocaf-dev
 * liboce-visualization-dev
 * liboce-ocaf-lite-dev

Vous pouvez optionnellement installer ces paquets supplémentaires :
 * libsimage-dev (pour permettre à Coin d'offrir davantage de formats d'images)
 * checkinstall (pour enregistrer vous fichiers installés dans votre gestionnaire de paquets, afin de pouvoir les désinstaller facilement plus tard)
 * python-matplotlib
 * doxygen and libcoin80-doc (si vous avez l'intention de générer la documentation du code source)
 * libspnav-dev (pour le support des périphériques 3Dconnexion comme la Space Navigator ou la Space Pilot)

Commande unique pour Qt5 et Python 3 (requiert Pyside2, disponible sous Debian buster et les dépôts PPA freecad-stable/freecad-daily)

Commande unique pour Qt4 et Python 2

Utilisateurs de Ubuntu 16.04, veuillez aussi consulter ces instructions complémentaires (EN).

Fedora
Vous avez besoin des paquets suivants :


 * gcc-c++ (or possibly another C++ compiler?)
 * cmake
 * doxygen
 * swig
 * gettext
 * dos2unix
 * desktop-file-utils
 * libXmu-devel
 * freeimage-devel
 * mesa-libGLU-devel
 * OCE-devel
 * python
 * python-devel
 * python-pyside-devel
 * pyside-tools
 * boost-devel
 * tbb-devel
 * eigen3-devel
 * qt-devel
 * qt-webkit-devel
 * ode-devel
 * xerces-c
 * xerces-c-devel
 * opencv-devel
 * smesh-devel
 * coin3-devel

(si coin2 est la dernière disponible pour votre version de Fedora, utilisez les paquets à partir de http://www.zultron.com/rpm-repo/)
 * soqt-devel
 * freetype
 * freetype-devel

Et optionnellement :


 * libspnav-devel (pour le support des périphériques 3Dconnexion comme le Space Navigator ou le Space Pilot)
 * pivy (https://bugzilla.redhat.com/show_bug.cgi?id=458975 Pivy n'est pas obligatoire mais nécessaire pour le module Draft)

Gentoo
Le moyen le plus facile de vérifier quels paquets sont nécessaires pour compiler FreeCAD et de vérifier via portage :

emerge -pv freecad

Ceci devrait vous donner une superbe liste de paquets supplémentaires que devez avoir installés sur votre système.

Si FreeCAD n'est pas disponible sur portage, il est disponible sur la waebbl overlay. Le suivi des problèmes sur le recouvrement waebbl Github peut vous aider à résoudre certains problèmes que vous pourriez rencontrer. La superposition fournit  freecad-9999 , que vous pouvez choisir de compiler ou simplement utiliser pour obtenir les dépendances.

layman -a waebbl

Tumbleweed
The following commands will install the packages required for building FreeCAD with Qt5 and Python 3.

The following command will install Qt Creator and the GNU Project Debugger.

If any packages are missing, then you can check the Tumbleweed "FreeCAD.spec" file on the Open Build Service.

Also, check to see if there are any patches you need to apply (such as 0001-find-openmpi2-include-files.patch).

Leap
If there is a difference between the available packages on Tumbleweed and Leap, then you can read the Leap "FreeCAD.spec" file on the Open Build Service to determine the required packages.

Arch Linux
You will need the following libraries from the official repositories:


 * boost-libs
 * curl
 * hicolor-icon-theme
 * libspnav
 * opencascade
 * python2-matplotlib
 * shared-mime-info
 * xerces-c
 * boost
 * cmake
 * desktop-file-utils
 * eigen
 * gcc-fortran
 * swig

Aussi, assurez vous de vérifier le AUR pour tout paquet manquant qui ne sont pas dans les dépôts, actuellement :
 * coin
 * python2-pivy
 * python2-pyside
 * python2-pyside-tools
 * python2-shiboken
 * qtwebkit
 * med (Modelisation et Echanges de Donnees)

Distributions anciennes et non-conventionnelles
Sous d'autres distributions, nous n'avons que très peu de retours des utilisateurs, il pourrait être plus difficile de trouver les paquets requis. Repérez d'abord les bibliothèques requises mentionnées à la page Bibliothèques externes. Prenez note que certaines de ces bibliothèques pourraient se trouver dans votre distribution sous un nom différent (tel que nom, libnom, nom-dev, nom-devel, etc...).

Vous aurez aussi besoin du GNU gcc compiler en version égale ou supérieur à 3.0.0. g++ est également nécessaire puisque FreeCAD est complètement écrit en C++. Pendant la compilation, quelques script Python sont exécutés. L'interpréteur Python doit donc fonctionner correctement. Pour éviter tout problème avec l'éditeur de liens pendant la compilation, c'est aussi une bonne idée de régler les liens de bibliothèques dans votre variable LD_LIBRARY_PATH ou dans votre fichier ld.so.conf. C'est généralement déjà le cas dans les distributions récentes.

Pour plus de détails, consultez le fichier README.Linux dans vos sources.

Pivy
Pivy n'est pas nécessaire pour compiler FreeCAD ou l'exécuter, mais il est requis par le module Draft qui ne fonctionnera pas autrement. Si vous ne comptez pas utiliser ce module, vous n'avez pas besoin de pivy. En date de novembre 2015, la version obsolète de Pivy incluse dans le code source de FreeCAD ne compile plus sur de nombreux systèmes, en raison de son âge. Si vous ne trouvez pas Pivy dans les dépôts de paquets de votre distribution ou ailleurs, vous pouvez compiler pivy vous-même :

instructions de compilation Pivy

Compiler FreeCAD
FreeCAD utilise CMake comme système de construction principal. CMake est un système de compilation disponible sur tous les principaux systèmes d'exploitation. Compiler avec CMake est généralement très simple et se fait en deux étapes.


 * 1) CMake vérifie que tous les programmes et toutes les bibliothèques nécessaires sont présents sur votre système et configure le système de construction pour la deuxième étape. FreeCAD a le choix entre plusieurs options de configurations. Certaines alternatives sont détaillées ci-dessous.
 * 2) La compilation elle-même qui produit l'exécutable FreeCAD.

FreeCAD est une application volumineuse. La compilation peut durer entre 10 et 30 minutes en fonction de la puissance du matériel effectuant la compilation.

Compilation out-of-source
Si vous avez l’intention de suivre l’évolution rapide de FreeCAD, il est pratique de créer un dossier séparé que de le construire dans la source. Chaque fois que vous mettez à jour le code source, CMake peut déterminer de manière intelligente quels fichiers ont été modifiés et ne recompiler que ce qui est nécessaire. Les compilations hors source sont particulièrement pratiques lorsque vous utilisez le système Git car vous pouvez facilement essayer d’autres branches sans "dérouter" le système de compilation. Pour construire out-of-source, créez simplement un répertoire de construction distinct de votre dossier source FreeCAD et dans le dossier de compilation pointez CMake (ou si vous utilisez cmake-gui, remplacez "cmake" dans le code ci-dessous par "cmake-gui ") dans le dossier source:

L’exécutable FreeCAD se trouvera alors dans le répertoire freecad-build/bin.

Compilation in-source
Les compilations in-source conviennent si vous regardez uniquement FreeCAD et souhaitez pouvoir le supprimer facilement en supprimant simplement ce dossier. Cependant, si vous n'êtes pas sûr où le compiler, ne faites pas une compilation in-source. Faites une compilation out-of-source comme expliqué précédemment. Cependant FreeCAD peut être compilé en mode in-source ce qui signifie que tous les fichiers résultant de la compilation restent dans le même dossier que le code source.

Les commandes suivantes vont compiler FreeCAD:

L’exécutable FreeCAD se trouvera alors dans le répertoire freecad-source/bin .

Comment réparer votre répertoire du code source après avoir accidentellement effectué une compilation dans le dossier source
Ceci est une méthode utilisant Git pour réparer votre répertoire du code source après avoir accidentellement effectué une compilation dans le dossier source. Si vous ne l'effacez pas, les exécutions ultérieures de cmake risquent de ne pas capturer toutes vos nouvelles options.

La première ligne efface le fichier  .gitignore . Cela garantit que les commandes de nettoyage et de réinitialisation suivantes affecteront tout le contenu du répertoire et n'ignoreront pas les éléments correspondant aux expressions contenues dans .gitignore. La deuxième ligne supprime tous les fichiers et répertoires qui ne sont pas suivis par le référentiel git, puis la réinitialisation réinitialisera toutes les modifications apportées aux fichiers suivis (y compris la première commande effaçant le fichier .gitignore</tt>.

Configuration
En appliquant différentes options à CMake, vous pouvez modifier la manière dont FreeCAD est compilé. Cela peut être utile à plusieurs fins. Par exemple, en appelant CMake comme ceci, vous pouvez lui demander de ne pas construire le module FEM:

Toutes les options possibles sont listées dans le fichier racine CMakeLists.txt</tt> de FreeCAD. Essayez de rechercher la chaîne OPTION</tt>. Vous pouvez également utiliser la commande cmake-LH</tt>. Ci-dessous, nous avons répertorié certaines des options les plus pertinentes que vous pourriez vouloir configurer.

Pour indiquer une valeur pour une option trouvée dans le fichier CMakeLists.txt</tt>, utilisez l'indicateur suivant: -D : =

Ou pour une compilation "Release"
Une version Release sera beaucoup plus rapide qu'une version Debug. Sketcher devient très lent avec les croquis complexes si votre FreeCAD est une version Debug.

Pivy interne ou externe
Si vous souhaitez utiliser votre copie de Pivy de votre système, ce que vous ferez le plus souvent, définissez le drapeau du compilateur sur le bon Pivy avec -DFREECAD_USE_EXTERNAL_PIVY=1</tt>. L'utilisation d'un Pivy externe est devenu la manière par défaut pour Linux lors du développement de FreeCAD 0.16. Il n'est pas besoin de définir manuellement lors de la compilation à partir de cette version sous Linux.

Compiler pour Qt5
Par défaut FreeCAD est compilé pour Qt4. Il est possible de compiler pour Qt5 en activant l'option -DBUILD-QT5</tt>.

Compiler pour une version spécifique de Python
Par défaut, FreeCAD ne peut détecter que Python 2. Il est possible de choisir comment compiler une version spécifique de Python (par exemple Python 2 ou Python 3) en définissant certaines options cmake</tt>. Un exemple pour Python 3 est présenté ci-dessous:

Les emplacements et les numéros de version de vos fichiers et répertoires Python seront différents selon la distribution que vous utilisez. Vous pouvez les trouver en utilisant le locate</tt> or which</tt> d'Unix.

Building with Qt Creator
To use Qt5 and Python 3, add the following to the bottom of: Projects -> Manage Kits -> Kits -> Default (or your kit) -> CMake Configuration:

The paths used for python depend on your system and might need to be changed. "python3 -m site" in a terminal will at least help with determining the site-package directory.

If you aren't using Python 3.7.x, you will need to replace the "3.7". From a terminal you can check with "python3 -V" and ignore the number furthest right.

Switch Projects -> Run -> Run Configuration from FreeCADMainCMD to FreeCADMain (unless you want the command line only version).

Le plugin de développement de Qt
Si vous souhaitez développer des éléments Qt pour FreeCAD, vous aurez besoin du plugin Qt Designer qui fournit tous les widgets personnalisés de FreeCAD. Aller à:

Jusqu’à présent, nous ne fournissons pas de fichier Make, mais appelons

le crée. Une fois que c'est fait, appeler

créera la bibliothèque libFreeCAD_widgets.so</tt>. Pour faire connaître cette bibliothèque à Qt Designer, vous devez copier le fichier dans $QTDIR/plugin/designer</tt>

Doxygen
Si vous vous sentez assez audacieux pour plonger dans le code, vous pouvez en profiter pour construire et consulter le Documentation source de FreeCAD généré par Doxygen

Construire un paquet Debian
Si vous envisagez de construire un paquet Debian voici les sources que vous devez installer en premier :

Pour construire un paquet ouvrez une console, puis il suffit d'aller dans le répertoire FreeCAD et l’appeler

Une fois que le paquet est construit, vous pouvez utiliser lintian pour vérifier si le paquet contient des erreurs

Note sur les systèmes 64 bits
Pour la compilation de FreeCAD pour 64 bits, il y a un problème connu avec le paquet OpenCASCADE 64 bits. Afin que FreeCAD s'exécute correctement, vous pourriez devoir exécuter le script ./configure avec le réglage additionnel define _OCC64 :

Sous les systèmes basés sur Debian, cette solution n'est pas requise avec l'utilisation du paquet précompilé OpenCASCADE, puisque celui-ci est déja compilé avec ce réglage. Maintenant il ne reste plus qu'à compiler FreeCAD tel que décrit ci-dessus.

Scripts de compilation automatiques
Voici tout ce dont vous avez besoin pour une compilation complète de FreeCAD. Il s'agit d'une approche en un unique script qui fonctionne sous une distribution fraîchement installée. Les commandes demanderont un mot de passe (pour l'installation des paquets) et parfois reconnaître une empreinte pour un serveur externe ou le dépôt https-subversion. Ces scripts devraient fonctionner autant sous des systèmes 32 bits que 64 bits. Ils sont rédigés pour des versions spécifiques, mais devraient aussi fonctionner sous des versions ultérieures sans changements ou avec changements mineurs.

Si vous avez un tel script pour votre distribution favorite, svp envoyez-le nous ! Nous l'intégrerons dans cet article.

Ubuntu
Ces scripts fournissent un moyen fiable d'installer le bon ensemble de dépendances pour compiler et exécuter FreeCAD sur Ubuntu. Ils utilisent les dépôts PPA d'Ubuntu et devraient fonctionner sur n'importe quelle version d'Ubuntu ciblée par le PPA. Le 'daily' PPA cible les versions récentes d'Ubuntu et le 'stable' PPA cible toutes les versions officiellement supportées d'Ubuntu.

Ce script installe les dépendances pour l’instantané de développement quotidien de FreeCAD

Ce script installe les dépendances pour la dernière version stable de FreeCAD. (Pour Ubuntu 12.04, enlever "--enable-source" de la commande add-apt-repository)

(Ces scripts installent également les PPA de la compilation de FreeCAD en tant qu'effet secondaire.Vous pourriez alors les désinstaller tout en gardant les dépendances. Cependant, le laisser installé permettra au gestionnaire de paquets de garder l'ensemble des dépendances à jour, ce qui est utile si vous suivez le développement pendant une longue période.)

Après avoir installé les dépendances, consultez les instructions génériques pour obtenir le code source, exécuter CMake et compiler. Le script suivant est un exemple d'un moyen de le faire.

OpenSUSE 12.2
Aucuns dépôts externes ne sont nécessaires pour compiler FreeCAD 0.13 avec cette version. Cependant, il existe un incompatibilité avec python3-devel qui doit être enlevé. FreeCAD peut être compilé à partir de GIT de la même manière que pour OpenSUSE 12.2

Since you are using git, next time you wish to compile you do not have to clone everything, just pull from git and compile once more

Fedora 27/28/29
Posted by user [PrzemoF] in the forum.

{ echo "~/$MAIN_DIR already exist. Quitting.."; exit; } cd $MAIN_DIR git clone https://github.com/FreeCAD/FreeCAD.git mkdir $BUILD_DIR

Mettre à jour le code source
Le développement de FreeCAD est très rapide, presque chaque jour il y a des correctifs ou de nouvelles fonctionnalités. Le système cMake vous permet de mettre à jour le code source de façon intelligente, et ne recompile que ce qui a changé, ce qui accélère les compilations subséquentes. La mise à jour du code source avec git ou sous-version est très facile :

Déplacez vous dans le répertoire de compilation approprié et exécutez cmake encore une fois (puisque cmake met à jour les données du numéro de version pour le menu Aide, ...A propos de FreeCAD), cependant, vous n'avez pas besoin d'ajouter le chemin au code source après "cmake", juste un espace et un point :

Liens
Consultez également Compilation - Accélérer Comment accélérer la compilation.