Compile on MacOS/fr

Présentation
Cette page décrit comment compiler le code source FreeCAD sur MacOS X. 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 'tap' Homebrew qui installe les formules et dépendances requises. Exécutez les commandes de préparation suivantes dans votre terminal.

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

Alternately, you can install the individual dependencies manually by installing the following packages using :


 * - Only Qt5 is currently supported, support for Qt6 is a work-in-progress
 * - Note that as of this writing (Nov. 2022) this will install an unusable version of pyside@2 as a dependency.
 * - Only Qt5 is currently supported, support for Qt6 is a work-in-progress
 * - Note that as of this writing (Nov. 2022) this will install an unusable version of pyside@2 as a dependency.
 * - Only Qt5 is currently supported, support for Qt6 is a work-in-progress
 * - Note that as of this writing (Nov. 2022) this will install an unusable version of pyside@2 as a dependency.
 * - Only Qt5 is currently supported, support for Qt6 is a work-in-progress
 * - Note that as of this writing (Nov. 2022) this will install an unusable version of pyside@2 as a dependency.
 * - Only Qt5 is currently supported, support for Qt6 is a work-in-progress
 * - Note that as of this writing (Nov. 2022) this will install an unusable version of pyside@2 as a dependency.
 * - Note that as of this writing (Nov. 2022) this will install an unusable version of pyside@2 as a dependency.
 * - Note that as of this writing (Nov. 2022) this will install an unusable version of pyside@2 as a dependency.
 * - Note that as of this writing (Nov. 2022) this will install an unusable version of pyside@2 as a dependency.

There are several packages that are only available when you have tapped the freecad cask: you must do that. Due to some historical bug workarounds, at the time of this writing (Nov. 2022) the versions of PySide2 and Shiboken2 installed by Homebrew are not usable because they force the use of Py_Limited_API, which FreeCAD does not support. It is expected that this workaround will be removed in the coming months, but in the meantime you must use the FreeCAD cask versions of PySide and Shiboken. Use, install the following packages:



You will also need to "link" PySide and Shiboken:

In some cases the packages installed by Homebrew do not use the same Python version: for example, at the time of this writing PySide2 uses Python 3.10, but boost-python3 uses Python 3.11. While it is possible to "roll back" the more advanced version (so that in this case boost-python3 uses Python 3.10) this is an advanced operation, and in many cases it is best to wait for an update to the other package. If you want to pursue that path anyway, look at the "brew extract" command, which you can use to extract a formula into a new cask (typically freecad/freecad). You can then edit that formula as needed.

You will need to set the path to Qt: Qt5 is currently supported, while support for Qt6 is a work-in-progress. Set FREECAD_QT_VERSION to "Auto" or "5" to select Qt5 (the default). On the command line, use something like:

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

mais vous pouvez utiliser les dossiers de votre choix.

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

Créez le dossier 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
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.

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

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.

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.

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.