Skip to content

Commit aef2b00

Browse files
DelazJm-kuhn
DelazJ
authored and
m-kuhn
committedJan 27, 2017
QGIS 3 is only qt5 compliant
Remove qt4 mention (for linux based processes)
·
ltr-3_40final-3_0_0
1 parent f7644b4 commit aef2b00

File tree

3 files changed

+86
-209
lines changed

3 files changed

+86
-209
lines changed
 

‎INSTALL

Lines changed: 16 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,24 @@
11
QGIS
22
Building QGIS from source - step by step
3-
Monday January 09, 2017
3+
Wednesday January 25, 2017
44

55

6-
Last Updated: Monday January 09, 2017
7-
Last Change : Monday January 09, 2017
6+
Last Updated: Wednesday January 25, 2017
7+
Last Change : Friday January 20, 2017
88

99

1010
1. Introduction
1111
2. Overview
1212
3. Building on GNU/Linux
13-
3.1. Building QGIS with Qt 4.x
13+
3.1. Building QGIS with Qt 5.x
1414
3.2. Prepare apt
1515
3.3. Install build dependencies
1616
3.4. Setup ccache (Optional)
1717
3.5. Prepare your development environment
1818
3.6. Check out the QGIS Source Code
1919
3.7. Starting the compile
2020
3.8. Building Debian packages
21-
3.9. Building QGIS with Qt 5.x
22-
3.10. On Debian Linux
23-
3.11. On Fedora Linux
21+
3.9. On Fedora Linux
2422
4. Building on Windows
2523
4.1. Building with Microsoft Visual Studio
2624
4.2. Building using MinGW
@@ -139,13 +137,13 @@ those formats in GDAL.
139137
========================
140138

141139

142-
3.1. Building QGIS with Qt 4.x
140+
3.1. Building QGIS with Qt 5.x
143141
==============================
144142

145143
Requires: Ubuntu / Debian derived distro
146144

147145
/!\ Note: Refer to the section Building Debian packages for building
148-
debian packages. Unless you plan to develop on QGIS, that is probably the
146+
debian packages. Unless you plan to develop on QGIS, that is probably the
149147
easiest option to compile and install QGIS.
150148

151149
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.
263261
After the 'g' generation is complete, press 'q' to exit the ccmake
264262
interactive dialog.
265263

264+
/!\ Warning: Make sure that your build directory is completely empty when you
265+
enter the command. Do never try to "re-use" an existing Qt4 build directory.
266+
If you want to use `ccmake` or other interactive tools, run the command in
267+
the empty build directory once before starting to use the interactive tools.
268+
266269
Now on with the build:
267270

268271
make -jX
@@ -349,56 +352,15 @@ Install them using dpkg. E.g.:
349352
sudo debi
350353

351354

352-
3.9. Building QGIS with Qt 5.x
353-
==============================
354-
355-
/!\ Warning: Qt 5 is not officially supported. Building against Qt 5
356-
libraries seems to work quite well already but be prepared that you are one
357-
of very few with this setup. We strongly recommend using QGIS with Qt 4 for
358-
production work.
359-
360-
Python bindings in particular are not expected to be compatible. When Qt 5
361-
is enabled, the build system automatically activates Python 3 and PyQt5 as well.
362-
There are no plugins and not even the python code shipped along the QGIS source
363-
code is compatible with PyQt5.
364-
365-
You have been warned.
366-
367-
368-
3.10. On Debian Linux
369-
=====================
370-
371-
We assume that you have the source code of QGIS ready and created a new
372-
subdirectory called `build` or `build-qt5` in it.
373-
374-
375-
3.10.1. Install build dependencies
376-
==================================
377-
378-
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
379-
380-
Make sure that your build directory is completely empty when you enter the
381-
following command. Do never try to "re-use" an existing Qt4 build directory.
382-
If you want to use `ccmake` or other interactive tools, run the following
383-
command in the empty build directory once before starting to use the
384-
interactive tools.
385-
386-
cmake
387-
388-
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)
389-
390-
make
391-
392-
393-
3.11. On Fedora Linux
394-
=====================
355+
3.9. On Fedora Linux
356+
====================
395357

396358
We assume that you have the source code of QGIS ready and created a
397359
new subdirectory called `build` or `build-qt5` in it.
398360

399361

400-
3.11.1. Install build dependencies
401-
==================================
362+
3.9.1. Install build dependencies
363+
=================================
402364

403365
dnf install qt5-qtwebkit-devel qt5-qtlocation-devel qt5-qttools-static
404366
qt5-qtscript-devel qca-qt5-devel python3-qt5-devel python3-qscintilla-qt5-devel

‎doc/INSTALL.html

Lines changed: 63 additions & 112 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8">
66
<TITLE>QGIS</TITLE>
77

8-
<!-- Included /home/fischer/src/qgis3/doc/style.css -->
8+
<!-- Included doc/style.css -->
99
<STYLE TYPE="text/css">
1010
body{ background: white;
1111
color: black;
@@ -77,13 +77,13 @@
7777
<DIV CLASS="header" ID="header">
7878
<H1>QGIS</H1>
7979
<H2>Building QGIS from source - step by step</H2>
80-
<H3>Monday January 09, 2017</H3>
80+
<H3>Wednesday January 25, 2017</H3>
8181
</DIV>
8282

8383
<DIV CLASS="body" ID="body">
8484
<P>
85-
Last Updated: Monday January 09, 2017
86-
Last Change : Monday January 09, 2017
85+
Last Updated: Wednesday January 25, 2017
86+
Last Change : Friday January 20, 2017
8787
</P>
8888
<DIV CLASS="toc">
8989

@@ -92,47 +92,45 @@ <H3>Monday January 09, 2017</H3>
9292
<LI><A HREF="#toc2">Overview</A>
9393
<LI><A HREF="#toc3">Building on GNU/Linux</A>
9494
<UL>
95-
<LI><A HREF="#toc4">3.1. Building QGIS with Qt 4.x</A>
95+
<LI><A HREF="#toc4">3.1. Building QGIS with Qt 5.x</A>
9696
<LI><A HREF="#toc5">3.2. Prepare apt</A>
9797
<LI><A HREF="#toc6">3.3. Install build dependencies</A>
9898
<LI><A HREF="#toc7">3.4. Setup ccache (Optional)</A>
9999
<LI><A HREF="#toc8">3.5. Prepare your development environment</A>
100100
<LI><A HREF="#toc9">3.6. Check out the QGIS Source Code</A>
101101
<LI><A HREF="#toc10">3.7. Starting the compile</A>
102102
<LI><A HREF="#toc11">3.8. Building Debian packages</A>
103-
<LI><A HREF="#toc12">3.9. Building QGIS with Qt 5.x</A>
104-
<LI><A HREF="#toc13">3.10. On Debian Linux</A>
105-
<LI><A HREF="#toc14">3.11. On Fedora Linux</A>
103+
<LI><A HREF="#toc12">3.9. On Fedora Linux</A>
106104
</UL>
107-
<LI><A HREF="#toc15">Building on Windows</A>
105+
<LI><A HREF="#toc13">Building on Windows</A>
108106
<UL>
109-
<LI><A HREF="#toc16">4.1. Building with Microsoft Visual Studio</A>
110-
<LI><A HREF="#toc17">4.2. Building using MinGW</A>
111-
<LI><A HREF="#toc18">4.3. Creation of MSYS environment for compilation of QGIS</A>
107+
<LI><A HREF="#toc14">4.1. Building with Microsoft Visual Studio</A>
108+
<LI><A HREF="#toc15">4.2. Building using MinGW</A>
109+
<LI><A HREF="#toc16">4.3. Creation of MSYS environment for compilation of QGIS</A>
112110
</UL>
113-
<LI><A HREF="#toc19">Building on MacOS X</A>
111+
<LI><A HREF="#toc17">Building on MacOS X</A>
114112
<UL>
115-
<LI><A HREF="#toc20">5.1. Install Developer Tools</A>
116-
<LI><A HREF="#toc21">5.2. Install Qt4 from disk image</A>
117-
<LI><A HREF="#toc22">5.3. Install CMake for OSX</A>
118-
<LI><A HREF="#toc23">5.4. Install development frameworks for QGIS dependencies</A>
119-
<LI><A HREF="#toc24">5.5. API documentation</A>
120-
<LI><A HREF="#toc25">5.6. QGIS source</A>
121-
<LI><A HREF="#toc26">5.7. Configure the build</A>
122-
<LI><A HREF="#toc27">5.8. Building</A>
123-
<LI><A HREF="#toc28">5.9. Post-Install</A>
113+
<LI><A HREF="#toc18">5.1. Install Developer Tools</A>
114+
<LI><A HREF="#toc19">5.2. Install Qt4 from disk image</A>
115+
<LI><A HREF="#toc20">5.3. Install CMake for OSX</A>
116+
<LI><A HREF="#toc21">5.4. Install development frameworks for QGIS dependencies</A>
117+
<LI><A HREF="#toc22">5.5. API documentation</A>
118+
<LI><A HREF="#toc23">5.6. QGIS source</A>
119+
<LI><A HREF="#toc24">5.7. Configure the build</A>
120+
<LI><A HREF="#toc25">5.8. Building</A>
121+
<LI><A HREF="#toc26">5.9. Post-Install</A>
124122
</UL>
125-
<LI><A HREF="#toc29">Setting up the WCS test server on GNU/Linux</A>
123+
<LI><A HREF="#toc27">Setting up the WCS test server on GNU/Linux</A>
126124
<UL>
127-
<LI><A HREF="#toc30">6.1. Preparation</A>
128-
<LI><A HREF="#toc31">6.2. Setup mapserver</A>
129-
<LI><A HREF="#toc32">6.3. Create a home page</A>
130-
<LI><A HREF="#toc33">6.4. Now deploy it</A>
131-
<LI><A HREF="#toc34">6.5. Debugging</A>
125+
<LI><A HREF="#toc28">6.1. Preparation</A>
126+
<LI><A HREF="#toc29">6.2. Setup mapserver</A>
127+
<LI><A HREF="#toc30">6.3. Create a home page</A>
128+
<LI><A HREF="#toc31">6.4. Now deploy it</A>
129+
<LI><A HREF="#toc32">6.5. Debugging</A>
132130
</UL>
133-
<LI><A HREF="#toc35">Setting up a Jenkins Build Server</A>
134-
<LI><A HREF="#toc36">Debug output and running tests</A>
135-
<LI><A HREF="#toc37">Authors and Acknowledgments</A>
131+
<LI><A HREF="#toc33">Setting up a Jenkins Build Server</A>
132+
<LI><A HREF="#toc34">Debug output and running tests</A>
133+
<LI><A HREF="#toc35">Authors and Acknowledgments</A>
136134
</OL>
137135

138136
</DIV>
@@ -253,14 +251,14 @@ <H1>2. Overview</H1>
253251
<H1>3. Building on GNU/Linux</H1>
254252

255253
<A NAME="toc4"></A>
256-
<H2>3.1. Building QGIS with Qt 4.x</H2>
254+
<H2>3.1. Building QGIS with Qt 5.x</H2>
257255

258256
<P>
259257
<B>Requires:</B> Ubuntu / Debian derived distro
260258
</P>
261259
<P>
262260
/!\ <B>Note:</B> Refer to the section Building Debian packages for building
263-
debian packages. Unless you plan to develop on QGIS, that is probably the
261+
debian packages. Unless you plan to develop on QGIS, that is probably the
264262
easiest option to compile and install QGIS.
265263
</P>
266264
<P>
@@ -433,6 +431,12 @@ <H2>3.7. Starting the compile</H2>
433431
interactive dialog.
434432
</P>
435433
<P>
434+
/!\ <B>Warning:</B> Make sure that your build directory is completely empty when you
435+
enter the command. Do never try to "re-use" an existing <B>Qt4</B> build directory.
436+
If you want to use `ccmake` or other interactive tools, run the command in
437+
the empty build directory once before starting to use the interactive tools.
438+
</P>
439+
<P>
436440
Now on with the build:
437441
</P>
438442

@@ -574,67 +578,14 @@ <H2>3.8. Building Debian packages</H2>
574578
</PRE></div>
575579

576580
<A NAME="toc12"></A>
577-
<H2>3.9. Building QGIS with Qt 5.x</H2>
578-
579-
<P>
580-
/!\ <B>Warning:</B> Qt 5 is not officially supported. Building against Qt 5
581-
libraries seems to work quite well already but be prepared that you are one
582-
of very few with this setup. We strongly recommend using QGIS with Qt 4 for
583-
production work.
584-
</P>
585-
<P>
586-
Python bindings in particular are not expected to be compatible. When Qt 5
587-
is enabled, the build system automatically activates Python 3 and PyQt5 as well.
588-
There are no plugins and not even the python code shipped along the QGIS source
589-
code is compatible with PyQt5.
590-
</P>
591-
<P>
592-
You have been warned.
593-
</P>
594-
595-
<A NAME="toc13"></A>
596-
<H2>3.10. On Debian Linux</H2>
597-
598-
<P>
599-
We assume that you have the source code of QGIS ready and created a new
600-
subdirectory called `build` or `build-qt5` in it.
601-
</P>
602-
603-
<H3>3.10.1. Install build dependencies</H3>
604-
605-
<div class="code"><PRE>
606-
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
607-
</PRE></div>
608-
609-
<P>
610-
Make sure that your build directory is completely empty when you enter the
611-
following command. Do never try to "re-use" an existing Qt4 build directory.
612-
If you want to use `ccmake` or other interactive tools, run the following
613-
command in the empty build directory once before starting to use the
614-
interactive tools.
615-
</P>
616-
617-
<div class="code"><PRE>
618-
cmake
619-
</PRE></div>
620-
621-
<P>
622-
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)
623-
</P>
624-
625-
<div class="code"><PRE>
626-
make
627-
</PRE></div>
628-
629-
<A NAME="toc14"></A>
630-
<H2>3.11. On Fedora Linux</H2>
581+
<H2>3.9. On Fedora Linux</H2>
631582

632583
<P>
633584
We assume that you have the source code of QGIS ready and created a
634585
new subdirectory called `build` or `build-qt5` in it.
635586
</P>
636587

637-
<H3>3.11.1. Install build dependencies</H3>
588+
<H3>3.9.1. Install build dependencies</H3>
638589

639590
<div class="code"><PRE>
640591
dnf install qt5-qtwebkit-devel qt5-qtlocation-devel qt5-qttools-static
@@ -692,10 +643,10 @@ <H3>3.11.1. Install build dependencies</H3>
692643
make install
693644
</PRE></div>
694645

695-
<A NAME="toc15"></A>
646+
<A NAME="toc13"></A>
696647
<H1>4. Building on Windows</H1>
697648

698-
<A NAME="toc16"></A>
649+
<A NAME="toc14"></A>
699650
<H2>4.1. Building with Microsoft Visual Studio</H2>
700651

701652
<P>
@@ -953,7 +904,7 @@ <H3>4.1.6. Osgeo4w packaging</H3>
953904
<I>ms-windows/osgeo4w/package.cmd</I>
954905
</P>
955906

956-
<A NAME="toc17"></A>
907+
<A NAME="toc15"></A>
957908
<H2>4.2. Building using MinGW</H2>
958909

959910
<P>
@@ -1222,7 +1173,7 @@ <H3>4.2.12. Create the installation package: (optional)</H3>
12221173
on qgis.nsi and choose the option 'Compile NSIS Script'.
12231174
</P>
12241175

1225-
<A NAME="toc18"></A>
1176+
<A NAME="toc16"></A>
12261177
<H2>4.3. Creation of MSYS environment for compilation of QGIS</H2>
12271178

12281179
<H3>4.3.1. Initial setup</H3>
@@ -1479,7 +1430,7 @@ <H3>4.3.3. Cleanup</H3>
14791430
of space and it's not necessary at all.
14801431
</P>
14811432

1482-
<A NAME="toc19"></A>
1433+
<A NAME="toc17"></A>
14831434
<H1>5. Building on MacOS X</H1>
14841435

14851436
<P>
@@ -1546,7 +1497,7 @@ <H1>5. Building on MacOS X</H1>
15461497
many threads.
15471498
</P>
15481499

1549-
<A NAME="toc20"></A>
1500+
<A NAME="toc18"></A>
15501501
<H2>5.1. Install Developer Tools</H2>
15511502

15521503
<P>
@@ -1603,7 +1554,7 @@ <H2>5.1. Install Developer Tools</H2>
16031554
(e.g. OSG &amp; osgEarth), try using only the LLVM compilers.
16041555
</P>
16051556

1606-
<A NAME="toc21"></A>
1557+
<A NAME="toc19"></A>
16071558
<H2>5.2. Install Qt4 from disk image</H2>
16081559

16091560
<P>
@@ -1663,7 +1614,7 @@ <H2>5.2. Install Qt4 from disk image</H2>
16631614
CMAKE_MODULE_LINKER_FLAGS and CMAKE_EXE_LINKER_FLAGS in the cmake build.
16641615
</P>
16651616

1666-
<A NAME="toc22"></A>
1617+
<A NAME="toc20"></A>
16671618
<H2>5.3. Install CMake for OSX</H2>
16681619

16691620
<P>
@@ -1745,7 +1696,7 @@ <H3>5.3.1. Optional setup: ccache</H3>
17451696
osgEarth), try bypassing ccache.
17461697
</P>
17471698

1748-
<A NAME="toc23"></A>
1699+
<A NAME="toc21"></A>
17491700
<H2>5.4. Install development frameworks for QGIS dependencies</H2>
17501701

17511702
<P>
@@ -2418,7 +2369,7 @@ <H3>5.4.13. Optional dependencies: OSG &amp; osgEarth</H3>
24182369
And as for OSG, you can leave the bin/ executables where they are.
24192370
</P>
24202371

2421-
<A NAME="toc24"></A>
2372+
<A NAME="toc22"></A>
24222373
<H2>5.5. API documentation</H2>
24232374

24242375
<P>
@@ -2454,7 +2405,7 @@ <H2>5.5. API documentation</H2>
24542405
QGIS.app/Contents/Resources/doc
24552406
</P>
24562407

2457-
<A NAME="toc25"></A>
2408+
<A NAME="toc23"></A>
24582409
<H2>5.6. QGIS source</H2>
24592410

24602411
<P>
@@ -2489,7 +2440,7 @@ <H2>5.6. QGIS source</H2>
24892440

24902441
</PRE></div>
24912442

2492-
<A NAME="toc26"></A>
2443+
<A NAME="toc24"></A>
24932444
<H2>5.7. Configure the build</H2>
24942445

24952446
<P>
@@ -2630,7 +2581,7 @@ <H2>5.7. Configure the build</H2>
26302581
-D QGIS_MACAPP_BUNDLE=2 \
26312582
</PRE></div>
26322583

2633-
<A NAME="toc27"></A>
2584+
<A NAME="toc25"></A>
26342585
<H2>5.8. Building</H2>
26352586

26362587
<P>
@@ -2658,7 +2609,7 @@ <H2>5.8. Building</H2>
26582609
sudo make install
26592610
</PRE></div>
26602611

2661-
<A NAME="toc28"></A>
2612+
<A NAME="toc26"></A>
26622613
<H2>5.9. Post-Install</H2>
26632614

26642615
<P>
@@ -2694,7 +2645,7 @@ <H2>5.9. Post-Install</H2>
26942645
installing the mod-fastcgi that is missing on Lion.
26952646
</P>
26962647

2697-
<A NAME="toc29"></A>
2648+
<A NAME="toc27"></A>
26982649
<H1>6. Setting up the WCS test server on GNU/Linux</H1>
26992650

27002651
<P>
@@ -2705,7 +2656,7 @@ <H1>6. Setting up the WCS test server on GNU/Linux</H1>
27052656
require slight variations in package names.
27062657
</P>
27072658

2708-
<A NAME="toc30"></A>
2659+
<A NAME="toc28"></A>
27092660
<H2>6.1. Preparation</H2>
27102661

27112662
<P>
@@ -2725,7 +2676,7 @@ <H2>6.1. Preparation</H2>
27252676
cd cgi-bin/
27262677
</P>
27272678

2728-
<A NAME="toc31"></A>
2679+
<A NAME="toc29"></A>
27292680
<H2>6.2. Setup mapserver</H2>
27302681

27312682
<P>
@@ -2791,7 +2742,7 @@ <H2>6.2. Setup mapserver</H2>
27912742
&lt;/VirtualHost&gt;
27922743
</PRE></div>
27932744

2794-
<A NAME="toc32"></A>
2745+
<A NAME="toc30"></A>
27952746
<H2>6.3. Create a home page</H2>
27962747

27972748
<div class="code"><PRE>
@@ -2809,7 +2760,7 @@ <H2>6.3. Create a home page</H2>
28092760
http://wcs.qgis.org/1.9.0/wcs
28102761
</PRE></div>
28112762

2812-
<A NAME="toc33"></A>
2763+
<A NAME="toc31"></A>
28132764
<H2>6.4. Now deploy it</H2>
28142765

28152766
<div class="code"><PRE>
@@ -2822,14 +2773,14 @@ <H2>6.4. Now deploy it</H2>
28222773
sudo /etc/init.d/apache2 reload
28232774
</PRE></div>
28242775

2825-
<A NAME="toc34"></A>
2776+
<A NAME="toc32"></A>
28262777
<H2>6.5. Debugging</H2>
28272778

28282779
<div class="code"><PRE>
28292780
sudo tail -f /var/log/apache2/wcs_qgis.org/error.log
28302781
</PRE></div>
28312782

2832-
<A NAME="toc35"></A>
2783+
<A NAME="toc33"></A>
28332784
<H1>7. Setting up a Jenkins Build Server</H1>
28342785

28352786
<P>
@@ -2931,7 +2882,7 @@ <H1>7. Setting up a Jenkins Build Server</H1>
29312882
<A HREF="http://alexott.blogspot.com/2012/03/jenkins-cmakectest.html">http://alexott.blogspot.com/2012/03/jenkins-cmakectest.html</A>
29322883
</UL>
29332884

2934-
<A NAME="toc36"></A>
2885+
<A NAME="toc34"></A>
29352886
<H1>8. Debug output and running tests</H1>
29362887

29372888
<P>
@@ -2997,7 +2948,7 @@ <H1>8. Debug output and running tests</H1>
29972948
ctest --verbose --tests-regex SomeTestName
29982949
</PRE></div>
29992950

3000-
<A NAME="toc37"></A>
2951+
<A NAME="toc35"></A>
30012952
<H1>9. Authors and Acknowledgments</H1>
30022953

30032954
<P>
@@ -3063,5 +3014,5 @@ <H1>9. Authors and Acknowledgments</H1>
30633014

30643015
</DIV>
30653016
<!-- html code generated by txt2tags 2.6 (http://txt2tags.org) -->
3066-
<!-- 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 -->
3017+
<!-- cmdline: txt2tags -\-encoding=utf-8 -o doc/INSTALL.html -t html doc/INSTALL.t2t -->
30673018
</BODY></HTML>

‎doc/linux.t2t

Lines changed: 7 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11

22
= Building on GNU/Linux =
33

4-
== Building QGIS with Qt 4.x ==
4+
== Building QGIS with Qt 5.x ==
55

66
**Requires:** Ubuntu / Debian derived distro
77

88
/!\ **Note:** Refer to the section ''Building Debian packages'' for building
9-
debian packages. Unless you plan to develop on QGIS, that is probably the
9+
debian packages. Unless you plan to develop on QGIS, that is probably the
1010
easiest option to compile and install QGIS.
1111

1212
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.
129129
After the 'g' generation is complete, press 'q' to exit the ccmake
130130
interactive dialog.
131131

132+
/!\ **Warning:** Make sure that your build directory is completely empty when you
133+
enter the command. Do never try to "re-use" an existing **Qt4** build directory.
134+
If you want to use `ccmake` or other interactive tools, run the command in
135+
the empty build directory once before starting to use the interactive tools.
136+
132137
Now on with the build:
133138

134139
```
@@ -238,47 +243,6 @@ Install them using dpkg. E.g.:
238243
sudo debi
239244
```
240245

241-
== Building QGIS with Qt 5.x ==
242-
243-
/!\ **Warning:** Qt 5 is not officially supported. Building against Qt 5
244-
libraries seems to work quite well already but be prepared that you are one
245-
of very few with this setup. We strongly recommend using QGIS with Qt 4 for
246-
production work.
247-
248-
Python bindings in particular are not expected to be compatible. When Qt 5
249-
is enabled, the build system automatically activates Python 3 and PyQt5 as well.
250-
There are no plugins and not even the python code shipped along the QGIS source
251-
code is compatible with PyQt5.
252-
253-
You have been warned.
254-
255-
== On Debian Linux ==
256-
257-
We assume that you have the source code of QGIS ready and created a new
258-
subdirectory called `build` or `build-qt5` in it.
259-
260-
=== Install build dependencies ===
261-
262-
```
263-
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
264-
```
265-
266-
Make sure that your build directory is completely empty when you enter the
267-
following command. Do never try to "re-use" an existing Qt4 build directory.
268-
If you want to use `ccmake` or other interactive tools, run the following
269-
command in the empty build directory once before starting to use the
270-
interactive tools.
271-
272-
```
273-
cmake
274-
```
275-
276-
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)
277-
278-
```
279-
make
280-
```
281-
282246
== On Fedora Linux ==
283247

284248
We assume that you have the source code of QGIS ready and created a

0 commit comments

Comments
 (0)
Please sign in to comment.