sharpetronics/QGIS
1
0
Fork 0
mirror of https://github.com/qgis/QGIS.git synced 2025-04-13 00:03:09 -04:00
Code Issues Packages Projects Releases Wiki Activity

OS X install updates

Browse Source
This commit is contained in:
William Kyngesburye 2013-04-01 18:39:08 -05:00
parent a0e9f89854
commit 3d15e679b4
3 changed files with 260 additions and 104 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

120
INSTALL
View File

@ -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,6 +1756,28 @@ 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
@ -1741,6 +1785,10 @@ In a new Terminal cd to the source folder and:
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:

152
doc/INSTALL.html
View File

@ -5,7 +5,7 @@
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>Quantum GIS (QGIS)</TITLE>
<!-- Included /home/fischer/src/qgis/doc/style.css -->
<!-- Included style.css -->
<STYLE TYPE="text/css">
body{ background: white;
color: black;
@ -77,13 +77,13 @@ label{ background-color: #FFFFCC;
<DIV CLASS="header" ID="header">
<H1>Quantum GIS (QGIS)</H1>
<H2>Building QGIS from source - step by step</H2>
<H3>Friday January 04, 2013</H3>
<H3>Monday April 01, 2013</H3>
</DIV>
<DIV CLASS="body" ID="body">
<P>
Last Updated: Friday January 04, 2013
Last Change : Friday January 04, 2013
Last Updated: Monday April 01, 2013
Last Change : Saturday December 08, 2012
</P>
<DIV CLASS="toc">
@ -1021,8 +1021,9 @@ In the <I>Where to build the binaries:</I> box, browse to the 'build' directory
created.
</P>
<P>
Adjust the path to bison and flex so that the shortened <CODE>C:/Progra~1</CODE> is used
rather than <CODE>C:/Program Files</CODE>.
If the path to bison and flex contains blanks, you need to use the short name
for the directory (i.e. <CODE>C:\Program Files</CODE> should be rewritten to
<CODE>C:\Progra~n</CODE>, where <CODE>n</CODE> is the number as shown in `dir /x C:\``).
</P>
<P>
Verify that the 'BINDINGS_GLOBAL_INSTALL' option is not checked, so that python
@ -1746,7 +1747,11 @@ 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.
</P>
<P>
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.
</P>
<P>
<B>Note:</B> In XCODE 4.5 installed from the app store, you need to install the
command line tools from XCode -&gt; Preferences -&gt; Downloads and choose command line tools.
</P>
<P>
<A HREF="http://clang.llvm.org/">http://clang.llvm.org/</A>
@ -1771,7 +1776,7 @@ If you have trouble building some of the dependencies listed below with clang
<H2>5.2. Install Qt4 from disk image</H2>
<P>
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.
</P>
@ -1782,10 +1787,12 @@ 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.
</P>
<P>
<U>Mt. Lion note:</U> Any Qt version &lt; 4.8.3 will cause a 'This version of Mac OS X
is unsupported' error when building QGIS.
<U>General note:</U> 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.
</P>
<P>
<U>PPC note:</U> The readymade Qt Cocoa installers don't include PPC support, you'd
@ -1793,7 +1800,7 @@ 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.
</P>
<P>
<A HREF="http://qt.nokia.com/downloads">http://qt.nokia.com/downloads</A>
<A HREF="http://qt-project.org/downloads">http://qt-project.org/downloads</A>
</P>
<P>
If you want debug frameworks, Qt also provides a separate download with these.
@ -1809,7 +1816,7 @@ Once downloaded open the disk image and run the installer. Note you need admin
privileges to install.
</P>
<P>
<U>Leopard note:</U> Qt includes a couple non-framework libraries in /usr/lib.
<U>Leopard+ note:</U> 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:
</P>
@ -1839,7 +1846,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:
</P>
<div class="code"><PRE>
@ -1908,10 +1915,10 @@ osgEarth), try bypassing ccache.
<P>
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.
</P>
<P>
<A HREF="http://www.kyngchaos.com/wiki/software/frameworks">http://www.kyngchaos.com/wiki/software/frameworks</A>
<A HREF="http://www.kyngchaos.com/software/frameworks">http://www.kyngchaos.com/software/frameworks</A>
</P>
<P>
Once downloaded, open and install the frameworks.
@ -1923,13 +1930,13 @@ setup the full Postgres + PostGIS server, all you need is the client-only
package. It's available here:
</P>
<P>
<A HREF="http://www.kyngchaos.com/wiki/software/postgres">http://www.kyngchaos.com/wiki/software/postgres</A>
<A HREF="http://www.kyngchaos.com/software/postgres">http://www.kyngchaos.com/software/postgres</A>
</P>
<P>
Also available is a GRASS application:
</P>
<P>
<A HREF="http://www.kyngchaos.com/wiki/software/grass">http://www.kyngchaos.com/wiki/software/grass</A>
<A HREF="http://www.kyngchaos.com/software/grass">http://www.kyngchaos.com/software/grass</A>
</P>
<P>
Old versions of these packages for older systems are available in the
@ -1956,7 +1963,7 @@ have problems and you are on your own with those.
<P>
<U>Snow Leopard+ note:</U> Snow Leopard includes a usable expat, so this step is
not necessary on Snow Leopard or Lion.
not necessary on Snow Leopard or above.
</P>
<P>
Get the expat sources:
@ -1998,7 +2005,7 @@ sudo make install
<P>
<U>Leopard+ note:</U> 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.
</P>
@ -2078,12 +2085,11 @@ python2.6 configure.py -n -d /Library/Python/2.6/site-packages -b /usr/local/bin
</PRE></div>
<P>
<U>Lion system Python</U>
<U>Lion+ system Python</U>
</P>
<P>
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:
</P>
<div class="code"><PRE>
@ -2142,7 +2148,7 @@ header.path = $$[QT_INSTALL_HEADERS] --&gt; header.path = /usr/local/include
</PRE></div>
<P>
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):
</P>
<div class="code"><PRE>
@ -2150,8 +2156,8 @@ 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
</PRE></div>
<P>
@ -2238,7 +2244,7 @@ python2.6 configure.py -d /Library/Python/2.6/site-packages -b /usr/local/bin --
</PRE></div>
<P>
<U>Lion system Python</U>
<U>Lion and Mt. Lion system Python</U>
</P>
<P>
Similar to Snow Leopard, you should install outside the system Python path.
@ -2268,6 +2274,7 @@ Then make again.
<P>
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.
</P>
<P>
<U>Snow Leopard:</U> substitute '2.6' for Python version
@ -2276,7 +2283,10 @@ This will create the Qsci.so module in /Library/Python/2.x/site-packages/PyQt4.
<div class="code"><PRE>
cd &lt;QScintilla2 source dir&gt;
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
</PRE></div>
@ -2330,7 +2340,32 @@ cd &lt;Qwt 6.x.x source directory&gt;
qmake -spec macx-g++
make -j [#cpus]
sudo make install
</PRE></div>
<P>
<B>TODO:</B> Remedy for :
</P>
<div class="code"><PRE>
shrub:qwt-6.1-rc3 timlinux$ sudo make install
Password:
cd src/ &amp;&amp; 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/ &amp;&amp; make -f Makefile install
make[1]: Nothing to be done for `install'.
cd designer/ &amp;&amp; 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
</PRE></div>
<div class="code"><PRE>
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
</PRE></div>
@ -2409,17 +2444,8 @@ sudo make install
If you want the Globe plugin in QGIS (default OFF), OSG and osgEarth are needed.
</P>
<P>
First, <B>OpenSceneGraph</B>. The main site is:
</P>
<P>
<A HREF="http://www.openscenegraph.org/">http://www.openscenegraph.org/</A>
</P>
<P>
Get the tarball (or zip) for the the latest 3.x version.
Binary availability is unknown at this time as the site is down.
</P>
<P>
Another place to get the source is github:
First, <B>OpenSceneGraph</B>. The main site is very out of date, just go to
github:
</P>
<P>
<A HREF="http://github.com/openscenegraph/osg/tags">http://github.com/openscenegraph/osg/tags</A>
@ -2436,6 +2462,48 @@ 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.
</P>
<P>
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:
</P>
<div class="code"><PRE>
ELSEIF(${OSG_OSX_SDK_NAME} STREQUAL "macosx10.6" OR ${OSG_OSX_SDK_NAME} STREQUAL "macosx10.5")
</PRE></div>
<P>
In that section before the next ELSEIF, change:
</P>
<div class="code"><PRE>
ppc;i386
</PRE></div>
<P>
to:
</P>
<div class="code"><PRE>
i386;x86_64
</PRE></div>
<P>
and change:
</P>
<div class="code"><PRE>
mmacosx-version-min=10.5
</PRE></div>
<P>
to:
</P>
<div class="code"><PRE>
mmacosx-version-min=10.6
</PRE></div>
<P>
In a new Terminal cd to the source folder and:
</P>
@ -2446,6 +2514,10 @@ 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
@ -2458,7 +2530,7 @@ Enter the staging path you chose for the CMAKE_INSTALL_PREFIX option above.
<P>
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.
</P>
<P>
Next up is <B>libzip</B>. Get the latest tarball at:
@ -3164,5 +3236,5 @@ The following people have contributed to this document:
</DIV>
<!-- html code generated by txt2tags 2.6 (http://txt2tags.org) -->
<!-- cmdline: txt2tags -odoc/INSTALL.html -t html doc/INSTALL.t2t -->
<!-- cmdline: txt2tags -t html -o INSTALL.html INSTALL.t2t -->
</BODY></HTML>

92
doc/osx.t2t
View File

@ -1,3 +1,4 @@
= Building on MacOS X =
In this approach I will try to avoid as much as possible building dependencies
@ -74,7 +75,7 @@ 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.
@ -95,7 +96,7 @@ If you have trouble building some of the dependencies listed below with clang
== 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.
@ -105,9 +106,11 @@ 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
@ -125,7 +128,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:
@ -149,7 +152,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
@ -204,9 +207,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.
@ -215,11 +218,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.
@ -240,7 +243,7 @@ have problems and you are on your own with those.
=== Additional dependencies: Expat ===
__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:
@ -273,7 +276,7 @@ sudo make install
=== Additional dependencies: Python ===
__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.
@ -334,11 +337,10 @@ 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 \
@ -383,15 +385,15 @@ current line --> new line
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
@ -479,13 +481,17 @@ Then make again.
=== Additional dependencies: QScintilla2 Python Module ===
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
```
@ -615,14 +621,8 @@ sudo make install
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
@ -636,6 +636,38 @@ 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:
```
@ -644,6 +676,10 @@ 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
@ -654,7 +690,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: