1. 项目背景与核心价值
在GIS（地理信息系统）开发领域，PROJ和GEOS是两个至关重要的基础库。PROJ负责处理地理坐标转换，而GEOS则提供了强大的空间几何运算能力。许多开发者都遇到过这样的困境：需要在自己的项目中集成这两个库，但官方提供的构建方式要么过于复杂，要么难以跨平台统一。
我最近在为一个跨平台GIS项目做技术预研时，发现手动编译这两个库不仅耗时费力，而且在不同操作系统上构建流程差异很大。于是决定开发一套通用的CMake构建脚本，实现以下目标：
- 一键完成PROJ和GEOS的下载、编译和安装
- 自动处理依赖关系（如SQLite3、TIFF等）
- 支持Windows/Linux/macOS多平台
- 可灵活集成到现有CMake项目中
2. 环境准备与工具链选型
2.1 基础环境要求
在开始之前，需要确保系统已安装以下工具：
- CMake 3.12或更高版本
- Git（用于源码下载）
- 对应平台的编译工具链：
- Windows: Visual Studio 2019+ 或 MinGW
- Linux: GCC 9+ 或 Clang
- macOS: Xcode命令行工具
注意：PROJ 8.0+需要C++17支持，请确保编译器版本足够新。我曾在Ubuntu 18.04上遇到问题，最终通过升级GCC到9.0解决。
2.2 第三方依赖管理
这两个库有一些共同的依赖项，我的方案是：
- 对于小型依赖（如libtiff、sqlite3），直接使用CMake的FetchContent模块在线获取
- 对于大型依赖（如GDAL），提供选项让用户自行安装
- 通过设置CMAKE_PREFIX_PATH变量实现依赖查找
cmake复制# 示例：SQLite3依赖处理
include(FetchContent)
FetchContent_Declare(
sqlite3
URL https://sqlite.org/2023/sqlite-amalgamation-3420000.zip
)
FetchContent_MakeAvailable(sqlite3)
3. 核心构建脚本解析
3.1 PROJ构建模块
PROJ的构建有几个关键点需要注意：
- 数据文件（proj.db）的部署位置
- 线程安全选项的开启
- 与SQLite3的链接方式
这是我优化后的PROJ构建脚本核心部分：
cmake复制# proj.cmake
set(PROJ_VERSION 9.2.1)
FetchContent_Declare(
proj
GIT_REPOSITORY https://github.com/OSGeo/PROJ.git
GIT_TAG ${PROJ_VERSION}
)
# 关键配置选项
option(BUILD_TESTING "Build PROJ tests" OFF)
option(BUILD_PROJSYNC "Build projsync utility" OFF)
FetchContent_MakeAvailable(proj)
# 处理数据文件安装
install(
DIRECTORY ${proj_SOURCE_DIR}/data
DESTINATION share/proj
)
3.2 GEOS构建模块
GEOS的构建相对简单，但需要注意：
- C++11特性的兼容性
- 静态库/动态库的选择
- 精度控制选项
核心构建配置如下：
cmake复制# geos.cmake
set(GEOS_VERSION 3.11.2)
FetchContent_Declare(
geos
URL https://download.osgeo.org/geos/geos-${GEOS_VERSION}.tar.bz2
)
# 重要性能选项
option(GEOS_ENABLE_INLINE "Enable inline optimizations" ON)
option(GEOS_ENABLE_ASSERT "Enable assertions" OFF)
FetchContent_MakeAvailable(geos)
4. 跨平台构建实战
4.1 Windows平台特别处理
在Windows上构建时，有几个常见陷阱：
- 路径长度限制（建议在短路径如C:\build下操作）
- 动态库的运行时依赖
- 字符集设置（必须使用Unicode）
这是我的解决方案：
cmake复制if(WIN32)
# 设置输出目录结构
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/lib)
# 处理Windows导出符号
add_definitions(-DGEOS_DLL_EXPORT)
endif()
4.2 Linux/macOS优化
在Unix-like系统上，我们可以利用pkg-config简化配置：
cmake复制find_package(PkgConfig REQUIRED)
pkg_check_modules(SQLITE3 REQUIRED sqlite3)
# 设置rpath确保动态库可找到
set(CMAKE_INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/lib")
5. 集成到现有项目
5.1 作为子模块使用
推荐将这套脚本作为git子模块添加到项目中：
bash复制git submodule add https://github.com/yourname/proj-geos-builder.git thirdparty
然后在主CMakeLists.txt中：
cmake复制include(thirdparty/proj.cmake)
include(thirdparty/geos.cmake)
target_link_libraries(your_target PRIVATE PROJ::proj GEOS::geos)
5.2 自定义构建选项
通过CMake选项提供灵活性：
cmake复制option(BUILD_PROJ "Build PROJ library" ON)
option(BUILD_GEOS "Build GEOS library" ON)
option(DOWNLOAD_MISSING_DEPS "Download missing dependencies" ON)
6. 常见问题与解决方案
6.1 编译错误排查表
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
| 'sqlite3.h' not found | SQLite3路径未正确设置 | 设置-DSQLITE3_INCLUDE_DIR=... |
| 链接错误：未定义符号 | 库顺序不正确 | 调整target_link_libraries顺序 |
| 运行时数据文件找不到 | PROJ_DATA未设置 | export PROJ_DATA=/path/to/proj-data |
6.2 性能优化技巧
-
对于生产环境，建议：
- 开启GEOS_INLINE和PROJ_OPTIMIZE_FOR_SPEED
- 使用静态链接减少运行时开销
- 禁用调试符号（-DCMAKE_BUILD_TYPE=Release）
-
内存管理：
cpp复制// 使用RAII包装器避免内存泄漏 GEOSContextHandle_t ctx = GEOS_init_r(); // ...操作代码... GEOS_finish_r(ctx);
7. 进阶应用与扩展
7.1 自定义坐标转换管道
结合PROJ的管道语法，可以实现复杂坐标转换：
cpp复制PJ* P = proj_create_crs_to_crs(
PJ_DEFAULT_CTX,
"EPSG:4326", // WGS84
"+proj=utm +zone=32 +datum=WGS84", // UTM Zone 32N
nullptr);
7.2 空间分析实战示例
使用GEOS进行空间关系判断：
cpp复制GEOSGeometry* geom1 = GEOSGeomFromWKT("POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))");
GEOSGeometry* geom2 = GEOSGeomFromWKT("POINT(0.5 0.5)");
int contains = GEOSContains(geom1, geom2);
这套构建系统已经在多个实际项目中验证，包括一个跨平台的GIS数据处理工具和一个实时地图渲染引擎。最大的收获是统一了团队在不同操作系统下的开发环境，新成员上手时间从原来的2天缩短到30分钟。