FindGDAL — CMake 4.3.1 Documentation

# FindGDAL

Deprecated since version 4.0: GDAL 3.5 and above provide a `GDALConfig.cmake` package configuration file. Call `find_package(GDAL CONFIG)` to find it directly and avoid using this find module. For further details, see GDAL's documentation on CMake integration.

Finds Geospatial Data Abstraction Library (GDAL):

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

## Imported Targets

This module provides the following Imported Targets:

`GDAL::GDAL`

  Added in version 3.14.

  Target encapsulating the GDAL usage requirements, available only if GDAL has been found.

## Result Variables

This module defines the following variables:

`GDAL_FOUND`

  Boolean indicating whether (the requested version of) GDAL was found.

`GDAL_VERSION`

  Added in version 3.14.

  The version of GDAL found.

`GDAL_INCLUDE_DIRS`

  Include directories for GDAL headers.

`GDAL_LIBRARIES`

  Libraries to link to GDAL.

## Cache Variables

The following cache variables may also be set:

`GDAL_INCLUDE_DIR`

  The directory containing `<gdal.h>`.

`GDAL_LIBRARY`

  The libgdal library file.

## Hints

The following variables may be set to modify the search strategy:

`GDAL_DIR` or `GDAL_ROOT`

  Set one of these environment variables to specify the GDAL installation prefix.

`FindGDAL_SKIP_GDAL_CONFIG`

  If set, `gdal-config` will not be used. This can be useful if there are GDAL libraries built with autotools (which provide the tool) and CMake (which do not) in the same environment.

`GDAL_ADDITIONAL_LIBRARY_VERSIONS`

  Extra versions of library names to search for.

## Examples

Finding GDAL in config mode without using this module and linking its imported target to a project target:

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