QGIS3.10编译指南

下载所需要软件

1. 安装VS2015以及版本5以上的QT。
   根据我的电脑环境，我使用vs2015 x64 和 QT5.10.1版本，并将QT配置到VS上；安装CMake（有需要的再额外安装Python37；安装doxyden）。

除VS默认加入环境路径，检查QT和CMake的bin文件是否已经加入到环境路径中，
你可以右击“我的电脑”->“属性”->“高级系统设置”->“环境变量”->在系统变量中找到PATH，编辑查看
（如果此时不添加，也可在生成工程时一起配置环境）
2. 安装Cygwin依赖库
在这之前，你可以新建一个文件夹QGIS，将下载的需要的文件都放到下面，便于整理，最后它将是这样。

2.1 运行Cygwin setup安装包，按以下步骤继续

随便选择一个网址，一般默认第一个；无需点击Add，直接下一步。


所需库均搜索完毕，点击下一步等候下载安装即可。

2.2 在这个过程中，注意以下几点
（1）View选择Category（若不是，点击View可更改）
（2）Search输入要下载的内容，本工具只用下载flex和bison
（3）选择Devel，展开，如果当前未下载则显示的是"Skip"，点击会变成具体的版本，然后点击下一步即可下载（由于我这边都下过了，所以显示的是版本号和keep）。
没有下载的应该类似这样

（4）Search一个库之后，点击"Skip"使其出现版本编号后，清除search框的内容，继续search下一个。全部搜索点击完成后，再点击下一步，所有搜索项将会一起下载。
（5）上述路径不要有中文或空格

3. 安装osgeo4W依赖库
   （文件较多较大，建议在网速流畅的条件下进行）
   3.1 运行osgeo4w-setup安装包
   如下
   
   
   按个人需要修改路径
   
   
   
   
   等待加载
   
   

3.2 依赖库的搜索项
（1）操作同Cygwin的步骤类似，略去不提
（2）你需要依次search以下内容：
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、qjson。
除上面方法外，如果你嫌一个一个库下载麻烦，可以直接查找qgis-dev-deps安装，该库会将所有依赖库一起安装，省时省力，一步到位。

（3）遵从“宁可多下，绝不少下”的原则
（4）仅仅下载Library的内容
4.安装ninja
解压ninja的压缩包，并把ninja.exe复制到osgeo4w的安装路径的bin目录中（默认是C:\OSGeo4W64\bin），路径可在第3步中修改，后续的bat脚本会用到这个路径。

用CMake生成工程

1. 配置环境
   新建一个txt文件，命名path（具体什么命名无所谓）
   将以下内容拷贝到里面。
   @echo off
   set VS140COMNTOOLS = D:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\Tools\
   call “D:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat” x64
   set INCLUDE=%INCLUDE%;C:\Program Files (x86)\Microsoft SDKs\Windows\v7.1A\Include
   set LIB=%LIB%;C:\Program Files (x86)\Microsoft SDKs\Windows\v7.1A\Lib
   set OSGEO4W_ROOT=D:\QGIS\OSGeo4W64
   call “%OSGEO4W_ROOT%\bin\o4w_env.bat”
   call “%OSGEO4W_ROOT%\bin\py3_env.bat”
   call “%OSGEO4W_ROOT%\bin\qt5_env.bat”
   set O4W_ROOT=%OSGEO4W_ROOT:=/%
   set LIB_DIR=%O4W_ROOT%
   path %path%;D:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\bin
   path %PATH%;D:\Program Files\CMake\bin;D:\QGIS\cygwin64\bin
   @set GRASS_PREFIX7=D:/QGIS/OSGeo4W64/apps/grass/grass78
   @set INCLUDE=%INCLUDE%;%OSGEO4W_ROOT%\include
   @set LIB=%LIB%;%OSGEO4W_ROOT%\lib;%OSGEO4W_ROOT%\lib
   set LIB=%LIB%;%OSGEO4W_ROOT%\apps\Qt5\lib;%OSGEO4W_ROOT%\lib
   set INCLUDE=%INCLUDE%;%OSGEO4W_ROOT%\apps\Qt5\include;%OSGEO4W_ROOT%\include
   @cmd

注意说明：上面的路径以及grass的版本要根据自己的实际情况，做适当地改变
（1）VS140COMNTOOLS表示VS15
（若是VS2017则用语句VS150COMNTOOLS表示）
（2）Include表示头文件，这里加了Win10系统的sdk；Lib表示编译的动态库
（3）Path表示环境变量（刚才在前面没有设置的路径，现在也可以在这里添加）
（4）特别注意：GRASS_PREFIX的路径地址必须是“/”；Path路径多个;之间不能有空格，另外在CMake中GRASS_PREFIX的名称可能会变为GRASS_PREFIX7，所以在配置环境时需要将GRASS_PREFIX时更改为GRASS_PREFIX7，要不然GRASS_PREFIX会识别不出路径。

保存txt的内容，将文件后缀名改为.bat
在path.bat当前目录下按住shift键不放，右击鼠标选择 “在此处打开power shell 窗口(s)” ,输入下面命令进入cmake窗口。
输入以下命令：path.bat（在win10新版本中语法规则改变，输入：/.path.bat）
出现类似“Microsoft Windows 版本 10.0.17134.345 2018 Microsoft Corporation。保留所有权利。”字样，表执行成功
接着输入cmake-gui
将会打开CMake编辑页

2. 利用CMake构建项目
在上方文本框中分别输入QGIS源码路径；构建的VS工程的输出路径

点击下方“Configure”，将弹出VS版本选择（若为VS2017选择Visual Studio 15 2017 Win64）

点击Configure后可能会出现一些错误，找到相应的路径添加上去就行了，下面是我的路径，可能会有所不同，仅供参考。

随后，CMake将自动索引有关链接库，生成链接，对没有搜索到的库会报错显示没有找到路径。
（建议第一遍搜索后按我的配置手动增加路径）

增加步骤：
选择Add Entry


在这里，建议将QT与Python的有关路径全部改为OSGeo4W64/apps下的QT5和Python3文件夹下的路径。

因为CMake搜索机制是从硬盘文件夹逐步深入；所以主目录优先寻找到此主机安装上的QT与Python目录。
如果您的版本刚好是QT5.11.2与Python3+，可能不会影响结果，但如果版本有差异很可能造成后期编译出现链接错误。
而OSGeo4W64是QGIS方提供的最新库，将保证链接不出现问题（若后期有意更换最新版本的QGIS源码，仅在OSGeo4W64重新下载有关库到原保存文件夹下，更新生成VS工程即可）

当“Configure”直到下方信息栏显示Configuring done；
点击“Generate”显示Generate done；
此时“Open Object”按钮变亮点击它，即可进入工程项目；
（下一次需要打开工程，可在新建项目文件夹下，寻找.sln后缀的工程文件，打开即可）

在VS下编译
工程加载进入后，先将Debug格式改为Release或者RelWithDebInfo（在这两种版本下，编译不包含调试信息，容量上大大减小，运行速度大幅度提高；对于较大工程比较适用；在Rel版本下调试正确后换为Deg版本依旧正确，无须担心）
此处以RelWithDebInfo做例

1. 修改不识别的符号

先在资源管理器中找到qgis项目，右击该项目，选择“设为启动项目”

接着，你可以先试着第一次生成解决方案，以排除所有页面不识别的错误

你应会遇到大量报错，请等待生成完毕。
在错误中会出现例如
“错误 C2143 语法错误: 缺少“)”(在“;”的前面) ”
“错误 C2001 常量中有换行符 ”
……
这些错误的原因是因为页面不支持("′")("″")的符号

在错误列表关闭错误，仅查看警告，并点击“说明”让其聚类。大体上将出现会三种警告类型。
对于以下这两种，我们忽视掉——
“警告 C4718 “QMapNode<int,QgsRasterIterator::RasterPartInfo>::doDestroySubTree”: 递归调用无副作用，正在删除 ”
“警告 C4702 无法访问的代码 ”

而对于——
“警告 C4819 该文件包含不能在当前代码页(936)中表示的字符。请将该文件保存为 Unicode 格式以防止数据丢失 ”

我们点双击其文件一栏的文件名，进入对应的.cpp或.h文件

Ctrl+A 全选文件内容，点击上方“文件”，找到“高级保存设置”

将其从无签名改为带签名

修改所有出现此类警告的.cpp和.h文件，再次生成“qgis”项目，大部分报错将会消失。（也有可能直接编译通过）

2.可能报错的其他问题

2.1与qtmain.lib有关的未初始化的定义

解决方法：
找到例如此的警告信息
LNK4099 未找到 PDB“qtmain.pdb”(使用“qtmain.lib(qtmain_win.obj)正在链接对象，如同没有调试信息一样
得到该警告来源的项目名，如“qgiscrashhandle”

右击“qgiscrashhandle项目”->“属性”->“连接器”->“输入”附加依赖项中修改添加
D:\QGIS\OSGeo4W64\apps\Qt5\lib\qtmain.lib

2.2 qgis_gui项目中出现未定义的标识符 “QWebElement”

解决方法：
“qgis_gui项目”->“属性”->“C/C++”->“常规”附加包含目录中修改添加
D:\QGIS\OSGeo4W64\apps\Qt5\include\QtWebKit

注释掉报错函数关于QWebElemen类的内容，并在qgismaptip.cpp文件开头注释掉——
//#if WITH_QTWEBKIT
//#endif
（因为原代码中WITH_QTWEBKIT未定义，头文件 不可被识别；又因WITH_QTWEBKIT未定义，QWebElemen类中部分函数无法被调用，故也注释掉）

2.3 qgis_gui项目中出现CORE_EXPORT显式实例化声明无效

解决方法：
对于报错的位置——qgsoptionalexpression.h文件中，在template后添加class

重新生成解决方案。
如果完整的下载了链接库并正确引入路径，此时，不会再遇到其他问题。

我们可以在输出路径下发现生成的qgis.exe文件
示例路径：D:\QGIS\qgis-3.2.2-build\output\bin\RelWithDebInfo）

2.4 可能会报错未定义标识符，一般为QAction或QButonGroup的头文件未添加，在当前文件下添加相应头文件即可。

3.其他可能的问题（来源于网络统计）

如果出现问题，优先选择从gis_core项目、qgis_analysis项目、qgis_gui项目依次调试（其他项目均依赖于他们）
此时仍然有可能出现：

3.1 找不到 <netinet/in.h>，注释掉即可

3.2 error MSB6006: “rc.exe”已退出，代码为 5
在C盘下直接搜索该应用，将其路径配置到项目中即可。

3.3 MSVCRT.lib(exe_winmain.obj) : error LNK2019: 无法解析的外部符号 WinMain
这是因为——
新建项目是控制台应用程序，而程序通过的是WinMian（及windows入口函数）
可以在“qgis_core项目”->“属性”->“连接器”->“输入”附加依赖项中修改添加
D:\QGIS\OSGeo4W64\apps\Qt5\lib\qtmain.lib
重新生成即可。

3.4 链接错误或者缺少有关附加库问题
通常表现为——无法解析的外部符号；找不到、打不开.lib文件等
这与个人的主机环境有关，可以在“项目”->“属性”->“连接器”->“输入”附加依赖项中修改。
附上我的部分属性情况

Lib问题，检查附加依赖项
可以在“项目”->“属性”->“连接器”->“输入”附加依赖项中查看修改；

对于Release或者RelWithDebInfo版本，Lib路径基本如下图列举
对于Debug版本，部分Lib库名后有d标识
如下图的Qt5Cored即为Debug版本
（Debug版本与Release（RelWithDebInfo）版本的Lib名称不同，但路径一致。在工程修改版本环境时会自动更新链接，更改库名。无需手动更改。）

附加依赖项——

3.5 缺少可执行文件或者环境路径问题
Dll问题，检查可执行文件目录，即检查环境路径
可以在“项目”->“属性”->“VC++目录”->“可执行文件目录”中编辑查看
主要检查有无以下路径：
D:\QGIS\OSGeo4W64\apps\qt5\bin
D:\QGIS\OSGeo4W64\apps\Python37
D:\QGIS\OSGeo4W64\apps\Python37\Scripts
D:\QGIS\OSGeo4W64\bin
D:\Program Files\CMake\bin
D:\QGIS\cygwin64\bin
C:\WINDOWS\system32
C:\WINDOWS
C:\WINDOWS\system32\WBem
运行成果
配置运行环境
编译好的qgis.exe会在目录D:\QGIS\qgis-3.2.2-build\output\bin\RelWithDebInfo下

但打开qgis.exe时会出现报错

此时，把OSGeo4W64\apps\Qt5\bin和OSGeo4W64\bin下的dll文件全部拷贝到exe文件同目录下即可

同时，把OSGeo4W64\apps\Qt5\plugins文件下的platforms文件夹也拷贝到exe文件同目录下

当程序运行时，找不到正确支持图标格式（svg）的库文件。这里需要把OSGeo4W64\apps\Qt5\plugins文件下的imageformats文件夹也拷贝到exe文件同目录下

当运行时还可能找不到数据库，需要把QGIS\apps\Qt5\plugins文件夹下的sqldrivers文件夹也拷贝到exe文件同目录下
再次打开运行qgis.exe
如图所示——

语言汉化
QGIS2版本
点击Settings->Options，选择国旗和语言（一定要选国旗），设置完成以后，重新启动即可。
QGIS3版本
依次打开 setting --> option --> General，如图：