GDAL3.1.2+VS2015编译指南：如何用CMake搞定PROJ6依赖？附现成编译好的lib文件

GDAL 3.1.2与VS2015深度编译实战CMake可视化配置与PROJ6依赖全解析在空间数据处理领域GDAL作为地理信息系统的瑞士军刀其重要性不言而喻。但对于需要在Windows平台下进行二次开发的科研人员来说从源码编译GDAL往往成为项目启动的第一道门槛。特别是GDAL 3.0版本引入PROJ6作为强制依赖后编译环境的搭建变得更加复杂。本文将彻底解决这个痛点通过CMake可视化配置方案带你一步步完成整个编译链条的构建。1. 环境准备与工具链配置1.1 基础软件安装编译GDAL 3.1.2需要准备以下工具链Visual Studio 2015确保已安装C桌面开发工作负载CMake 3.18从官网获取Windows x64版本安装包Git for Windows用于源码下载和版本管理推荐使用Chocolatey包管理器一键安装choco install -y cmake --version 3.18.3 choco install -y git1.2 目录结构规划合理的目录结构能避免后续路径混乱问题C:\GIS_DEV\ ├── sources\ # 存放所有源码 │ ├── sqlite\ │ ├── proj\ │ └── gdal\ ├── build\ # 各组件构建目录 └── output\ # 最终输出目录 ├── x64\ │ ├── debug\ │ └── release\2. SQLite3编译PROJ6的基础依赖2.1 源码获取与准备SQLite作为PROJ6的底层存储引擎需要优先编译cd C:\GIS_DEV\sources curl -o sqlite-amalgamation-3330000.zip https://sqlite.org/2020/sqlite-amalgamation-3330000.zip unzip sqlite-amalgamation-3330000.zip -d sqlite2.2 VS2015工程配置关键点创建Win32控制台项目时需特别注意预处理器定义_USRDLL; SQLITE_ENABLE_RTREE; SQLITE_ENABLE_COLUMN_METADATA; SQLITE_ENABLE_FTS5模块定义文件在sqlite3.def末尾添加EXPORTS sqlite3_unlock_notify提示x64平台配置完成后建议保存为属性表(.props)文件方便复用3. PROJ6编译CMake可视化配置详解3.1 源码获取与CMake初始配置git clone --branch 6.3.2 https://github.com/OSGeo/PROJ.git C:\GIS_DEV\sources\proj使用CMake GUI配置时重点关注以下参数参数名推荐值说明SQLITE3_INCLUDE_DIRC:/GIS_DEV/output/x64/includeSQLite头文件目录SQLITE3_LIBRARYC:/GIS_DEV/output/x64/lib/sqlite3.libSQLite库文件路径CMAKE_INSTALL_PREFIXC:/GIS_DEV/output/x64安装目录3.2 常见错误解决方案问题1找不到sqlite3.dll将编译好的sqlite3.dll放入C:\Windows\System32问题2PROJ.db路径错误设置环境变量set PROJ_LIBC:\GIS_DEV\output\x64\share\proj4. GDAL 3.1.2编译CMake全流程实战4.1 源码获取与目录准备git clone --branch v3.1.2 https://github.com/OSGeo/gdal.git C:\GIS_DEV\sources\gdal mkdir C:\GIS_DEV\build\gdal4.2 CMake关键配置参数在CMake GUI中设置以下核心参数set(PROJ_INCLUDE_DIR C:/GIS_DEV/output/x64/include) set(PROJ_LIBRARY C:/GIS_DEV/output/x64/lib/proj.lib) set(CMAKE_BUILD_TYPE Release) set(BUILD_SHARED_LIBS ON)4.3 编译后文件结构成功编译后将生成gdal-3.1.2/ ├── bin/ # gdal301.dll等运行时文件 ├── include/ # 所有头文件 ├── lib/ # 静态库和导入库 └── share/ # 数据文件和样例5. 项目集成与测试验证5.1 VS2015项目属性配置创建属性表GDAL.props包含PropertyGroup GDAL_DIRC:\GIS_DEV\output\x64/GDAL_DIR /PropertyGroup ItemDefinitionGroup ClCompile AdditionalIncludeDirectories$(GDAL_DIR)\include;%(AdditionalIncludeDirectories)/AdditionalIncludeDirectories /ClCompile Link AdditionalLibraryDirectories$(GDAL_DIR)\lib;%(AdditionalLibraryDirectories)/AdditionalLibraryDirectories AdditionalDependenciesgdal_i.lib;%(AdditionalDependencies)/AdditionalDependencies /Link /ItemDefinitionGroup5.2 简单功能测试代码#include gdal_priv.h #include iostream int main() { GDALAllRegister(); auto dataset (GDALDataset*)GDALOpen(test.tif, GA_ReadOnly); if(dataset) { std::cout 波段数: dataset-GetRasterCount() \n; std::cout 影像大小: dataset-GetRasterXSize() x dataset-GetRasterYSize() \n; GDALClose(dataset); } return 0; }6. 高级配置与性能优化6.1 多版本共存管理通过符号链接实现版本切换New-Item -ItemType SymbolicLink -Path C:\GIS_DEV\output\current -Target C:\GIS_DEV\output\x646.2 常用编译选项对比选项推荐值影响范围BUILD_SHARED_LIBSON生成DLL而非静态库GDAL_ENABLE_DRIVER_XXX按需启用减少不必要的驱动编译CMAKE_BUILD_TYPERelease生产环境使用在实际项目中GDAL的编译问题往往出现在依赖项版本不匹配上。建议使用vcpkg等包管理器辅助管理依赖关系可以大幅降低环境配置的复杂度。