Compiler sous Mac

From FreeCAD Documentation
Revision as of 12:42, 23 December 2014 by Rockn (talk | contribs) (Created page with "{| class="wikitable" style="text-align:left" |- ! Nom de l'option !! Valeur !! Notes |- | BUILD_ROBOT || OFF (unchecked) || Puisque depuis le 19/12/2014, le mo...")

Cette page explique comment compiler le dernier code source de FreeCAD sur MAC OS X.

Prérequis

Tout d'abord, vous allez avoir besoin d'installer les logiciels suivants.

Xcode Development Tools

À moins que vous ne souhaitiez utiliser l'IDE Xcode pour le développement de FreeCAD, vous n'avez besoin d'installer que les outils de Ligne de Commande (Command Line Tools). Pour faire ça sur 10.9 ou plus récent, ouvrez un Terminal, lancer la commande suivante puis cliquer sur Installer dans la boîte de dialogue qui s'affiche.

xcode-select --install

Pour les autres version de OS X, vous pouvez avoir le paquet des sur la page de téléchargement des développeurs Apple (connectez vous avec le même ID Apple que vous utilisez sur d'autre services d'Apple). Techniquement vous avez besoin de télécharger Development Tools 3.2 pour OS X 10.6, et Commande Line Tools 4.8 pour OS X 10.8.

CMake

Installez la dernière version de CMake depuis http://www.cmake.org/download. Bien que Homebrew installe aussi CMake, il n'installe que l’exécutable de la ligne de commande.

Homebrew

Pour installer Homebrew, entrer ce qui suit dans un terminal :

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Récupérer les sources

Dans ce guide, les dossiers source et build sont créés dans /Users/username/FreeCAD, mais vous pouvez bien sur utiliser le dossier que vous voulez.

mkdir ~/FreeCAD
cd ~/FreeCAD

Pour télécharger le code source de FreeCAD, lancer :

git clone git://git.code.sf.net/p/free-cad/code FreeCAD-git

Une alternative est d'utiliser le mirroir Github : https://github.com/FreeCAD/FreeCAD_sf_master.git

Installer les dépendances

Toutes les librairies nécessaires peuvent être installer avec Homebrew.

brew tap homebrew/science
brew tap sanelson/freecad
brew install boost eigen freetype oce python qt pyside pyside-tools xerces-c
brew install --without-framework --without-soqt sanelson/freecad/coin
brew install --HEAD pivy

Compiler FreeCAD

En premier, créez un nouveau dossier pour le build :

mkdir ~/FreeCAD/build

Maintenant vous allez devoir lancer CMake pour générer les fichiers de build. Ouvrez l'application CMake et remplissez les chemins des dossiers source et build. Dans ce cas ce devrait être : /Users/username/FreeCAD/FreeCAD-git pour les sources, et /Users/username/FreeCAD/build pour le dossier de build.

Ensuite, cliquer sur le bouton "Configure". Cela fait apparaître une boîte de dialogue demandant de spécifier quel générateur utiliser. Laisser le choix par défaut (Unix Makefiles'). La configuration va échouer la première fois car il y a quelques options qui doivent être changés. Note : il faut cocher la case Advanced pour voir toutes les options.

Nom de l'option Valeur Notes
BUILD_ROBOT OFF (unchecked) Puisque depuis le 19/12/2014, le module Robot échoue à la compilation avec la dernière version de clang (OS X 10.9 et suivant)
CMAKE_BUILD_TYPE Release
FREECAD_USE_EXTERNAL_PIVY ON (checked)
FREETYPE_INCLUDE_DIR_freetype2 /usr/local/include/freetype2 Seulement si vous utilisez une version de CMake plus vielle que la 3.1.0
OCE_DIR /usr/local/Cellar/oce/0.16.1/OCE.framework/Versions/0.16/Resources
PYSIDERCC4BINARY /usr/local/bin/pyside-rcc
PYSIDEUIC4BINARY /usr/local/bin/pyside-uic
PYTHON_EXECUTABLE /usr/local/bin/python
PYTHON_INCLUDE_DIR /usr/local/Cellar/python/2.7.9/Frameworks/Python.framework/Versions/2.7/include/python2.7
PYTHON_LIBRARY /usr/local/Cellar/python/2.7.9/Frameworks/Python.framework/Versions/2.7/lib/libpython2.7.dylib

Note : les chemins pour OCE et Python sont pour les versions respectives 0.16.1 et 2.7.9 -- à changer si besoin.

Now click Configure again and then Generate.

Finally, run make to compile FreeCAD.

cd ~/FreeCAD/build
make –j3

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.

If make finishes without any errors, you can now launch FreeCAD, either from Terminal with ./bin/FreeCAD, or by double clicking the executable in Finder.

Creating an application bundle

TODO

Updating

FreeCAD development happens fast; everyday or so there are bug fixes or new features. To get these changes, run:

cd ~/FreeCAD/FreeCAD-git
git pull

And then repeat the compile step above.

Troubleshooting

TODO

CompileOnUnix
Third Party Libraries