Difference between revisions of "CompileOnUnix/fr"

From FreeCAD Documentation
Jump to: navigation, search
(Created page with "Pour mettre à jour FreeCAD vers la dernière version, recommencez à partir de l'étape 3. Mettez à jour le référentiel AUR en cas de modifications importantes de la recet...")
(33 intermediate revisions by 3 users not shown)
Line 19: Line 19:
  
 
Ceci créera une copie de la dernière version du code source de FreeCAD dans un nouveau répertoire nommé {{incode|freecad-source}}.
 
Ceci créera une copie de la dernière version du code source de FreeCAD dans un nouveau répertoire nommé {{incode|freecad-source}}.
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
sudo apt install git
 
sudo apt install git
Line 37: Line 38:
  
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
 +
 
=== Debian et Ubuntu ===
 
=== Debian et Ubuntu ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
 
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 {{incode|apt}}, le gestionnaire de paquets Synaptic, ou le gestionnaire de paquets de votre choix.
 
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 {{incode|apt}}, 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 :
 
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 :
 +
 
{{Code|code=
 
{{Code|code=
 
sudo apt build-dep freecad
 
sudo apt build-dep freecad
Line 61: Line 66:
  
 
Les librairies Boost doivent être installées :
 
Les librairies Boost doivent être installées :
 +
 
*{{incode|libboost-dev}}
 
*{{incode|libboost-dev}}
 
*{{incode|libboost-date-time-dev}}
 
*{{incode|libboost-date-time-dev}}
Line 78: Line 84:
  
 
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 :
 
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 :
 +
 
*{{incode|libeigen3-dev}}
 
*{{incode|libeigen3-dev}}
 
*{{incode|libgts-bin}}
 
*{{incode|libgts-bin}}
Line 91: Line 98:
  
 
<div class="mw-collapsible mw-collapsed" style="background-color:#e0e0e0">
 
<div class="mw-collapsible mw-collapsed" style="background-color:#e0e0e0">
 +
 
==== Python 2 et Qt4 ====
 
==== Python 2 et Qt4 ====
Ceci n’est plus recommandé car Python 2 et Qt4 sont obsolètes et disparaîtront des futures distributions Linux.
+
Ceci n’est plus recommandé pour les nouvelles installations car Python 2 et Qt4 sont obsolètes.
 +
 
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
 
Pour compiler FreeCAD pour Debian Jessie, Stretch, Ubuntu 16.04, en utilisant Python 2 et Qt4, installez les dépendances suivantes.
 
Pour compiler FreeCAD pour Debian Jessie, Stretch, Ubuntu 16.04, en utilisant Python 2 et Qt4, installez les dépendances suivantes.
 +
 
*{{incode|qt4-dev-tools}}
 
*{{incode|qt4-dev-tools}}
 
*{{incode|libqt4-dev}}
 
*{{incode|libqt4-dev}}
Line 107: Line 118:
 
*{{incode|python-ply}}
 
*{{incode|python-ply}}
 
*{{incode|python-pyside}}
 
*{{incode|python-pyside}}
 +
 
</div>
 
</div>
 
</div>
 
</div>
Line 113: Line 125:
  
 
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 [[Install_on_Unix/fr#Dépôt officiel Ubuntu|dépôts PPA freecad-stable/freecad-daily]] ajouté à vos sources de logiciels, installez les dépendances suivantes.
 
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 [[Install_on_Unix/fr#Dépôt officiel Ubuntu|dépôts PPA freecad-stable/freecad-daily]] ajouté à vos sources de logiciels, installez les dépendances suivantes.
 +
 
*{{incode|qtbase5-dev}}
 
*{{incode|qtbase5-dev}}
 
*{{incode|qttools5-dev}}
 
*{{incode|qttools5-dev}}
Line 138: Line 151:
  
 
Pour Debian Buster, Ubuntu 18.10 et versions ultérieures, ainsi que pour Ubuntu 18.04 avec les [[Install_on_Unix/fr#Dépôt_officiel_Ubuntu|freecad-stable/freecad-daily PPAs]] ajoutés à vos sources de logiciels, installez les paquets officiels.
 
Pour Debian Buster, Ubuntu 18.10 et versions ultérieures, ainsi que pour Ubuntu 18.04 avec les [[Install_on_Unix/fr#Dépôt_officiel_Ubuntu|freecad-stable/freecad-daily PPAs]] ajoutés à vos sources de logiciels, installez les paquets officiels.
 +
 
*{{incode|libocct*-dev}}
 
*{{incode|libocct*-dev}}
 
**{{incode|libocct-data-exchange-dev}}
 
**{{incode|libocct-data-exchange-dev}}
Line 149: Line 163:
  
 
Pour Debian Jessie, Stretch, Ubuntu 16.04 et plus récente, installez les paquetages Edition Communautaire.
 
Pour Debian Jessie, Stretch, Ubuntu 16.04 et plus récente, installez les paquetages Edition Communautaire.
 +
 
*{{incode|liboce*-dev}}
 
*{{incode|liboce*-dev}}
 
**{{incode|liboce-foundation-dev}}
 
**{{incode|liboce-foundation-dev}}
Line 158: Line 173:
  
 
Vous pouvez installer toutes les librairies individuellement ou en utilisant l’extension astérisque. Changez {{incode|occ}} par {{incode|oce}} si vous voulez installer les librairies de la communauté.
 
Vous pouvez installer toutes les librairies individuellement ou en utilisant l’extension astérisque. Changez {{incode|occ}} par {{incode|oce}} si vous voulez installer les librairies de la communauté.
 +
 
{{Code|code=
 
{{Code|code=
 
sudo apt install libocct*-dev
 
sudo apt install libocct*-dev
Line 166: Line 182:
 
*{{incode|libsimage-dev}}, pour que Coin prenne en charge d'autres formats de fichier image.
 
*{{incode|libsimage-dev}}, pour que Coin prenne en charge d'autres formats de fichier image.
 
*{{incode|doxygen}} et {{incode|libcoin-doc}} (ou {{incode|libcoin80-doc}} pour d'anciens systèmes), si vous avez l’intention de générer de la documentation sur le code source.
 
*{{incode|doxygen}} et {{incode|libcoin-doc}} (ou {{incode|libcoin80-doc}} pour d'anciens systèmes), si vous avez l’intention de générer de la documentation sur le code source.
*{{incode|libspnav-dev}}, pour la prise en charge des périphériques 3Dconnexion, comme Space Navigator ou Space Pilot.
+
*{{incode|libspnav-dev}}, pour la prise en charge des [[3D input devices|périphériques 3Dconnexion]], comme "Space Navigator" ou "Space Pilot".
 
*{{incode|checkinstall}}, 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.
 
*{{incode|checkinstall}}, 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.
  
Line 180: Line 196:
 
==== Commande unique pour Python 2 et Qt4 ====
 
==== Commande unique pour Python 2 et Qt4 ====
 
Ceci n'est pas recommandé pour les installations plus récentes car Python 2 et Qt4 sont obsolètes.
 
Ceci n'est pas recommandé pour les installations plus récentes car Python 2 et Qt4 sont obsolètes.
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
 
{{Code|code=
 
{{Code|code=
 
sudo apt install cmake debhelper dh-exec dh-python libboost-date-time-dev libboost-dev libboost-filesystem-dev libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev libboost-python-dev libboost-regex-dev libboost-serialization-dev libboost-signals-dev libboost-thread-dev libcoin80-dev libeigen3-dev libgts-bin libgts-dev libkdtree++-dev libmedc-dev libocct-data-exchange-dev libocct-ocaf-dev libocct-visualization-dev libopencv-dev libproj-dev libpyside-dev libqt4-dev libqt4-opengl-dev libqtwebkit-dev libshiboken-dev libspnav-dev libvtk6-dev libx11-dev libxerces-c-dev libzipios++-dev lsb-release occt-draw pyside-tools python-dev python-matplotlib python-pivy python-ply swig
 
sudo apt install cmake debhelper dh-exec dh-python libboost-date-time-dev libboost-dev libboost-filesystem-dev libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev libboost-python-dev libboost-regex-dev libboost-serialization-dev libboost-signals-dev libboost-thread-dev libcoin80-dev libeigen3-dev libgts-bin libgts-dev libkdtree++-dev libmedc-dev libocct-data-exchange-dev libocct-ocaf-dev libocct-visualization-dev libopencv-dev libproj-dev libpyside-dev libqt4-dev libqt4-opengl-dev libqtwebkit-dev libshiboken-dev libspnav-dev libvtk6-dev libx11-dev libxerces-c-dev libzipios++-dev lsb-release occt-draw pyside-tools python-dev python-matplotlib python-pivy python-ply swig
 
}}
 
}}
 +
 
Utilisateurs de Ubuntu 16.04, veuillez aussi consulter la discussion sur la compilation dans le forum [http://forum.freecadweb.org/viewtopic.php?f=4&t=16292 Compiler sur Linux (Kubuntu): CMake ne peut pas trouver VTK].
 
Utilisateurs de Ubuntu 16.04, veuillez aussi consulter la discussion sur la compilation dans le forum [http://forum.freecadweb.org/viewtopic.php?f=4&t=16292 Compiler sur Linux (Kubuntu): CMake ne peut pas trouver VTK].
 +
 
</div>
 
</div>
 
</div>
 
</div>
Line 195: Line 215:
  
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
 
Vous avez besoin des paquets suivants :
 
Vous avez besoin des paquets suivants :
 +
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 
*gcc-c++ (or possibly another C++ compiler?)
 
*gcc-c++ (or possibly another C++ compiler?)
Line 225: Line 247:
  
 
(si coin2 est la dernière disponible pour votre version de Fedora, utilisez les paquets à partir de http://www.zultron.com/rpm-repo/)
 
(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
 
*soqt-devel
 
*freetype
 
*freetype
Line 231: Line 254:
  
 
Et optionnellement :  
 
Et optionnellement :  
 +
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 +
 
* libspnav-devel (pour le support des périphériques 3Dconnexion comme le Space Navigator ou le Space Pilot)
 
* 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)
 
* pivy (https://bugzilla.redhat.com/show_bug.cgi?id=458975 Pivy n'est pas obligatoire mais nécessaire pour le module Draft)
 +
 
</div>
 
</div>
 
</div>
 
</div>
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
 +
 
=== Gentoo ===
 
=== Gentoo ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
 
Le moyen le plus facile de vérifier quels paquets sont nécessaires pour compiler FreeCAD et de vérifier via portage :
 
Le moyen le plus facile de vérifier quels paquets sont nécessaires pour compiler FreeCAD et de vérifier via portage :
  
Line 248: Line 277:
  
 
<tt>layman -a waebbl</tt>
 
<tt>layman -a waebbl</tt>
 +
 
</div>
 
</div>
 
</div>
 
</div>
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
 +
 
=== openSUSE ===
 
=== openSUSE ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
  
Line 272: Line 304:
 
Vérifiez également s’il existe des correctifs à appliquer (tels que [https://build.opensuse.org/package/view_file/openSUSE:Factory/FreeCAD/0001-find-openmpi2-include-files.patch 0001-find-openmpi2-include-files.patch]).
 
Vérifiez également s’il existe des correctifs à appliquer (tels que [https://build.opensuse.org/package/view_file/openSUSE:Factory/FreeCAD/0001-find-openmpi2-include-files.patch 0001-find-openmpi2-include-files.patch]).
  
==== Leap ====
+
==== Saut ====
  
 
S'il existe une différence entre les packages disponibles sur Tumbleweed et Leap, alors vous pouvez lire le lien [https://build.opensuse.org/package/view_file/openSUSE:Leap:15.0/FreeCAD/FreeCAD.spec "FreeCAD.spec"] file on the [https://build.opensuse.org/ Open Build Service] pour déterminer les paquets requis.
 
S'il existe une différence entre les packages disponibles sur Tumbleweed et Leap, alors vous pouvez lire le lien [https://build.opensuse.org/package/view_file/openSUSE:Leap:15.0/FreeCAD/FreeCAD.spec "FreeCAD.spec"] file on the [https://build.opensuse.org/ Open Build Service] pour déterminer les paquets requis.
 +
 
</div>
 
</div>
 
</div>
 
</div>
Line 280: Line 313:
  
 
=== Arch Linux ===
 
=== Arch Linux ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
 
Vous aurez besoin des bibliothèques suivantes des référentiels officiels:
 
Vous aurez besoin des bibliothèques suivantes des référentiels officiels:
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
 
<!--<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">-->
Line 310: Line 345:
 
*shared-mime-info
 
*shared-mime-info
 
<!--</div>-->
 
<!--</div>-->
 +
 
Aussi, assurez vous de vérifier le AUR pour tout paquet manquant qui ne sont pas dans les dépôts, actuellement :
 
Aussi, assurez vous de vérifier le AUR pour tout paquet manquant qui ne sont pas dans les dépôts, actuellement :
 +
 
*coin
 
*coin
 
*python-pivy
 
*python-pivy
Line 321: Line 358:
 
</div>
 
</div>
 
</div>
 
</div>
 +
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
  
 
=== Distributions anciennes et non-conventionnelles ===
 
=== Distributions anciennes et non-conventionnelles ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 +
 
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.
 
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.
  
Line 330: Line 370:
  
 
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 {{incode|LD_LIBRARY_PATH}} ou dans le fichier {{incode|ld.so.conf}}. Cela est déjà fait dans les distributions Linux modernes, mais il faudra peut-être le configurer dans les anciennes.
 
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 {{incode|LD_LIBRARY_PATH}} ou dans le fichier {{incode|ld.so.conf}}. Cela est déjà fait dans les distributions Linux modernes, mais il faudra peut-être le configurer dans les anciennes.
 +
 
</div>
 
</div>
 
</div>
 
</div>
  
==== Pivy ====
+
=== Pivy ===
[[Pivy/fr|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 le [[Draft Module/fr|Draft Workbench]]. Si vous n'utilisez pas cet atelier, vous n'aurez pas besoin de Pivy. Cependant, notez que Draft Workbench est utilisé en interne par d'autres établis, tels que [[Arch Workbench/fr|Arch]] et [[BIM Workbench/fr|BIM]], aussi Pivy doit-il être installé pour pouvoir également utiliser ces établis.
+
 
 +
[[Pivy/fr|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'[[Draft Module/fr|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 Workbench/fr|Arch]] et [[BIM Workbench/fr|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 [[Extra_python_modules/fr#Pivy|instructions de compilation de Pivy]].
 
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 [[Extra_python_modules/fr#Pivy|instructions de compilation de Pivy]].
 +
 +
=== 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 {{incode|-dbg}}, {{incode|-dbgsym}}, {{incode|-debuginfo}} 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 [https://wiki.ubuntu.com/Debug_Symbol_Packages Paquets de symboles de débogage] pour plus d'informations.
  
 
== Compiler FreeCAD ==
 
== Compiler FreeCAD ==
Line 353: Line 401:
  
 
Pour construire out-of-source, créez simplement un répertoire de construction ({{incode|freecad-build}}) distinct de votre dossier source FreeCAD ({{incode|freecad-source}}) ; ensuite depuis le dossier de compilation pointez {{incode|cmake}} comme dossier source. Vous pouvez également utiliser {{incode|cmake-gui}} ou {{incode|ccmake}} au lieu de {{incode|cmake}} dans les instructions ci-dessous. Une fois que {{incode|cmake}} a fini de configurer l’environnement, utilisez {{incode|make}} pour lancer la nouvelle compilation.
 
Pour construire out-of-source, créez simplement un répertoire de construction ({{incode|freecad-build}}) distinct de votre dossier source FreeCAD ({{incode|freecad-source}}) ; ensuite depuis le dossier de compilation pointez {{incode|cmake}} comme dossier source. Vous pouvez également utiliser {{incode|cmake-gui}} ou {{incode|ccmake}} au lieu de {{incode|cmake}} dans les instructions ci-dessous. Une fois que {{incode|cmake}} a fini de configurer l’environnement, utilisez {{incode|make}} pour lancer la nouvelle compilation.
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
mkdir freecad-build
 
mkdir freecad-build
Line 367: Line 416:
  
 
Allez dans le répertoire source et pointez {{incode|cmake}} dans le répertoire actuel (désigné par un simple point) :
 
Allez dans le répertoire source et pointez {{incode|cmake}} dans le répertoire actuel (désigné par un simple point) :
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
cd freecad-source
 
cd freecad-source
Line 375: Line 425:
 
L’exécutable FreeCAD se trouvera alors dans le répertoire {{incode|freecad-source/bin}}.
 
L’exécutable FreeCAD se trouvera alors dans le répertoire {{incode|freecad-source/bin}}.
  
==== Comment réparer votre répertoire du code source après avoir accidentellement effectué une compilation dans le dossier source ====
+
==== 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.
  
Si vous avez accidentellement effectué une compilation dans le répertoire du code source et souhaitez restaurer le contenu uniquement du code source d'origine, vous pouvez effectuer les étapes suivantes.
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
> .gitignore
 
> .gitignore
Line 391: Line 442:
  
 
En appliquant différentes options à {{incode|cmake}}, vous pouvez modifier la manière dont FreeCAD est compilé. La syntaxe est la suivante.
 
En appliquant différentes options à {{incode|cmake}}, vous pouvez modifier la manière dont FreeCAD est compilé. La syntaxe est la suivante.
 +
 
{{Code|code=
 
{{Code|code=
 
cmake -D <var>:<type>=<value> $SOURCE_DIR
 
cmake -D <var>:<type>=<value> $SOURCE_DIR
 
}}
 
}}
 +
 
Où {{incode|$SOURCE_DIR}} est le répertoire qui contient le code source. Le {{incode|<type>}} peut être omis dans la plupart des cas. L'espace après l'option {{incode|-D}} peut également être omis.
 
Où {{incode|$SOURCE_DIR}} est le répertoire qui contient le code source. Le {{incode|<type>}} peut être omis dans la plupart des cas. L'espace après l'option {{incode|-D}} peut également être omis.
  
 
Par exemple, pour éviter de construire le [[FEM Workbench/fr|module FEM]] :
 
Par exemple, pour éviter de construire le [[FEM Workbench/fr|module FEM]] :
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
cmake -D BUILD_FEM:BOOL=OFF ../freecad-source
 
cmake -D BUILD_FEM:BOOL=OFF ../freecad-source
Line 403: Line 457:
  
 
Toutes les variables possibles sont répertoriées dans le fichier {{incode|CMakeLists.txt}}, situé dans le dossier primaire {{incode|freecad-source}}. Dans ce fichier, recherchez le mot {{incode|option}} pour obtenir toutes les variables pouvant être définies et voir leurs valeurs par défaut.
 
Toutes les variables possibles sont répertoriées dans le fichier {{incode|CMakeLists.txt}}, situé dans le dossier primaire {{incode|freecad-source}}. Dans ce fichier, recherchez le mot {{incode|option}} pour obtenir toutes les variables pouvant être définies et voir leurs valeurs par défaut.
{{Code|code=
+
 
 +
<!--NOT CHANGE THE <pre> </pre> BALISE-->
 +
<pre>
 +
 
 
# ==============================================================================
 
# ==============================================================================
# =================  Toutes les options du processus de construction   =================
+
# =================  Toutes les options du processus de construction =================
 
# ==============================================================================
 
# ==============================================================================
  
Line 413: Line 470:
 
option(FREECAD_USE_EXTERNAL_SMESH "Utilisez smesh installé par le système au lieu de celui fourni." OFF)
 
option(FREECAD_USE_EXTERNAL_SMESH "Utilisez smesh installé par le système au lieu de celui fourni." OFF)
 
...
 
...
}}
+
</pre>
 +
<!--NOT CHANGE THE <pre> </pre> BALISE-->
  
 
Vous pouvez également utiliser la commande {{incode|cmake -LH}} pour répertorier la configuration actuelle, ainsi que toutes les variables pouvant être modifiées. Vous pouvez également installer et utiliser {{incode|cmake-gui}} 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.
 
Vous pouvez également utiliser la commande {{incode|cmake -LH}} pour répertorier la configuration actuelle, ainsi que toutes les variables pouvant être modifiées. Vous pouvez également installer et utiliser {{incode|cmake-gui}} 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.
Line 420: Line 478:
  
 
Créez une version {{incode|Debug}} pour résoudre les pannes dans FreeCAD. Attention, avec cette construction [[Sketcher Workbench/fr|Sketcher]] devient très lent avec des esquisses complexes.
 
Créez une version {{incode|Debug}} pour résoudre les pannes dans FreeCAD. Attention, avec cette construction [[Sketcher Workbench/fr|Sketcher]] devient très lent avec des esquisses complexes.
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
cmake -DCMAKE_BUILD_TYPE=Debug ../freecad-source
 
cmake -DCMAKE_BUILD_TYPE=Debug ../freecad-source
Line 427: Line 486:
  
 
Créez une version {{incode|Release}} pour tester que le code qui ne plante pas. Une {{incode|Release}} sera beaucoup plus rapide qu'une version {{incode|Debug}}.
 
Créez une version {{incode|Release}} pour tester que le code qui ne plante pas. Une {{incode|Release}} sera beaucoup plus rapide qu'une version {{incode|Debug}}.
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
cmake -DCMAKE_BUILD_TYPE=Release ../freecad-source
 
cmake -DCMAKE_BUILD_TYPE=Release ../freecad-source
Line 436: Line 496:
  
 
Dans une distribution Linux moderne, il suffit de fournir deux variables spécifiant l'utilisation de Qt5 et le chemin d'accès à l'interpréteur Python.
 
Dans une distribution Linux moderne, il suffit de fournir deux variables spécifiant l'utilisation de Qt5 et le chemin d'accès à l'interpréteur Python.
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
cmake -DBUILD_QT5=ON -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source
 
cmake -DBUILD_QT5=ON -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source
Line 443: Line 504:
  
 
Si l'exécutable {{incode|python}} par défaut de votre système est un lien symbolique vers Python 2, {{incode|cmake}} essaiera de configurer FreeCAD pour cette version. Vous pouvez choisir une autre version de Python en donnant le chemin d'un exécutable spécifique :
 
Si l'exécutable {{incode|python}} par défaut de votre système est un lien symbolique vers Python 2, {{incode|cmake}} essaiera de configurer FreeCAD pour cette version. Vous pouvez choisir une autre version de Python en donnant le chemin d'un exécutable spécifique :
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source
 
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source
Line 448: Line 510:
  
 
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 :
 
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 :
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3.6 \
 
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3.6 \
Line 455: Line 518:
 
     ../freecad-source
 
     ../freecad-source
 
}}
 
}}
 +
 
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 {{incode|python3 -V}} 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 {{incode|Python 3.6.8}}, 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 {{incode|locate}}.
 
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 {{incode|python3 -V}} 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 {{incode|Python 3.6.8}}, 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 {{incode|locate}}.
 +
 
{{Code|code=
 
{{Code|code=
 
locate python3.6
 
locate python3.6
Line 465: Line 530:
  
 
Pour compiler dans Qt Creator, ajoutez les variables appropriées au bas du menu {{MenuCommand|Projects → Manage Kits → Kits → Default (or your kit) → CMake Configuration}}. Spécifiez à nouveau les chemins corrects et la version Python que vous souhaitez utiliser.
 
Pour compiler dans Qt Creator, ajoutez les variables appropriées au bas du menu {{MenuCommand|Projects → Manage Kits → Kits → Default (or your kit) → CMake Configuration}}. Spécifiez à nouveau les chemins corrects et la version Python que vous souhaitez utiliser.
 +
 
{{Code|code=
 
{{Code|code=
 
PYTHON_EXECUTABLE=/usr/bin/python3.7
 
PYTHON_EXECUTABLE=/usr/bin/python3.7
Line 479: Line 545:
  
 
Allez dans un répertoire auxiliaire du code source, lancez {{incode|qmake}} avec le fichier de projet indiqué pour créer un {{incode|Makefile}} ; puis lancez {{incode|make}} pour compiler le plugin.
 
Allez dans un répertoire auxiliaire du code source, lancez {{incode|qmake}} avec le fichier de projet indiqué pour créer un {{incode|Makefile}} ; puis lancez {{incode|make}} pour compiler le plugin.
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
cd freecad-source/src/Tools/plugins/widget
 
cd freecad-source/src/Tools/plugins/widget
Line 485: Line 552:
 
}}
 
}}
  
La librairie créée est {{incode|libFreeCAD_widgets.so}}, qui doit être copiée dans {{incode|$QTDIR/plugins/designer}}, où {{incode|$QTDIR}} est le répertoire qui stocke les librairies binaires Qt.
+
Si vous compilez pour Qt5, assurez-vous que le code binaire {{incode|qmake}} est celui de cette version, afin que {{incode|Makefile}} résultant contienne les informations nécessaires pour Qt5.
 +
 
 +
{{Code|lang=bash|code=
 +
cd freecad-source/src/Tools/plugins/widget
 +
$QT_DIR/bin/qmake plugin.pro
 +
make
 +
}}
 +
 
 +
Où {{incode|$QT_DIR}} est le répertoire qui stocke les bibliothèques binaires Qt, par exemple, {{incode|/usr/lib/x86_64-linux-gnu/qt5}}.
 +
 
 +
La librairie créée est {{incode|libFreeCAD_widgets.so}}, qui doit être copiée dans {{incode|$QTDIR/plugins/designer}}.
 +
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
sudo cp libFreeCAD_widgets.so /usr/lib/x86_64-linux-gnu/qt5/plugins/designer
+
sudo cp libFreeCAD_widgets.so $QT_DIR/plugins/designer
 
}}
 
}}
  
Line 508: Line 586:
 
===Construire un paquet Debian===
 
===Construire un paquet Debian===
 
Si vous envisagez de construire un paquet Debian voici les sources que vous devez d’abord installer certains paquets :
 
Si vous envisagez de construire un paquet Debian voici les sources que vous devez d’abord installer certains paquets :
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
sudo apt install dh-make devscripts lintian
 
sudo apt install dh-make devscripts lintian
 
}}
 
}}
 +
 
Allez dans le répertoire FreeCAD et appelez
 
Allez dans le répertoire FreeCAD et appelez
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
debuild
 
debuild
 
}}
 
}}
 +
 
Une fois que le paquet est construit, vous pouvez utiliser {{incode|lintian}} pour vérifier si le paquet contient des erreurs
 
Une fois que le paquet est construit, vous pouvez utiliser {{incode|lintian}} pour vérifier si le paquet contient des erreurs
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
lintian freecad-package.deb
 
lintian freecad-package.deb
Line 525: Line 608:
  
 
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 :
 
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 :
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
cd freecad-source
 
cd freecad-source
Line 531: Line 615:
  
 
Puis déplacez-vous dans le répertoire de construction où le code a été initialement compilé, et lancez {{incode|cmake}} spécifiant le répertoire actuel (indiqué par un point), puis déclenchez la recompilation avec {{incode|make}}.
 
Puis déplacez-vous dans le répertoire de construction où le code a été initialement compilé, et lancez {{incode|cmake}} spécifiant le répertoire actuel (indiqué par un point), puis déclenchez la recompilation avec {{incode|make}}.
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
cd ../freecad-build
 
cd ../freecad-build
Line 541: Line 626:
 
=== Note sur les systèmes 64 bits ===
 
=== Note sur 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 {{incode|configure}} et définir des {{incode|CXXFLAGS}} supplémentaires :
 
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 {{incode|configure}} et définir des {{incode|CXXFLAGS}} supplémentaires :
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
./configure CXXFLAGS="-D_OCC64"
 
./configure CXXFLAGS="-D_OCC64"
 
}}
 
}}
 +
 
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 {{incode|CXXFLAGS}} en interne.
 
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 {{incode|CXXFLAGS}} en interne.
  
Line 552: Line 639:
  
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
 +
 
=== Ubuntu ===  
 
=== Ubuntu ===  
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
  
Line 558: Line 647:
  
 
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 {{incode|cmake}} et finalement construit l'ensemble du programme avec {{incode|make}}. Enregistrez le script dans un fichier, rendez-le exécutable et exécutez-le, mais n'utilisez pas {{incode|sudo}}; les privilèges de super-utilisateur ne seront demandés que pour les commandes sélectionnées.
 
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 {{incode|cmake}} et finalement construit l'ensemble du programme avec {{incode|make}}. Enregistrez le script dans un fichier, rendez-le exécutable et exécutez-le, mais n'utilisez pas {{incode|sudo}}; les privilèges de super-utilisateur ne seront demandés que pour les commandes sélectionnées.
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
#!/bin/sh
 
#!/bin/sh
Line 574: Line 664:
  
 
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 {{incode|--enable-source}} de la commande.
 
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 {{incode|--enable-source}} de la commande.
 +
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
#!/bin/sh
 
#!/bin/sh
Line 582: Line 673:
  
 
Une fois que vous avez installé le paquet {{incode|freecad}} à partir du référentiel {{incode|freecad-stable}}, il remplacera l'exécutable FreeCAD disponible à partir du référentiel Universe Ubuntu. L'exécutable s'appellera simplement {{incode|freecad}}, et non pas {{incode|freecad-stable}}.
 
Une fois que vous avez installé le paquet {{incode|freecad}} à partir du référentiel {{incode|freecad-stable}}, il remplacera l'exécutable FreeCAD disponible à partir du référentiel Universe Ubuntu. L'exécutable s'appellera simplement {{incode|freecad}}, et non pas {{incode|freecad-stable}}.
 +
 
</div>
 
</div>
 
</div>
 
</div>
 
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
  
Line 590: Line 681:
  
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
Aucun dépôt externe n'est nécessaire 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
+
 
 +
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
 +
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
# install needed packages for development
 
# install needed packages for development
Line 620: Line 713:
 
./FreeCAD -t 0
 
./FreeCAD -t 0
 
}}
 
}}
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
+
 
 +
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.
 +
 
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
 
# go into free-cad dir created earlier
 
# go into free-cad dir created earlier
Line 654: Line 749:
  
 
=== Debian Squeeze ===
 
=== Debian Squeeze ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
Line 688: Line 784:
  
 
=== Fedora 27/28/29 ===  
 
=== Fedora 27/28/29 ===  
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
Posted by user [[http://forum.freecadweb.org/memberlist.php?mode=viewprofile&u=3666 PrzemoF]] in the forum.
+
 
 +
Vous pouvez poster à l'utilisateur [[http://forum.freecadweb.org/memberlist.php?mode=viewprofile&u=3666 PrzemoF]] sur le forum.
  
 
{{Code|lang=bash|code=
 
{{Code|lang=bash|code=
Line 729: Line 827:
  
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
 +
 
=== Arch using AUR ===
 
=== Arch using AUR ===
 +
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
[https://aur.archlinux.org/ 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
+
[https://aur.archlinux.org/ 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
  
 
Steps :
 
Steps :
#Open a terminal. Optionally create a directory eg. {{incode | mkdir git}}. Optionally change directory eg. {{incode | cd git}}.
+
#Ouvrez un terminal. Créez éventuellement un répertoire, par exemple {{incode|mkdir git}}. Éventuellement changer de répertoire par exemple {{incode|cd git}}.
#Clone the AUR repository : {{incode | git clone http://aur.archlinux.org/packages/freecad-git}}
+
#Cloner le référentiel AUR : {{incode|git clone http://aur.archlinux.org/packages/freecad-git}}
#Enter AUR repository folder : {{incode | cd freecad-git}}
+
#Entrez le dossier du référentiel AUR : {{incode|cd freecad-git}}
#Compile using [https://wiki.archlinux.org/index.php/Makepkg Arch makepkg] : {{incode | makepkg -s}}. The -s or --syncdeps flag  will also install required dependencies.
+
#Compiler en utilisant [https://wiki.archlinux.org/index.php/Makepkg Arch makepkg] : {{incode|makepkg -s}}. Les flag -s ou --syncdeps installeront également les dépendances requises.
#Install created package : {{incode | makepkg --install}} or double click on the pkgname-pkgver.pkg.tar.xz inside your file browser.
+
#Installer le paquet créé : {{incode|makepkg --install}} ou double-cliquez sur pkgname-pkgver.pkg.tar.xz dans votre navigateur de fichiers.
 +
 
 +
Pour mettre à jour FreeCAD vers la dernière version, recommencez à partir de l'étape 3. Mettez à jour le référentiel AUR en cas de modifications importantes de la recette ou de nouvelles fonctionnalités à l'aide de {{incode|git checkout -f}} dans le dossier.
  
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 {{incode | git checkout -f}} inside the folder.
 
 
</div>
 
</div>
 
</div>
 
</div>

Revision as of 10:42, 8 October 2019

Other languages:
български • ‎čeština • ‎Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎한국어 • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎svenska • ‎Türkçe • ‎中文(中国大陆)‎
Arrow-left.svg Page précédente: Compiler sur Windows
Page suivante: Compiler sur Mac Arrow-right.svg

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

FreeCAD source compilation workflow.svg

Processus général pour compiler FreeCAD à partir des sources. Les dépendances tierces doivent être dans le système, ainsi que le code source de FreeCAD lui-même. CMake configure le système de manière à ce que le projet entier soit compilé avec une seule instruction make.


Obtenir le code source

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 git qui peut être installé dans la plupart des distributions Linux. Il peut également être obtenu sur le site officiel.

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

sudo apt install git
git clone https://github.com/FreeCAD/FreeCAD.git freecad-source

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 alternativement télécharger la source sous forme d'archive, en fichier .zip ou .tar.gz, 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 apt, 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

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 :

  • build-essential, installe les compilateurs C et C++ et les librairies C.
  • cmake, un outil indispensable pour configurer la source de FreeCAD. Vous pouvez également souhaiter installer cmake-gui et cmake-curses-gui pour une option graphique.
  • libtool, des outils essentiels pour produire des librairies partagées.
  • lsb-release, 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é.

  • python3
  • swig, 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 :

  • 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-serialization-dev
  • libboost-signals-dev
  • libboost-thread-dev

Les librairies Coin doivent être installées :

  • libcoin80-dev, pour Debian Jessie, Stretch, Ubuntu 16.04 à 18.10, ou
  • libcoin-dev, 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 :

  • libeigen3-dev
  • libgts-bin
  • libgts-dev
  • libkdtree++-dev
  • libmedc-dev
  • libopencv-dev or libcv-dev
  • libproj-dev
  • libvtk7-dev or libvtk6-dev
  • libx11-dev
  • libxerces-c-dev
  • libzipios++-dev

Python 2 et Qt4

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

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

  • qt4-dev-tools
  • libqt4-dev
  • libqt4-opengl-dev
  • libqtwebkit-dev
  • libshiboken-dev
  • libpyside-dev
  • pyside-tools
  • python-dev
  • python-matplotlib
  • python-pivy
  • python-ply
  • python-pyside

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.

  • qtbase5-dev
  • qttools5-dev
  • libqt5opengl5-dev
  • libqt5svg5-dev
  • libqt5webkit5-dev or qtwebengine5-dev
  • libqt5xmlpatterns5-dev
  • libqt5x11extras5-dev
  • libpyside2-dev
  • libshiboken2-dev
  • pyside2-tools
  • python3-dev
  • python3-matplotlib
  • python3-pivy
  • python3-ply
  • python3-pyside2.qtcore
  • python3-pyside2.qtgui
  • python3-pyside2.qtsvg
  • python3-pyside2.qtwidgets
  • python3-pyside2uic

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.

  • libocct*-dev
    • libocct-data-exchange-dev
    • libocct-draw-dev
    • libocct-foundation-dev
    • libocct-modeling-algorithms-dev
    • libocct-modeling-data-dev
    • libocct-ocaf-dev
    • libocct-visualization-dev
  • occt-draw

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

  • liboce*-dev
    • liboce-foundation-dev
    • liboce-modeling-dev
    • liboce-ocaf-dev
    • liboce-ocaf-lite-dev
    • liboce-visualization-dev
  • oce-draw

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

sudo apt install libocct*-dev

Paquets optionnels

Vous pouvez éventuellement installer ces paquets supplémentaires :

  • libsimage-dev, pour que Coin prenne en charge d'autres formats de fichier image.
  • doxygen et libcoin-doc (ou libcoin80-doc pour d'anciens systèmes), si vous avez l’intention de générer de la documentation sur le code source.
  • libspnav-dev, pour la prise en charge des périphériques 3Dconnexion, comme "Space Navigator" ou "Space Pilot".
  • checkinstall, 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.

sudo apt install cmake cmake-gui libboost-date-time-dev libboost-dev libboost-filesystem-dev libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev libboost-python-dev libboost-regex-dev libboost-serialization-dev libboost-signals-dev libboost-thread-dev libcoin-dev libeigen3-dev libgts-bin libgts-dev libkdtree++-dev libmedc-dev libocct-data-exchange-dev libocct-ocaf-dev libocct-visualization-dev libopencv-dev libproj-dev libpyside2-dev libqt5opengl5-dev libqt5svg5-dev libqt5webkit5-dev libqt5x11extras5-dev libqt5xmlpatterns5-dev libshiboken2-dev libspnav-dev libvtk7-dev libx11-dev libxerces-c-dev libzipios++-dev occt-draw pyside2-tools python3-dev python3-matplotlib python3-pivy python3-ply python3-pyside2.qtcore python3-pyside2.qtgui python3-pyside2.qtsvg python3-pyside2.qtwidgets python3-pyside2uic qtbase5-dev qttools5-dev swig

Commande unique pour Python 2 et Qt4

Ceci n'est pas recommandé pour les installations plus récentes car Python 2 et Qt4 sont obsolètes.

sudo apt install cmake debhelper dh-exec dh-python libboost-date-time-dev libboost-dev libboost-filesystem-dev libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev libboost-python-dev libboost-regex-dev libboost-serialization-dev libboost-signals-dev libboost-thread-dev libcoin80-dev libeigen3-dev libgts-bin libgts-dev libkdtree++-dev libmedc-dev libocct-data-exchange-dev libocct-ocaf-dev libocct-visualization-dev libopencv-dev libproj-dev libpyside-dev libqt4-dev libqt4-opengl-dev libqtwebkit-dev libshiboken-dev libspnav-dev libvtk6-dev libx11-dev libxerces-c-dev libzipios++-dev lsb-release occt-draw pyside-tools python-dev python-matplotlib python-pivy python-ply swig

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.

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 :


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

openSUSE

Tumbleweed

Les commandes suivantes installeront les packages nécessaires à la construction de FreeCAD avec Qt5 et Python 3.

zypper in --no-recommends -t pattern devel_C_C++ devel_qt5

zypper in libqt5-qtbase-devel libqt5-qtsvg-devel libqt5-qttools-devel boost-devel swig libboost_program_options-devel libboost_mpi_python3-devel libboost_system-devel libboost_program_options-devel libboost_regex-devel libboost_python3-devel libboost_thread-devel libboost_system-devel libboost_headers-devel libboost_graph-devel python3 python3-devel python3-matplotlib python3-matplotlib-qt5 python3-pyside2 python3-pyside2-devel python3-pivy gcc gcc-fortran cmake occt-devel libXi-devel opencv-devel libxerces-c-devel Coin-devel SoQt-devel freetype2-devel eigen3-devel libode6 vtk-devel libmed-devel hdf5-openmpi-devel openmpi2-devel netgen-devel freeglut-devel libspnav-devel f2c doxygen dos2unix glew-devel

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

zypper in libqt5-creator gdb

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

Saut

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
sudo pacman -S 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 cmake eigen git gcc-fortran pyside2-tools swig qt5-tools shared-mime-info 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.

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 name, mais aussi libname, name-dev, name-devel 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 LD_LIBRARY_PATH ou dans le fichier ld.so.conf. 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.

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 -dbg, -dbgsym, -debuginfo 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.

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 Makefile 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 make, 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.

Compilation out-of-source

Construire 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 (freecad-build) distinct de votre dossier source FreeCAD (freecad-source) ; ensuite depuis le dossier de compilation pointez cmake comme dossier source. Vous pouvez également utiliser cmake-gui ou ccmake au lieu de cmake dans les instructions ci-dessous. Une fois que cmake a fini de configurer l’environnement, utilisez make pour lancer la nouvelle compilation.

mkdir freecad-build
cd freecad-build
cmake ../freecad-source
make -j$(nproc --ignore=2)

L'option -j de make contrôle le nombre de jobs (fichiers) compilés en parallèle. Le programme nproc retourne le nombre de cœurs de processeur de votre système utilisés avec l'option -j, 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 freecad-build/bin. Voir aussi Compilation (accélération) pour améliorer la vitesse de compilation.

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 cmake dans le répertoire actuel (désigné par un simple point) :

cd freecad-source
cmake .
make -j$(nproc --ignore=2)

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

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.

> .gitignore
git clean -df
git reset --hard HEAD

La première ligne efface le fichier .gitignore. 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 .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 dernière commande réinitialisera toutes les modifications apportées aux fichiers suivis, y compris la première commande effaçant le fichier .gitignore.

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

Configuration

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

cmake -D <var>:<type>=<value> $SOURCE_DIR

$SOURCE_DIR est le répertoire qui contient le code source. Le <type> peut être omis dans la plupart des cas. L'espace après l'option -D peut également être omis.

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

cmake -D BUILD_FEM:BOOL=OFF ../freecad-source
cmake -DBUILD_FEM=OFF ../freecad-source

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


# ==============================================================================
# =================   Toutes les options du processus de construction =================
# ==============================================================================

option(BUILD_FORCE_DIRECTORY "Le répertoire de construction doit être différent du répertoire source." OFF)
option(BUILD_GUI "Construction FreeCAD Gui. Sinon, vous avez uniquement la ligne de commande et le module d'importation Python." ON)
option(FREECAD_USE_EXTERNAL_ZIPIOS "Utilisez le système installé zipios++ au lieu de celui fourni." OFF)
option(FREECAD_USE_EXTERNAL_SMESH "Utilisez smesh installé par le système au lieu de celui fourni." OFF)
...

Vous pouvez également utiliser la commande cmake -LH pour répertorier la configuration actuelle, ainsi que toutes les variables pouvant être modifiées. Vous pouvez également installer et utiliser cmake-gui 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.

Pour une compilation de Debogage

Créez une version Debug pour résoudre les pannes dans FreeCAD. Attention, avec cette construction Sketcher devient très lent avec des esquisses complexes.

cmake -DCMAKE_BUILD_TYPE=Debug ../freecad-source

Pour une compilation "Release"

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

cmake -DCMAKE_BUILD_TYPE=Release ../freecad-source

Compiler en s'appuyant sur Python 3 et Qt5

Par défaut FreeCAD est compilé pour Python 2 et Qt4. Ces deux paquets étant obsolètes, il est préférable de les compiler pour Python 3 et Qt5.

Dans une distribution Linux moderne, il suffit de fournir deux variables spécifiant l'utilisation de Qt5 et le chemin d'accès à l'interpréteur Python.

cmake -DBUILD_QT5=ON -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source

Compiler pour une version spécifique de Python

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

cmake -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source

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 :

cmake -DPYTHON_EXECUTABLE=/usr/bin/python3.6 \
    -DPYTHON_INCLUDE_DIR=/usr/include/python3.6m \
    -DPYTHON_LIBRARY=/usr/lib/x86_64-linux-gnu/libpython3.6m.so \
    -DPYTHON_PACKAGES_PATH=/usr/lib/python3.6/site-packages/ \
    ../freecad-source

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 python3 -V 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 Python 3.6.8, 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 locate.

locate python3.6

Vous pouvez utiliser python3 -m site dans un terminal pour déterminer les répertoires site-package ou dist-package sur les systèmes Debian.

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

Pour compiler dans Qt Creator, ajoutez les variables appropriées au bas du menu Projects → Manage Kits → Kits → Default (or your kit) → CMake Configuration. Spécifiez à nouveau les chemins corrects et la version Python que vous souhaitez utiliser.

PYTHON_EXECUTABLE=/usr/bin/python3.7
PYTHON_INCLUDE_DIR=/usr/include/python3.7m
PYTHON_LIBRARY=/usr/lib/x86_64-linux-gnu/libpython3.7m.so
PYTHON_PACKAGES_PATH=/usr/lib/python3.7/site-packages
BUILD_QT5=ON

Allez à Projects → Run → Run Configuration et choisissez FreeCADMain pour compiler la version graphique de FreeCAD ou FreeCADMainCMD pour ne compiler que la version en ligne de commande.

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 qmake avec le fichier de projet indiqué pour créer un Makefile ; puis lancez make pour compiler le plugin.

cd freecad-source/src/Tools/plugins/widget
qmake plugin.pro
make

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

cd freecad-source/src/Tools/plugins/widget
$QT_DIR/bin/qmake plugin.pro
make

$QT_DIR est le répertoire qui stocke les bibliothèques binaires Qt, par exemple, /usr/lib/x86_64-linux-gnu/qt5.

La librairie créée est libFreeCAD_widgets.so, qui doit être copiée dans $QTDIR/plugins/designer.

sudo cp libFreeCAD_widgets.so $QT_DIR/plugins/designer

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 -DFREECAD_USE_EXTERNAL_PIVY=1.

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.

Documentation Doxygen

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

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.

Construire un paquet Debian

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

sudo apt install dh-make devscripts lintian

Allez dans le répertoire FreeCAD et appelez

debuild

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

lintian freecad-package.deb

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 :

cd freecad-source
git pull

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

cd ../freecad-build
cmake .
make -j$(nproc --ignore=2)

Dépannage

Note sur 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 configure et définir des CXXFLAGS supplémentaires :

./configure CXXFLAGS="-D_OCC64"

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 CXXFLAGS en interne.

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 cmake et finalement construit l'ensemble du programme avec make. Enregistrez le script dans un fichier, rendez-le exécutable et exécutez-le, mais n'utilisez pas sudo; les privilèges de super-utilisateur ne seront demandés que pour les commandes sélectionnées.

#!/bin/sh
sudo add-apt-repository --enable-source ppa:freecad-maintainers/freecad-daily && sudo apt-get update
sudo apt-get build-dep freecad-daily
sudo apt-get install freecad-daily

git clone https://github.com/FreeCAD/FreeCAD.git freecad-source
mkdir freecad-build
cd freecad-build
cmake -DBUILD_QT5=ON -DPYTHON_EXECUTABLE=/usr/bin/python3 ../freecad-source
make -j$(nproc --ignore=2)

Si vous le souhaitez, vous pouvez désinstaller la version pré-compilée de FreeCAD (freecad-daily) 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 --enable-source de la commande.

#!/bin/sh
sudo add-apt-repository --enable-source ppa:freecad-maintainers/freecad-stable && sudo apt-get update
sudo apt-get build-dep freecad
sudo apt-get install freecad

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

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

# install needed packages for development
sudo zypper install gcc cmake OpenCASCADE-devel libXerces-c-devel \
python-devel libqt4-devel python-qt4 Coin-devel SoQt-devel boost-devel \
libode-devel libQtWebKit-devel libeigen3-devel gcc-fortran git swig
 
# create new dir, and go into it
mkdir FreeCAD-Compiled 
cd FreeCAD-Compiled
 
# get the source
git clone https://github.com/FreeCAD/FreeCAD.git free-cad
 
# Now you will have subfolder in this location called free-cad. It contains the source
 
# make another dir for compilation, and go into it
mkdir FreeCAD-Build1
cd FreeCAD-Build1 
 
# build configuration 
cmake ../free-cad
 
# build FreeCAD
make
 
# test FreeCAD
cd bin
./FreeCAD -t 0

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.

# go into free-cad dir created earlier
cd free-cad
 
# pull
git pull
 
# get back to previous dir
cd ..
 
# Now repeat last few steps from before.
 
# make another dir for compilation, and go into it
mkdir FreeCAD-Build2
cd FreeCAD-Build2
 
# build configuration 
cmake ../free-cad
 
# build FreeCAD
# Note: to speed up build use all CPU cores: make -j$(nproc)
make
 
# test FreeCAD
cd bin
./FreeCAD -t 0

Debian Squeeze

# get the needed tools and libs
sudo apt-get install build-essential python libcoin60-dev libsoqt4-dev \
libxerces-c2-dev libboost-dev libboost-date-time-dev libboost-filesystem-dev \
libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev \
libboost-serialization-dev libboost-signals-dev libboost-regex-dev \
libqt4-dev qt4-dev-tools python2.5-dev \
libsimage-dev libopencascade-dev \
libsoqt4-dev libode-dev subversion cmake libeigen2-dev python-pivy \
libtool autotools-dev automake gfortran
 
# checkout the latest source
git clone https://github.com/FreeCAD/FreeCAD.git freecad
 
# go to source dir
cd freecad
 
# build configuration 
cmake .
 
# build FreeCAD
# Note: to speed up build use all CPU cores: make -j$(nproc)
make
 
# test FreeCAD
cd bin
./FreeCAD -t 0

Fedora 27/28/29

Vous pouvez poster à l'utilisateur [PrzemoF] sur le forum.

#!/bin/bash

ARCH=$(arch)

MAIN_DIR=FreeCAD
BUILD_DIR=build

#FEDORA_VERSION=27
#FEDORA_VERSION=28
FEDORA_VERSION=29

PACKAGES="gcc cmake gcc-c++ boost-devel zlib-devel swig eigen3 qt-devel \
shiboken shiboken-devel pyside-tools python-pyside python-pyside-devel xerces-c \
xerces-c-devel OCE-devel smesh graphviz python-pivy python-matplotlib tbb-devel \
 freeimage-devel Coin3 Coin3-devel med-devel vtk-devel"

FEDORA_29_PACKAGES="boost-python2 boost-python3 boost-python2-devel boost-python3-devel"

if [ "$FEDORA_VERSION" = "29" ]; then
    PACKAGES="$PACKAGES $FEDORA_29_PACKAGES"
fi

echo "Installing packages required to build FreeCAD"
sudo dnf -y install $PACKAGES
cd ~
mkdir $MAIN_DIR || { echo "~/$MAIN_DIR already exist. Quitting.."; exit; }
cd $MAIN_DIR
git clone https://github.com/FreeCAD/FreeCAD.git
mkdir $BUILD_DIR || { echo "~/$BUILD_DIR already exist. Quitting.."; exit; }
cd $BUILD_DIR
cmake ../FreeCAD 
make -j$(nproc)

Arch using 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

Steps :

  1. Ouvrez un terminal. Créez éventuellement un répertoire, par exemple mkdir git. Éventuellement changer de répertoire par exemple cd git.
  2. Cloner le référentiel AUR : git clone http://aur.archlinux.org/packages/freecad-git
  3. Entrez le dossier du référentiel AUR : cd freecad-git
  4. Compiler en utilisant Arch makepkg : makepkg -s. Les flag -s ou --syncdeps installeront également les dépendances requises.
  5. Installer le paquet créé : makepkg --install ou double-cliquez sur pkgname-pkgver.pkg.tar.xz dans votre navigateur de fichiers.

Pour mettre à jour FreeCAD vers la dernière version, recommencez à partir de l'étape 3. Mettez à jour le référentiel AUR en cas de modifications importantes de la recette ou de nouvelles fonctionnalités à l'aide de git checkout -f dans le dossier.

Arrow-left.svg Page précédente: CompileOnWindows
Page suivante: CompileOnMac Arrow-right.svg