Valhalla项目在Ubuntu 20.04上GEOS库的配置问题解决方案

问题背景

Valhalla是一款开源的高性能路由引擎，在构建过程中需要依赖GEOS（Geometry Engine, Open Source）库。在Ubuntu 20.04 LTS系统上，用户可能会遇到一个典型的构建错误：CMake无法找到GEOS库，即使系统已经安装了相关软件包。

问题现象

当用户尝试构建Valhalla项目时，CMake配置阶段会报错：

-- Checking for module 'geos'
--   No package 'geos' found
CMake Error at /usr/share/cmake-3.16/Modules/FindPkgConfig.cmake:463 (message):
  A required package was not found

问题根源分析

这个问题源于Ubuntu 20.04和Debian Buster发行版中libgeos-dev软件包的一个打包问题。虽然这些发行版确实包含了GEOS库的头文件和库文件，但缺少了关键的geos.pc文件，这个文件是pkg-config工具用来定位库的位置和版本信息的配置文件。

解决方案

方法一：手动创建pkg-config文件

1. 使用root权限创建文件/usr/lib/pkgconfig/geos.pc
2. 写入以下内容：

prefix=/usr
exec_prefix=${prefix}
includedir=${prefix}/include
libdir=${exec_prefix}/lib

Name: GEOS
Description: Geometry Engine, Open Source - C API
Requires:
Version: 3.12.0
Cflags: -I${includedir}
Libs: -L${libdir} -lgeos_c
Libs.private: -lgeos -lstdc++ -lm

3. 保存文件后，CMake应该就能正确找到GEOS库了

方法二：回退到旧版本Valhalla

如果不想手动创建配置文件，可以考虑使用Valhalla 3.3.0或3.4.0版本，这些版本使用了自定义的FindGEOS.cmake模块，不依赖pkg-config工具。

技术细节

1. pkg-config机制：这是Linux系统上用来帮助构建系统定位依赖库的工具，通过.pc文件提供库的元数据信息。

2. GEOS库结构：在Ubuntu 20.04中，GEOS库被拆分为多个包：

   • libgeos++-dev：C++开发文件
   • libgeos-3.8.0：C++库
   • libgeos-c1v5：C接口库
   • libgeos-dev：开发文件

3. CMake查找机制：Valhalla项目使用CMake的pkg_check_modules命令来查找GEOS库，这依赖于pkg-config工具和对应的.pc文件。

最佳实践建议

1. 对于生产环境，建议使用Docker容器来避免系统依赖问题
2. 定期检查系统依赖库的版本兼容性
3. 在构建失败时，可以检查/usr/lib/pkgconfig/目录下是否存在相关库的.pc文件

总结

Ubuntu 20.04上Valhalla构建过程中遇到的GEOS库问题是一个典型的发行版打包问题。通过手动创建pkg-config文件可以优雅地解决这个问题，同时也让我们理解到构建系统依赖管理的重要性。这种解决方案不仅适用于Valhalla项目，对于其他依赖GEOS库的项目也有参考价值。