Compile on MacOS: Difference between revisions
m (Robot: Automated text replacement (-www.freecadweb.org/forum +forum.freecadweb.org)) |
Renatorivo (talk | contribs) (translate) |
||
Line 1: | Line 1: | ||
<translate> |
|||
Since Mac OS X is BSD (UNIX) based, compiling FreeCAD on a Mac isn't much different from [[CompileOnUnix]], however there are a number of Mac-specific details critical to getting everything working properly. These instructions have been tested on Lion (10.7), but ''should work'' on Intel Macs running (Snow) Leopard as well. |
Since Mac OS X is BSD (UNIX) based, compiling FreeCAD on a Mac isn't much different from [[CompileOnUnix]], however there are a number of Mac-specific details critical to getting everything working properly. These instructions have been tested on Lion (10.7), but ''should work'' on Intel Macs running (Snow) Leopard as well. |
||
== Getting the source == |
== Getting the source == |
||
Before you can compile FreeCAD, you need the source code. There are 3 ways to get it: |
Before you can compile FreeCAD, you need the source code. There are 3 ways to get it: |
||
=== Git === |
=== Git === |
||
The quickest and best way to get the code is to clone the read-only git repository (you need the [http://git-scm.com/ git] package installed): |
The quickest and best way to get the code is to clone the read-only git repository (you need the [http://git-scm.com/ git] package installed): |
||
</translate> |
|||
git clone git://free-cad.git.sourceforge.net/gitroot/free-cad/free-cad freecad |
git clone git://free-cad.git.sourceforge.net/gitroot/free-cad/free-cad freecad |
||
<translate> |
|||
This will place a copy of the latest version of the FreeCAD source code in a new directory called "freecad". The first time you try connecting to the free-cad.git.sourceforge.net host, you will receive a message asking to authenticate the sourceforge SSH key, which is normally safe to accept (you can check their SSH keys on the sourceforge website if you are not sure) |
This will place a copy of the latest version of the FreeCAD source code in a new directory called "freecad". The first time you try connecting to the free-cad.git.sourceforge.net host, you will receive a message asking to authenticate the sourceforge SSH key, which is normally safe to accept (you can check their SSH keys on the sourceforge website if you are not sure) |
||
=== Github === |
=== Github === |
||
There is an always up to date FreeCAD repository on Gihub: |
There is an always up to date FreeCAD repository on Gihub: |
||
[https://github.com/FreeCAD/FreeCAD_sf_master github.com/FreeCAD/FreeCAD_sf_master] |
[https://github.com/FreeCAD/FreeCAD_sf_master github.com/FreeCAD/FreeCAD_sf_master] |
||
=== Source package === |
=== Source package === |
||
Alternatively you can download a source package, but they could be already quite old so it's always better to get the latest sources. Depending on your distribution, there are several ways to obtain a source package: |
Alternatively you can download a source package, but they could be already quite old so it's always better to get the latest sources. Depending on your distribution, there are several ways to obtain a source package: |
||
</translate> |
|||
Official FreeCAD source packages (distribution-independent): https://sourceforge.net/projects/free-cad/files/FreeCAD%20Source/ |
Official FreeCAD source packages (distribution-independent): https://sourceforge.net/projects/free-cad/files/FreeCAD%20Source/ |
||
Debian: http://packages.debian.org/source/sid/freecad |
Debian: http://packages.debian.org/source/sid/freecad |
||
Ubuntu: http://packages.ubuntu.com/source/precise/freecad |
Ubuntu: http://packages.ubuntu.com/source/precise/freecad |
||
<translate> |
|||
=== Install Dependencies === |
=== Install Dependencies === |
||
On Mac OS X 10.7, the following dependencies are NOT bundled with the operating and thus must be installed before building FreeCAD: |
On Mac OS X 10.7, the following dependencies are NOT bundled with the operating and thus must be installed before building FreeCAD: |
||
Line 44: | Line 40: | ||
==== Option 1: Homebrew ==== |
==== Option 1: Homebrew ==== |
||
'''Note''': this section is still a work in progress! See the help forum post for the latest. |
'''Note''': this section is still a work in progress! See the help forum post for the latest. |
||
Line 54: | Line 49: | ||
Then compile and install most of FreeCAD's dependencies: |
Then compile and install most of FreeCAD's dependencies: |
||
</translate> |
|||
brew install sip gfortran xerces-c boost eigen coin qt pyqt soqt ftgl |
brew install sip gfortran xerces-c boost eigen coin qt pyqt soqt ftgl |
||
<translate> |
|||
Go on to [[CompileOnMac#Build OpenCASCADE]]. |
Go on to [[CompileOnMac#Build OpenCASCADE]]. |
||
==== Option 2: MacPorts/Fink ==== |
==== Option 2: MacPorts/Fink ==== |
||
'''Note: this section is in need of updates.''' |
'''Note: this section is in need of updates.''' |
||
Install MacPorts |
Install MacPorts (if you don't already have it). MacPorts is a system that allows you to download, compile, and install many common open-source applications with a single command. Similar applications from the UNIX/Linux world are PKGSRC and APT. To install, just download the disk image from the MacPorts site and follow the directions: |
||
:http://www.macports.org/install.php |
:http://www.macports.org/install.php |
||
Whether or not you just installed MacPorts, you'll probably want to make sure it's up to date. Run: |
Whether or not you just installed MacPorts, you'll probably want to make sure it's up to date. Run: |
||
</translate> |
|||
sudo port selfupdate |
sudo port selfupdate |
||
<translate> |
|||
Now that MacPorts is installed and up to date, you can start installing some of FreeCAD's required packages: |
Now that MacPorts is installed and up to date, you can start installing some of FreeCAD's required packages: |
||
Line 83: | Line 77: | ||
The following command will compile/install the above libraries. If MacPorts produces errors, you may want to try installing them one at a time. |
The following command will compile/install the above libraries. If MacPorts produces errors, you may want to try installing them one at a time. |
||
</translate> |
|||
sudo port install xercesc boost ftgl f2c eigen3 py-sip py-pyqt4 Coin |
sudo port install xercesc boost ftgl f2c eigen3 py-sip py-pyqt4 Coin |
||
<translate> |
|||
Note that for python packages like py-sip and py-pyqt4, there are multiple packages, one for each MacPorts version of Python. |
Note that for python packages like py-sip and py-pyqt4, there are multiple packages, one for each MacPorts version of Python. |
||
Line 93: | Line 87: | ||
It is also possible to choose the version of the gcc compiler to use, some recent versions might sometimes cause problems: |
It is also possible to choose the version of the gcc compiler to use, some recent versions might sometimes cause problems: |
||
</translate> |
|||
sudo port -v install gcc_select |
sudo port -v install gcc_select |
||
sudo port select --list gcc |
sudo port select --list gcc |
||
sudo port select --set gcc mp-gcc46 |
sudo port select --set gcc mp-gcc46 |
||
<translate> |
|||
'''Install Fortran Compiler''' |
'''Install Fortran Compiler''' |
||
Line 107: | Line 101: | ||
If you are using fink, another method is to use the following commands (attempted by Shaneyfelt 2100.Nov.14) |
If you are using fink, another method is to use the following commands (attempted by Shaneyfelt 2100.Nov.14) |
||
</translate> |
|||
sudo fink selfupdate |
sudo fink selfupdate |
||
sudo fink install gcc46 |
sudo fink install gcc46 |
||
<translate> |
|||
''This installs another gcc compiler collection with the name gcc-4 to avoid a name conflict with the apple one.'' |
''This installs another gcc compiler collection with the name gcc-4 to avoid a name conflict with the apple one.'' |
||
MacPorts gcc4x packages also include FORTRAN compilers, so this should also work: |
MacPorts gcc4x packages also include FORTRAN compilers, so this should also work: |
||
</translate> |
|||
sudo port install gcc46 |
sudo port install gcc46 |
||
<translate> |
|||
Another possible MacPorts package is g95. This seems to be a valid FORTRAN90 compiler and will pass FreeCAD's cmake configuration tests, but the actual build seems to ask for gcc-specific options, so probably easier to stick to gcc4x. |
Another possible MacPorts package is g95. This seems to be a valid FORTRAN90 compiler and will pass FreeCAD's cmake configuration tests, but the actual build seems to ask for gcc-specific options, so probably easier to stick to gcc4x. |
||
'''Install Eigen3''' |
'''Install Eigen3''' |
||
Line 136: | Line 130: | ||
Then, in terminal: |
Then, in terminal: |
||
</translate> |
|||
mkdir build |
mkdir build |
||
cd build |
cd build |
||
Line 143: | Line 137: | ||
make |
make |
||
make install/strip |
make install/strip |
||
<translate> |
|||
You may need cmake: |
You may need cmake: |
||
</translate> |
|||
sudo port install cmake |
sudo port install cmake |
||
<translate> |
|||
=== Download and 'install' the FreeCAD.app template === |
=== Download and 'install' the FreeCAD.app template === |
||
The following archive contains an application bundle template for FreeCAD. This is not strictly necessary, but it makes working with FreeCAD more convenient than the default installation configuration. The recommended install location for the bundle is the /Applications folder, but you should be able to put it anywhere you want -- just remember that the bundle can't be moved after FreeCAD is complied and installed without further modifications. Running make install using the configuration in the next step will install into this bundle. |
The following archive contains an application bundle template for FreeCAD. This is not strictly necessary, but it makes working with FreeCAD more convenient than the default installation configuration. The recommended install location for the bundle is the /Applications folder, but you should be able to put it anywhere you want -- just remember that the bundle can't be moved after FreeCAD is complied and installed without further modifications. Running make install using the configuration in the next step will install into this bundle. |
||
Line 155: | Line 148: | ||
=== Compile === |
=== Compile === |
||
Configure, compile, and install FreeCAD using the following commands from within the root FreeCAD folder. If you put your FreeCAD.app bundle somewhere other than /Applications (or aren't using the bundle), change the 'PREFIX' argument accordingly. |
Configure, compile, and install FreeCAD using the following commands from within the root FreeCAD folder. If you put your FreeCAD.app bundle somewhere other than /Applications (or aren't using the bundle), change the 'PREFIX' argument accordingly. |
||
</translate> |
|||
./autogen.sh |
./autogen.sh |
||
PREFIX=/Applications/FreeCAD.app/Contents |
PREFIX=/Applications/FreeCAD.app/Contents |
||
<translate> |
|||
If you installed dependencies using Option 1 (Homebrew): |
If you installed dependencies using Option 1 (Homebrew): |
||
''Note'': this config line has not been verified and may contain errors! |
''Note'': this config line has not been verified and may contain errors! |
||
</translate> |
|||
./configure --with-xercesc-lib=/usr/local/lib --with-xercesc-include=/usr/local/include \ |
./configure --with-xercesc-lib=/usr/local/lib --with-xercesc-include=/usr/local/include \ |
||
--with-boost-lib=/usr/local/lib --with-boost-include=/usr/local/include \ |
--with-boost-lib=/usr/local/lib --with-boost-include=/usr/local/include \ |
||
Line 176: | Line 168: | ||
--datarootdir=/Applications/FreeCAD.app/Contents/Resources/share --enable-debug=no \ |
--datarootdir=/Applications/FreeCAD.app/Contents/Resources/share --enable-debug=no \ |
||
--with-python-include=/System/Library/Frameworks/Python.framework/Versions/2.5/Headers |
--with-python-include=/System/Library/Frameworks/Python.framework/Versions/2.5/Headers |
||
<translate> |
|||
Or if you installed dependencies using Option 2 (MacPorts/Fink): |
Or if you installed dependencies using Option 2 (MacPorts/Fink): |
||
</translate> |
|||
./configure --with-xercesc-lib=/opt/local/lib --with-xercesc-include=/opt/local/include \ |
./configure --with-xercesc-lib=/opt/local/lib --with-xercesc-include=/opt/local/include \ |
||
--with-boost-lib=/opt/local/lib --with-boost-include=/opt/local/include \ |
--with-boost-lib=/opt/local/lib --with-boost-include=/opt/local/include \ |
||
Line 190: | Line 182: | ||
--datarootdir=/Applications/FreeCAD.app/Contents/Resources/share --enable-debug=no \ |
--datarootdir=/Applications/FreeCAD.app/Contents/Resources/share --enable-debug=no \ |
||
--with-python-include=/System/Library/Frameworks/Python.framework/Versions/2.5/Headers |
--with-python-include=/System/Library/Frameworks/Python.framework/Versions/2.5/Headers |
||
<translate> |
|||
Then: |
Then: |
||
</translate> |
|||
make |
make |
||
make install |
make install |
||
<translate> |
|||
Depending on your machine's processing power, the make step can take quite a while. |
Depending on your machine's processing power, the make step can take quite a while. |
||
Line 204: | Line 196: | ||
Some users reported facing a "No Module named PyQt4" message on FreeCAD startup. This is a workaround to correct it: |
Some users reported facing a "No Module named PyQt4" message on FreeCAD startup. This is a workaround to correct it: |
||
</translate> |
|||
cd /Library/Python/2.6/site-packages |
cd /Library/Python/2.6/site-packages |
||
sudo ln -s /contrib/lib/python2.6/site-packages/PyQt4 . |
sudo ln -s /contrib/lib/python2.6/site-packages/PyQt4 . |
||
Line 211: | Line 204: | ||
cd /volatile/FreeCAD-r5443-ser/lib |
cd /volatile/FreeCAD-r5443-ser/lib |
||
for i in *.dylib; do j=`basename $i .dylib`; cp $i $j.so; done |
for i in *.dylib; do j=`basename $i .dylib`; cp $i $j.so; done |
||
<translate> |
|||
=== Pivy === |
=== Pivy === |
||
Some FreeCAD components won't work without Pivy. See [[Extra_python_modules#Pivy|here]] for partial build instructions. |
Some FreeCAD components won't work without Pivy. See [[Extra_python_modules#Pivy|here]] for partial build instructions. |
||
Line 218: | Line 211: | ||
{{docnav|CompileOnUnix|Third Party Libraries}} |
{{docnav|CompileOnUnix|Third Party Libraries}} |
||
⚫ | |||
{{languages | {{es|CompileOnMac/es}} {{fr|CompileOnMac/fr}} {{it|CompileOnMac/it}} {{jp|CompileOnMac/jp}} {{se|CompileOnMac/se}} }} |
|||
</translate> |
|||
⚫ | |||
{{clear}} |
|||
<languages/> |
Revision as of 21:57, 6 November 2014
Since Mac OS X is BSD (UNIX) based, compiling FreeCAD on a Mac isn't much different from CompileOnUnix, however there are a number of Mac-specific details critical to getting everything working properly. These instructions have been tested on Lion (10.7), but should work on Intel Macs running (Snow) Leopard as well.
Getting the source
Before you can compile FreeCAD, you need the source code. There are 3 ways to get it:
Git
The quickest and best way to get the code is to clone the read-only git repository (you need the git package installed):
git clone git://free-cad.git.sourceforge.net/gitroot/free-cad/free-cad freecad
This will place a copy of the latest version of the FreeCAD source code in a new directory called "freecad". The first time you try connecting to the free-cad.git.sourceforge.net host, you will receive a message asking to authenticate the sourceforge SSH key, which is normally safe to accept (you can check their SSH keys on the sourceforge website if you are not sure)
Github
There is an always up to date FreeCAD repository on Gihub: github.com/FreeCAD/FreeCAD_sf_master
Source package
Alternatively you can download a source package, but they could be already quite old so it's always better to get the latest sources. Depending on your distribution, there are several ways to obtain a source package:
Official FreeCAD source packages (distribution-independent): https://sourceforge.net/projects/free-cad/files/FreeCAD%20Source/ Debian: http://packages.debian.org/source/sid/freecad Ubuntu: http://packages.ubuntu.com/source/precise/freecad
Install Dependencies
On Mac OS X 10.7, the following dependencies are NOT bundled with the operating and thus must be installed before building FreeCAD:
- sip
- fortran
- xerces-c
- boost
- eigen
- ftgl
- coin3d
- OpenCASCADE
- Qt
- pyqt
- soqt
Option 1: Homebrew
Note: this section is still a work in progress! See the help forum post for the latest.
Download and install the package manager Homebrew:
Then compile and install most of FreeCAD's dependencies:
brew install sip gfortran xerces-c boost eigen coin qt pyqt soqt ftgl
Go on to CompileOnMac#Build OpenCASCADE.
Option 2: MacPorts/Fink
Note: this section is in need of updates.
Install MacPorts (if you don't already have it). MacPorts is a system that allows you to download, compile, and install many common open-source applications with a single command. Similar applications from the UNIX/Linux world are PKGSRC and APT. To install, just download the disk image from the MacPorts site and follow the directions:
Whether or not you just installed MacPorts, you'll probably want to make sure it's up to date. Run:
sudo port selfupdate
Now that MacPorts is installed and up to date, you can start installing some of FreeCAD's required packages:
- xercesc
- boost
- py-sip
- ftlg
- f2c
- eigen3
- py-pyqt4
- Coin
The following command will compile/install the above libraries. If MacPorts produces errors, you may want to try installing them one at a time.
sudo port install xercesc boost ftgl f2c eigen3 py-sip py-pyqt4 Coin
Note that for python packages like py-sip and py-pyqt4, there are multiple packages, one for each MacPorts version of Python.
Note that boost is a large package, and py-pyqt4 depends on qt4-mac, which is a large package. You may want to run port -v install so that you have more of an idea what's going on during these long builds.
Qt4 is also available for Mac as a binary installer from the Qt web site. I'm not sure how nicely this approach plays with FreeCAD compiling.
It is also possible to choose the version of the gcc compiler to use, some recent versions might sometimes cause problems:
sudo port -v install gcc_select sudo port select --list gcc sudo port select --set gcc mp-gcc46
Install Fortran Compiler
You also need a FORTRAN compiler. Apple's fork of gcc on OSX does not come with FORTRAN.
An installer for GFortran can be found here, and will do the trick:
http://gcc.gnu.org/wiki/GFortranBinaries#MacOS
If you are using fink, another method is to use the following commands (attempted by Shaneyfelt 2100.Nov.14)
sudo fink selfupdate sudo fink install gcc46
This installs another gcc compiler collection with the name gcc-4 to avoid a name conflict with the apple one.
MacPorts gcc4x packages also include FORTRAN compilers, so this should also work:
sudo port install gcc46
Another possible MacPorts package is g95. This seems to be a valid FORTRAN90 compiler and will pass FreeCAD's cmake configuration tests, but the actual build seems to ask for gcc-specific options, so probably easier to stick to gcc4x.
Install Eigen3
Download and unzip the latest eigen3 library here:
http://eigen.tuxfamily.org/index.php?title=Main_Page
These are needed for solver functionality. Once unzipped, the folder named 'Eigen' can be dropped into
/usr/local/include/eigen3/
Build OpenCASCADE
Currently, the easiest way to build OpenCASCADE on OS X is from the community edition (oce). Download the source or check out the Git repository from:
Then, in terminal:
mkdir build cd build cmake .. cd .. make make install/strip
You may need cmake:
sudo port install cmake
Download and 'install' the FreeCAD.app template
The following archive contains an application bundle template for FreeCAD. This is not strictly necessary, but it makes working with FreeCAD more convenient than the default installation configuration. The recommended install location for the bundle is the /Applications folder, but you should be able to put it anywhere you want -- just remember that the bundle can't be moved after FreeCAD is complied and installed without further modifications. Running make install using the configuration in the next step will install into this bundle.
Compile
Configure, compile, and install FreeCAD using the following commands from within the root FreeCAD folder. If you put your FreeCAD.app bundle somewhere other than /Applications (or aren't using the bundle), change the 'PREFIX' argument accordingly.
./autogen.sh PREFIX=/Applications/FreeCAD.app/Contents
If you installed dependencies using Option 1 (Homebrew):
Note: this config line has not been verified and may contain errors!
./configure --with-xercesc-lib=/usr/local/lib --with-xercesc-include=/usr/local/include \ --with-boost-lib=/usr/local/lib --with-boost-include=/usr/local/include \ --with-qt4-dir=/usr/local--with-qt4-lib=/usr/local/lib --with-qt4-include=/usr/local/include \ --with-qt4-framework=/usr/local/lib --with-qt4-bin=/usr/local/bin --with-occ-lib=/usr/local/lib \ --with-occ-include=/usr/local/include/oce --with-coin=/usr/local/lib --with-soqt=/usr/local/lib \ --prefix=/Applications/FreeCAD.app/Contents --bindir=/Applications/FreeCAD.app/Contents/MacOS \ --libdir=/Applications/FreeCAD.app/Contents/Frameworks/FreeCAD \ --includedir=/Applications/FreeCAD.app/Contents/Resources/include \ --datarootdir=/Applications/FreeCAD.app/Contents/Resources/share --enable-debug=no \ --with-python-include=/System/Library/Frameworks/Python.framework/Versions/2.5/Headers
Or if you installed dependencies using Option 2 (MacPorts/Fink):
./configure --with-xercesc-lib=/opt/local/lib --with-xercesc-include=/opt/local/include \ --with-boost-lib=/opt/local/lib --with-boost-include=/opt/local/include \ --with-qt4-dir=/usr/local/Trolltech/Qt-4.8.0 --with-qt4-lib=/usr/local/Trolltech/Qt-4.8.0/lib \ --with-qt4-include=/usr/local/Trolltech/Qt-4.8.0/include --with-qt4-framework=/Library/Frameworks \ --with-qt4-bin=/usr/local/Trolltech/Qt-4.8.0/bin --with-occ-lib=/usr/local/lib \ --with-occ-include=/usr/local/include/oce --with-coin=/Library/Frameworks \ --with-soqt=/Library/Frameworks --prefix=/Applications/FreeCAD.app/Contents \ --bindir=/Applications/FreeCAD.app/Contents/MacOS --libdir=/Applications/FreeCAD.app/Contents/Frameworks/FreeCAD \ --includedir=/Applications/FreeCAD.app/Contents/Resources/include \ --datarootdir=/Applications/FreeCAD.app/Contents/Resources/share --enable-debug=no \ --with-python-include=/System/Library/Frameworks/Python.framework/Versions/2.5/Headers
Then:
make make install
Depending on your machine's processing power, the make step can take quite a while.
Run
If everything went OK, double-clicking the .app bundle should start FreeCAD. If you have any issues, post the details on the help forum.
PyQt4
Some users reported facing a "No Module named PyQt4" message on FreeCAD startup. This is a workaround to correct it:
cd /Library/Python/2.6/site-packages sudo ln -s /contrib/lib/python2.6/site-packages/PyQt4 . sudo ln -s /contrib/lib/python2.6/site-packages/sip* . cd /volatile/FreeCAD-r5443-ser/bin/pivy cp _coin.dylib _coin.so cd /volatile/FreeCAD-r5443-ser/lib for i in *.dylib; do j=`basename $i .dylib`; cp $i $j.so; done
Pivy
Some FreeCAD components won't work without Pivy. See here for partial build instructions.