Compile on MacOS/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(142 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{docnav|CompileOnUnix|Compiling (Speeding up)}}


{{Docnav/fr
This page describes how to compile the latest FreeCAD source on macOS X. ''Latest'' means the most recent commit to the master branch of the FreeCAD github repository.
|[[Compile_on_Linux/fr|Compiler sous Linux]]
|[[Compile_on_Docker/fr|Compiler sur Docker]]
}}


{{VeryImportantMessage|Il existe un conteneur Docker FreeCAD expérimental qui est testé pour le développement FreeCAD. En savoir plus à ce sujet sur [[Compile_on_Docker/fr|Compiler sur Docker]]}}
These instructions have been tested on macOS High Sierra


{{TOCright}}
This page serves as a quick start, and is not intended to be comprehensive with regard to describing all the available build options.


<span id="Overview"></span>
If you just want to evaluate the latest pre-release build of FreeCAD, you can download pre-built binaries [https://github.com/FreeCAD/FreeCAD/releases from here].
== Présentation ==


Cette page décrit comment compiler le code source FreeCAD sur macOS. Pour les autres plates-formes, voir [[Compiling/fr|Compiler]].
== Install Prerequisites ==
The following software must be installed to support the build process.


Ces instructions ont été testées sur macOS Catalina avec le XCode 11.6 standard. Il est connu pour fonctionner sur macOS BigSur Beta avec XCode 12.0 beta. Si vous prévoyez d'utiliser XCode Beta, assurez-vous de télécharger le module complémentaire Outils de ligne de commande via un package dmg pour contourner certains problèmes de dépendance libz.
=== Homebrew Package Manager ===

Homebrew is a command line based package manager for macOS. The [https://brew.sh/ Homebrew main page] provides an installation command line that you simply paste into a terminal window.
Cette page sert de point de départ et n’a pas vocation à être exhaustive en ce qui concerne la description de toutes les options disponibles de build.

Si vous souhaitez simplement évaluer la dernière version de FreeCAD en version préliminaire, vous pouvez télécharger les fichiers binaires pré-construits [https://github.com/FreeCAD/FreeCAD/releases ici].

<span id="Install_Prerequisites"></span>
== Conditions préalables à l'installation ==

Les logiciels suivants doivent être installés pour prendre en charge le processus de compilation.

<span id="Homebrew_Package_Manager"></span>
=== Gestionnaire de paquets Homebrew ===

Homebrew est un gestionnaire de paquets basé sur la ligne de commande pour macOS. La [https://brew.sh/ page d'accueil de Homebrew] fournit une ligne de commande d'installation que vous collez simplement dans une fenêtre de terminal.


=== CMake ===
=== CMake ===
CMake is build tool that generates a build configuration based on variables you specify. You then issue the 'make' command to actually build that configuration. The command-line version of CMake is automatically installed as part of the Homebrew installation, above. If you prefer to use a GUI version of CMake, you can download it from [https://www.cmake.org/downloadDownload here].


CMake est un outil de build qui génère une configuration de build basée sur les variables que vous spécifiez. Vous lancez ensuite la commande 'make' pour construire cette configuration. La version en ligne de commande de CMake est automatiquement installée dans le cadre de l'installation de Homebrew, ci-dessus. Si vous préférez utiliser une version graphique de CMake, vous pouvez la télécharger à partir de [https://www.cmake.org/downloadDownload ici].
== Install Dependencies ==
FreeCAD maintains a Homebrew 'tap' which installs the required formulas and dependencies. Issue the following brew commands in your terminal.


<span id="Install_Dependencies"></span>
<br />
== Installation des dépendances ==
<pre>

FreeCAD maintient un Homebrew "cask" qui installe les formules et dépendances requises. Exécutez les commandes de préparation suivantes dans votre terminal.

{{Code|code=
brew tap freecad/freecad
brew tap freecad/freecad
brew install eigen
brew install eigen
brew install --only-dependencies freecad --with-packaging-utils
brew install --only-dependencies freecad
}}
</pre>

Notes:
# 'brew install' may take quite a while, so you may want go grab a beverage. :-)
{{Incode|brew install}} peut prendre un certain temps, donc vous pouvez aller prendre une verre:-).

Vous pouvez également installer manuellement les dépendances individuelles en installant les paquets suivants à l'aide de {{Incode|brew install ...}} :

* {{incode|cmake}}
* {{incode|swig}}
* {{incode|boost}}
* {{incode|boost-python3}}
* {{incode|eigen}}
* {{incode|gts}}
* {{incode|vtk}}
* {{incode|xerces-c}}
* {{incode|qt@5}} - Seul Qt5 est actuellement supporté, le support de Qt6 est en cours de réalisation
* {{incode|opencascade}}
* {{incode|doxygen}}
* {{incode|pkgconfig}}
* {{incode|coin3d}} - Notez qu'à l'heure où nous écrivons ces lignes (Nov. 2022), cela installera une version inutilisable de pyside@2 en tant que dépendance.

Il existe plusieurs paquets qui ne sont disponibles que lorsque vous avez tapé le cask freecad : vous devez faire ({{incode|brew tap freecad/freecad}}). En raison de certains contournements de bogues historiques, au moment de la rédaction de cet article (Nov. 2022) les versions de PySide2 et Shiboken2 installées par Homebrew ne sont pas utilisables car elles forcent l'utilisation de Py_Limited_API, que FreeCAD ne supporte pas. Il est prévu que cette solution de contournement soit supprimée dans les prochains mois, mais en attendant vous devez utiliser les versions FreeCAD cask de PySide et Shiboken. Utilisez {{incode|brew install ...}}, installez les paquets suivants :

* {{incode|freecad/freecad/pyside2@5.15.5}}
* {{incode|freecad/freecad/shiboken2@5.15.5}}
* {{incode|freecad/freecad/med-file}}
* {{incode|freecad/freecad/netgen}}

Vous devrez également "lier" PySide et Shiboken :

{{Code|code=
brew link freecad/freecad/pyside2@5.15.5 freecad/freecad/shiboken2@5.15.5
}}

Dans certains cas, les paquets installés par Homebrew n'utilisent pas la même version de Python : par exemple, au moment où nous écrivons ces lignes, PySide2 utilise Python 3.10, mais boost-python3 utilise Python 3.11. Bien qu'il soit possible de "revenir en arrière" sur la version la plus avancée (de sorte que dans ce cas, boost-python3 utilise Python 3.10), il s'agit d'une opération avancée, et dans de nombreux cas, il est préférable d'attendre une mise à jour de l'autre paquet. Si vous voulez quand même poursuivre dans cette voie, regardez la commande "brew extract", que vous pouvez utiliser pour extraire une formule dans un nouveau cask (typiquement freecad/freecad). Vous pouvez ensuite modifier cette formule selon vos besoins.

Vous devrez définir le chemin d'accès à Qt : Qt5 est actuellement supporté, tandis que le support pour Qt6 est un travail en cours. Définissez FREECAD_QT_VERSION à "Auto" ou "5" pour sélectionner Qt5 (la valeur par défaut). Sur la ligne de commande, utilisez quelque chose comme :

{{Code|code=
cmake \
-DCMAKE_BUILD_TYPE="Release" \
-DPYTHON_EXECUTABLE="/usr/local/bin/python3" \
-DQt5_DIR="/usr/local/Cellar/qt@5/5.15.7/lib/cmake/Qt5" \
-DPySide2_DIR="/usr/local/Cellar/pyside2@5.15.5/5.15.5/lib/cmake/PySide2-5.15.5" \
-DShiboken2_DIR="/usr/local/Cellar/shiboken2@5.15.5/5.15.5_1/lib/cmake/Shiboken2-5.15.5" \
../freecad-source
}}

<span id="Get_the_source"></span>
== Obtenir les sources ==


Dans les instructions suivantes, les dossiers source et de build sont créés côte à côte sous
== Get the source ==
In the following instructions, the source and build folders are created side-by-side under


{{Code|code=
/Users/username/FreeCAD
/Users/username/FreeCAD
}}


mais vous pouvez utiliser les dossiers de votre choix.
but you can use whatever folders you want.

<pre>
{{Code|code=
mkdir ~/FreeCAD
mkdir ~/FreeCAD
cd ~/FreeCAD
cd ~/FreeCAD
}}
</pre>

The following command will clone the FreeCAD git repository into a directory called FreeCAD-git.
La commande suivante clone le référentiel FreeCAD git dans un répertoire appelé FreeCAD-git.
<pre>

{{Code|code=
git clone https://github.com/FreeCAD/FreeCAD FreeCAD-git
git clone https://github.com/FreeCAD/FreeCAD FreeCAD-git
}}
</pre>

Create the build folder.
Créez le dossier build.
<pre>

{{Code|code=
mkdir ~/FreeCAD/build
mkdir ~/FreeCAD/build
}}
</pre>
<br />


<span id="Run_CMake"></span>
== Run CMake ==
== Lancer CMake ==


Next, we will run CMake to generate the build configuration. Several options must be passed to CMake. The following table describes the options and gives some background.
Ensuite, nous allons lancer CMake pour générer la configuration de construction. Plusieurs options doivent être transmises à CMake. Le tableau suivant décrit les options et donne un aperçu.


<span id="CMake_Options"></span>
=== CMake Options ===
=== Les options de CMake ===


{| class="wikitable" style="text-align:left"
{| class="wikitable" style="text-align:left"
|-
|-
! Name !! Value !! Notes
! Nom !! Valeur !! Remarques
|-
|-
| CMAKE_BUILD_TYPE || Release (STRING) || Release or Debug. Debug is generally used for developer-level testing but may also be required for user-level testing and troubleshooting.
| CMAKE_BUILD_TYPE || Release (STRING) || Release ou Debug. Le débogage est généralement utilisé pour les tests au niveau développeur mais peut également être requis pour des tests et le dépannage au niveau utilisateur.
|-
| BUILD_QT5 || 1 (BOOL) || Required to build with Qt5.
|-
|-
| CMAKE_PREFIX_PATH || "/usr/local/Cellar/qt@5.6/5.6.2/lib/cmake" (PATH) || Required to build with Qt5. See note below.
| CMAKE_PREFIX_PATH || "/usr/local/opt/qt5152;" ... (PATH) || Nécessaire pour un build avec Qt5. Voir la remarque ci-dessous. Vous devez également ajouter le chemin d'accès au fichier de configuration cmake des librairies VTK et NGLIB.


|-
|-
| FREECAD_CREATE_MAC_APP || 1 (BOOL) || Create a FreeCAD.app bundle at the location specified in CMAKE_INSTALL_PREFIX, when the 'make install' command issued.
| FREECAD_CREATE_MAC_APP || 1 (BOOL) || Crée un paquet FreeCAD.app à l'emplacement spécifié dans CMAKE_INSTALL_PREFIX lorsque la commande 'make install' a été émise.
|-
|-
| CMAKE_INSTALL_PREFIX || "./.." (PATH) || Path where you want to generate the FreeCAD.app bundle.
| CMAKE_INSTALL_PREFIX || "./.." (PATH) || Chemin où vous souhaitez générer le paquet FreeCAD.app.
|-
|-
| FREECAD_USE_EXTERNAL_KDL || 1 (BOOL) || Required.
| FREECAD_USE_EXTERNAL_KDL || 1 (BOOL) || Nécessaire.
|-
|-
| BUILD_FEM_NETGEN || 1 (BOOL) || Required.
| BUILD_FEM_NETGEN || 1 (BOOL) || Requis si vous choisissez de construire les outils FEM.
|}
|}


Note: Command line to generate CMAKE_PREFIX_PATH:
Remarque : ligne de commande pour générer CMAKE_PREFIX_PATH :
<pre>
ls -d $(brew list -1 | grep qt | tail -1 | xargs brew --cellar)/*/lib/cmake
</pre>


<!--NOT CHANGE THE <pre> </pre> BALISE CAUSE THE PIPE OR SPACE IN MACRO CODE CUT THE MACRO-->
=== CMake GUI ===
ls -d $(brew list -1 | grep qt | tail -1 | xargs brew --cellar)/*/lib/cmake
Open the CMake app, and fill in the source and build folder fields. In this example, it would be '''/Users/username/FreeCAD/FreeCAD-git''' for the source, and '''/Users/username/FreeCAD/build''' for the build folder.


<span id="CMake_GUI"></span>
Next, click the '''Configure''' button to populate the list of configuration options. This will display a dialog asking you to specify what generator to use. Leave it at the default '''Unix Makefiles.''' Configuring will fail the first time because there are some options that need to be changed. Note: You will need to check the '''Advanced''' checkbox to get all of the options.
=== Interface graphique CMake ===


Ouvrez l'application CMake, et remplissez les champs source et dossier de compilation. Dans cet exemple, il s'agirait de '''/Users/username/FreeCAD/FreeCAD-git''' pour les sources et ''/Users/username/FreeCAD/build''' pour le dossier de build.
Set options from the table above, then click '''Configure''' again and then '''Generate'''.

=== CMake command line ===
Ensuite, cliquez sur le bouton '''Configure''' pour remplir la liste des options de configuration. Cela affichera une boîte de dialogue vous demandant de spécifier quel générateur utiliser. Laissez la valeur par défaut '''Unix Makefiles'''. La configuration échouera pour la première fois car certaines options doivent être changées. Remarque: vous devrez cocher la case à cocher '''Advanced''' pour obtenir toutes les options.
Enter the following in the terminal.

<pre>
Définissez les options du tableau ci-dessus, puis cliquez à nouveau sur '''Configure''' puis sur '''Generate'''.

<span id="CMake_command_line"></span>
=== CMake en lignes de commande ===

Entrez ce qui suit dans le terminal.

{{Code|code=
export PREFIX_PATH="/usr/local/opt/qt5152;\
/usr/local/Cellar/nglib/v6.2.2007/Contents/Resources;\
/usr/local/Cellar/vtk@8.2/8.2.0_1/lib/cmake;"
}}

{{Code|code=
$cd ~/FreeCAD/build
$cd ~/FreeCAD/build
$cmake \
$cmake \
-DCMAKE_BUILD_TYPE="Release" \
-DCMAKE_BUILD_TYPE="Release" \
-DBUILD_QT5=1 \
-DBUILD_QT5=1 \
-DWITH_PYTHON3=1 \
-DCMAKE_PREFIX_PATH="/usr/local/Cellar/qt@5.6/5.6.2/lib/cmake" \
-DCMAKE_PREFIX_PATH="$PREFIX_PATH" \
-DPYTHON_EXECUTABLE="/usr/local/bin/python3" \
-DFREECAD_USE_EXTERNAL_KDL=1 \
-DFREECAD_USE_EXTERNAL_KDL=1 \
-DCMAKE_CXX_FLAGS='-std=c++14' \
-DBUILD_FEM_NETGEN=1 \
-DBUILD_FEM_NETGEN=1 \
-DFREECAD_CREATE_MAC_APP=1 \
-DFREECAD_CREATE_MAC_APP=1 \
Line 102: Line 185:
../FreeCAD-git/
../FreeCAD-git/


}}
</pre>


<span id="Run_make"></span>
== Run make ==
== Exécuter make ==
Finally, from a terminal run '''make''' to compile and link FreeCAD, and generate the app bundle.

<pre>
Enfin, à partir d’un terminal, exécutez '''make''' pour compiler et lier FreeCAD et générer le paquet applicatif.

{{Code|code=
cd ~/FreeCAD/build
cd ~/FreeCAD/build
make –j5 install
make -j5 install
}}
</pre>
The -j option specifies how many make processes to run at once. One plus the number of CPU cores is usually a good number to use. However, if compiling fails for some reason, it is useful to rerun make without the -j option, so that you can see exactly where the error occurred.


L'option -j spécifie le nombre de processus de création à exécuter simultanément. Prendre le nombre de cœurs de processeur et ajouter un est généralement le bon nombre à utiliser. Cependant, si la compilation échoue pour une raison quelconque, il est utile de réexécuter make sans l'option -j afin de pouvoir voir exactement où l'erreur s'est produite.
See also [[Compiling_(Speeding_up)|Compiling - Speeding up]].


Voir aussi [[Compiling_(Speeding_up)/fr|Compilation (accélération)]].
If make finishes without any errors, you can now launch FreeCAD by double clicking the executable in the Finder.


Si make se termine sans erreur, vous pouvez maintenant lancer FreeCAD en double-cliquant sur l'exécutable dans le Finder.
== Updating from Github ==
FreeCAD development happens fast; every day or so there are bug fixes or new features. To get the latest changes, use git to update the source directory (see [[Source code management]]), then re-run the CMake and make steps above. It is not usually necessary to start with a clean build directory in this case, and subsequent compiles will generally go much faster than the first one.


<span id="Updating_from_Github"></span>
== Building with Qt4 ==
== Mise à jour depuis Github ==
FreeCAD has transitioned from Qt 4 to Qt 5. If you need to build with Qt4, the following additional steps are required.


Le développement de FreeCAD est rapide ; chaque jour ou presque, il y a des corrections de bugs ou de nouvelles fonctionnalités. Pour obtenir les dernières modifications, utilisez git pour mettre à jour le répertoire source (voir [[Source code management/fr|Gestion du code source]]), puis réexécutez CMake et suivez les étapes ci-dessus. Dans ce cas, il n’est généralement pas nécessaire de commencer par un répertoire de build vierge et les compilations suivantes iront généralement beaucoup plus vite que la première.
# Append '--with-qt4' to the 'brew install' command.
# Do not specify BUILD_QT5 CMake option.
# Do not specify CMAKE_PREFIX_PATH CMake option


<span id="Building_with_Qt4_and_Python_2.7"></span>
After you install Qt4, if you want to switch to building with Qt5, you will need to uninstall Qt4.
== Faire une compilation avec Qt4 et Python 2.7 ==
<pre>
brew uninstall --ignore-dependencies --force cartr/qt4/shiboken@1.2 cartr/qt4/pyside@1.2 cartr/qt4/pyside-tools@1.2 cartr/qt4/qt
</pre>


FreeCAD est passé de Qt 4 à Qt 5 comme homebrew. Qt 4 n'est plus disponible en option pour une nouvelle version sur macOS après la transition Qt 5. Python 2.7 est obsolète dans homebrew et macOS à venir et nous ne le supportons plus non plus pour la version macOS.
== Troubleshooting ==


<span id="Troubleshooting"></span>
=== Segfault on Qt5 launch ===
== Dépannage ==
If Qt4 was previously installed via brew, and you then build with Qt5, you may get a EXC_BAD_ACCESS (SEGSEGV) exception when launching the new Qt5 build. The fix for this is to manually uninstall Qt4.

<pre>
<span id="Segfault_on_Qt5_launch"></span>
=== Un segfault sur le lancement de Qt5 ===

Si Qt4 a été précédemment installé via Homebrew et que vous faites un build ensuite avec Qt5, vous pouvez obtenir une exception EXC_BAD_ACCESS (SEGSEGV) lors du lancement de la nouvelle version de Qt5. Le correctif consiste à désinstaller manuellement Qt4.

{{Code|code=
brew uninstall --ignore-dependencies --force cartr/qt4/shiboken@1.2 cartr/qt4/pyside@1.2 cartr/qt4/pyside-tools@1.2 cartr/qt4/qt-legacy-formula
brew uninstall --ignore-dependencies --force cartr/qt4/shiboken@1.2 cartr/qt4/pyside@1.2 cartr/qt4/pyside-tools@1.2 cartr/qt4/qt-legacy-formula
}}
</pre>


=== Fortran ===
=== Fortran ===
''"No CMAKE_Fortran_COMPILER could be found."'' during configuration - Older versions of FreeCAD will need a fortran compiler installed. With Homebrew, do "brew install gcc" and try configuring again, giving cmake the path to Fortran ie -DCMAKE_Fortran_COMPILER=/opt/local/bin/gfortran-mp-4.9 . Or, preferably use a more current version of FreeCAD source!


''"No CMAKE_Fortran_COMPILER could be found."'' (Aucun CMAKE_Fortran_COMPILER n'a pu être trouvé) lors de la configuration - Les anciennes versions de FreeCAD nécessiteront l'installation d'un compilateur Fortran. Avec Homebrew, faites "brew install gcc" et essayez à nouveau de configurer cmake en donnant le chemin à Fortran, c'est-à-dire -DCMAKE_Fortran_COMPILER=/opt/local/bin/gfortran-mp-4.9, ou utilisez de préférence une version plus récente de la source FreeCAD!
=== OpenGL ===
See [[OpenGL_on_MacOS|OpenGL on MacOS]] for OpenGL issues when Qt 4.8 and earlier are used on MacOS.


=== FreeType ===
=== FreeType ===
When using CMake versions older than 3.1.0, it's necessary to set CMake variable FREETYPE_INCLUDE_DIR_freetype2 manually, eg /usr/local/include/freetype2


Si vous utilisez des versions de CMake antérieures à la version 3.1.0, il est nécessaire de définir la variable CMake FREETYPE_INCLUDE_DIR_freetype2 manuellement, par exemple /usr/local/include/freetype2.
{{docnav/fr|[[CompileOnUnix/fr|CompileOnUnix]]|[[Third Party Libraries/fr|Third Party Libraries]]}}

<span id="Additional_Build_Instructions"></span>
=== Instructions de compilation supplémentaires ===


FreeCAD peut être construit à partir du dernier master git hébergé sur github et lancé à partir d'une CLI en utilisant les bibliothèques fournies par le tap homebrew-freecad. Pour une liste complète des instructions de construction, voir [https://github.com/ipatch/homebrew-us-05/tree/dev/freecad#building-freecad-for-macos-by-macos ici].
{{Userdocnavi}}


{{Docnav/fr
[[Category:Developer Documentation/fr]]
|[[Compile_on_Linux/fr|Compiler sous Linux]]
|[[Compile_on_Docker/fr|Compiler sur Docker]]
}}


{{Userdocnavi{{#translation:}}}}
{{clear}}
[[Category:Developer_Documentation{{#translation:}}]]
[[Category:Developer{{#translation:}}]]

Latest revision as of 12:55, 12 March 2023

Other languages:
Il existe un conteneur Docker FreeCAD expérimental qui est testé pour le développement FreeCAD. En savoir plus à ce sujet sur Compiler sur Docker

Présentation

Cette page décrit comment compiler le code source FreeCAD sur macOS. Pour les autres plates-formes, voir Compiler.

Ces instructions ont été testées sur macOS Catalina avec le XCode 11.6 standard. Il est connu pour fonctionner sur macOS BigSur Beta avec XCode 12.0 beta. Si vous prévoyez d'utiliser XCode Beta, assurez-vous de télécharger le module complémentaire Outils de ligne de commande via un package dmg pour contourner certains problèmes de dépendance libz.

Cette page sert de point de départ et n’a pas vocation à être exhaustive en ce qui concerne la description de toutes les options disponibles de build.

Si vous souhaitez simplement évaluer la dernière version de FreeCAD en version préliminaire, vous pouvez télécharger les fichiers binaires pré-construits ici.

Conditions préalables à l'installation

Les logiciels suivants doivent être installés pour prendre en charge le processus de compilation.

Gestionnaire de paquets Homebrew

Homebrew est un gestionnaire de paquets basé sur la ligne de commande pour macOS. La page d'accueil de Homebrew fournit une ligne de commande d'installation que vous collez simplement dans une fenêtre de terminal.

CMake

CMake est un outil de build qui génère une configuration de build basée sur les variables que vous spécifiez. Vous lancez ensuite la commande 'make' pour construire cette configuration. La version en ligne de commande de CMake est automatiquement installée dans le cadre de l'installation de Homebrew, ci-dessus. Si vous préférez utiliser une version graphique de CMake, vous pouvez la télécharger à partir de ici.

Installation des dépendances

FreeCAD maintient un Homebrew "cask" qui installe les formules et dépendances requises. Exécutez les commandes de préparation suivantes dans votre terminal. 

brew tap freecad/freecad
brew install eigen
brew install --only-dependencies freecad

brew install peut prendre un certain temps, donc vous pouvez aller prendre une verre:-).

Vous pouvez également installer manuellement les dépendances individuelles en installant les paquets suivants à l'aide de brew install ... :

  • cmake
  • swig
  • boost
  • boost-python3
  • eigen
  • gts
  • vtk
  • xerces-c
  • qt@5 - Seul Qt5 est actuellement supporté, le support de Qt6 est en cours de réalisation
  • opencascade
  • doxygen
  • pkgconfig
  • coin3d - Notez qu'à l'heure où nous écrivons ces lignes (Nov. 2022), cela installera une version inutilisable de pyside@2 en tant que dépendance.

Il existe plusieurs paquets qui ne sont disponibles que lorsque vous avez tapé le cask freecad : vous devez faire (brew tap freecad/freecad). En raison de certains contournements de bogues historiques, au moment de la rédaction de cet article (Nov. 2022) les versions de PySide2 et Shiboken2 installées par Homebrew ne sont pas utilisables car elles forcent l'utilisation de Py_Limited_API, que FreeCAD ne supporte pas. Il est prévu que cette solution de contournement soit supprimée dans les prochains mois, mais en attendant vous devez utiliser les versions FreeCAD cask de PySide et Shiboken. Utilisez brew install ..., installez les paquets suivants :

  • freecad/freecad/pyside2@5.15.5
  • freecad/freecad/shiboken2@5.15.5
  • freecad/freecad/med-file
  • freecad/freecad/netgen

Vous devrez également "lier" PySide et Shiboken : 

brew link freecad/freecad/pyside2@5.15.5 freecad/freecad/shiboken2@5.15.5

Dans certains cas, les paquets installés par Homebrew n'utilisent pas la même version de Python : par exemple, au moment où nous écrivons ces lignes, PySide2 utilise Python 3.10, mais boost-python3 utilise Python 3.11. Bien qu'il soit possible de "revenir en arrière" sur la version la plus avancée (de sorte que dans ce cas, boost-python3 utilise Python 3.10), il s'agit d'une opération avancée, et dans de nombreux cas, il est préférable d'attendre une mise à jour de l'autre paquet. Si vous voulez quand même poursuivre dans cette voie, regardez la commande "brew extract", que vous pouvez utiliser pour extraire une formule dans un nouveau cask (typiquement freecad/freecad). Vous pouvez ensuite modifier cette formule selon vos besoins.

Vous devrez définir le chemin d'accès à Qt : Qt5 est actuellement supporté, tandis que le support pour Qt6 est un travail en cours. Définissez FREECAD_QT_VERSION à "Auto" ou "5" pour sélectionner Qt5 (la valeur par défaut). Sur la ligne de commande, utilisez quelque chose comme : 

cmake \
  -DCMAKE_BUILD_TYPE="Release" \
  -DPYTHON_EXECUTABLE="/usr/local/bin/python3" \
  -DQt5_DIR="/usr/local/Cellar/qt@5/5.15.7/lib/cmake/Qt5" \
  -DPySide2_DIR="/usr/local/Cellar/pyside2@5.15.5/5.15.5/lib/cmake/PySide2-5.15.5" \
  -DShiboken2_DIR="/usr/local/Cellar/shiboken2@5.15.5/5.15.5_1/lib/cmake/Shiboken2-5.15.5" \
  ../freecad-source

Obtenir les sources

Dans les instructions suivantes, les dossiers source et de build sont créés côte à côte sous 

/Users/username/FreeCAD

mais vous pouvez utiliser les dossiers de votre choix. 

mkdir ~/FreeCAD
cd ~/FreeCAD

La commande suivante clone le référentiel FreeCAD git dans un répertoire appelé FreeCAD-git. 

git clone https://github.com/FreeCAD/FreeCAD FreeCAD-git

Créez le dossier build. 

mkdir ~/FreeCAD/build

Lancer CMake

Ensuite, nous allons lancer CMake pour générer la configuration de construction. Plusieurs options doivent être transmises à CMake. Le tableau suivant décrit les options et donne un aperçu.

Les options de CMake

Nom Valeur Remarques
CMAKE_BUILD_TYPE Release (STRING) Release ou Debug. Le débogage est généralement utilisé pour les tests au niveau développeur mais peut également être requis pour des tests et le dépannage au niveau utilisateur.
CMAKE_PREFIX_PATH "/usr/local/opt/qt5152;" ... (PATH) Nécessaire pour un build avec Qt5. Voir la remarque ci-dessous. Vous devez également ajouter le chemin d'accès au fichier de configuration cmake des librairies VTK et NGLIB.
FREECAD_CREATE_MAC_APP 1 (BOOL) Crée un paquet FreeCAD.app à l'emplacement spécifié dans CMAKE_INSTALL_PREFIX lorsque la commande 'make install' a été émise.
CMAKE_INSTALL_PREFIX "./.." (PATH) Chemin où vous souhaitez générer le paquet FreeCAD.app.
FREECAD_USE_EXTERNAL_KDL 1 (BOOL) Nécessaire.
BUILD_FEM_NETGEN 1 (BOOL) Requis si vous choisissez de construire les outils FEM.

Remarque : ligne de commande pour générer CMAKE_PREFIX_PATH : 

ls -d $(brew list -1 | grep qt | tail -1 | xargs brew --cellar)/*/lib/cmake

Interface graphique CMake

Ouvrez l'application CMake, et remplissez les champs source et dossier de compilation. Dans cet exemple, il s'agirait de /Users/username/FreeCAD/FreeCAD-git' pour les sources et /Users/username/FreeCAD/build pour le dossier de build.

Ensuite, cliquez sur le bouton Configure pour remplir la liste des options de configuration. Cela affichera une boîte de dialogue vous demandant de spécifier quel générateur utiliser. Laissez la valeur par défaut Unix Makefiles. La configuration échouera pour la première fois car certaines options doivent être changées. Remarque: vous devrez cocher la case à cocher Advanced pour obtenir toutes les options.

Définissez les options du tableau ci-dessus, puis cliquez à nouveau sur Configure puis sur Generate.

CMake en lignes de commande

Entrez ce qui suit dans le terminal. 

export PREFIX_PATH="/usr/local/opt/qt5152;\
/usr/local/Cellar/nglib/v6.2.2007/Contents/Resources;\
/usr/local/Cellar/vtk@8.2/8.2.0_1/lib/cmake;"

$cd ~/FreeCAD/build
$cmake \
  -DCMAKE_BUILD_TYPE="Release"   \
  -DBUILD_QT5=1                  \
  -DWITH_PYTHON3=1               \
  -DCMAKE_PREFIX_PATH="$PREFIX_PATH" \
  -DPYTHON_EXECUTABLE="/usr/local/bin/python3" \
  -DFREECAD_USE_EXTERNAL_KDL=1   \
  -DCMAKE_CXX_FLAGS='-std=c++14' \
  -DBUILD_FEM_NETGEN=1           \
  -DFREECAD_CREATE_MAC_APP=1     \
  -DCMAKE_INSTALL_PREFIX="./.."  \
  ../FreeCAD-git/

Exécuter make

Enfin, à partir d’un terminal, exécutez make pour compiler et lier FreeCAD et générer le paquet applicatif. 

cd ~/FreeCAD/build
make -j5 install

L'option -j spécifie le nombre de processus de création à exécuter simultanément. Prendre le nombre de cœurs de processeur et ajouter un est généralement le bon nombre à utiliser. Cependant, si la compilation échoue pour une raison quelconque, il est utile de réexécuter make sans l'option -j afin de pouvoir voir exactement où l'erreur s'est produite.

Voir aussi Compilation (accélération).

Si make se termine sans erreur, vous pouvez maintenant lancer FreeCAD en double-cliquant sur l'exécutable dans le Finder.

Mise à jour depuis Github

Le développement de FreeCAD est rapide ; chaque jour ou presque, il y a des corrections de bugs ou de nouvelles fonctionnalités. Pour obtenir les dernières modifications, utilisez git pour mettre à jour le répertoire source (voir Gestion du code source), puis réexécutez CMake et suivez les étapes ci-dessus. Dans ce cas, il n’est généralement pas nécessaire de commencer par un répertoire de build vierge et les compilations suivantes iront généralement beaucoup plus vite que la première.

Faire une compilation avec Qt4 et Python 2.7

FreeCAD est passé de Qt 4 à Qt 5 comme homebrew. Qt 4 n'est plus disponible en option pour une nouvelle version sur macOS après la transition Qt 5. Python 2.7 est obsolète dans homebrew et macOS à venir et nous ne le supportons plus non plus pour la version macOS.

Dépannage

Un segfault sur le lancement de Qt5

Si Qt4 a été précédemment installé via Homebrew et que vous faites un build ensuite avec Qt5, vous pouvez obtenir une exception EXC_BAD_ACCESS (SEGSEGV) lors du lancement de la nouvelle version de Qt5. Le correctif consiste à désinstaller manuellement Qt4. 

brew uninstall --ignore-dependencies --force cartr/qt4/shiboken@1.2 cartr/qt4/pyside@1.2 cartr/qt4/pyside-tools@1.2 cartr/qt4/qt-legacy-formula

Fortran

"No CMAKE_Fortran_COMPILER could be found." (Aucun CMAKE_Fortran_COMPILER n'a pu être trouvé) lors de la configuration - Les anciennes versions de FreeCAD nécessiteront l'installation d'un compilateur Fortran. Avec Homebrew, faites "brew install gcc" et essayez à nouveau de configurer cmake en donnant le chemin à Fortran, c'est-à-dire -DCMAKE_Fortran_COMPILER=/opt/local/bin/gfortran-mp-4.9, ou utilisez de préférence une version plus récente de la source FreeCAD!

FreeType

Si vous utilisez des versions de CMake antérieures à la version 3.1.0, il est nécessaire de définir la variable CMake FREETYPE_INCLUDE_DIR_freetype2 manuellement, par exemple /usr/local/include/freetype2.

Instructions de compilation supplémentaires

FreeCAD peut être construit à partir du dernier master git hébergé sur github et lancé à partir d'une CLI en utilisant les bibliothèques fournies par le tap homebrew-freecad. Pour une liste complète des instructions de construction, voir ici.

Hub utilisateurs
Retrieved from "http://wiki.freecad.org/index.php?title=Compile_on_MacOS/fr&oldid=1237825"