QGIS在Windows下的编译——QGIS3.28.15 + Qt5.15.3 +CMake3.28.0 + VS2022 —64位版本

0 前言

        1. 编译环境&&软件版本:
        (1)Windows 10 64位 专业版
        (2)Visual Studio Community 2022(社区版)
        (3)CMake-3.28.0 64位
        (4)Cygwin 64位
        (5)OSGeo4W 64位
        (6)Qt5.15.3-64位(通过OSGeo4W 下载)
        (7)QGIS-3.28.15 源码
        2. 关于QT:
        本次编译使用的QT依赖项来源于OSGeo4W下载,读者也可以通过单独下载安装QT5.15.3,并完成相关配置,得到QT环境。
        3. 关于OSGeo4W和Cygwin下载:
        (1)安装OSGeo4W和Cygwin的过程相似,都会伴随依赖项的下载安装。
        (2)凡是还没下载的依赖项,OSGeo4W和Cygwin中都需要选择install;对于已下载的依赖项,在OSGeo4W和Cygwin中都显示为keep,无需再下载。
        (3)OSGeo4W和Cygwin中下载依赖项是增量式的,比如你已经安装了OSGeo4W和Cygwin,但是后期编译过程中发现少了东西(例如iconv、gdal等),可以重复OSGeo4W和Cygwin的安装过程,而已下载的依赖项不会被清除。

1 编译过程

1.1 软件准备

        (1)操作系统:Windows 10 64位 专业版(旗舰版、家庭版等其他版本也可)
        (2)其他软件下载及安装:

工具包 下载地址
QGIS 3.28.15源码 Download QGIS
CMake 3.28.0(64位) Index of /files
Cygwin(64位) Cygwin Installation
OSGeo4W (64位) Download QGIS
QT 5.15.3(64位) 在OSGeo4W 中搜索qgis-dev-deps下载
?
源码下载
?
CMake下载及安装

?

?

?

?

?

Cygwin安装时要安装以下包:

        - bison

        -flex

        -git(即使你的电脑上已经安装了git) 

?
Cygwin下载及安装

?

?

?

?

?

?

?

?

?

?

?

?
OSGeo4W下载及安装

?

?

?

?

?

?

?

?

?

?

?

?

?

        Visual Studio 2022(大于2019的版本即可)的安装省略,需要包含有c++模块。

1.2 配置环境变量

        下载完成后,将Cygwin和OSGeo4W及其下载的依赖库添加到系统的环境变量。假设都装在D盘,则在系统变量Path里添加以下内容: D:cygwin64in;D:cygwin64lib;D:OSGeo4Win;D:OSGeo4Winclude;D:OSGeo4Wlib;

?

1.3 创建批处理脚本

        1)新建一个start_compile.bat,右键-编辑,里面内容如下(批处理脚本中的具体路径取决于前面的安装位置):

@echo off
set VS150COMNTOOLS=C:Program FilesMicrosoft Visual Studio2022CommunityCommon7Tools
call "C:Program FilesMicrosoft Visual Studio2022CommunityVCAuxiliaryBuildvcvarsall.bat" x64
 
set INCLUDE=%INCLUDE%;C:Program Files (x86)Windows Kits10Include
set LIB=%LIB%;C:Program Files (x86)Windows Kits10Lib
 
set OSGEO4W_ROOT=D:OSGeo4W
call "%OSGEO4W_ROOT%ino4w_env.bat"
SET PYTHONHOME=%OSGEO4W_ROOT%appsPython39
SET PYTHONPATH=%PYTHONHOME%;%PYTHONHOME%Scripts
set PYTHON_EXECUTABLE=%PYTHONHOME%/python3.exe
PATH %PYTHONPATH%;%PATH%
 
 
path %OSGEO4W_ROOT%appsQt5in;%PATH%
 
set QT_PLUGIN_PATH=%OSGEO4W_ROOT%appsQt5plugins
set O4W_QT_PREFIX=%OSGEO4W_ROOT:=/%/apps/Qt5
set O4W_QT_BINARIES=%OSGEO4W_ROOT:=/%/apps/Qt5/bin
set O4W_QT_PLUGINS=%OSGEO4W_ROOT:=/%/apps/Qt5/plugins
set O4W_QT_LIBRARIES=%OSGEO4W_ROOT:=/%/apps/Qt5/lib
set O4W_QT_TRANSLATIONS=%OSGEO4W_ROOT:=/%/apps/Qt5/translations
set O4W_QT_HEADERS=%OSGEO4W_ROOT:=/%/apps/Qt5/include
set O4W_QT_DOC=%OSGEO4W_ROOT:=/%/apps/Qt5/doc
 
set O4W_ROOT=%OSGEO4W_ROOT:=/%
set LIB_DIR=%O4W_ROOT%
path %path%;C:Program FilesMicrosoft Visual Studio2022CommunityVCToolsMSVC14.32.31326inHostx64x64
path %PATH%;D:OSGeo4WappsQt5in;D:cygwin64in
@set GRASS_PREFIX=D:OSGeo4Wappsgrassgrass83
@set INCLUDE=%INCLUDE%;%OSGEO4W_ROOT%include
@set LIB=%LIB%;%OSGEO4W_ROOT%lib;%OSGEO4W_ROOT%lib
set LIB=%LIB%;%OSGEO4W_ROOT%appsQt5lib;%OSGEO4W_ROOT%lib
set INCLUDE=%INCLUDE%;%OSGEO4W_ROOT%appsQt5include;%OSGEO4W_ROOT%include
 
call "D:CMakeincmake-gui.exe"

        2)以管理员身份启动cmd命令行,切换到上述start_compile.bat路径下,回车运行start_compile.bat,如图所示:

        3)弹出CMake的图形化界面。

2 编译QGIS

        1)“Where is the source code”一栏选择QGIS源码文件夹,“Where to build the binaries”一栏选择生成vs工程的目标路径。

        2)点击“Configure”,在弹出对话框选择“Visual Studio 17 2022”,点击“finish”。 

        3)如果前面的配置没有问题,configure将顺利完成;笔者遇到一个报错,提示没找到gdal,解决方案是手动配置gdal的头文件和lib库路径,然后继续点击“configure”即可,如下图所示:

gdal在前面下载的OSGeo4W路径下

        4)接下来笔者又遇到一个报错,提示没找到Python的开发包,如下图所示。解决方案是取消勾选“WITH_BINDINGS”和“BUILD_TESTING”,其他不变,再次点击“configure”,不再报错,如下图所示:

提示missing:Development Development.Module Development.Embed
取消勾选“WITH_BINDINGS”和“BUILD_TESTING”
取消勾选“WITH_BINDINGS”和“BUILD_TESTING”

        5)点击“Generate”,如果前面的配置没有问题,generate将顺利完成。

        6)点击“Open Project”,打开生成的VS工程,可以看到一共有432个工程,如下图所示:

        7)编译模式选择“RelWithDebInfo”,如下图所示:

        8)将qgis设置为启动项。

        9)将“D:cygwin64in”、“D:OSGeo4Win”、“D:OSGeo4Wappsgdal-devin”和“D:OSGeo4WappsQt5in”路径下所有dll文件,拷贝到“%构建目录%outputinRelWithDebInfo”下,即“qgis.exe”所在目录下。其中,%构建目录%是指CMake的“Where to build the binaries”指向的目录。

        10)点击“本地Windows调试器”,VS自动进行qgis的编译,等待qgis编译完成(编译链接打包耗时约一个半小时),QGIS正常启动,证明QGIS源码编译成功。