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 :

This command may install the wrong libraries, so please verify that you have installed the following packages.

These packages are essential for any sort of compilation to succeed:
 * , installs the C and C++ compilers and C libraries.
 * , essential tool to configure the source of FreeCAD.
 * , essential tools to produce shared libraries.

Scripting in FreeCAD uses the Python language, so it needs to be installed:
 * or
 * or

soit : (Debian jessie, stretch, Ubuntu 16.04 à 18.10) ou : (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)

The Boost libraries need to be installed:

Some utilities needs to be installed:
 * , to report the system used.
 * , to integrate C++ code with Python.

Several libraries that deal with mathematics, computer vision, triangulated surfaces, meshes, cartographic projection, 3D visualization, XML parsing, Zip file reading, and the X11 Window system need to be installed:
 * or
 * or
 * or
 * or
 * or
 * or
 * or
 * or

Python 2 and Qt4
To compile FreeCAD for Debian Jessie, Stretch, Ubuntu 16.04, using Python 2 and Qt4, install the following dependencies. This is not recommended anymore as both Python 2 and Qt4 are obsolete and will disappear from future Linux distributions.

Python 3 and Qt5
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) :
 * or
 * or
 * or

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

The OpenCascade kernel is the core graphics library to create 3D shapes. It exists in an official version OCCT, and a community version OCE. The community version is no longer recommended, as it's outdated.

For Debian Buster and Ubuntu 18.10 and newer, as well as Ubuntu 18.04 with the freecad-stable/freecad-daily PPAs added to your software sources, install the official packages.

For Debian Jessie, Stretch, Ubuntu 16.04 and newer, install the community edition packages.

Notez que liboce*-dev/libocct*-dev inclusent les bibliothèques suivantes (substituez oce par occt) :

Vous pouvez optionnellement installer ces paquets supplémentaires : (pour enregistrer vous fichiers installés dans votre gestionnaire de paquets, afin de pouvoir les désinstaller facilement plus tard)
 * , (pour permettre à Coin d'offrir davantage de formats d'images)
 * and, (si vous avez l'intention de générer la documentation du code source)
 * , (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
Les commandes suivantes installeront les packages nécessaires à la construction de FreeCAD avec Qt5 et Python 3.

La commande suivante installera Qt Creator et le débogueur de projet GNU.

S'il manque des packages, vous pouvez vérifier le fichier Tumbleweed "FreeCAD.spec" sur Open Build Service.

Vérifiez également s’il existe des correctifs à appliquer (tels que 0001-find-openmpi2-include-files.patch).

Leap
S'il existe une différence entre les packages disponibles sur Tumbleweed et Leap, alors vous pouvez lire le lien "FreeCAD.spec" file on the Open Build Service pour déterminer les paquets requis.

Arch Linux
Vous aurez besoin des bibliothèques suivantes des référentiels officiels:


 * boost-libs
 * curl
 * desktop-file-utils
 * glew
 * hicolor-icon-theme
 * jsoncpp
 * libspnav
 * med
 * opencascade
 * shiboken2
 * xerces-c
 * pyside2
 * python-matplotlib
 * python-netcdf4
 * qt5-svg
 * qt5-webkit
 * qt5-webengine
 * boost
 * cmake
 * eigen
 * git
 * gcc-fortran
 * pyside2-tools
 * swig
 * qt5-tools
 * shared-mime-info

Aussi, assurez vous de vérifier le AUR pour tout paquet manquant qui ne sont pas dans les dépôts, actuellement :
 * coin
 * python-pivy
 * med

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 :

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.

Vous pouvez générer le code dans ou hors du répertoire source. La construction hors source est généralement la meilleure option.

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.

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.

If you accidentally performed a compilation inside the source code directory, and would like to restore the contents to only the original source code, you can perform the following steps.

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>.

If you do not clear the source directory, subsequent runs of may not capture new options to the system if the code changes.

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:

Where is the directory that contains the source code. The may be omitted in most cases. The space after the option may also be omitted.

For example, to avoid building the FEM module:

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.

option(BUILD_FORCE_DIRECTORY "The build directory must be different to the source directory." OFF) option(BUILD_GUI "Build FreeCAD Gui. Otherwise you have only the command line and the Python import module." ON) option(FREECAD_USE_EXTERNAL_ZIPIOS "Use system installed zipios++ instead of the bundled." OFF) option(FREECAD_USE_EXTERNAL_SMESH "Use system installed smesh instead of the bundled." OFF) ... }}

Alternatively, use the command to list the current configuration, and thus all variables that can be changed (a big list). Below, we've listed some of the more relevant options you may want to use.

Pour une compilation "Debug"
Create a build to troubleshoot crashes in FreeCAD. Beware that the Sketcher becomes very slow with complex sketches with a build.

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.

Create a build to test code that doesn't crash. A build will run much faster than a  build.

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>.

By default, FreeCAD builds for Qt4. It is possible to build for Qt5 with the following option.

Building against Python 3 and Qt5
In a modern Linux distribution you only need to provide the path to the Python interpreter for the compilation system to be configured correctly.

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:

By default your system may use Python 2, so CMake will try to configure the compilation of FreeCAD against this version. It is possible to choose a specific version of Python by specifying the desired Python executable.

If that doesn't work, you may have to define other variables with the required Python directories.

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.

Also use in a terminal to determine the  or  directories.

Compiler avec Qt Creator
Pour utiliser Qt5 et Python 3, ajoutez ce qui suit au bas de : Projects → Manage Kits → Kits → Default (or your kit) → CMake Configuration:

Les chemins utilisés pour python dépendent de votre système et doivent éventuellement être modifiés. "Python3 -m site" dans un terminal aidera au moins à déterminer le répertoire site-package.

Switch Projects → Run → Run Configuration de FreeCADMainCMD à FreeCADMain (à moins que vous ne vouliez utiliser que la version en ligne de commande).

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 à:

Go to

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

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

Once that's done, run

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>

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.

Using external Pivy became the default during development of FreeCAD 0.16, therefore this option does not need to be set manually anymore.

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

Arch using AUR
Arch User Repository (AUR) is a collection user made recipes to build packages which are not officially supported by distribution maintainers / community. They are usually safe. You can see who maintain the package and for how long he did. It is recommended to check construction files. Also non open source software are available in this area even if maintained by the official owning company.

Prerequisite : git

Steps :
 * 1) Open a terminal. Optionally create a directory eg. . Optionally change directory eg..
 * 2) Clone the AUR repository :
 * 3) Enter AUR repository folder :
 * 4) Compile using Arch makepkg : . The -s or --syncdeps flag will also install required dependencies.
 * 5) Install created package : or double click on the pkgname-pkgver.pkg.tar.xz inside your file browser.

To update FreeCAD to latest build just repeat from step 3. Update AUR repo when there is some breaking change in the recipe or new features using inside the folder.

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 :

The CMake system allows you to intelligently update the source code, and only recompile what has changed, making subsequent compilations faster.

Move to the location where the FreeCAD source code was first downloaded, and pull the new code.

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 :

To use all CPU cores for compilation use

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