Skip to content
Permalink
Browse files

OS X install updates

  • Loading branch information
kyngchaos committed Apr 1, 2013
1 parent a0e9f89 commit 3d15e679b496d44be73f4053e6bd003a1f6bfa36
Showing with 260 additions and 104 deletions.
  1. +84 −36 INSTALL
  2. +112 −40 doc/INSTALL.html
  3. +64 −28 doc/osx.t2t
120 INSTALL
@@ -1,10 +1,10 @@
Quantum GIS (QGIS)
Building QGIS from source - step by step
Friday January 04, 2013
Monday April 01, 2013


Last Updated: Friday January 04, 2013
Last Change : Friday January 04, 2013
Last Updated: Monday April 01, 2013
Last Change : Saturday December 08, 2012


1. Introduction
@@ -650,8 +650,9 @@ box, browse to the top level QGIS directory.
In the Where to build the binaries: box, browse to the 'build' directory you
created.

Adjust the path to bison and flex so that the shortened C:/Progra~1 is used
rather than C:/Program Files.
If the path to bison and flex contains blanks, you need to use the short name
for the directory (i.e. C:\Program Files should be rewritten to
C:\Progra~n, where n is the number as shown in `dir /x C:\``).

Verify that the 'BINDINGS_GLOBAL_INSTALL' option is not checked, so that python
bindings are placed into the output directory when you run the INSTALL target.
@@ -1225,7 +1226,10 @@ On Lion and Mt. Lion, using Xcode 4.4+, the developer command line tools can be
installed via the Xcode preferences. The tools now appear to require an install
of Xcode, regardless of using a separate DMG installer for just the tools.

Xcode 4.4+ also introduces the clang frontend to the LLVM compiler as default.
Xcode 4.3+ also introduces the clang frontend to the LLVM compiler as default.

Note: In XCODE 4.5 installed from the app store, you need to install the
command line tools from XCode -> Preferences -> Downloads and choose command line tools.

http://clang.llvm.org/

@@ -1243,7 +1247,7 @@ If you have trouble building some of the dependencies listed below with clang
5.2. Install Qt4 from disk image
================================

You need a minimum of Qt-4.4.0. I suggest getting the latest. There is no need
You need a minimum of Qt-4.4.0. I suggest getting the latest (Qt 4, not 5). There is no need
for the full Qt SDK, so save yourself some download time and get the frameworks
only. This is available in the Libraries section of the Qt download page.

@@ -1253,15 +1257,17 @@ support in the Qt Cocoa branch. Appropriate installers are available for both
as of Qt-4.5.2, though they stopped making Carbon packages at Qt 4.7.4.
Qt 4.6+ is recommended for Cocoa.
Starting with Lion, Carbon may not work properly, if at all.
Starting with Qt 4.8, only 64bit Cocoa installers are available.

Mt. Lion note: Any Qt version < 4.8.3 will cause a 'This version of Mac OS X
is unsupported' error when building QGIS.
General note: Support for new system versions in any given Qt version may
not be present and may cause a 'This version of Mac OS X
is unsupported' error when building QGIS. Try the next Qt version.

PPC note: The readymade Qt Cocoa installers don't include PPC support, you'd
have to compile Qt yourself. But, there appear to be issues with Qt Cocoa on
PPC Macs anyways. Qt Carbon is recommended on PPC Macs.

http://qt.nokia.com/downloads
http://qt-project.org/downloads

If you want debug frameworks, Qt also provides a separate download with these.
These are in addition to the non-debug frameworks.
@@ -1273,7 +1279,7 @@ of the download page. Files are in the qt/source (yes, even the binary packages
Once downloaded open the disk image and run the installer. Note you need admin
privileges to install.

Leopard note: Qt includes a couple non-framework libraries in /usr/lib.
Leopard+ note: Qt includes a couple non-framework libraries in /usr/lib.
When using a system SDK these libraries will not be found. To fix this problem,
add symlinks to /usr/local:

@@ -1296,7 +1302,7 @@ Binary installers are available for OS X, but they are not recommended
(2.4 versions install in /usr instead of /usr/local, and 2.6+ versions are a
strange application). Instead, download the source.
NOTE: 2.8.5 is broken for detecting part of Qt. Fixed in 2.8.6.
Double-click the source tarball, then cd to the source folder and:
Double-click the source tarball to unpack it, then cd to the source folder and:

./bootstrap --docdir=/share/doc/CMake --mandir=/share/man
make -j [#cpus]
@@ -1347,9 +1353,9 @@ osgEarth), try bypassing ccache.

Download William Kyngesburye's excellent GDAL Complete package that includes
PROJ, GEOS, GDAL, SQLite3, Spatialite, and image libraries, as frameworks.
There is also a GSL framework.
There are also GSL and FreeType frameworks.

http://www.kyngchaos.com/wiki/software/frameworks
http://www.kyngchaos.com/software/frameworks

Once downloaded, open and install the frameworks.

@@ -1358,11 +1364,11 @@ support). QGIS just needs the libpq client library, so unless you want to
setup the full Postgres + PostGIS server, all you need is the client-only
package. It's available here:

http://www.kyngchaos.com/wiki/software/postgres
http://www.kyngchaos.com/software/postgres

Also available is a GRASS application:

http://www.kyngchaos.com/wiki/software/grass
http://www.kyngchaos.com/software/grass

Old versions of these packages for older systems are available in the
software archive section.
@@ -1387,7 +1393,7 @@ have problems and you are on your own with those.
=====================================

Snow Leopard+ note: Snow Leopard includes a usable expat, so this step is
not necessary on Snow Leopard or Lion.
not necessary on Snow Leopard or above.

Get the expat sources:

@@ -1420,7 +1426,7 @@ source folder and:
======================================

Leopard+ note: Starting with Leopard a usable Python is included
in the system. This Python 2.5, 2.6 and 2.7, respectively for Leo, Snow and Lion.
in the system. This is Python 2.5, 2.6 and 2.7, respectively for Leo, Snow and Lion+.
So there is no need to install Python on Leopard and newer.
You can still install Python from python.org if preferred.

@@ -1475,11 +1481,10 @@ For 64-bit Qt (Qt Cocoa), use this configure line:
python2.6 configure.py -n -d /Library/Python/2.6/site-packages -b /usr/local/bin \
-e /usr/local/include -v /usr/local/share/sip --arch=x86_64 -s MacOSX10.6.sdk

Lion system Python
Lion+ system Python

Similar to Snow Leopard, you should install outside the system Python path.
There is no need for the SDK option (the CLI tools for Lion don't include SDKs)
or arch option:
There is no need for the SDK option or arch option:

python2.7 configure.py -d /Library/Python/2.7/site-packages -b /usr/local/bin \
-e /usr/local/include -v /usr/local/share/sip
@@ -1519,14 +1524,14 @@ Edit QScintilla-gpl-2.x.x/Qt4Qt5/qscintilla.pro in the following manner:
target.path = $$[QT_INSTALL_LIBS] --> target.path = /usr/local/lib
header.path = $$[QT_INSTALL_HEADERS] --> header.path = /usr/local/include

Save the qscintilla.pro file and build the QScintilla2 C++ library:
Save the qscintilla.pro file and build the QScintilla2 C++ library (adjust the install_name_tool command for the version installed):

qmake -spec macx-g++ qscintilla.pro
make -j [#cpus]
sudo make install

sudo install_name_tool -id /usr/local/lib/libqscintilla2.8.dylib \
/usr/local/lib/libqscintilla2.8.dylib
sudo install_name_tool -id /usr/local/lib/libqscintilla2.9.dylib \
/usr/local/lib/libqscintilla2.9.dylib

This installs QScintilla2's dylib in /usr/local/lib/ and the header files in
/usr/local/include/Qsci/, both of which should be automatically found when
@@ -1585,7 +1590,7 @@ For 64-bit Qt (Qt Cocoa), use this configure line:

python2.6 configure.py -d /Library/Python/2.6/site-packages -b /usr/local/bin --use-arch x86_64

Lion system Python
Lion and Mt. Lion system Python

Similar to Snow Leopard, you should install outside the system Python path.
But you don't need the arch option:
@@ -1606,12 +1611,16 @@ Then make again.
=========================================================

This will create the Qsci.so module in /Library/Python/2.x/site-packages/PyQt4.
Like PyQt, it needs help to not install in system locations.

Snow Leopard: substitute '2.6' for Python version

cd <QScintilla2 source dir>
cd Python
python2.7 configure.py -o /usr/local/lib -n /usr/local/include
python2.7 configure.py -o /usr/local/lib -n /usr/local/include \
-d /Library/Python/2.7/site-packages/PyQt4 -v /usr/local/share/sip/PyQt4 \
--pyqt-sipdir=/usr/local/share/sip/PyQt4
qmake -spec macx-g++ Qsci.pro
make -j [#cpus]
sudo make install

@@ -1651,7 +1660,26 @@ Qwt 6.x.x is similarly built, but defaults to being installed as a framework:
qmake -spec macx-g++
make -j [#cpus]
sudo make install


TODO: Remedy for :

shrub:qwt-6.1-rc3 timlinux$ sudo make install
Password:
cd src/ && make -f Makefile install
rm -f -r "/usr/local/qwt-6.1.0-rc3/lib/qwt.framework"
cp -f -R "../lib/qwt.framework" "/usr/local/qwt-6.1.0-rc3/lib/qwt.framework"
cp -f -R /Users/timlinux/dev/cpp/qwt-6.1-rc3/doc/html /usr/local/qwt-6.1.0-rc3/doc/
cp -f -R /Users/timlinux/dev/cpp/qwt-6.1-rc3/doc/man /usr/local/qwt-6.1.0-rc3/doc/
cd textengines/ && make -f Makefile install
make[1]: Nothing to be done for `install'.
cd designer/ && make -f Makefile install
rm -f libqwt_designer_plugin.dylib
linking plugins/designer/libqwt_designer_plugin.dylib
ld: library not found for -lqwt
collect2: ld returned 1 exit status
make[1]: *** [plugins/designer/libqwt_designer_plugin.dylib] Error 1
make: *** [sub-designer-install_subtargets-ordered] Error 2

sudo install_name_tool -id /usr/local/qwt-6.0.1/lib/qwt.framework/Versions/6/qwt \
/usr/local/qwt-6.0.1/lib/qwt.framework/Versions/6/qwt

@@ -1713,14 +1741,8 @@ tarball to unpack it, then cd to the source folder and:

If you want the Globe plugin in QGIS (default OFF), OSG and osgEarth are needed.

First, OpenSceneGraph. The main site is:

http://www.openscenegraph.org/

Get the tarball (or zip) for the the latest 3.x version.
Binary availability is unknown at this time as the site is down.

Another place to get the source is github:
First, OpenSceneGraph. The main site is very out of date, just go to
github:

http://github.com/openscenegraph/osg/tags

@@ -1734,13 +1756,39 @@ temporary location first. You could stage it to the folder that the OSG source
folder is in, or a common staging area like /Users/Shared/unix/osg. Pick a
folder not hidden and that doesn't need admin permissions to write to for simplicity.

If you are building on Leopard, its configure forces a old ppc/i386 32bit build.
If you want 64bit you need to fix CMakeLists.txt - in a text editor, find the
if-block that starts with:

ELSEIF(${OSG_OSX_SDK_NAME} STREQUAL "macosx10.6" OR ${OSG_OSX_SDK_NAME} STREQUAL "macosx10.5")

In that section before the next ELSEIF, change:

ppc;i386

to:

i386;x86_64

and change:

mmacosx-version-min=10.5

to:

mmacosx-version-min=10.6

In a new Terminal cd to the source folder and:

mkdir build
cd build
cmake -D CMAKE_INSTALL_PREFIX=/path/to/some/staging/folder \
-D OSG_COMPILE_FRAMEWORKS=ON \
-D OSG_PLUGIN_SEARCH_INSTALL_DIR_FOR_PLUGINS=OFF \
-D JASPER_LIBRARY=/Library/Frameworks/UnixImageIO.framework \
-D JASPER_INCLUDE_DIR=/Library/Frameworks/UnixImageIO.framework/Headers \
-D TIFF_LIBRARY=/Library/Frameworks/UnixImageIO.framework \
-D TIFF_INCLUDE_DIR=/Library/Frameworks/UnixImageIO.framework/Headers \
..
make
make install
@@ -1750,7 +1798,7 @@ Enter the staging path you chose for the CMAKE_INSTALL_PREFIX option above.

Now move all .frameworks from the lib/ folder in the staging area to /Library/Frameworks. Move the files in the osgPlugins folder in the lib/ folder
to /Library/Application Support/OpenSceneGraph/PlugIns. The bin/ executables
can be left where they are, we don't need them.
can be left where they are.

Next up is libzip. Get the latest tarball at:

0 comments on commit 3d15e67

Please sign in to comment.
You can’t perform that action at this time.