Compile on Linux/fr

Présentation
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 ou les paquets dont FreeCAD dépend
 * 3) Configurer avec  et compiler avec

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, pour les discussion voir sur le forum, votre aide pour corriger le tout sera appréciée.





Git
Le meilleur moyen d’obtenir le code est de cloner le dépôt Git en lecture seule. Pour cela, vous avez besoin du programme qui peut être installé dans la plupart des distributions Linux. Il peut également être obtenu sur le site officiel.

Git peut être installé via la commande suivante :

La commande suivante placera une copie de la dernière version du code source de FreeCAD dans un nouveau répertoire appelé.

Pour plus d'informations sur l'utilisation de Git et sur la contribution de code au projet, voir gestion du code source.



Source sous forme archive
Vous pouvez aussi télécharger la source sous forme d'archive, fichier ou  et décompresser cela dans le dossier voulu.



Obtenir les dépendances
Pour compiler FreeCAD, vous devez installer les dépendances requises mentionnées dans les Bibliothèques externes ; les packages contenant ces dépendances sont répertoriés ci-dessous pour différentes distributions Linux. Veuillez noter que les noms et la disponibilité des bibliothèques dépendront de votre distribution particulière. Si votre distribution est ancienne, certains paquets peuvent ne pas être disponibles ou avoir un nom différent. Dans ce cas, consultez la section Anciennes distributions et distributions non-conventionnelles ci-dessous.

Une fois que vous avez toutes les dépendances installées procédez à la Compilation de FreeCAD.

Veuillez noter que le code source de FreeCAD est d’environ 500 Mo ; il peut être trois fois plus gros si vous clonez le référentiel Git avec son historique de modifications complet. Obtenir toutes les dépendances peut nécessiter le téléchargement de 500 Mo ou plus de nouveaux fichiers ; Lorsque ces fichiers sont décompressés, ils peuvent nécessiter 1500 Mo ou plus d’espace. Notez également que le processus de compilation peut générer jusqu'à 1500 Mo de fichiers supplémentaires lorsque le système copie et modifie le code source complet. Par conséquent, assurez-vous de disposer de suffisamment d’espace libre sur votre disque dur, au moins 4 Go, lors de la tentative de compilation.



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

Cependant, si la version de FreeCAD dans les référentiels est ancienne, les dépendances peuvent être mauvaises pour compiler une version récente de FreeCAD. Par conséquent, vérifiez que vous avez installé les packages suivants.

Ces packages sont essentiels à la réussite de toute compilation :
 * , installe les compilateurs C et C++ et les librairies C.
 * , un outil indispensable pour configurer la source de FreeCAD. Vous pouvez également souhaiter installer et  pour une option graphique.
 * , des outils essentiels pour produire des librairies partagées.
 * , l'utilitaire reporting de base standard est normalement déjà installé sur un système Debian et vous permet de distinguer, par programme, entre une installation Debian pure et une variante, telle que Ubuntu ou Linux Mint. Ne supprimez pas ce paquet, car de nombreux autres paquets système peuvent en dépendre.

La compilation de FreeCAD utilise le langage Python, et est également utilisé au moment de l'exécution en tant que script. Si vous utilisez une distribution basée sur Debian, l'interpréteur Python est normalement déjà installé.
 * , l'outil qui crée des interfaces entre le code C++ et Python.
 * , l'outil qui crée des interfaces entre le code C++ et Python.

Veuillez vérifier que vous avez installé Python 3. Python 2 étant obsolète en 2019, les nouveaux développements dans FreeCAD ne sont pas testés avec cette version du langage.

Les librairies Boost doivent être installées :



Les librairies Coin doivent être installées :
 * , pour Debian Jessie, Stretch, Ubuntu 16.04 à 18.10, ou
 * , pour Debian Buster, Ubuntu 19.04 et suivants, ainsi que pour Ubuntu 18.04/18.10 avec les PPAs freecad-stable/freecad-daily ajoutés à vos sources logicielles.

Plusieurs librairies traitant des mathématiques, des surfaces triangulées, du tri, des maillages, de la vision par ordinateur, des projections cartographiques, de la visualisation 3D, du système X11 Window, de l'analyse XML et de la lecture de fichiers Zip :


 * or
 * or
 * or
 * or
 * or
 * or
 * or
 * or



Python 2 et Qt4
Ceci n'est pas recommandé pour les nouvelles installations comme Python 2 et Qt4 sont obsolètes. À partir de la version 0.20, Freecad ne les maintient plus.

Pour compiler FreeCAD pour Debian Jessie, Stretch, Ubuntu 16.04, en utilisant Python 2 et Qt4, installez les dépendances suivantes.





Python 3 et Qt5
Pour compiler FreeCAD avec 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, installez les dépendances suivantes.


 * (if compiling 0.20 on a machine that still has Qt4)
 * (if compiling 0.20 on a machine that still has Qt4)
 * (if compiling 0.20 on a machine that still has Qt4)



Noyau OpenCascade
Le noyau OpenCascade est la librairie graphique principale pour créer des formes 3D. Il existe dans une version officielle OCCT et une version communautaire OCE. La version communautaire n'est plus recommandée car elle est obsolète.

Pour Debian Buster, Ubuntu 18.10 et versions ultérieures, ainsi que pour Ubuntu 18.04 avec les freecad-stable/freecad-daily PPAs ajoutés à vos sources de logiciels, installez les paquets officiels.



Pour Debian Jessie, Stretch, Ubuntu 16.04 et plus récente, installez les paquetages Édition Communautaire.



Vous pouvez installer toutes les librairies individuellement ou en utilisant l’extension astérisque. Changez par  si vous voulez installer les librairies de la communauté.



Paquets optionnels
Vous pouvez éventuellement installer ces paquets supplémentaires :
 * , pour que Coin prenne en charge d'autres formats de fichier image.
 * et (ou  pour d'anciens systèmes), si vous avez l’intention de générer de la documentation sur le code source.
 * , pour la prise en charge des Périphériques d'entrée 3D, comme "Space Navigator" ou "Space Pilot".
 * , si vous avez l'intention d'enregistrer vos fichiers installés dans le gestionnaire de paquets de votre système, afin de pouvoir les désinstaller ultérieurement.



Commande unique pour Qt5 et Python 3
Requiert Pyside2, disponible sous Debian Buster et les freecad-stable/freecad-daily PPAs.

REMARQUE : Sur certaines versions d'Ubuntu et certaines versions de Qt, vous obtiendrez une erreur indiquant que python3-pyside2uic est introuvable -- sur ces systèmes, vous pouvez l'omettre sans risque. Sur Ubuntu 20.04, vous devrez ajouter. Vous trouverez plus d'informations dans cette discussion du forum.



Commande unique pour Python 2 et Qt4
Ceci n’est pas recommandé pour les nouvelles installations car Python 2 et Qt4 sont obsolètes.

Utilisateurs de Ubuntu 16.04, veuillez aussi consulter la discussion sur la compilation dans le forum Compiler sur Linux (Kubuntu): CMake ne peut pas trouver VTK.

Raspberry Pi
Suivez les mêmes étapes que pour Debian et Ubuntu.

Des problèmes ont été signalés lors de la tentative de compilation dans Raspberry PI OS 32-bit avec Python 3 et Qt5, mais la combinaison Python 3 et Qt4 semble fonctionner pour les anciennes versions de FreeCAD (avec des problèmes mineurs).

Pour les versions plus récentes de FreeCAD (>= 0.20), la compilation avec Py3/Qt5 fonctionne si le système d'exploitation installé est Raspberry Pi OS 64-bit ou Ubuntu 20.04

En raison de différents problèmes avec Qt, avec Ubuntu 20.04, les outils PySide normaux ne seront pas trouvés.

Dans ce cas, nous pouvons installer les packages depuis PyQt et créer des liens symboliques vers les outils nécessaires.

La compilation peut maintenant se poursuivre.

L'option de  ne doit pas dépasser 3 car le Raspberry Pi a une mémoire limitée. La compilation prendra plusieurs heures, il est donc préférable de le faire pendant la nuit.

Plus d'informations, FreeCAD et Raspberry Pi 4.

Fedora
Il y a un bogue dans cmake distribué par Fedora 34/35 qui fait que cmake ne trouve pas les bibliothèques d'opencascade. Ceci peut être facilement corrigé en faisant un changement mineur au fichier cmake de niveau supérieur d'opencascade installé sur Fedora. Plus de détails ici : https://bugzilla.redhat.com/show_bug.cgi?id=2083568.

Vers le haut du fichier, changez la ligne suivante pour utiliser. Ceci corrige un bogue introduit par l'utilisation d'un lien symbolique de à  de Fedora, qui fait échouer cmake.

Ce fichier est généralement installé dans.

changez cela en :

Ce changement trivial doit être fait dans le répertoire de compilation une fois que cmake a été lancé et a échoué. Une nouvelle exécution de cmake détectera alors correctement les bibliothèques OCCT de la manière habituelle.

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
 * opencascade-devel
 * openmpi-devel
 * python3
 * python3-devel
 * python3-pyside2
 * python3-pyside2-devel
 * pyside2-tools
 * boost-devel
 * tbb-devel
 * eigen3-devel
 * qt-devel
 * qt5-qtwebengine-devel
 * qt5-qtxmlpatterns
 * qt5-qtxmlpatterns-devel
 * qt5-qtsvg-devel
 * qt5-qttools-static
 * ode-devel
 * xerces-c
 * xerces-c-devel
 * opencv-devel
 * smesh-devel
 * Coin3
 * Coin3-devel

(Avril 2021, Coin4 et Coin4-devel sont disponibles) (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
 * vtk
 * vtk-devel
 * med
 * med-devel

Et éventuellement :


 * libspnav-devel (pour le support des périphériques 3Dconnexion comme le Space Navigator ou le Space Pilot)
 * python3-pivy (https://bugzilla.redhat.com/show_bug.cgi?id=458975 Pivy n'est pas obligatoire mais nécessaire pour l'atelier Draft)
 * python3-markdown (pour que le gestionnaire d'addons affiche le markdown natif)
 * python3-GitPython (pour que le gestionnaire d'addons utilise git, vérifie et mette à jour les ateliers et les macros)

Pour installer toutes les dépendances en une seule fois (testé sur fedora 36 et 37) :

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.

Voir piano_jonas unofficial "Compile On openSUSE" guide.

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


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

<span id="Older_and_non-conventional_distributions">

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.

Essayez d’abord de localiser les bibliothèques requises mentionnées dans third party libraries/fr|bibliothèques tierces dans votre gestionnaire de paquets. Attention, certains d'entre eux pourraient avoir un nom de paquet légèrement différent; recherchez, mais aussi , , et similaire. Si ce n'est pas possible, essayez de compiler vous-même ces bibliothèques.

FreeCAD requiert une version du compilateur GNU g++ supérieure ou égale à la version 3.0.0, car FreeCAD est principalement écrit en C++. Lors de la compilation, certains scripts Python sont exécutés. L'interpréteur Python doit donc fonctionner correctement. Pour éviter tout problème d’éditeur de liens, il est également conseillé d’avoir les chemins de bibliothèque dans la variable ou dans le fichier. Cela est déjà fait dans les distributions Linux modernes, mais il faudra peut-être le configurer dans les anciennes.

Pivy
Pivy (les wrappers Python sous Coin3d) n'est pas nécessaire pour construire FreeCAD ni pour le démarrer, mais il est nécessaire en tant que dépendance d'exécution par l'atelier Draft. Si vous n'utilisez pas cet atelier, vous n'aurez pas besoin de Pivy. Cependant, notez que l'atelier Draft est utilisé en interne par d'autres ateliers, tels que Arch et BIM, aussi Pivy doit-il être installé pour pouvoir également utiliser ces ateliers.

Depuis novembre 2015, la version obsolète de Pivy incluse dans le code source de FreeCAD n'est plus compilée sur de nombreux systèmes. Ce n'est pas un gros problème car normalement vous devriez obtenir Pivy depuis le gestionnaire de paquets de votre distribution ; si vous ne trouvez pas Pivy, vous devrez peut-être le compiler vous-même, voir les instructions de compilation de Pivy.

<span id="Debug_symbols">

Symboles de débogage
Afin de résoudre les pannes dans FreeCAD, il est utile de disposer des symboles de débogage d'importantes bibliothèques de dépendances telles que Qt. Pour cela, essayez d'installer les packages de dépendance se terminant par, , ou similaire, selon votre distribution Linux.

Pour Ubuntu, vous devrez peut-être activer les dépôts spéciaux pour pouvoir voir et installer ces paquets de débogage avec le gestionnaire de paquets. Voir Paquets de symboles de débogage pour plus d'informations.

<span id="Compile_FreeCAD">

Compiler FreeCAD
FreeCAD utilise CMake comme système de construction principal, qui 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 génère un  qui est configuré 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, effectuée avec le programme, génère les exécutables FreeCAD.

FreeCAD étant une application volumineuse, la compilation de tout le code source peut durer de 10 minutes à une heure, en fonction de votre CPU et du nombre de cœurs de CPU utilisés pour 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.

<span id="Out-of-source_build">

Compilation out-of-source
Construire (build) dans un dossier séparé est plus pratique que de construire dans le même répertoire que celui où se trouve le code source, car chaque fois que vous mettez à jour le code source, CMake peut déterminer de manière intelligente les fichiers modifiés et recompiler uniquement ce qui est nécessaire. Ceci est très utile lorsque vous testez différentes branches de Git, car vous ne confondez pas le système de construction.

Pour construire out-of-source, créez simplement un répertoire de construction distinct de votre dossier source FreeCAD  ; ensuite depuis le dossier de compilation pointez  comme dossier source. Vous pouvez également utiliser ou  au lieu de  dans les instructions ci-dessous. Une fois que a fini de configurer l’environnement, utilisez  pour lancer la nouvelle compilation.

Remarque: Si vous compilez la branche de version 0.19, vous devez explicitement spécifier que vous compilez avec Qt5 et Python 3 - Remplacez la commande CMAKE ci-dessus par:

L'option de  contrôle le nombre de jobs (fichiers) compilés en parallèle. Le programme retourne le nombre de cœurs de processeur de votre système utilisés avec l'option, vous pouvez choisir de procéder sur autant de fichiers que vous avez de cœurs afin d'accélérer la compilation. Dans l'exemple ci-dessus, il sera utilisé tous les cœurs de votre système sauf deux ; Cela permettra à votre ordinateur de rester réactif pour d'autres usages pendant la compilation en arrière-plan. L'exécutable FreeCAD apparaîtra éventuellement dans le dossier. Voir aussi Compilation (accélération) pour améliorer la vitesse de compilation.

<span id="Resolving_cmake_issues">

Résoudre les problèmes de cmake
Si vous avez déjà effectué une construction hors source et que vous êtes bloqué par une dépendance qui n'est pas reconnue ou qui ne semble pas pouvoir être résolue, essayez ce qui suit :


 * Supprimez le contenu du répertoire de construction avant de relancer cmake. FreeCAD est une cible qui évolue rapidement, vous pouvez rencontrer des informations de cmake en cache qui pointent vers une version plus ancienne que celle que la nouvelle tête de dépôt peut utiliser. Vider le cache peut permettre à cmake de récupérer et de reconnaître la version dont vous avez réellement besoin.


 * Si cmake se plaint qu'il manque un fichier spécifique, utilisez un outil tel que "apt-file search" ou son équivalent dans d'autres systèmes de paquets, pour découvrir à quel paquetage appartient ce fichier et l'installer. Gardez à l'esprit que vous aurez probablement besoin de la version -dev du paquetage qui contient les fichiers d'en-tête ou de configuration nécessaires à FreeCAD pour utiliser le paquetage.

<span id="Compiling_against_GNU_libc_2.34_and_later">

Compiler avec GNU libc 2.34 et versions ultérieures
GNU libc 2.34 introduit un changement dans la bibliothèque qui peut faire échouer les builds sur certains systèmes Linux avec une erreur du type :

Pour résoudre ce problème, un lien symbolique doit être créé manuellement à partir de libdl.so.* (maintenant vide) installé sur le système vers l'emplacement où votre compilateur indique qu'il recherche le fichier. Par exemple (si la copie réellement installée de libdl.so sur votre système est /usr/lib/x86_64-linux-gnu/libdl.so.2) :

Adaptez la commande à la structure de votre système en recherchant libdl.so* et en le liant à l'emplacement approprié.

<span id="In-source_building">

Compilation in-source
Les compilations in-source conviennent si vous voulez compiler rapidement une version de FreeCAD et que vous n’avez pas l’intention de mettre à jour souvent le code source. Dans ce cas, vous pouvez supprimer le programme compilé et la source en supprimant simplement un seul dossier.

Allez dans le répertoire source et pointez dans le répertoire actuel (désigné par un simple point) :

L’exécutable FreeCAD se trouvera alors dans le répertoire.

<span id="How_to_repair_your_source_code_directory">

Comment réparer votre répertoire du code source
Si vous avez accidentellement effectué une compilation dans le répertoire du code source, ou ajouté des fichiers étranges, et souhaitez restaurer le contenu uniquement du code source d'origine, vous pouvez effectuer les étapes suivantes.

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

Si vous n'effacez pas le répertoire source, les exécutions ultérieures de risquent de ne pas intégrer les nouvelles options sur le système si le code change.

Configuration
En appliquant différentes options à, vous pouvez modifier la manière dont FreeCAD est compilé. La syntaxe est la suivante.

Où est le répertoire qui contient le code source. Le peut être omis dans la plupart des cas. L'espace après l'option peut également être omis.

Par exemple, pour éviter de construire le module FEM :

Toutes les variables possibles sont répertoriées dans le fichier, situé dans le dossier. Dans ce fichier, recherchez le mot pour obtenir toutes les variables pouvant être définies et voir leurs valeurs par défaut.


 * 1) =================   All the options for the build process    =================
 * 1) =================   All the options for the build process    =================

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

Vous pouvez également utiliser la commande pour répertorier la configuration actuelle, ainsi que toutes les variables pouvant être modifiées. Vous pouvez également installer et utiliser pour lancer une interface graphique affichant toutes les variables pouvant être modifiées. Dans les sections suivantes, nous énumérons certaines des options les plus pertinentes que vous souhaiterez peut-être utiliser.

<span id="For_a_Debug_build">

Pour une compilation de Debogage
Créez une version pour résoudre les pannes dans FreeCAD. Attention, avec cette construction, l'atelier Sketcher devient très lent avec des esquisses complexes.

<span id="For_a_Release_build">

Pour une compilation "Release"
Créez une version pour tester que le code qui ne plante pas. Une sera beaucoup plus rapide qu'une version.

<span id="Building_against_Python_3_and_Qt5">

Compiler en s'appuyant sur Python 3 et Qt5
Le support de Python 2 et Qt4 a été supprimé dans FreeCAD 0.20 et il n'est pas nécessaire d'activer explicitement Qt5 et Python 3 si vous compilez les dernières versions. Le support de Qt6 est actuellement en cours et ne fonctionne pas encore. A moins que vous ne prévoyiez de participer à l'effort de migration vers Qt6, FREECAD_QT_VERSION devrait être laissé à "Auto" (la valeur par défaut) ou explicitement défini à "5".

Pour la 0.20_dev et 0.21_dev :

Remarquez que lorsque vous passez de la version 0.20 à la version 0.21_dev, il peut être nécessaire de supprimer CMakeCache.txt avant d'exécuter cmake.

<span id="Building_for_a_specific_Python_version">

Compiler pour une version spécifique de Python
Si l'exécutable par défaut de votre système est un lien symbolique vers Python 2,  essaiera de configurer FreeCAD pour cette version. Vous devez alors choisir une autre version de Python en donnant le chemin vers un exécutable spécifique :

Si cela ne fonctionne pas, vous devrez peut-être définir des variables supplémentaires pointant sur les bibliothèques Python souhaitées et les répertoires inclus :

Il est possible d'avoir plusieurs versions indépendantes de Python dans le même système. Par conséquent, l'emplacement et le numéro de version de vos fichiers Python dépendent de votre distribution Linux. Utilisez pour afficher la version de Python que vous utilisez actuellement. Seuls les deux premiers chiffres sont nécessaires ; Par exemple, si le résultat est, vous devez spécifier les répertoires associés à la version 3.6. Si vous ne connaissez pas les bons répertoires, essayez de les rechercher avec la commande.

Vous pouvez utiliser dans un terminal pour déterminer les répertoires  ou  sur les systèmes Debian.

Certains composants de FreeCAD, comme PySide, essaient de détecter automatiquement la version la plus récente de Python installée sur votre système, ce qui peut échouer si elle est différente de celle que vous avez entrée ci-dessus. L'ajout de l'option cMake suivante pourrait résoudre le problème :

<span id="Building_with_Qt_Creator_against_Python_3_and_Qt5">

Compiler avec Qt Creator en s'appuyant sur Python 3 and Qt5
1. Lancez Qt Creator.

2. Cliquez sur.

3. Accédez au répertoire où se trouve le code source et choisissez le fichier  le plus haut.

4. En sélectionnant le fichier, il s'exécutera automatiquement sur, mais il peut échouer si les options appropriées ne sont pas correctement définies.

5. Accédez à. Définissez le répertoire de construction approprié,.

6. Définissez les variables appropriées dans la boîte de dialogue Valeur-clé, de types et.

7. Si les variables ne chargent pas correctement le projet, vous devrez peut-être accéder à. Appuyez ensuite sur et ajoutez la configuration appropriée comme décrit ci-dessus. Vous devrez peut-être ajouter plus de variables sur les chemins Python, si le système Python n'est pas trouvé.

7.1. Appuyez sur, puis sur.

7.2. Assurez-vous que les autres options sont correctement définies, par exemple, doit être une version actuelle installée dans le système, comme.

Appuyez sur puis sur  pour fermer la configuration.

Le programme devrait s'exécuter de nouveau automatiquement et il devrait remplir la boîte de dialogue Valeur-clé entière avec toutes les variables qui peuvent être configurées.

8. Allez à et choisissez  pour compiler la version graphique de FreeCAD ou  pour ne compiler que la version en ligne de commande.

9. Enfin, allez dans le menu. S'il s'agit d'une nouvelle compilation, cela devrait prendre plusieurs minutes, voire heures, selon le nombre de processeurs dont vous disposez.

<span id="Qt_designer_plugin">

Plugin Qt designer
Si vous souhaitez développer des éléments de code Qt pour FreeCAD, vous aurez besoin du plugin Qt Designer qui fournit tous les widgets personnalisés de FreeCAD.

Allez dans un répertoire auxiliaire du code source, lancez avec le fichier de projet indiqué pour créer un  ; puis lancez  pour compiler le plugin.

Si vous compilez pour Qt5, assurez-vous que le code binaire est celui de cette version, afin que  résultant contienne les informations nécessaires pour Qt5.

Où est le répertoire qui stocke les bibliothèques binaires Qt, par exemple,.

La librairie créée est, qui doit être copiée dans.

<span id="External_or_internal_Pivy">

Pivy interne ou externe
Auparavant, une version de Pivy était incluse dans le code source de FreeCAD (interne). Si vous souhaitez utiliser la copie de Pivy (externe) de votre système, vous devez utiliser.

L'utilisation externe de Pivy est devenue la valeur par défaut à partir du développement de FreeCAD 0.16 ; cette option n'a donc plus besoin d'être définie manuellement.

<span id="Doxygen_documentation">

Documentation Doxygen
Si vous avez installé Doxygen, vous pouvez créer la documentation du code source. Voir la documentation source pour les instructions.

<span id="Additional_documentation">

Documentation complémentaire
Le code source de FreeCAD est très complet et avec CMake, il est possible de configurer de nombreuses options. Apprendre à utiliser pleinement CMake peut être utile pour choisir les bonnes options pour vos besoins particuliers.
 * Documentation de référence CMake par Kitware.
 * Comment construire un projet basé sur CMake (blog) en s'appuyant sur la programmation.
 * le langage de script de CMake en 15 minutes (blog) en s'appuyant sur la programmation.

<span id="Making_a_debian_package">

Construire un paquet Debian
Si vous envisagez de construire un paquet Debian voici les sources que vous devez d’abord installer certains paquets :

Allez dans le répertoire FreeCAD et appelez

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

<span id="*.deb_package_with_checkinstall">

Paquet *.deb avec checkinstall
Le script Debian permet de créer un paquet *.deb qui peut être installé et supprimé avec les commandes standardes de. Il peut être nécessaire de l'installer au préalable (sur Ubuntu, utilisez ). Il est interactif et demande les informations nécessaires en fournissant des valeurs par défaut utiles. Pendant le processus, le paquet est installé et un fichier *.deb et une archive de sauvegarde sont créés.

Il est conseillé de définir un nom et une courte description pour le paquet. Le nom doit être saisi pour le désinstaller à nouveau et la description sera listée par. Le nom par défaut "build" n'est pas très parlant.

Exemple :

Le résultat est un fichier *.deb dans le dossier freecad-build. installera la compilation par défaut. Voici comment vous pouvez l'installer ou la désinstaller :

grep freecad freecad-test1_20220814-1_amd64.deb sudo dpkg -i freecad-test1_20220814-1_amd64.deb  # install dkpg -l

<span id="Updating_the_source_code">

Mettre à jour le code source
Le système CMake vous permet de mettre à jour intelligemment le code source et de ne recompiler que ce qui a changé, ce qui accélère les compilations ultérieures.

Déplacez-vous à l'emplacement où le code source FreeCAD a été téléchargé pour la première fois et récupérez le nouveau code :

Puis déplacez-vous dans le répertoire de construction où le code a été initialement compilé, et lancez spécifiant le répertoire actuel (indiqué par un point), puis déclenchez la recompilation avec.

<span id="Uninstalling_the_source_code">

Désinstallation du code source
Dans le cas où le code source compilé a été installé avec (pour Debian), les fichiers ont été copiés dans le dossier  en plusieurs sous-dossiers. Pour la désinstallation, le fichier peut être utilisé. Il a été créé dans le dossier de compilation pendant la compilation et contient tous les fichiers installés. Tant que ce fichier existe, l'installation peut être désinstallée.

Dépannage
<span id="For_64_bit_systems">

Pour les systèmes 64 bits
Pour la compilation de FreeCAD en 64 bits, il y a un problème connu avec le paquet OpenCASCADE (OCCT) 64 bits. Pour que FreeCAD fonctionne correctement, vous devrez peut-être exécuter le script et définir des  supplémentaires :

Pour les systèmes basés sur Debian, cette option n’est pas nécessaire lors de l’utilisation des packages OpenCASCADE pré-construits, car ceux-ci définissent le bon en interne.

<span id="Automatic_build_scripts">

Scripts de compilation automatiques
Voici tout ce dont vous avez besoin pour une compilation complète de FreeCAD. C'est une approche en un script qui fonctionne sur une distribution Linux récemment installée. Les commandes demanderont le mot de passe root pour l'installation des packages et des nouveaux référentiels en ligne. Ces scripts doivent fonctionner sur les versions 32 et 64 bits. Ils sont écrits pour différentes versions, mais sont également susceptibles de fonctionner sur une version ultérieure avec ou sans modifications majeures.

Si vous avez un tel script pour votre distribution préférée, veuillez en discuter sur le forum FreeCAD afin que nous puissions l'intégrer.

Ubuntu
Ces scripts constituent un moyen fiable d’installer le bon ensemble de dépendances requises pour créer et exécuter FreeCAD sur Ubuntu. Ils utilisent les PPA (personal package archives) et devraient fonctionner sur toute version d'Ubuntu ciblée par le PPA. Le PPA freecad-daily cible les versions récentes d'Ubuntu, tandis que le PPA freecad-stable cible les versions officiellement prises en charge d'Ubuntu.

Ce script installe l’aperçu instantané de la compilation quotidiennement de FreeCAD et ses dépendances. Il ajoute le référentiel quotidien, obtient les dépendances pour construire cette version et installe les packages requis. Ensuite, il extrait le code source dans un répertoire particulier, crée un répertoire de construction et y apporte des modifications, configure l'environnement de compilation avec et finalement construit l'ensemble du programme avec. Enregistrez le script dans un fichier, rendez-le exécutable et exécutez-le, mais n'utilisez pas ; les privilèges de super-utilisateur ne seront demandés que pour les commandes sélectionnées.

Si vous le souhaitez, vous pouvez désinstaller la version pré-compilée de FreeCAD en laissant les dépendances en place. Toutefois, laisser ce paquet installé permettra au gestionnaire de paquets de garder ses dépendances à jour également ; Cela est surtout utile si vous souhaitez suivre le développement de FreeCAD et mettre à jour et compiler en permanence les sources à partir du référentiel Git.

Le script précédent suppose que vous souhaitiez compiler la dernière version de FreeCAD, vous utilisez donc le référentiel "quotidien" pour obtenir les dépendances. Cependant, vous pouvez préférer obtenir les dépendances de construction de la version "stable" pour la version actuelle d'Ubuntu. Si tel est le cas, remplacez la partie supérieure du script précédent par les instructions suivantes. Pour Ubuntu 12.04, omettez de la commande.

Une fois que vous avez installé le paquet à partir du référentiel, il remplacera l'exécutable FreeCAD disponible à partir du référentiel Universe Ubuntu. L'exécutable s'appellera simplement, et non pas.

openSUSE
Aucun dépôt externe n'est nécessaire pour compiler FreeCAD. Cependant, il y a une incompatibilité avec python3-devel qui doit être supprimée. FreeCAD peut être compilé à partir de GIT.

Après avoir utilisé git, la prochaine fois que vous souhaiterez recompiler vous même, vous n'aurez pas à tout cloner, il vous suffira d'extraire de git et de recompiler une nouvelle fois.

Fedora 27/28/29
Vous pouvez poster à l'utilisateur [PrzemoF] sur le forum.

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

<span id="Arch_using_AUR">

Arch utilise AUR
Arch User Repository (AUR) est une collection de recettes faites par les utilisateurs pour construire des packages qui ne sont pas officiellement supportés par les responsables de la distribution / la communauté. Ils sont généralement en sécurité. Vous pouvez voir qui gère le colis et pendant combien de temps il l'a fait. Il est recommandé de vérifier les fichiers de construction. Des logiciels non-open source sont également disponibles dans cette zone même s'ils sont gérés par la société propriétaire.

Prérequis : git

Étapes :
 * 1) Ouvrez un terminal. Créez un répertoire, par exemple . Changez de répertoire par exemple.
 * 2) Cloner le dépôt AUR :
 * 3) Entrez le dossier du dépôt AUR :
 * 4) Compilez en utilisant Arch makepkg : . Les flag -s ou --syncdeps installeront également les dépendances requises.
 * 5) Installez le paquet créé : ou double-cliquez sur pkgname-pkgver.pkg.tar.xz dans votre navigateur de fichiers.

Pour mettre à jour FreeCAD vers la dernière version, répétez l'étape 3. Mettez à jour le dépôt AUR lorsqu'il y a un changement de rupture dans la manière de faire ou de nouvelles fonctionnalités en utilisant dans le dossier.