Browse Source
OSX build improvements.
OSX build improvements.
* Compile all binaries into a single application bundle. * Use CMake BundleUtilities to make application bundle relocatable. * Restructure build output to directly create an image file. * Fix default search paths. * Set KIGITHUB environment variable. * Added patch to fix wxWidgets so names for OSX.pull/1/head
Bernhard Stegmaier
11 years ago
committed by
Wayne Stambaugh
Wayne Stambaugh
16 changed files with 440 additions and 315 deletions
-
42CMakeLists.txt
-
207Documentation/compiling/mac-osx.txt
-
31bitmap2component/CMakeLists.txt
-
2common/kiface_i.cpp
-
22common/systemdirsappend.cpp
-
60cvpcb/CMakeLists.txt
-
57eeschema/CMakeLists.txt
-
55gerbview/CMakeLists.txt
-
15include/common.h
-
28kicad/CMakeLists.txt
-
11kicad/Info.plist
-
57pagelayout_editor/CMakeLists.txt
-
44patches/wxwidgets-3.0.0_macosx_soname.patch
-
55pcb_calculator/CMakeLists.txt
-
56pcbnew/CMakeLists.txt
-
13utils/idftools/CMakeLists.txt
@ -1,63 +1,150 @@ |
|||
Compiling KiCad on Apple Mac OS X |
|||
================================= |
|||
First written: 2010-01-31 |
|||
by: Jerry Jacobs <xor.gate.engineering[at]gmail[dot]com> |
|||
|
|||
Modified at: 2014-02-07 |
|||
by: Marco Serantoni <marco.serantoni[at]gmail[dot]com> |
|||
|
|||
Snow Leopard |
|||
------------ |
|||
|
|||
Requirements |
|||
* XCode Tools (http://developer.apple.com/tools/xcode) |
|||
* bzr (bazaar) |
|||
* CMake (http://www.cmake.org) |
|||
|
|||
The build of Kicad for OSX is now easier than before. |
|||
The building system will download and compile the needed libraries for you |
|||
patching them accordly to the needs. |
|||
|
|||
Building Kicad with no support for Scripting |
|||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|||
|
|||
The building needs to know if you want a static binary or a dynamic one |
|||
Just set ONE of those two options KICAD_BUILD_STATIC or KICAD_BUILD_DYNAMIC |
|||
|
|||
If you set KICAD_BUILD_DYNAMIC the building system will build all and include |
|||
the needed libraries for each executable in its bundle |
|||
|
|||
cmake -DKICAD_BUILD_DYNAMIC=ON . |
|||
make |
|||
|
|||
Building Kicad with support for Scripting |
|||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|||
Due some problems with some dependencies the build of this kind of binary is a bit |
|||
more complex, you should initially set KICAD_BUILD_DYNAMIC |
|||
then issue for example |
|||
|
|||
cmake -DKICAD_BUILD_DYNAMIC=ON . |
|||
make swig |
|||
|
|||
After successfully building you can set your KICAD_SCRIPTING* options (for example): |
|||
|
|||
cmake -DKICAD_SCRIPTING=ON -DKICAD_SCRIPTING_WXPYTHON=ON -DKICAD_SCRIPTING_MODULES=ON . |
|||
make |
|||
|
|||
The system will build all accordling your choices and package all in the bundle |
|||
I know bundles will be huge, but those will be autosufficient. |
|||
|
|||
Building Kicad for other processors or Universal binaries |
|||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|||
|
|||
I wish remember you should set the processor like |
|||
|
|||
cmake -DCMAKE_OSX_ARCHITECTURES="x86_64" |
|||
|
|||
for other platforms |
|||
|
|||
cmake -DCMAKE_OSX_ARCHITECTURES="x86_64 -arch i386" |
|||
cmake -DCMAKE_OSX_ARCHITECTURES="x86_64 -arch i386 -arch ppc" |
|||
|
|||
I know some you should prefer use ; as separator, this will be accomplished soon |
|||
keeping support for both the syntaxes |
|||
Building on OSX is very similar to building on Linux. This document will provide a |
|||
complete walk-through on what to do but it will focus on OSX specific things. |
|||
See general documentation on non-OSX specific KiCad build switches, etc. |
|||
|
|||
|
|||
Prerequisites |
|||
------------- |
|||
|
|||
Tools needed for building KiCad: |
|||
* XCode Tools |
|||
* bzr - Bazaar version control system |
|||
* CMake - Cross-platform make |
|||
|
|||
Optional tools: |
|||
* Doxygen - Documentation system for several programming languages |
|||
|
|||
Mandatory library dependencies needed to compile KiCad: |
|||
* GLEW - The OpenGL Extension Wrangler Library |
|||
* cairo - 2D graphics library |
|||
* wxWidgets - Cross-Platform GUI Library |
|||
|
|||
Optional library dependencies, depends on used KiCad features |
|||
* OpenSSL - The Open Source toolkit for SSL/TLS |
|||
=> Needed for github plugin |
|||
|
|||
All tools (except XCode, of course) and all dependencies except wxWidgets can be compiled |
|||
manually, but it is advised to install them using your favorite package manager for OSX |
|||
like MacPorts or Homebrew. |
|||
Depending on the package manager the development packages of the library dependencies |
|||
may have to be installed (usually something like <pkg>-dev or <pkg>-devel). |
|||
Further, depending on the configuration of your package manager packages might have to |
|||
be compiled with special flags/variants to support the correct architecture. E.g., some |
|||
packages of MacPorts need to have the "+universal" variant set to also include the |
|||
x86_64 variant that might be chosen automatically by KiCad build process. |
|||
|
|||
IMPORTANT: |
|||
At the moment you *must not* use a wxWidgets version installed by any package manager. |
|||
KiCad on OSX needs overlay support and some other fixes, which are not yet contained in |
|||
mainline wxWidgets sources and builds. |
|||
|
|||
Install now the tools and library dependencies as mentioned above. |
|||
|
|||
|
|||
Folder Structure |
|||
---------------- |
|||
|
|||
This documentation will use the following folder structure as an example, but it is not |
|||
mandatory to do it like that: |
|||
KiCad/ |
|||
+-- kicad/ KiCad source folder |
|||
+-- build/ KiCad build folder |
|||
+-- bin/ KiCad binaries folder |
|||
+-- wx-src/ wxWidgets source folder |
|||
+-- wx-build/ wxWidgets build folder |
|||
+-- wx-bin/ wxWidgets binaries folder |
|||
|
|||
|
|||
Get KiCad sources |
|||
----------------- |
|||
|
|||
Create your work root "KiCad" wherever you like and sync KiCad sources to it: |
|||
# mkdir KiCad |
|||
# cd KiCad |
|||
# bzr branch lp:kicad |
|||
|
|||
|
|||
Compiling wxWidgets |
|||
------------------- |
|||
|
|||
Get wxWidgets sources from |
|||
http://www.wxwidgets.org/downloads/ |
|||
and unpack them to the wx-src folder. |
|||
It's recommended to use the latest stable (at the time of this writing 3.0.1) version. |
|||
|
|||
Apply the patches needed for KiCad: |
|||
# cd wx-src |
|||
# patch -p0 ../kicad/patches/wxwidgets-3.0.0_macosx.patch |
|||
# patch -p0 ../kicad/patches/wxwidgets-3.0.0_macosx_bug_15908.patch |
|||
# patch -p0 ../kicad/patches/wxwidgets-3.0.0_macosx_soname.patch |
|||
|
|||
Configure: |
|||
# cd .. |
|||
# mkdir wx-build |
|||
# cd wx-build |
|||
# ../wx-src/configure \ |
|||
--prefix=`pwd`/../wx-bin \ |
|||
--with-opengl \ |
|||
--enable-aui \ |
|||
--enable-utf8 \ |
|||
--enable-html \ |
|||
--enable-stl \ |
|||
--with-libjpeg=builtin \ |
|||
--with-libpng=builtin \ |
|||
--with-regex=builtin \ |
|||
--with-libtiff=builtin \ |
|||
--with-zlib=builtin \ |
|||
--with-expat=builtin \ |
|||
--without-liblzma \ |
|||
--with-macosx-version-min=10.5 \ |
|||
CPPFLAGS="-stdlib=libstdc++” \ |
|||
LDFLAGS="-stdlib=libstdc++” \ |
|||
CC=clang \ |
|||
CXX=clang++ |
|||
|
|||
Build & Install: |
|||
# make |
|||
... will take some time ... |
|||
# make install |
|||
|
|||
If everything went fine you will now have a working wxWidgets installation in the wx-bin |
|||
folder. |
|||
For building KiCad it is sufficient to keep the wx-bin folder. |
|||
The above configuration of wxWidgets is known to work, if you know what you are doing |
|||
you of course can use different settings. |
|||
|
|||
|
|||
Compiling KiCad (without scripting support) |
|||
------------------------------------------- |
|||
|
|||
Change to your working root "KiCad" and create the build folder there: |
|||
# mkdir build |
|||
|
|||
Configure KiCad: |
|||
# cd build |
|||
# cmake ../kicad \ |
|||
-DCMAKE_C_COMPILER=clang \ |
|||
-DCMAKE_CXX_COMPILER=clang++ \ |
|||
-DwxWidgets_CONFIG_EXECUTABLE=../wx-bin/bin/wx-config \ |
|||
-DKICAD_SCRIPTING=OFF \ |
|||
-DKICAD_SCRIPTING_MODULES=OFF \ |
|||
-DKICAD_SCRIPTING_WXPYTHON=OFF \ |
|||
-DCMAKE_INSTALL_PREFIX=../bin \ |
|||
-DCMAKE_BUILD_TYPE=Release |
|||
|
|||
Now KiCad is configured using default features/build-switches without scripting support. |
|||
See Documentation/compiling/build-config.txt for a list of all CMake options available |
|||
when compiling KiCad. |
|||
|
|||
Build & Install: |
|||
# make |
|||
... will take some time ... |
|||
# make install |
|||
|
|||
Again, if everything went fine you will now have KiCad binaries in the "bin" folder. |
|||
KiCad application can be directly run from there to test. |
|||
If everything is OK, you can create a .dmg image of your "bin" folder or just copy/install |
|||
the KiCad binaries and/or support files (like demos or documentation) wherever you want. |
|||
@ -0,0 +1,44 @@ |
|||
Index: configure
|
|||
===================================================================
|
|||
--- configure (revision 77757)
|
|||
+++ configure (working copy)
|
|||
@@ -29176,7 +29176,7 @@
|
|||
*-*-darwin* ) |
|||
install_name_tool=`which ${HOST_PREFIX}install_name_tool` |
|||
if test "$install_name_tool" -a -x "$install_name_tool"; then |
|||
- DYLIB_RPATH_POSTLINK="${HOST_PREFIX}install_name_tool -id \$@ \$@"
|
|||
+ DYLIB_RPATH_POSTLINK=""
|
|||
cat <<EOF >change-install-names |
|||
#!/bin/sh |
|||
libnames=\`cd \${1} ; ls -1 | grep '\.[0-9][0-9]*\.dylib\$'\` |
|||
@@ -29189,7 +29189,7 @@
|
|||
done |
|||
EOF |
|||
chmod +x change-install-names |
|||
- DYLIB_RPATH_INSTALL="\$(wx_top_builddir)/change-install-names \${DESTDIR}\${libdir} \${DESTDIR}\${bindir} \${libdir} \$(wx_top_builddir)/lib"
|
|||
+ DYLIB_RPATH_INSTALL=""
|
|||
fi |
|||
|
|||
HEADER_PAD_OPTION="-headerpad_max_install_names" |
|||
Index: configure.in
|
|||
===================================================================
|
|||
--- configure.in (revision 77757)
|
|||
+++ configure.in (working copy)
|
|||
@@ -3772,7 +3772,7 @@
|
|||
*-*-darwin* ) |
|||
install_name_tool=`which ${HOST_PREFIX}install_name_tool` |
|||
if test "$install_name_tool" -a -x "$install_name_tool"; then |
|||
- DYLIB_RPATH_POSTLINK="${HOST_PREFIX}install_name_tool -id \$@ \$@"
|
|||
+ DYLIB_RPATH_POSTLINK=""
|
|||
cat <<EOF >change-install-names |
|||
#!/bin/sh |
|||
libnames=\`cd \${1} ; ls -1 | grep '\.[[0-9]][[0-9]]*\.dylib\$'\` |
|||
@@ -3785,7 +3785,7 @@
|
|||
done |
|||
EOF |
|||
chmod +x change-install-names |
|||
- DYLIB_RPATH_INSTALL="\$(wx_top_builddir)/change-install-names \${DESTDIR}\${libdir} \${DESTDIR}\${bindir} \${libdir} \$(wx_top_builddir)/lib"
|
|||
+ DYLIB_RPATH_INSTALL=""
|
|||
fi |
|||
|
|||
dnl the HEADER_PAD_OPTION is required by some wx samples to avoid the error: |
|||
Write
Preview
Loading…
Cancel
Save
Reference in new issue