FindGDAL

自 4.0 版本起已弃用： GDAL 3.5 及更高版本提供了 GDALConfig.cmake 包配置文件。请直接调用 find_package(GDAL CONFIG) 来查找它，避免使用此查找模块。更多详情，请参阅 GDAL 关于 CMake 集成的文档。

查找地理空间数据抽象库 (GDAL)

find_package(GDAL [<version>] [...])

导入的目标

此模块提供以下 导入目标

GDAL::GDAL

3.14 版新增。

封装 GDAL 使用需求的 Target，仅在找到 GDAL 时可用。

结果变量

此模块定义了以下变量

GDAL_FOUND

布尔值，指示是否找到了 (请求版本的) GDAL。

GDAL_VERSION

3.14 版新增。

找到的 GDAL 版本。

GDAL_INCLUDE_DIRS

GDAL 头文件的包含目录。

GDAL_LIBRARIES

链接到 GDAL 所需的库。

缓存变量

以下缓存变量也可以设置

GDAL_INCLUDE_DIR

包含 <gdal.h> 的目录。

GDAL_LIBRARY

libgdal 库文件。

提示

以下变量可用于修改搜索策略

GDAL_DIR 或 GDAL_ROOT

设置其中一个环境变量来指定 GDAL 的安装前缀。

FindGDAL_SKIP_GDAL_CONFIG

如果设置，将不会使用 gdal-config。这在同一环境中存在用 autotools 构建 (提供此工具) 和用 CMake 构建 (不提供此工具) 的 GDAL 库时可能很有用。

GDAL_ADDITIONAL_LIBRARY_VERSIONS

要搜索的额外库名版本。

示例

在不使用此模块且将其导入的 Target 链接到项目 Target 的情况下，以配置模式查找 GDAL

find_package(GDAL CONFIG)
target_link_libraries(example PRIVATE GDAL::GDAL)