联合编译C++版本gdal编译过程文档

gdal联合编译C++版本proj.4、geos、hdf4、hdf5、netcdf

各依赖库源代码版本及下载地址

gdal

Proj.4

geos

HDF4

HDF5

netCDF

编译环境及工具版本

编译安装

1、 编译geos

2、 编译proj.4

3、 修改gdal的编译配置文件make.opt

4、 编译gdal

编译及运行过程中可能出现的问题及对应的解决方法

测试gdal是否正确联合编译其他三方库的命令

测试hdf

测试proj.4

测试netCDF

gdal联合编译C++版本proj.4、geos、hdf4、hdf5、netcdf

各依赖库源代码版本及下载地址

gdal

版本：2.4.4

下载地址：https://gdal.org/download.html

说明：下载的是源码文件，也是本地联合编译的中心文件，其他四个三方库是融入到gdal中调用的

Proj.4

版本：4.9.3

下载地址：https://proj.org/download.html

说明：源码文件，需要使用vs进行编译，重要文件在src文件夹中

geos

版本：3.7.3

下载地址：http://download.osgeo.org/geos

说明：源码，需要使用vs进行编译，重要文件是include文件夹和src文件夹下的geos_c_i.lib文件

HDF4

版本：4.2.6

下载地址：https://support.hdfgroup.org/ftp/HDF/releases/HDF4.2.6/bin/windows/

说明：是已经编译好了的文件，也包含源码，重要文件在dll文件夹中

HDF5

版本：1.10.3

下载地址：https://support.hdfgroup.org/ftp/HDF5/releases/hdf5-1.10/hdf5-1.10.3/bin/

说明：下载的文件解压后是一个.msi文件，双击可安装，安装之后得到一个文件夹，其中的内容和HDF4中的内容相似，重要文件在bin文件夹中

netCDF

版本：4.7.2-NC4

下载地址： http://www.unidata.ucar.edu/downloads/netcdf/ftp/netCDF4.7.2-NC4-64.exe

说明：下载所得是一个.exe可执行文件，双击安装之后得到一个包含三个文件夹的文件夹，重要文件在bin当中

编译环境及工具版本

Windows x64、vs2015 x64 本机工具提示符

编译安装

注：示例文件组织模式如下：

1、 编译geos

进入geos文件夹，如果可以找到autogen.bat和makefile.vc两个文件，则证明文件夹正确，打开vs2015 x64 本机工具提示符，cd到geos文件夹，即autogen.bat和makefile.vc所在文件夹，先后运行autogen.bat和nmake /f makefile.vc src_dir

2、 编译proj.4

cd转到proj.4的文件夹，其中应该包含makefile.vc，运行nmake /f makefile.vc install-all

3、 修改gdal的编译配置文件make.opt

进入gdal文件夹，找到make.opt文件并使用notepad++打开，修改gdal安装路径

使用搜索工具，搜索GDAL_HOME，找到如57行的位置(不同版本位置可能会有差别)，将值改为自己准备安装gdal的文件夹

修改编译版本为64位

搜索win64，找到如191行的位置，去掉其前面的#号(#号代表注释)

集成geos数据读取路径

搜索geos，找到如621~623行的位置，去掉前面的#号，将如621行GEOS_DIR的值修改为geos文件夹的路径，如geos文件夹内的内容未做修改，可将622和623行中的内容修改为截图所示

集成HDF4数据读取路径

搜索hdf4，找到如441~443行的位置，去掉前面的#号

将441行HDF4_DIR修改为HDF4文件夹的路径，其余内容与图上一致，442行为dll文件夹下的.lib文件列表，完整的内容为：$(HDF4_DIR)\dll\hd426m.lib $(HDF4_DIR)\dll\hm426m.lib $(HDF4_DIR)\lib\hd426.lib $(HDF4_DIR)\lib\hm426.lib Ws2_32.lib

集成HDF5数据读取路径

搜索hdf5，找到如451~453行的位置，去掉前面的#号

将452行HDF5_DIR的值修改为HDF5文件夹的路径，其余内容与图上一致，453行完整的内容为：$(HDF5_DIR)\lib\hdf5_cpp.lib $(HDF5_DIR)\lib\hdf5_hl.lib $(HDF5_DIR)\lib\hdf5_hl_cpp.lib $(HDF5_DIR)\lib\hdf5_tools.lib $(HDF5_DIR)\lib\libhdf5.lib $(HDF5_DIR)\lib\libhdf5_cpp.lib $(HDF5_DIR)\lib\libhdf5_hl.lib $(HDF5_DIR)\lib\libhdf5_hl_cpp.lib $(HDF5_DIR)\lib\libszip.lib $(HDF5_DIR)\lib\libzlib.lib $(HDF5_DIR)\lib\szip.lib $(HDF5_DIR)\lib\zlib.lib

集成netCDF数据读取路径

搜索netcdf，找到如541~545行的位置，去掉前面的#号

将544行NETCDF_LIB和545行NETCDF_INC_DIR中的D:\gdal-pgh45n替换为netcdf所在的文件夹路径，保证按照所写路径可以找到netcdf.lib和include文件夹

4、 编译gdal

将vs2015 x64 本机工具cd转到gdal文件夹，即make.opt所在文件夹，先后运行

nmake /f makefile.vc

nmake /f makefile.vc install

nmake /f makefile.vc devinstall

运行结束之后指定的安装路径下会出现如下的多个文件夹

编译及运行过程中可能出现的问题及对应的解决方法

1)、NMAKE:fatal error U1077. return code 0x460

工程中连接了一个lib文件，链接的时候却出现不能解析的外部符号。大概率是32位和64位不兼容问题，也有可能是包含的lib是错的。可以从以下几个方面检查：1、gdal的配置文件make.opt中的win64=yes是否打开以及是否将注释符号去掉；2、vs工具提示符使用的版本不对，使用其他版本的工具重试；3、参与编译的文件存在32版本

2)、NMAKE:fatal error U1077. return code 0x49d

文件路径不对，查询到文件不存在，可以返回到make.opt挨个检查文件路径是否准确，可以沿着设置的路径依次进入检查，避免漏检

3)运行安装的gdal中的bin文件夹下的.exe提示缺少某.dll文件，一般在某个依赖库的bin文件或其他文件下有该.dll文件，对于dpapi.dll的缺失可以在网上搜索下载

4)当所有的.dll都不缺失后，运行上述.exe文件提示netcdf定位H5Literate失败，这是由于netcdf中的hdf5与gdal中引用的hdf5版本冲突导致的，笔者采用的办法是寻找与netcdf中的gdf5中的一样的hdf5引入到gdal中

注：gdal运行依赖库所需的.dll文件

测试gdal是否正确联合编译其他三方库的命令

测试时采用dos命令行启动.exe读取或计算指定路径下的文件，根据运行结果及提示信息判断gdal是否正确集成对应的三方库，因此在输入测试命令前需要提前cd将当前路径转到安装的gdal的bin文件夹下

测试hdf

命令：gdalinfo.exe 目标.HDF文件

提示该.HDF文件如下图所示的各种数据信息则证明安装成功，否则安装失败

测试proj.4

命令：gdalwarp.exe" -t_srs “PROJCS[“WGS_1984_Web_Mercator_Auxiliary_Sphere”,GEOGCS[“GCS_WGS_1984”,DATUM[“D_WGS_1984”,SPHEROID[“WGS_1984”,6378137.0,298.257223563]],PRIMEM[“Greenwich”,0.0],UNIT[“Degree”,0.0174532925199433]],PROJECTION[“Mercator_Auxiliary_Sphere”],PARAMETER[“False_Easting”,0.0],PARAMETER[“False_Northing”,0.0],PARAMETER[“Central_Meridian”,0.0],PARAMETER[“Standard_Parallel_1”,0.0],PARAMETER[“Auxiliary_Sphere_Type”,0.0],UNIT[“Meter”,1.0],AUTHORITY[“Esri”,3857]]” 源tif文件 目标tif文件

测试netCDF

命令：gdalwarp.exe -t_srs “+proj=latlong +datum=WGS84” -te 112.0 28.4 116.7 32.3 -tr 0.05 0.05 -dstnodata -9999 -overwrite NETCDF:源.nc文件路径:AOT_Merged 目标.nc文件路径，如gdalwarp.exe -t_srs “+proj=latlong +datum=WGS84” -te 112.0 28.4 116.7 32.3 -tr 0.05 0.05 -dstnodata -9999 -overwrite NETCDF:F:\H08_20200727_0100_1HARP030_FLDK.02401_02401.nc:AOT_Merged F:\1.tif

错误提示：

1) 若提示ERROR 4: `NETCDF:F:\H08_20200727_0100_1HARP030_FLDK.02401_02401.nc:AOT_Merged’ does not exist in the file system, and is not recognized as a supported dataset name.说明netCDF和gdal版本不兼容，需要更换netcdf版本，笔者是由netCDF3更换为了netCDF4解决了这个问题

2) 若出现如图所示的提示

说明netCDF中的hdf5版本号是1.10.3，而gdal中的hdf5版本号是1.8.19，两者不一致，需要将gdal中的版本更换为和netCDF中的一样，即需要重新下载1.10.3版本的hdf联合编译gdal

附：

联合编译好的gdal.

单独编译好但还没做集成的文件

完全没改动过的源文件