Expand Up
@@ -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;
Expand Down
Expand Up
@@ -77,13 +77,13 @@
< 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 ">
Expand Down
Expand Up
@@ -1021,8 +1021,9 @@ <H3>4.1.3. Setting up the Visual Studio project with CMake</H3>
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
Expand Down
Expand Up
@@ -1746,7 +1747,11 @@ <H2>5.1. Install Developer Tools</H2>
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 -> Preferences -> Downloads and choose command line tools.
</ P >
< P >
< A HREF ="http://clang.llvm.org/ "> http://clang.llvm.org/</ A >
Expand All
@@ -1771,7 +1776,7 @@ <H2>5.1. Install Developer Tools</H2>
< 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 >
Expand All
@@ -1782,18 +1787,20 @@ <H2>5.2. Install Qt4 from disk image</H2>
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 < 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
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.
Expand All
@@ -1809,7 +1816,7 @@ <H2>5.2. Install Qt4 from disk image</H2>
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 >
Expand Down
Expand Up
@@ -1839,7 +1846,7 @@ <H2>5.3. Install CMake for OSX</H2>
(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 >
Expand Down
Expand Up
@@ -1908,10 +1915,10 @@ <H2>5.4. Install development frameworks for QGIS dependencies</H2>
< 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.
Expand All
@@ -1923,13 +1930,13 @@ <H2>5.4. Install development frameworks for QGIS dependencies</H2>
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
Expand All
@@ -1956,7 +1963,7 @@ <H3>5.4.2. Additional dependencies: Expat</H3>
< 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:
Expand Down
Expand Up
@@ -1998,7 +2005,7 @@ <H3>5.4.4. Additional dependencies: Python</H3>
< 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 >
Expand Down
Expand Up
@@ -2078,12 +2085,11 @@ <H3>5.4.5. Additional dependencies: SIP</H3>
</ 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 >
Expand Down
Expand Up
@@ -2142,16 +2148,16 @@ <H3>5.4.6. Additional dependencies: QScintilla2</H3>
</ 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 >
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 >
Expand Down
Expand Up
@@ -2238,7 +2244,7 @@ <H3>5.4.7. Additional dependencies: PyQt</H3>
</ 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.
Expand Down
Expand Up
@@ -2268,6 +2274,7 @@ <H3>5.4.8. Additional dependencies: QScintilla2 Python Module</H3>
< 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
Expand All
@@ -2276,7 +2283,10 @@ <H3>5.4.8. Additional dependencies: QScintilla2 Python Module</H3>
< div class ="code "> < PRE >
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
</ PRE > </ div >
Expand Down
Expand Up
@@ -2330,7 +2340,32 @@ <H3>5.4.9. Additional dependencies: Qwt</H3>
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/ && 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
</ 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 >
Expand Down
Expand Up
@@ -2409,17 +2444,8 @@ <H3>5.4.13. Optional dependencies: OSG & osgEarth</H3>
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 >
Expand All
@@ -2436,6 +2462,48 @@ <H3>5.4.13. Optional dependencies: OSG & osgEarth</H3>
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 >
Expand All
@@ -2446,6 +2514,10 @@ <H3>5.4.13. Optional dependencies: OSG & osgEarth</H3>
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
Expand All
@@ -2458,7 +2530,7 @@ <H3>5.4.13. Optional dependencies: OSG & osgEarth</H3>
< 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:
Expand Down
Expand Up
@@ -3164,5 +3236,5 @@ <H1>9. Authors and Acknowledgments</H1>
</ 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 >