【GDAL】Windows下VS+GDAL开发环境搭建

news2024/9/22 10:01:25

Step.0 环境说明（vs版本，CMake版本）

本地的IDE环境是vs2022，安装的CMake版本是3.25.1。

Step.1 下载GDAL和依赖的组件

编译gdal之前需要安装gdal依赖的组件，gdal所依赖的组件可以在官网文档找到，可以根据自己的开发需求来下载编译相应的组件，在这里仅支持常用的数据及功能，所以就只下载了sqlite，libtiff，proj者几个依赖组件，下载的地址如下：
sqlite：https://www.sqlite.org/download.html ，根据自身的操作系统选择要下载的二进制文件。
sqlite下载
libtiff：https://download.osgeo.org/libtiff/，我这里选择的是4.6.0版本。
proj：https://proj.org/en/9.3/download.html。
gdal：https://download.osgeo.org/gdal/，我下载的是3.8.2版本。
以上源码包已经上传，以上链接访问不了的可以直接下载：下载gdal相关源码包

Step.2 编译Sqlite

2.1 将之前下载的sqlite的三个压缩包全部解压到一个目录下。
解压sqlite

2.1 在vs中新建一个名为SqliteCompile的空项目，将sqlite3.c和sqlite3.def文件导入源文件，将sqlite3.h和sqlite3ext.h导入头文件。
vs创建空项目
2.3 配置项目属性：
（1）配置平台和生成的目标类型（lib静态库）
配置项目属性1
（2）配置预处理器定义：

在预处理器定义中填入以下配置：

_USRDLL
SQLITE_ENABLE_RTREE
SQLITE_ENABLE_COLUMN_METADATA
SQLITE_ENABLE_FTS5
SQLITE_ENABLE_UNLOCK_NOTIFY

（3）设置模块定义文件：

（4）编辑模块定义文件，在sqlite3.def文件后添加 sqlite3_unlock_notify：

（5）生成Release静态库：

可以在项目目录中看到已经生成了lib静态库：
生成的lib静态库
（6）拷贝文件至指定目录：在sqlite的成品目录下新建bin, lib, include三个目录，bin目录放入解压的exe可执行文件，include目录中放入.h头文件，lib目录中放入上一步生成的lib库文件：

Step.3 编译libtiff

（1）将之前下载的libtiff源码包解压
（2）打开CMake，输入源码目录和build目录（libtiff源码目录下的build目录），点击Configure按钮。
编译libtiff CMake配置
（3）配置vs的版本和生成的平台，配置好之后点击Finish，然后点击主界面的Configure：
在这里插入图片描述
（4）输出框打印了Configuring done即说明配置成功了，可以修改安装libtiff的路径，搜索框中搜索“CMAKE_INSTALL_PREFIX”，设置安装路径，之后点击Generate生成文件：
配置生成路径
生成成功打印“Generating done”，这时可以在build目录中看到生成了vs的项目文件，点击“Open Project”按钮打开文件：
生成的vs解决方案文件
打开项目文件
（5）在VS中设置生成Release版本及平台（和之前的sqlite保持一致，后面的编译过程也是如此），生成ALL_BUILD和INSTALL两个项目，生成成功后在之前CMAKE设置的“CMAKE_INSTALL_PREFIX”路径下可以看到生成的文件。
生成libtiff
生成的libtiff文件

Step.4 编译proj

（1）将下载的proj源码包解压，打开CMake，选择源码目录和build目录（在proj源码目录下新建build目录），设置完成后点击Configure按钮，设置vs版本和生成的平台：
在这里插入图片描述
（2）生成过程中会报错，查看日志是因为没有找到sqlite3，这里搜索SQLITE3配置项，设置sqlite3的include目录、lib文件和可执行文件，顺便再把生成目标文件的目录一并设置了，设置好之后再次点击Configure：
设置sqlite3相关路径
设置proj的生成目标路径
（3）配置后还是报错，查看日志发现找不到TIFF，这里参考上一个步骤的方法搜索TIFF相关的配置，配置libtiff的include目录和lib路径，配置后再次Configure：
配置tiff的路径
（4）配置完成后还是报错，日志中打印缺少Curl，这里可以取消ENABLE_CURL的勾选使其不依赖curl，再次Configure。另外，如果本地访问不了github的话会报拉取代码失败的错误，这时可以取消BUILD_TESTING选项的勾选。
在这里插入图片描述

（5）还是报错“projsync requires Curl”，因为我们没有编译Curl，而projsync依赖Curl，自然配置projsync也就失败了，这里可以去掉BUILD_PROJSYNC的选项

（6）打印Configuring done即说明配置完成，再点击Generate按钮生成项目文件，打印“Generating done”即说明生成成功：
在这里插入图片描述
（7）点击打开项目按钮，在vs中设置生成Release版本，选择正确的平台，生成ALL_BUILD和INSTALL两个项目，生成成功后在之前设置的“CMAKE_INSTALL_PREFIX”路径下生成了PROJ相关的文件：

在这里插入图片描述

至此，编译proj的前序工作就完成了，下面就可以开始编译gdal了。

[TIPS] CMake输入参数时建议不要直接复制到文本框，最好使用选择目录活文件的方式填入，编译proj的时候由于CMake配置目录的斜杠与反斜杠问题导致一个模块编译失败，定位了很久。

Step.5 编译gdal

（1）解压下载的gdal源码包，在解压后gdal的跟路径下创建build目录用于存放CMake生成的临时文件。打开CMake，选择源码目录和build目录。
在这里插入图片描述
（2）点击Configure，设置平台类型和vs的版本后进行配置，发现报找不到PROJ的错误，配置proj的路径和生成二进制的路径，再点击配置。

配置输出路径
（3）稍等片刻后会出现Configuring done，这里一定要注意，虽然Configure完成了，但是我们并没有配置tiff和sqlite的依赖，后面在编译和开发的时候大概率会有问题，所以这里把sqlite和tiff的路径给配置上，当然，这里有很多其他的配置项，后面有时间研究一下对应的功能。
配置sqlite
（4）配置完之后点击Generate生成项目文件，然后点击打开项目按钮。
在这里插入图片描述
（5）在vs中设置生成Release版本和平台类型，依次生成ALL_BUILD和INSTALL两个项目，生成成功后可以看到目标路径下生成了编译好的二进制文件和一些数据文件。

Step.6 环境验证

通过以上步骤在本地已经配置好了gdal，现在在vs中新建一个c++项目来简单验证一下可用性，这个代码的功能也很简单，就是先注册gdal然后加载一副图像，如果正常执行就说明配置正确。

#include <iostream>
#include <gdal.h>
#include <gdal_priv.h>
using namespace std;

int main() {
	GDALDataset* poDataset;
	GDALAllRegister();
	poDataset = (GDALDataset*)GDALOpen("pic.tif", GA_ReadOnly);
	if (poDataset == NULL)
	{
		cout << "GDAL Configure OK";
	}
	return 0;
}

在执行前还需要配置下头文件和库的目录，在项目的属性中分别配置编译gdal生成的include目录，lib目录和lib文件路径：
配置附加包含目录
配置附加库目录
配置依赖项
这样配置后还没完，因为依赖了一些资源文件，所以需要把依赖的资源文件添加到项目中。在解决方案管理器中添加gdal.dll，proj_9_3.dll，tiff.dll三个资源文件，每个资源文件右键设置属性，设置类型为复制文件。
设置资源文件类型
至此，gdal的开发环境搭建就ok了，就可以进行基于gdal的一些开发了，ENJOY!!!