4. Building on Mac OSX using frameworks and cmake or Xcode

4.1. Install Xcode

4.3.2. Additional Dependencies : Expat

4.3.3. Additional Dependencies : Python

4.3.6. Additional Dependencies : Qwt/PyQwt

4.3.7. Additional Dependencies : Bison

4.4. Install CMake for OSX

4.7.1. Configure the CMake build

http://www.qgis.org/wiki/Installation_Guide

* CMake >= 2.4.3

* Flex, Bison

* Qt >= 4.3.0

* Proj >= 4.4.x

* GEOS >= 3.0

* Sqlite3 >= 3.0.0

* GDAL/OGR >= 1.4.x

* for GRASS plugin - GRASS >= 6.0.0

* for georeferencer - GSL >= 1.8

* for postgis support and SPIT plugin - PostgreSQL >= 8.0.x

* for gps plugin - expat >= 1.95

* for mapserver export and PyQGIS - Python >= 2.3 (2.5+ preferred)

* for PyQGIS - SIP >= 4.8, PyQt >= must match Qt version

* for GPS tracking - Qwt >= 5.0

* for gps plugin - gpsbabel

http://qt.nokia.com/downloads

4. Building on Mac OSX using frameworks and cmake or Xcode

==========================================================

The base system here is Mac OS X 10.4 (Tiger) and below. Included are a few notes

for building on Mac OS X 10.5 (Leopard) and 10.6 (Snow Leopard).

4.1. Install Xcode

I recommend to get the latest Xcode dmg from the Apple XDC Web site

(http:/developer.apple.com). The Mac system install disks come with a copy of

Xcode, but it's likely out of date.

Install Xcode after the ~1gb download is complete.

Xcode (in particular if you are using Xcode 2.5 on Tiger):

You need a minimum of Qt-4.3.0. I suggest getting the latest.

as of Qt-4.5.2. Qt 4.6+ is recommended for Cocoa.

If you want debug frameworks, Qt also provides a dmg with these. These are in

Qt 4.4+ note: Starting in Qt 4.4 (?) libQtCLucene was added, and in 4.5

libQtUiTools was added, both in /usr/lib. When using a system SDK (which will

happen in the Xcode build), these libraries will not be found. To fix this problem,

add symlinks to /usr/local:

sudo ln -s /usr/lib/libQtUiTools.a /usr/local/lib/

sudo ln -s /usr/lib/libQtCLucene.dylib /usr/local/lib/

These should then be found automatically on Leopard and above. Earlier systems

may need some help by adding '-L/usr/local/lib' to CMAKE_SHARED_LINKER_FLAGS,

CMAKE_MODULE_LINKER_FLAGS and CMAKE_EXE_LINKER_FLAGS in the cmake build, or

adding '/usr/local/lib' to LIBRARY_SEARCH_PATHS in the Xcode build.

Download William Kyngesburye's excellent GDAL Complete package that includes

PROJ, GEOS, GDAL, SQLite3, and image libraries, as frameworks. There is also

a GSL framework.

William provides an additional installer package for Postgresql (for PostGIS 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:

default system architecture, which is 64-bit, according to instructions for

4.3.2. Additional Dependencies : Expat

======================================

Snow Leopard note: Snow Leopard includes a usable expat, so this step is

not necessary on Snow Leopard.

Get the expat sources:

http://sourceforge.net/project/showfiles.php?group_id=10127

Double-click the source tarball to unpack, then, in Terminal.app, cd to the source folder and:

./configure

make

sudo make install

Leopard note: To compile for 64bit, substitute the standard configure line with:

./configure CFLAGS="-Os -arch x86_64"

4.3.3. Additional Dependencies : Python

=======================================

Leopard and Snow Leopard note: Leopard and Snow Leopard include a usable

Python 2.5 and 2.6, respectively. So there is no need to install Python on

Leopard and Snow Leopard. You can still install Python from python.org if preferred.

Make sure you install at least the latest Python 2.5 from

http://www.python.org/download/

Python 3 is a major change, and may have compatibility issues, so try it at your own risk.

Double-click the source tarball to unpack it, then, in Terminal.app, cd to the source folder

and (this installs by default into the Python framework, and is appropriate only for python.org Python installs):

python configure.py -d /Library/Python/2.5/site-packages -b /usr/local/bin \

-e /usr/local/include -v /usr/local/share/sip

Similar to Leopard, you should install outside the system Python path.

Also, you need to specify the architecture you want (requires at least SIP 4.9),

and make sure to run the versioned python binary (this one responds to the

'arch' command, 'python' does not). If you are using 32-bit Qt (Qt Carbon):

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

-e /usr/local/include -v /usr/local/share/sip --arch=i386

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

-e /usr/local/include -v /usr/local/share/sip --arch=x86_64

Double-click the source tarball to unpack it, then, in Terminal.app, cd to the source folder

and (this installs by default into the Python framework, and is appropriate only for python.org Python installs):

If building on Leopard, using Leopard's bundled Python, PyQt wants to install

in the system path -- this is not a good idea. Use this configure command

instead of the basic configure above:

Similar to Leopard, you should install outside the system Python path.

Also, you need to specify the architecture you want (requires at least PyQt 4.6),

and make sure to run the versioned python binary (this one responds to the

'arch' command, which is important for pyuic4, 'python' does not).

If you are using 32-bit Qt (Qt Carbon):

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

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

4.3.6. Additional Dependencies : Qwt/PyQwt

==========================================

The GPS tracking feature uses Qwt. Some popular 3rd-party plugins use PyQwt.

You can take care of both with the PyQwt source from:

http://pyqwt.sourceforge.net/

Double-click the tarball to unpack it.

Now, first edit qwtconfig.pri in the qwt-5.2 subdir and change some settings so

you don't get a bloated debug static library (too bad they are configurable from

qmake). Scroll down to the 'release/debug mode' block. Edit the last 'CONFIG +='

line, within an 'else' block, and change 'debug' to 'release'. Also uncomment

(remove # prefix) the line 'CONFIG += QwtDll'.

Save and close.

Now, cd into the qwt-5.2 subdir in a Terminal. Type these commands to build and install:

qmake -spec macx-g++

make

sudo make install

The Qwt shared library is now installed in /usr/local/qwt-5.x.x[-svn] (x.x is the

minor.point version, and it may be an SVN version). Remember this for QGIS and PyQwt configuration.

Now for PyQwt. Still in the Terminal:

python configure.py --extra-include-dirs=/usr/local/qwt-5.2.1-svn/include \

--extra-lib-dirs=/usr/local/qwt-5.2.1-svn/lib --extra-libs=qwt

make

sudo make install

Make sure to use the qwt install path from the Qwt build above.

Snow Leopard note

If using Qt Carbon, you need to specify which architectures to build, otherwise

it will default to a combination that does not work (ie x86_64 for a Carbon Qt).

This is not needed for Qt Cocoa. Configure as follows:

python configure.py --extra-cflags="-arch i386" --extra-cxxflags="-arch i386" \

--extra-lflags="-arch i386" --extra-include-dirs=/usr/local/qwt-5.2.1-svn/include \

--extra-lib-dirs=/usr/local/qwt-5.2.1-svn/lib --extra-libs=qwt

4.3.7. Additional Dependencies : Bison

Leopard and Snow Leopard note: Leopard and Snow Leopard include Bison 2.3, so this step can be skipped on Leopard and Snow Leopard.

4.4. Install CMake for OSX

Leopard and Snow Leopard note: Leopard and Snow Leopard (Xcode 3+)

include SVN, so this step can be skipped on Leopard and Snow Leopard.

The [http://sourceforge.net/projects/macsvn/MacSVN] project has a downloadable

directory for working in (or some folder of your choice):

There are 2 different methods to build QGIS: the traditional CMake method,

additional bundling steps, though some optional QGIS features must be explicitly

stated in a user configuration file. The CMake build handles optional features,

4.7.1. Configure the CMake build

build process. OS X uses ${HOME}/Applications as a standard user app folder (it gives it the system app folder icon).

If you have the correct permissions you may want to build

building into a pre-existing ${HOME}/Applications directory ...

cmake -D CMAKE_INSTALL_PREFIX=~/Applications -D CMAKE_BUILD_TYPE=Release ..

cmake -D CMAKE_INSTALL_PREFIX=~/Applications -D CMAKE_BUILD_TYPE=Release \

-D GRASS_INCLUDE_DIR=/Applications/GRASS-6.4.app/Contents/MacOS/include \

-D GRASS_PREFIX=/Applications/GRASS-6.4.app/Contents/MacOS \

..

cmake -D CMAKE_INSTALL_PREFIX=~/Applications -D CMAKE_BUILD_TYPE=Release \

-D GRASS_INCLUDE_DIR=/user/local/grass-6.4.0/include \

-D GRASS_PREFIX=/user/local/grass-6.4.0 \

..

Leopard note: To find the custom install of SIP on Leopard, add

'-D SIP_BINARY_PATH=/usr/local/bin/sip' to the cmake commands above,

before the '..' at the end, ie:

cmake -D CMAKE_INSTALL_PREFIX=~/Applications -D CMAKE_BUILD_TYPE=Release \

-D SIP_BINARY_PATH=/usr/local/bin/sip \

..

Snow Leopard note: To handle the appropriate version of Qt (32-bit or 64-bit), you will need to invoke cmake based on which version of Qt you installed. Also, SIP/PyQt detection will fail for 32bit because Python runs 64bit.

For 32-bit Qt (Carbon) with GRASS-6.4, create a 32bit python script and add arch flags to the configuration:

sudo cat >/usr/local/bin/python32 <<EOF

#!/bin/sh

exec arch -i386 /usr/bin/python2.6 \${1+"\$@"}

EOF

sudo chmod +x /usr/local/bin/python32

cmake -D CMAKE_INSTALL_PREFIX=~/Applications -D CMAKE_BUILD_TYPE=Release \

-D SIP_BINARY_PATH=/usr/local/bin/sip \

-D CMAKE_CXX_FLAGS="-arch i386" -D CMAKE_OSX_ARCHITECTURES=i386 \

-D GRASS_INCLUDE_DIR=/Applications/GRASS-6.4.app/Contents/MacOS/include \

-D GRASS_PREFIX=/Applications/GRASS-6.4.app/Contents/MacOS \

-D PYTHON_EXECUTABLE=/usr/local/bin/python32 \

..

cmake -D CMAKE_INSTALL_PREFIX=~/Applications -D CMAKE_BUILD_TYPE=Release \

-D SIP_BINARY_PATH=/usr/local/bin/sip \

-D CMAKE_CXX_FLAGS="-arch x86_64" -D CMAKE_OSX_ARCHITECTURES=x86_64 \

-D GRASS_INCLUDE_DIR=/Applications/GRASS-6.4.app/Contents/MacOS/include \

-D GRASS_PREFIX=/Applications/GRASS-6.4.app/Contents/MacOS \

..

frameworks, Postgres, GRASS 6.4, the python.org Python 2.5 (for Tiger)

or the system Python (for Leopard and Snow Leopard) and extra dependencies

extra configuration is necessary.

The Qgis application will be found in the 'build/$SDKSYS/Release' folder

in the xcode folder, where $SDKSYS is the system you configured for in your

qgis_user.xcconfig. Copy this to whereever you like.

Run Start>All Programs>CMake-->CMake.

http://qt.nokia.com/downloads

% To generate the mediawiki version of this document:

% txt2tags -t wiki --no-enum-title -o INSTALL.wiki INSTALL.t2t

http://www.qgis.org/wiki/Installation_Guide

* CMake >= 2.4.3

* Flex, Bison

* Qt >= 4.3.0

* Proj >= 4.4.x

* GEOS >= 3.0

* Sqlite3 >= 3.0.0

* GDAL/OGR >= 1.4.x

* for GRASS plugin - GRASS >= 6.0.0

* for georeferencer - GSL >= 1.8

* for postgis support and SPIT plugin - PostgreSQL >= 8.0.x

* for gps plugin - expat >= 1.95

* for mapserver export and PyQGIS - Python >= 2.3 (2.5+ preferred)

* for PyQGIS - SIP >= 4.8, PyQt >= must match Qt version

* for GPS tracking - Qwt >= 5.0

* for gps plugin - gpsbabel