1+ Compiling QGIS From Source
2+ Tim Sutton 2007
13%!encoding: iso-8859-1
2- = Introduction =
34
45
56------------------------------------------------------------------------
67
7- 1. Building under windows using msys
8- 1.1. MSYS:
9- 1.2. Qt4.3
10- 1.3. Flex and Bison
11- 1.4. Python stuff: (optional)
12- 1.4.1. Download and install Python - use Windows installer
13- 1.4.2. Download SIP and PyQt4 sources
14- 1.4.3. Compile SIP
15- 1.4.4. Compile PyQt
16- 1.4.5. Final python notes
17- 1.5. Subversion:
18- 1.6. CMake:
19- 1.7. QGIS:
20- 1.8. Compiling:
21- 1.9. Configuration
22- 1.10. Compilation and installation
23- 1.11. Run qgis.exe from the directory where it's installed (CMAKE_INSTALL_PREFIX)
24- 1.12. Create the installation package: (optional)
25- 2. Building on Mac OSX using frameworks and cmake (QGIS > 0.8)
26- 2.1. Install XCODE
27- 2.2. Install Qt4 from .dmg
28- 2.3. Install development frameworks for QGIS dependencies
29- 2.3.1. Additional Dependencies : GSL
30- 2.3.2. Additional Dependencies : Expat
31- 2.3.3. Additional Dependencies : SIP
32- 2.3.4. Additional Dependencies : PyQt
33- 2.3.5. Additional Dependencies : Bison
34- 2.4. Install CMAKE for OSX
35- 2.5. Install subversion for OSX
36- 2.6. Check out QGIS from SVN
37- 2.7. Configure the build
38- 2.8. GEOS Issues
39- 2.9. Building
40- 3. Building on GNU/Linux
41- 3.1. Building QGIS with Qt4.x
42- 3.2. Prepare apt
43- 3.3. Install Qt4
44- 3.4. Install additional software dependencies required by QGIS
45- 3.5. GRASS Specific Steps
46- 3.6. Setup ccache (Optional)
47- 3.7. Prepare your development environment
48- 3.8. Check out the QGIS Source Code
49- 4. Further help and information
50- 5. Authors and Acknowledgments
8+ 1. Introduction
9+ 2. Building under windows using msys
10+ 2.1. MSYS:
11+ 2.2. Qt4.3
12+ 2.3. Flex and Bison
13+ 2.4. Python stuff: (optional)
14+ 2.4.1. Download and install Python - use Windows installer
15+ 2.4.2. Download SIP and PyQt4 sources
16+ 2.4.3. Compile SIP
17+ 2.4.4. Compile PyQt
18+ 2.4.5. Final python notes
19+ 2.5. Subversion:
20+ 2.6. CMake:
21+ 2.7. QGIS:
22+ 2.8. Compiling:
23+ 2.9. Configuration
24+ 2.10. Compilation and installation
25+ 2.11. Run qgis.exe from the directory where it's installed (CMAKE_INSTALL_PREFIX)
26+ 2.12. Create the installation package: (optional)
27+ 3. Building on Mac OSX using frameworks and cmake (QGIS > 0.8)
28+ 3.1. Install XCODE
29+ 3.2. Install Qt4 from .dmg
30+ 3.3. Install development frameworks for QGIS dependencies
31+ 3.3.1. Additional Dependencies : GSL
32+ 3.3.2. Additional Dependencies : Expat
33+ 3.3.3. Additional Dependencies : SIP
34+ 3.3.4. Additional Dependencies : PyQt
35+ 3.3.5. Additional Dependencies : Bison
36+ 3.4. Install CMAKE for OSX
37+ 3.5. Install subversion for OSX
38+ 3.6. Check out QGIS from SVN
39+ 3.7. Configure the build
40+ 3.8. GEOS Issues
41+ 3.9. Building
42+ 4. Building on GNU/Linux
43+ 4.1. Building QGIS with Qt4.x
44+ 4.2. Prepare apt
45+ 4.3. Install Qt4
46+ 4.4. Install additional software dependencies required by QGIS
47+ 4.5. GRASS Specific Steps
48+ 4.6. Setup ccache (Optional)
49+ 4.7. Prepare your development environment
50+ 4.8. Check out the QGIS Source Code
51+ 5. Further help and information
52+ 6. Authors and Acknowledgments
5153
5254
5355------------------------------------------------------------------------
5456
57+
58+ 1. Introduction
59+ ===============
60+
5561/!\ *Note to document writers:* Please use this document as the central
5662place for describing build procefures. Please do not remove this notice.
5763
@@ -63,11 +69,11 @@ simply copy the commands listed in codeblocks that look like this:
6369
6470
6571
66- 1 . Building under windows using msys
72+ 2 . Building under windows using msys
6773 ====================================
6874
6975
70- 1 .1. MSYS:
76+ 2 .1. MSYS:
7177 ==========
7278
7379MSYS provides a unix style build environment under windows. We have created a
@@ -85,7 +91,7 @@ windows application for creating and decompressing files here:
8591http://www.7-zip.org/
8692
8793
88- 1 .2. Qt4.3
94+ 2 .2. Qt4.3
8995 ==========
9096
9197Download qt4.3 opensource precompiled edition exe and install (including the
@@ -112,7 +118,7 @@ If you plan to do some debugging, you'll need to compile debug version of Qt:
112118C:\Qt\4.3.0\bin\qtvars.bat compile_debug
113119
114120
115- 1 .3. Flex and Bison
121+ 2 .3. Flex and Bison
116122 ===================
117123
118124*** Note I think this section can be removed as it should be installed int the
@@ -123,23 +129,23 @@ http://sourceforge.net/project/showfiles.php?group_id=23617&package_id=16424
123129(the zip bin) and extract it into c:\msys\mingw\bin
124130
125131
126- 1 .4. Python stuff: (optional)
132+ 2 .4. Python stuff: (optional)
127133 =============================
128134
129135Follow this section in case you would like to use Python bindings for QGIS. To
130136be able to compile bindings, you need to compile SIP and PyQt4 from sources as
131137their installer doesn't include some development files which are necessary.
132138
133139
134- 1 .4.1. Download and install Python - use Windows installer
140+ 2 .4.1. Download and install Python - use Windows installer
135141 ==========================================================
136142
137143(It doesn't matter to what folder you'll install it)
138144
139145http://python.org/download/
140146
141147
142- 1 .4.2. Download SIP and PyQt4 sources
148+ 2 .4.2. Download SIP and PyQt4 sources
143149 =====================================
144150
145151http://www.riverbankcomputing.com/Downloads/sip4/sip-4.6.zip
@@ -148,7 +154,7 @@ http://www.riverbankcomputing.com/Downloads/PyQt4/GPL/PyQt-win-gpl-4.2.zip
148154Extract each of the above zip files in a temporary directory.
149155
150156
151- 1 .4.3. Compile SIP
157+ 2 .4.3. Compile SIP
152158 ==================
153159
154160
@@ -159,7 +165,7 @@ Extract each of the above zip files in a temporary directory.
159165
160166
161167
162- 1 .4.4. Compile PyQt
168+ 2 .4.4. Compile PyQt
163169 ===================
164170
165171
@@ -170,14 +176,14 @@ Extract each of the above zip files in a temporary directory.
170176
171177
172178
173- 1 .4.5. Final python notes
179+ 2 .4.5. Final python notes
174180 =========================
175181
176182/!\ You can delete the directories with unpacked SIP and PyQt4 sources after a
177183successfull install, they're not needed anymore.
178184
179185
180- 1 .5. Subversion:
186+ 2 .5. Subversion:
181187 ================
182188
183189In order to check out QGIS sources from the repository, you need Subversion
@@ -186,15 +192,15 @@ client. This installer should work fine:
186192http://subversion.tigris.org/files/documents/15/36797/svn-1.4.3-setup.exe
187193
188194
189- 1 .6. CMake:
195+ 2 .6. CMake:
190196 ===========
191197
192198CMake is build system used by Quantum GIS. Download it from here:
193199
194200http://www.cmake.org/files/v2.4/cmake-2.4.6-win32-x86.exe
195201
196202
197- 1 .7. QGIS:
203+ 2 .7. QGIS:
198204 ==========
199205
200206Start a cmd.exe window ( Start -> Run -> cmd.exe ) Create development
@@ -216,7 +222,7 @@ For svn 0.8 branch
216222
217223
218224
219- 1 .8. Compiling:
225+ 2 .8. Compiling:
220226 ===============
221227
222228As a background read the generic building with CMake notes at the end of
@@ -238,7 +244,7 @@ Create build directory and set it as current directory:
238244
239245
240246
241- 1 .9. Configuration
247+ 2 .9. Configuration
242248 ==================
243249
244250
@@ -263,15 +269,15 @@ install prefix to its default c:\program files\
263269When configuration is done, click 'OK' to exit the setup utility.
264270
265271
266- 1 .10. Compilation and installation
272+ 2 .10. Compilation and installation
267273 ==================================
268274
269275
270276 make make install
271277
272278
273279
274- 1 .11. Run qgis.exe from the directory where it's installed (CMAKE_INSTALL_PREFIX)
280+ 2 .11. Run qgis.exe from the directory where it's installed (CMAKE_INSTALL_PREFIX)
275281 =================================================================================
276282
277283Make sure to copy all .dll:s needed to the same directory as the qgis.exe
@@ -292,7 +298,7 @@ c:\msys\local\bin and c:\msys\local\lib directories, so the DLLs will be
292298used from that place.
293299
294300
295- 1 .12. Create the installation package: (optional)
301+ 2 .12. Create the installation package: (optional)
296302 =================================================
297303
298304Downlad and install NSIS from (http://nsis.sourceforge.net/Main_Page)
@@ -302,21 +308,21 @@ tree. Read the READMEfile there and follow the instructions. Next right click
302308on qgis.nsi and choose the option 'Compile NSIS Script'.
303309
304310
305- 2 . Building on Mac OSX using frameworks and cmake (QGIS > 0.8)
311+ 3 . Building on Mac OSX using frameworks and cmake (QGIS > 0.8)
306312 ==============================================================
307313
308314In this approach I will try to avoid as much as possible building dependencies
309315from source and rather use frameworks wherever possible.
310316
311317
312- 2 .1. Install XCODE
318+ 3 .1. Install XCODE
313319 ==================
314320
315321I recommend to get the latest xcode dmg from the Apple XDC Web site. Install
316322XCODE after the ~941mb download is complete.
317323
318324
319- 2 .2. Install Qt4 from .dmg
325+ 3 .2. Install Qt4 from .dmg
320326 ==========================
321327
322328
@@ -350,7 +356,7 @@ Second change the default mkspec symlink so that it points to macx-g++:
350356
351357
352358
353- 2 .3. Install development frameworks for QGIS dependencies
359+ 3 .3. Install development frameworks for QGIS dependencies
354360 =========================================================
355361
356362Download William Kyngesburye's excellent all in one framework that includes
@@ -373,7 +379,7 @@ There are some additional dependencies that at the time of writing are not
373379provided as frameworks so we will need to build these from source.
374380
375381
376- 2 .3.1. Additional Dependencies : GSL
382+ 3 .3.1. Additional Dependencies : GSL
377383 ====================================
378384
379385Retrieve the Gnu Scientific Library from
@@ -393,7 +399,7 @@ Then extract it and build it to a prefix of /usr/local:
393399
394400
395401
396- 2 .3.2. Additional Dependencies : Expat
402+ 3 .3.2. Additional Dependencies : Expat
397403 ======================================
398404
399405Get the expat sources:
@@ -412,7 +418,7 @@ Get the expat sources:
412418
413419
414420
415- 2 .3.3. Additional Dependencies : SIP
421+ 3 .3.3. Additional Dependencies : SIP
416422 ====================================
417423
418424Retrieve the python bindings toolkit SIP from
@@ -433,7 +439,7 @@ Then extract and build it to a prefix of /usr/local:
433439
434440
435441
436- 2 .3.4. Additional Dependencies : PyQt
442+ 3 .3.4. Additional Dependencies : PyQt
437443 =====================================
438444
439445Retrieve the python bindings toolkit for Qt from
@@ -455,7 +461,7 @@ Then extract and build it to a prefix of /usr/local:
455461
456462
457463
458- 2 .3.5. Additional Dependencies : Bison
464+ 3 .3.5. Additional Dependencies : Bison
459465 ======================================
460466
461467The version of bison available by default on Mac OSX is too old so you need to
@@ -477,7 +483,7 @@ Now build and install it to a prefix of /usr/local :
477483
478484
479485
480- 2 .4. Install CMAKE for OSX
486+ 3 .4. Install CMAKE for OSX
481487 ==========================
482488
483489Get the latest release from here:
@@ -495,7 +501,7 @@ At the time of writing the file I grabbed was:
495501Once downloaded open the dmg and run the installer
496502
497503
498- 2 .5. Install subversion for OSX
504+ 3 .5. Install subversion for OSX
499505 ===============================
500506
501507The http://sourceforge.net/projects/macsvn/ (MacSVN) project has a downloadable
@@ -538,7 +544,7 @@ old) that is installed by MacOSX
538544Now close and reopen your shell to get the updated vars.
539545
540546
541- 2 .6. Check out QGIS from SVN
547+ 3 .6. Check out QGIS from SVN
542548 ============================
543549
544550Now we are going to check out the sources for QGIS. First we will create a
@@ -579,7 +585,7 @@ this:
579585I suggest you press 'p' to accept the key permanently.
580586
581587
582- 2 .7. Configure the build
588+ 3 .7. Configure the build
583589 ========================
584590
585591CMake supports out of source build so we will create a 'build' dir for the
@@ -593,7 +599,7 @@ build process
593599
594600
595601
596- 2 .8. GEOS Issues
602+ 3 .8. GEOS Issues
597603 ================
598604
599605I had some issues with GEOS headers so I made the following edits:
@@ -603,7 +609,7 @@ In file /Library/Frameworks/GEOS.framework/Headers/io.h, comment out line 61
603609In file /Library/Frameworks/GEOS.framework/Headers/geom.h, comment out line 145
604610
605611
606- 2 .9. Building
612+ 3 .9. Building
607613 =============
608614
609615Now we can start the build process:
@@ -619,11 +625,11 @@ If all built without errors you can then install it:
619625
620626
621627
622- 3 . Building on GNU/Linux
628+ 4 . Building on GNU/Linux
623629 ========================
624630
625631
626- 3 .1. Building QGIS with Qt4.x
632+ 4 .1. Building QGIS with Qt4.x
627633 =============================
628634
629635*Requires:* Ubuntu Edgy
@@ -640,7 +646,7 @@ in use for a while, you may need to just skip those steps which are irrelevant
640646to you.
641647
642648
643- 3 .2. Prepare apt
649+ 4 .2. Prepare apt
644650 ================
645651
646652The packages qgis depends on to build are available in the "universe" component
@@ -659,7 +665,7 @@ of Ubuntu. This is not activated by default, so you need to activate it:
659665 ```
660666
661667
662- 3 .3. Install Qt4
668+ 4 .3. Install Qt4
663669 ================
664670
665671 ```
@@ -705,7 +711,7 @@ of Ubuntu. This is not activated by default, so you need to activate it:
705711 above commands to select the Qt4 version of the relevant applications.
706712
707713
708- 3 .4. Install additional software dependencies required by QGIS
714+ 4 .4. Install additional software dependencies required by QGIS
709715 ==============================================================
710716
711717 ```
@@ -716,7 +722,7 @@ of Ubuntu. This is not activated by default, so you need to activate it:
716722 ```
717723
718724
719- 3 .5. GRASS Specific Steps
725+ 4 .5. GRASS Specific Steps
720726 =========================
721727
722728 /!\ *Note:* If you don't need to build with GRASS support, you can
@@ -729,7 +735,7 @@ of Ubuntu. This is not activated by default, so you need to activate it:
729735 ```
730736
731737
732- 3 .6. Setup ccache (Optional)
738+ 4 .6. Setup ccache (Optional)
733739 ============================
734740
735741 You should also setup ccache to speed up compile times:
@@ -741,7 +747,7 @@ of Ubuntu. This is not activated by default, so you need to activate it:
741747 ```
742748
743749
744- 3 .7. Prepare your development environment
750+ 4 .7. Prepare your development environment
745751 =========================================
746752
747753 As a convention I do all my development work in $HOME/dev/<language>, so in
@@ -756,7 +762,7 @@ of Ubuntu. This is not activated by default, so you need to activate it:
756762 This directory path will be assumed for all instructions that follow.
757763
758764
759- 3 .8. Check out the QGIS Source Code
765+ 4 .8. Check out the QGIS Source Code
760766 ===================================
761767
762768 There are two ways the source can be checked out. Use the anonymous method
@@ -826,14 +832,14 @@ of Ubuntu. This is not activated by default, so you need to activate it:
826832 on your screen.
827833
828834
829- 4 . Further help and information
835+ 5 . Further help and information
830836 ===============================
831837
832838 Please visit http://qgis.org for information on joining our mailing lists
833839 and getting involved in the project further.
834840
835841
836- 5 . Authors and Acknowledgments
842+ 6 . Authors and Acknowledgments
837843 ==============================
838844
839845The follwing people have contributed to this document:
0 commit comments