From c8441bcbb20597a461b0c3b5a749a365aa214759 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tudor=20B=C4=83r=C4=83scu?= Date: Fri, 30 Dec 2016 09:52:46 +0200 Subject: [PATCH] document building with ninja + non interactive options --- INSTALL | 55 ++++++++++++++++++++++++------- doc/INSTALL.html | 84 +++++++++++++++++++++++++++++++++++++++--------- doc/linux.t2t | 31 ++++++++++++++++-- 3 files changed, 141 insertions(+), 29 deletions(-) diff --git a/INSTALL b/INSTALL index ab3aa6762cf..8c5a61af59a 100644 --- a/INSTALL +++ b/INSTALL @@ -1,10 +1,10 @@ QGIS Building QGIS from source - step by step -Monday November 07, 2016 +Wednesday January 04, 2017 -Last Updated: Monday November 07, 2016 -Last Change : Monday November 07, 2016 +Last Updated: Wednesday January 04, 2017 +Last Change : Tuesday December 27, 2016 1. Introduction @@ -100,14 +100,17 @@ Required build tools: Required build dependencies: -- Qt >= 4.8.0 +- Qt >= 5.3.0 - Proj >= 4.4.x - GEOS >= 3.4 - Sqlite3 >= 3.0.0 -- GDAL/OGR >= 1.4.x +- SpatiaLite +- libspatialindex +- GDAL/OGR >= 2.0 - Qwt >= 5.0 & (< 6.1 with internal QwtPolar) - expat >= 1.95 - QScintilla2 +- QCA Optional dependencies: @@ -118,8 +121,8 @@ Optional dependencies: - for georeferencer - GSL >= 1.8 - for postgis support and SPIT plugin - PostgreSQL >= 8.0.x - for gps plugin - gpsbabel -- for mapserver export and PyQGIS - Python >= 2.3 (2.5+ preferred) -- for python support - SIP >= 4.12, PyQt >= 4.8.3 must match Qt version, Qscintilla2 +- for mapserver export and PyQGIS - Python >= 3.3 +- for python support - SIP >= 4.12, PyQt >= 5.3 must match Qt version, Qscintilla2 - for qgis mapserver - FastCGI - for oracle provider - Oracle OCI library @@ -262,27 +265,55 @@ interactive dialog. Now on with the build: - make - make install + make -jX -It may take a little while to build depending on your platform. +where X is the number of available cores. Depending on your platform, +this can speed up the build time considerably. + +Then you can directly run from the build directory: + + ./output/bin/qgis + +Another option is to install to your system: + + make install After that you can try to run QGIS: $HOME/apps/bin/qgis If all has worked properly the QGIS application should start up and appear -on your screen. If you get the error message "error while loading shared libraries", +on your screen. If you get the error message "error while loading shared libraries", execute this command in your shell. export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${HOME}/apps/lib/ +Optionally, if you already know what aspects you want in your custom build +then you can skip the interactive ccmake .. part by using the cmake -D +option for each aspect, e.g.: + + cmake -D CMAKE_BUILD_TYPE=Debug -D CMAKE_INSTALL_PREFIX=${HOME}/apps .. + +Also, if you want to speed your build times, you can easily do it with ninja, +an alternative to make with similar build options. + +For example, to configure your build you can do either one of: + + ccmake -G Ninja .. + + cmake -G Ninja -D CMAKE_BUILD_TYPE=Debug -D CMAKE_INSTALL_PREFIX=${HOME}/apps .. + +Build and install with ninja: + + ninja (uses all cores by default; also supports the above described -jX option) + ninja install + 3.8. Building Debian packages ============================= Instead of creating a personal installation as in the previous step you can -also create debian package. This is done from the QGIS root directory, where +also create debian package. This is done from the QGIS root directory, where you'll find a debian directory. First you need to install the debian packaging tools once: diff --git a/doc/INSTALL.html b/doc/INSTALL.html index 235339c6302..6fd2ac9a142 100644 --- a/doc/INSTALL.html +++ b/doc/INSTALL.html @@ -5,7 +5,7 @@ QGIS - +