QGIS 3 is only qt5 compliant

Remove qt4 mention (for linux based processes)
This commit is contained in:
Harrissou Sant-anna 2017-01-18 15:26:47 +01:00 committed by Matthias Kuhn
parent f7644b4708
commit aef2b00b7e
3 changed files with 86 additions and 209 deletions

70
INSTALL
View File

@ -1,16 +1,16 @@
QGIS
Building QGIS from source - step by step
Monday January 09, 2017
Wednesday January 25, 2017
Last Updated: Monday January 09, 2017
Last Change : Monday January 09, 2017
Last Updated: Wednesday January 25, 2017
Last Change : Friday January 20, 2017
1. Introduction
2. Overview
3. Building on GNU/Linux
3.1. Building QGIS with Qt 4.x
3.1. Building QGIS with Qt 5.x
3.2. Prepare apt
3.3. Install build dependencies
3.4. Setup ccache (Optional)
@ -18,9 +18,7 @@ Last Change : Monday January 09, 2017
3.6. Check out the QGIS Source Code
3.7. Starting the compile
3.8. Building Debian packages
3.9. Building QGIS with Qt 5.x
3.10. On Debian Linux
3.11. On Fedora Linux
3.9. On Fedora Linux
4. Building on Windows
4.1. Building with Microsoft Visual Studio
4.2. Building using MinGW
@ -139,13 +137,13 @@ those formats in GDAL.
========================
3.1. Building QGIS with Qt 4.x
3.1. Building QGIS with Qt 5.x
==============================
Requires: Ubuntu / Debian derived distro
/!\ Note: Refer to the section Building Debian packages for building
debian packages. Unless you plan to develop on QGIS, that is probably the
debian packages. Unless you plan to develop on QGIS, that is probably the
easiest option to compile and install QGIS.
These notes are for Ubuntu - other versions and Debian derived distros may
@ -263,6 +261,11 @@ be pressed several times before the 'g' option becomes available.
After the 'g' generation is complete, press 'q' to exit the ccmake
interactive dialog.
/!\ Warning: Make sure that your build directory is completely empty when you
enter the command. Do never try to "re-use" an existing Qt4 build directory.
If you want to use `ccmake` or other interactive tools, run the command in
the empty build directory once before starting to use the interactive tools.
Now on with the build:
make -jX
@ -349,56 +352,15 @@ Install them using dpkg. E.g.:
sudo debi
3.9. Building QGIS with Qt 5.x
==============================
/!\ Warning: Qt 5 is not officially supported. Building against Qt 5
libraries seems to work quite well already but be prepared that you are one
of very few with this setup. We strongly recommend using QGIS with Qt 4 for
production work.
Python bindings in particular are not expected to be compatible. When Qt 5
is enabled, the build system automatically activates Python 3 and PyQt5 as well.
There are no plugins and not even the python code shipped along the QGIS source
code is compatible with PyQt5.
You have been warned.
3.10. On Debian Linux
=====================
We assume that you have the source code of QGIS ready and created a new
subdirectory called `build` or `build-qt5` in it.
3.10.1. Install build dependencies
==================================
apt-get install git build-essential cmake flex bison pyqt5-dev qttools5-dev qtpositioning5-dev libqt5svg5-dev libqt5webkit5-dev libqt5gui5 libqt5scripttools5 qtscript5-dev libqca-qt5-2-dev grass-dev libgeos-dev libgdal-dev libqt5xmlpatterns5-dev libqt5scintilla2-dev pyqt5.qsci-dev python3-pyqt5.qsci libgsl-dev txt2tags libproj-dev libqwt-qt5-dev libspatialindex-dev pyqt5-dev-tools qttools5-dev-tools qt5-default python3-future python3-pyqt5.qtsql python3-psycopg2 python3-sip-dev
Make sure that your build directory is completely empty when you enter the
following command. Do never try to "re-use" an existing Qt4 build directory.
If you want to use `ccmake` or other interactive tools, run the following
command in the empty build directory once before starting to use the
interactive tools.
cmake
If everything went ok you can finally start to compile. (As usual append a -jX where X is the number of available cores option to make to speed up your build process)
make
3.11. On Fedora Linux
=====================
3.9. On Fedora Linux
====================
We assume that you have the source code of QGIS ready and created a
new subdirectory called `build` or `build-qt5` in it.
3.11.1. Install build dependencies
==================================
3.9.1. Install build dependencies
=================================
dnf install qt5-qtwebkit-devel qt5-qtlocation-devel qt5-qttools-static
qt5-qtscript-devel qca-qt5-devel python3-qt5-devel python3-qscintilla-qt5-devel

View File

@ -5,7 +5,7 @@
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8">
<TITLE>QGIS</TITLE>
<!-- Included /home/fischer/src/qgis3/doc/style.css -->
<!-- Included doc/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>QGIS</H1>
<H2>Building QGIS from source - step by step</H2>
<H3>Monday January 09, 2017</H3>
<H3>Wednesday January 25, 2017</H3>
</DIV>
<DIV CLASS="body" ID="body">
<P>
Last Updated: Monday January 09, 2017
Last Change : Monday January 09, 2017
Last Updated: Wednesday January 25, 2017
Last Change : Friday January 20, 2017
</P>
<DIV CLASS="toc">
@ -92,7 +92,7 @@ Last Change : Monday January 09, 2017
<LI><A HREF="#toc2">Overview</A>
<LI><A HREF="#toc3">Building on GNU/Linux</A>
<UL>
<LI><A HREF="#toc4">3.1. Building QGIS with Qt 4.x</A>
<LI><A HREF="#toc4">3.1. Building QGIS with Qt 5.x</A>
<LI><A HREF="#toc5">3.2. Prepare apt</A>
<LI><A HREF="#toc6">3.3. Install build dependencies</A>
<LI><A HREF="#toc7">3.4. Setup ccache (Optional)</A>
@ -100,39 +100,37 @@ Last Change : Monday January 09, 2017
<LI><A HREF="#toc9">3.6. Check out the QGIS Source Code</A>
<LI><A HREF="#toc10">3.7. Starting the compile</A>
<LI><A HREF="#toc11">3.8. Building Debian packages</A>
<LI><A HREF="#toc12">3.9. Building QGIS with Qt 5.x</A>
<LI><A HREF="#toc13">3.10. On Debian Linux</A>
<LI><A HREF="#toc14">3.11. On Fedora Linux</A>
<LI><A HREF="#toc12">3.9. On Fedora Linux</A>
</UL>
<LI><A HREF="#toc15">Building on Windows</A>
<LI><A HREF="#toc13">Building on Windows</A>
<UL>
<LI><A HREF="#toc16">4.1. Building with Microsoft Visual Studio</A>
<LI><A HREF="#toc17">4.2. Building using MinGW</A>
<LI><A HREF="#toc18">4.3. Creation of MSYS environment for compilation of QGIS</A>
<LI><A HREF="#toc14">4.1. Building with Microsoft Visual Studio</A>
<LI><A HREF="#toc15">4.2. Building using MinGW</A>
<LI><A HREF="#toc16">4.3. Creation of MSYS environment for compilation of QGIS</A>
</UL>
<LI><A HREF="#toc19">Building on MacOS X</A>
<LI><A HREF="#toc17">Building on MacOS X</A>
<UL>
<LI><A HREF="#toc20">5.1. Install Developer Tools</A>
<LI><A HREF="#toc21">5.2. Install Qt4 from disk image</A>
<LI><A HREF="#toc22">5.3. Install CMake for OSX</A>
<LI><A HREF="#toc23">5.4. Install development frameworks for QGIS dependencies</A>
<LI><A HREF="#toc24">5.5. API documentation</A>
<LI><A HREF="#toc25">5.6. QGIS source</A>
<LI><A HREF="#toc26">5.7. Configure the build</A>
<LI><A HREF="#toc27">5.8. Building</A>
<LI><A HREF="#toc28">5.9. Post-Install</A>
<LI><A HREF="#toc18">5.1. Install Developer Tools</A>
<LI><A HREF="#toc19">5.2. Install Qt4 from disk image</A>
<LI><A HREF="#toc20">5.3. Install CMake for OSX</A>
<LI><A HREF="#toc21">5.4. Install development frameworks for QGIS dependencies</A>
<LI><A HREF="#toc22">5.5. API documentation</A>
<LI><A HREF="#toc23">5.6. QGIS source</A>
<LI><A HREF="#toc24">5.7. Configure the build</A>
<LI><A HREF="#toc25">5.8. Building</A>
<LI><A HREF="#toc26">5.9. Post-Install</A>
</UL>
<LI><A HREF="#toc29">Setting up the WCS test server on GNU/Linux</A>
<LI><A HREF="#toc27">Setting up the WCS test server on GNU/Linux</A>
<UL>
<LI><A HREF="#toc30">6.1. Preparation</A>
<LI><A HREF="#toc31">6.2. Setup mapserver</A>
<LI><A HREF="#toc32">6.3. Create a home page</A>
<LI><A HREF="#toc33">6.4. Now deploy it</A>
<LI><A HREF="#toc34">6.5. Debugging</A>
<LI><A HREF="#toc28">6.1. Preparation</A>
<LI><A HREF="#toc29">6.2. Setup mapserver</A>
<LI><A HREF="#toc30">6.3. Create a home page</A>
<LI><A HREF="#toc31">6.4. Now deploy it</A>
<LI><A HREF="#toc32">6.5. Debugging</A>
</UL>
<LI><A HREF="#toc35">Setting up a Jenkins Build Server</A>
<LI><A HREF="#toc36">Debug output and running tests</A>
<LI><A HREF="#toc37">Authors and Acknowledgments</A>
<LI><A HREF="#toc33">Setting up a Jenkins Build Server</A>
<LI><A HREF="#toc34">Debug output and running tests</A>
<LI><A HREF="#toc35">Authors and Acknowledgments</A>
</OL>
</DIV>
@ -253,14 +251,14 @@ those formats in GDAL.
<H1>3. Building on GNU/Linux</H1>
<A NAME="toc4"></A>
<H2>3.1. Building QGIS with Qt 4.x</H2>
<H2>3.1. Building QGIS with Qt 5.x</H2>
<P>
<B>Requires:</B> Ubuntu / Debian derived distro
</P>
<P>
/!\ <B>Note:</B> Refer to the section Building Debian packages for building
debian packages. Unless you plan to develop on QGIS, that is probably the
debian packages. Unless you plan to develop on QGIS, that is probably the
easiest option to compile and install QGIS.
</P>
<P>
@ -433,6 +431,12 @@ After the 'g' generation is complete, press 'q' to exit the ccmake
interactive dialog.
</P>
<P>
/!\ <B>Warning:</B> Make sure that your build directory is completely empty when you
enter the command. Do never try to "re-use" an existing <B>Qt4</B> build directory.
If you want to use `ccmake` or other interactive tools, run the command in
the empty build directory once before starting to use the interactive tools.
</P>
<P>
Now on with the build:
</P>
@ -574,67 +578,14 @@ sudo debi
</PRE></div>
<A NAME="toc12"></A>
<H2>3.9. Building QGIS with Qt 5.x</H2>
<P>
/!\ <B>Warning:</B> Qt 5 is not officially supported. Building against Qt 5
libraries seems to work quite well already but be prepared that you are one
of very few with this setup. We strongly recommend using QGIS with Qt 4 for
production work.
</P>
<P>
Python bindings in particular are not expected to be compatible. When Qt 5
is enabled, the build system automatically activates Python 3 and PyQt5 as well.
There are no plugins and not even the python code shipped along the QGIS source
code is compatible with PyQt5.
</P>
<P>
You have been warned.
</P>
<A NAME="toc13"></A>
<H2>3.10. On Debian Linux</H2>
<P>
We assume that you have the source code of QGIS ready and created a new
subdirectory called `build` or `build-qt5` in it.
</P>
<H3>3.10.1. Install build dependencies</H3>
<div class="code"><PRE>
apt-get install git build-essential cmake flex bison pyqt5-dev qttools5-dev qtpositioning5-dev libqt5svg5-dev libqt5webkit5-dev libqt5gui5 libqt5scripttools5 qtscript5-dev libqca-qt5-2-dev grass-dev libgeos-dev libgdal-dev libqt5xmlpatterns5-dev libqt5scintilla2-dev pyqt5.qsci-dev python3-pyqt5.qsci libgsl-dev txt2tags libproj-dev libqwt-qt5-dev libspatialindex-dev pyqt5-dev-tools qttools5-dev-tools qt5-default python3-future python3-pyqt5.qtsql python3-psycopg2 python3-sip-dev
</PRE></div>
<P>
Make sure that your build directory is completely empty when you enter the
following command. Do never try to "re-use" an existing Qt4 build directory.
If you want to use `ccmake` or other interactive tools, run the following
command in the empty build directory once before starting to use the
interactive tools.
</P>
<div class="code"><PRE>
cmake
</PRE></div>
<P>
If everything went ok you can finally start to compile. (As usual append a -jX where X is the number of available cores option to make to speed up your build process)
</P>
<div class="code"><PRE>
make
</PRE></div>
<A NAME="toc14"></A>
<H2>3.11. On Fedora Linux</H2>
<H2>3.9. On Fedora Linux</H2>
<P>
We assume that you have the source code of QGIS ready and created a
new subdirectory called `build` or `build-qt5` in it.
</P>
<H3>3.11.1. Install build dependencies</H3>
<H3>3.9.1. Install build dependencies</H3>
<div class="code"><PRE>
dnf install qt5-qtwebkit-devel qt5-qtlocation-devel qt5-qttools-static
@ -692,10 +643,10 @@ Or install to your system
make install
</PRE></div>
<A NAME="toc15"></A>
<A NAME="toc13"></A>
<H1>4. Building on Windows</H1>
<A NAME="toc16"></A>
<A NAME="toc14"></A>
<H2>4.1. Building with Microsoft Visual Studio</H2>
<P>
@ -953,7 +904,7 @@ look at:
<I>ms-windows/osgeo4w/package.cmd</I>
</P>
<A NAME="toc17"></A>
<A NAME="toc15"></A>
<H2>4.2. Building using MinGW</H2>
<P>
@ -1222,7 +1173,7 @@ tree. Read the READMEfile there and follow the instructions. Next right click
on qgis.nsi and choose the option 'Compile NSIS Script'.
</P>
<A NAME="toc18"></A>
<A NAME="toc16"></A>
<H2>4.3. Creation of MSYS environment for compilation of QGIS</H2>
<H3>4.3.1. Initial setup</H3>
@ -1479,7 +1430,7 @@ We're done with preparation of MSYS environment. Now you can delete all stuff in
of space and it's not necessary at all.
</P>
<A NAME="toc19"></A>
<A NAME="toc17"></A>
<H1>5. Building on MacOS X</H1>
<P>
@ -1546,7 +1497,7 @@ so it's just 'make', or using a smaller number. Sometimes make can hiccup on to
many threads.
</P>
<A NAME="toc20"></A>
<A NAME="toc18"></A>
<H2>5.1. Install Developer Tools</H2>
<P>
@ -1603,7 +1554,7 @@ If you have trouble building some of the dependencies listed below with clang
(e.g. OSG &amp; osgEarth), try using only the LLVM compilers.
</P>
<A NAME="toc21"></A>
<A NAME="toc19"></A>
<H2>5.2. Install Qt4 from disk image</H2>
<P>
@ -1663,7 +1614,7 @@ 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.
</P>
<A NAME="toc22"></A>
<A NAME="toc20"></A>
<H2>5.3. Install CMake for OSX</H2>
<P>
@ -1745,7 +1696,7 @@ If you have trouble building some of the dependencies listed below (e.g. OSG &am
osgEarth), try bypassing ccache.
</P>
<A NAME="toc23"></A>
<A NAME="toc21"></A>
<H2>5.4. Install development frameworks for QGIS dependencies</H2>
<P>
@ -2418,7 +2369,7 @@ folder in the include/ folder to /Library/Application Support/OpenSceneGraph/Hea
And as for OSG, you can leave the bin/ executables where they are.
</P>
<A NAME="toc24"></A>
<A NAME="toc22"></A>
<H2>5.5. API documentation</H2>
<P>
@ -2454,7 +2405,7 @@ QGIS.app bundling on install, inside the app in:
QGIS.app/Contents/Resources/doc
</P>
<A NAME="toc25"></A>
<A NAME="toc23"></A>
<H2>5.6. QGIS source</H2>
<P>
@ -2489,7 +2440,7 @@ git merge qgisupstream
</PRE></div>
<A NAME="toc26"></A>
<A NAME="toc24"></A>
<H2>5.7. Configure the build</H2>
<P>
@ -2630,7 +2581,7 @@ non-standard, libs (ie postgres' libpq) set the bundle value to 2:
-D QGIS_MACAPP_BUNDLE=2 \
</PRE></div>
<A NAME="toc27"></A>
<A NAME="toc25"></A>
<H2>5.8. Building</H2>
<P>
@ -2658,7 +2609,7 @@ or, for an /Applications build:
sudo make install
</PRE></div>
<A NAME="toc28"></A>
<A NAME="toc26"></A>
<H2>5.9. Post-Install</H2>
<P>
@ -2694,7 +2645,7 @@ for instructions on setting up Apache fastcgi and testing Mapserver, including
installing the mod-fastcgi that is missing on Lion.
</P>
<A NAME="toc29"></A>
<A NAME="toc27"></A>
<H1>6. Setting up the WCS test server on GNU/Linux</H1>
<P>
@ -2705,7 +2656,7 @@ These notes are for Ubuntu - other versions and Debian derived distros may
require slight variations in package names.
</P>
<A NAME="toc30"></A>
<A NAME="toc28"></A>
<H2>6.1. Preparation</H2>
<P>
@ -2725,7 +2676,7 @@ is integrated into master.
cd cgi-bin/
</P>
<A NAME="toc31"></A>
<A NAME="toc29"></A>
<H2>6.2. Setup mapserver</H2>
<P>
@ -2791,7 +2742,7 @@ Then create /var/www/wcs/7-wcs.qgis.org.conf setting the contents to this:
&lt;/VirtualHost&gt;
</PRE></div>
<A NAME="toc32"></A>
<A NAME="toc30"></A>
<H2>6.3. Create a home page</H2>
<div class="code"><PRE>
@ -2809,7 +2760,7 @@ Set the contents to:
http://wcs.qgis.org/1.9.0/wcs
</PRE></div>
<A NAME="toc33"></A>
<A NAME="toc31"></A>
<H2>6.4. Now deploy it</H2>
<div class="code"><PRE>
@ -2822,14 +2773,14 @@ Set the contents to:
sudo /etc/init.d/apache2 reload
</PRE></div>
<A NAME="toc34"></A>
<A NAME="toc32"></A>
<H2>6.5. Debugging</H2>
<div class="code"><PRE>
sudo tail -f /var/log/apache2/wcs_qgis.org/error.log
</PRE></div>
<A NAME="toc35"></A>
<A NAME="toc33"></A>
<H1>7. Setting up a Jenkins Build Server</H1>
<P>
@ -2931,7 +2882,7 @@ I based some of the set up from this nice blog article here:
<A HREF="http://alexott.blogspot.com/2012/03/jenkins-cmakectest.html">http://alexott.blogspot.com/2012/03/jenkins-cmakectest.html</A>
</UL>
<A NAME="toc36"></A>
<A NAME="toc34"></A>
<H1>8. Debug output and running tests</H1>
<P>
@ -2997,7 +2948,7 @@ ctest --show-only
ctest --verbose --tests-regex SomeTestName
</PRE></div>
<A NAME="toc37"></A>
<A NAME="toc35"></A>
<H1>9. Authors and Acknowledgments</H1>
<P>
@ -3063,5 +3014,5 @@ The following people have contributed to this document:
</DIV>
<!-- html code generated by txt2tags 2.6 (http://txt2tags.org) -->
<!-- cmdline: txt2tags -\-encoding=utf-8 -o/home/fischer/src/qgis3/debian/build-master-ninja/doc/INSTALL.html -t html /home/fischer/src/qgis3/doc/INSTALL.t2t -->
<!-- cmdline: txt2tags -\-encoding=utf-8 -o doc/INSTALL.html -t html doc/INSTALL.t2t -->
</BODY></HTML>

View File

@ -1,12 +1,12 @@
= Building on GNU/Linux =
== Building QGIS with Qt 4.x ==
== Building QGIS with Qt 5.x ==
**Requires:** Ubuntu / Debian derived distro
/!\ **Note:** Refer to the section ''Building Debian packages'' for building
debian packages. Unless you plan to develop on QGIS, that is probably the
debian packages. Unless you plan to develop on QGIS, that is probably the
easiest option to compile and install QGIS.
These notes are for Ubuntu - other versions and Debian derived distros may
@ -129,6 +129,11 @@ be pressed several times before the 'g' option becomes available.
After the 'g' generation is complete, press 'q' to exit the ccmake
interactive dialog.
/!\ **Warning:** Make sure that your build directory is completely empty when you
enter the command. Do never try to "re-use" an existing **Qt4** build directory.
If you want to use `ccmake` or other interactive tools, run the command in
the empty build directory once before starting to use the interactive tools.
Now on with the build:
```
@ -238,47 +243,6 @@ Install them using dpkg. E.g.:
sudo debi
```
== Building QGIS with Qt 5.x ==
/!\ **Warning:** Qt 5 is not officially supported. Building against Qt 5
libraries seems to work quite well already but be prepared that you are one
of very few with this setup. We strongly recommend using QGIS with Qt 4 for
production work.
Python bindings in particular are not expected to be compatible. When Qt 5
is enabled, the build system automatically activates Python 3 and PyQt5 as well.
There are no plugins and not even the python code shipped along the QGIS source
code is compatible with PyQt5.
You have been warned.
== On Debian Linux ==
We assume that you have the source code of QGIS ready and created a new
subdirectory called `build` or `build-qt5` in it.
=== Install build dependencies ===
```
apt-get install git build-essential cmake flex bison pyqt5-dev qttools5-dev qtpositioning5-dev libqt5svg5-dev libqt5webkit5-dev libqt5gui5 libqt5scripttools5 qtscript5-dev libqca-qt5-2-dev grass-dev libgeos-dev libgdal-dev libqt5xmlpatterns5-dev libqt5scintilla2-dev pyqt5.qsci-dev python3-pyqt5.qsci libgsl-dev txt2tags libproj-dev libqwt-qt5-dev libspatialindex-dev pyqt5-dev-tools qttools5-dev-tools qt5-default python3-future python3-pyqt5.qtsql python3-psycopg2 python3-sip-dev
```
Make sure that your build directory is completely empty when you enter the
following command. Do never try to "re-use" an existing Qt4 build directory.
If you want to use `ccmake` or other interactive tools, run the following
command in the empty build directory once before starting to use the
interactive tools.
```
cmake
```
If everything went ok you can finally start to compile. (As usual append a -jX where X is the number of available cores option to make to speed up your build process)
```
make
```
== On Fedora Linux ==
We assume that you have the source code of QGIS ready and created a