#QGIS源码官方编译指南

QGIS源码官方编译指南

将QGIS官方的编译指南windows部分翻译一下,供大家参考。这个版本是QGIS源代码工程中2017年4月30日最后修改的版本,对应QGIS 2.99,也就是即将发布为QGIS 3.0的版本。

翻译:Jacory Gao
版本:2017年4月30日

引言

本文是QGIS软件官方安装指南。本文中所描述的软件和硬件都有注册商标并具有合法使用许可。QGIS使用GNU General Public许可。详细信息可查看QGIS官方网站:http://qgis.org

本文描写的技术细节都经过了笔者最大努力验证,尽管如此,错误也在所难免,因此,所有文字并不做完全保证。笔者和编辑对本文的后果不承担任何责任。欢迎批评指正。

由于QGIS源码每次发布都会有变化,本文介绍的方法应该与发布的版本保持常态化的一致性。本文最新的master分支请见http://htmlpreview.github.io/?https://raw.github.com/qgis/QGIS/master/doc/INSTALL.html. 如果你希望编译QGIS的其他版本,请确保使用合适的发布分支。

请访问http://qgis.org 获取加入邮件列表(mailing list)的方法,加入到QGIS工程的构建工作中来。

文档编写人员注意:请将本文作为描述源码编译最主要的文档。请不要删除本提示。
文档编写人员注意:本文是由doc/INSTALL.t2t文件生成,如果想要更改本文内容,请确保更改那个文件,而不是在本文件上做修改。

概述

QGIS, 像许多重大工程一样,使用CMake(http://www.cmake.org)作为源码构建工具。

构建源码需要的依赖库如下所述:

必需工具:
- CMake >= 2.8.6
- Flex >= 2.5.6
- Bison >= 2.4

必需依赖库:
- Qt >= 5.3.0
- Proj >= 4.4.x
- GEOS >= 3.4
- Sqlite3 >= 3.0.0
- SpatiaLite
- libspatialindex
- GDAL/OGR >= 2.0
- Qwt >= 5.0 & (< 6.1 with internal QwtPolar)
- expat >= 1.95
- QScintilla2
- QCA
- qtkeychain (>= 0.5)

可选依赖库:
- GRASS驱动和插件支持 - GRASS >= 6.0.0. QGIS可以和GRASS6或者GRASS7共同编译. 它也可以同时支持这两个版本的GRASS如果安装了rpath的话,具体使用的版本是由LD_LIBRARY_PATH或者PATH变量在运行时决定。
- georeferencer - GSL >= 1.8
- postgis数据库支持 - PostgreSQL >= 8.0.x
- gps插件 - gpsbabel
- mapserver导出以及PyQGIS - Python >= 3.3
- python支持 - SIP >= 4.12, PyQt >= 5.3 并且要与Qt版本吻合, Qscintilla2
- qgis mapserver - FastCGI
- oracle驱动 - Oracle OCI library

间接依赖:
一些由专有格式(例如,ECW,MrSid等)支持需要有相应的第三方库编译支持的GDAL。QGIS不需要任何其他库来编译,但是仅仅支持具有相应依赖的GDAL库来提供数据读写。请参见 http://gdal.org/formats_list.html 查看如何使GDAL支持那些专有格式。

Windows平台编译

使用Microsoft Visual Studio编译

本节描述了如何使用Windows平台下的Visual Studio编译器进行QGIS源码编译。这也是目前QGIS安装版本的编译方式(早期版本使用MinGW编译)。

本节描述了使用Visual Studio编译QGIS需要安装的软件环境

Visual C++社区版

免费的安装程序可以从下面的链接下载:
http://download.microsoft.com/download/D/2/3/D23F4D0F-BA2D-4600-8725-6CCECEA05196/vs_community_ENU.exe

其他工具和依赖

下载并安装以下程序:

工具网址
CMakehttps://cmake.org/files/v3.7/cmake-3.7.2-win64-x64.msi
GNU flex, GNU bison 以及 GIThttp://cygwin.com/setup-x86.exe (32bit) or http://cygwin.com/setup-x86_64.exe (64bit)
OSGeo4Whttp://download.osgeo.org/osgeo4w/osgeo4w-setup-x86.exe (32bit) or http://download.osgeo.org/osgeo4w/osgeo4w-setup-x86_64.exe (64bit)
ninjahttps://github.com/ninja-build/ninja/releases/download/v1.7.2/ninja-win.zip

OSGeo4W不仅提供了可用的QGIS发布版安装包和master分支的常态化编译版本,也提供了大多数编译QGIS所需的依赖库。

编译QGIS需要从cygwin安装以下软件:
- bison
- flex
- git

以及从OSGeo4W安装以下依赖库(选择Advanced Installation模式):
- expat
- fcgi
- gdal
- grass
- gsl-devel
- iconv
- libspatialindex-devel
- pyqt5
- python3-devel
- python3-qscintilla
- python3-nose2
- python3-future
- python3-pyyaml
- python3-mock
- qca-qt5-devel
- qca-qt5-libs
- qscintilla-qt5
- qt5-devel
- qt5-libs-debug
- qtwebkit-qt5-devel
- qtwebkit-qt5-libs-debug
- qwt-devel-qt5
- sip-qt5
- spatialite

这也会自动选择以上依赖库所需要的依赖项。

如果你安装其他软件包,可能会导致错误。尤其是确保不要安装msinttypes软件包,它会安装stdint.h文件到OSGeo4W[64]/include目录下,进而导致与Visual Studio本身的stdint.h文件冲突,致使编译某些模块失败。

本文早期的版本提供了所有上述依赖库的编译方法,如果你需要的话,可以切回到早期的分支等进行查看。

使用CMake配置Visual Studio工程

本节内容仅供参考,随着OSGeo4W和SDK的更新,本文可能会过时。ms-windows/osgeo4w/package-nightly.cmd被用来常态化编译并更新QGIS,它可能会包含本节没有提到的内容。

新建一个包含下面代码的批处理文件,可以创造一个同时包含VC++和OSGeo4W变量环境的命令行终端环境(假设上述的依赖库都安装在默认位置):

@echo off
set VS90COMNTOOLS=%PROGRAMFILES%\Microsoft Visual Studio 9.0\Common7\Tools\
call "%PROGRAMFILES%\Microsoft Visual Studio 9.0\VC\vcvarsall.bat" x86

set INCLUDE=%INCLUDE%;%PROGRAMFILES%\Microsoft SDKs\Windows\v7.1\include
set LIB=%LIB%;%PROGRAMFILES%\Microsoft SDKs\Windows\v7.1\lib

set OSGEO4W_ROOT=C:\OSGeo4W
call "%OSGEO4W_ROOT%\bin\o4w_env.bat"
path %PATH%;%PROGRAMFILES%\CMake\bin;c:\cygwin\bin

@set GRASS_PREFIX=c:/OSGeo4W/apps/grass/grass-6.4.4
@set INCLUDE=%INCLUDE%;%OSGEO4W_ROOT%\include
@set LIB=%LIB%;%OSGEO4W_ROOT%\lib;%OSGEO4W_ROOT%\lib

@cmd

在命令行终端运行这个批处理文件,并使用git检出QGIS源码目录:

git clone git://github.com/qgis/QGIS.git

创建一个’build’目录在别的地方,用来存储源码构建生成的文件。

在终端运行’cmake-gui’命令,并在相应位置填写上源码目录路径,选择QGIS顶层目录。

如果bison和flex的路径为空,你需要使用短路径规则手动填写(例如,C:\Program Files 应该重写为 C:\Progra~n, 这里的n表示使用 dir /x C:\命令时目标文件夹的显示顺序)。

确保‘BINDIGNS_GLOBAL_INSTALL’选项未被勾选,这样当运行INSTALL命令时,Python插件会被放置到输出目录。

单击Configure按钮开始配置工程,选择visual studio 9 2008版本,且保持native compiler选项默认,点击Finish按钮。

配置过程应该不会出现任何错误,这时你可以单击Generate来生成工程文件。

现在,关闭cmake-gui并继续在终端输入vcexpress打开Visual Studio,使用’文件/打开/工程/解决方案’命令打开QGIS工程输出目录下生成的qgis-x.y.z.sln工程文件。

在使用ALL_BUILD工程开始编译QGIS之前,将解决方案配置从Debug更改为RelWithDebInfo(Release with Debug Info)或者Release模式。(否则,你需要安装没有默认包含的debug版本依赖库)

编译完成之后可以使用INSTALL安装QGIS软件到系统中。

使用INSTALL安装QGIS软件默认会安装到c:\Programe Files\qgis目录(可以在cmake-gui中使用CMAKE_INSTALL_PREFIX变量改变这个安装路径)

同时你需要将所有依赖的DLL文件添加到QGIS安装目录,或者将他们分别加入到系统PATH环境变量中。

打包

可以使用’qgis/ms-windows/osgeo4w’路径下名为’creatensis.pl’的Perl脚本文件创建一个独立的安装包程序。它会下载从OSGEO4W下载所有需要的依赖库并利用NSIS将它们重新打包进安装程序中。

这个脚本文件同时支持Windows和Linux运行。

在Debian/Ubuntu平台下,你可以仅安装‘nsis’软件包。

NSIS for Windows可以从下面的链接下载:
http://nsis.sourceforge.net/

Perl for Windows(包括其他像’wget’,’unzip’,’tar’,’bzip2’等依赖库)可以在下面的链接下载:
http://cygwin.com/

打包你自己的QGIS程序

假如你已经完成了以上的打包步骤,如果你想要包含你自己的QGIS可执行程序,你需要使用’creatensis’脚本从Windows安装路径复制他们到ms-windows文件树中。

cd ms-windows/
rm -rf osgeo4w/unpacked/apps/qgis/*
cp -r /tmp/qgis1.7.0/* osgeo4w/unpacked/apps/qgis/

现在创建一个软件包:

./quickpackage.sh

完成以上步骤,你应该就拥有了一个自己的QGIS软件安装包以及在Windows运行它所需要的所有依赖库。

Osgeo4W打包

具体打包过程当前未列出,请参见:
‘ms-windows/osgeo4w/package.cmd’文件

  • 2
    点赞
  • 39
    收藏
    觉得还不错? 一键收藏
  • 8
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 8
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值