curl-curl/CMake
Viktor Szakats 8fce3e17e6
cmake: add CMake Config-based dependency detection
After limiting `find_package()`/`find_dependency()` calls to curl local
Find modules via the `MODULES` keyword, it became possible to detect
dependencies via CMake Configs from within those local Find modules, by
calling `find_package()` again with the `CONFIG` keyword. This patch
implements this. Then maps detection results to the result variables and
curl-specific imported targets the rest of the build expects.

Also honor recently introduced `*_USE_STATIC_LIBS` (experimental) flags
to map to the static target when requested.

This adds CMake Configs as an alternative to the existing `pkg-config`
and `find_path()`/`find_library()` auto-detection methods.

Enabled by default for MSVC, outside vcpkg and when not cross-building.
To enable for other cases, or override the default, you can use
`-DCURL_USE_CMAKECONFIG=ON` or `OFF`.

When enabled, Config detection happens after `pkg-config` and before
`find_path()`/`find_library()`. Using CMake's built-in options, you may
also manually point to the absolute directory holding Config files:

`Libssh2_DIR`, `MbedTLS_DIR`, `NGHTTP2_DIR`, `NGHTTP3_DIR`,
`NGTCP2_DIR` v1.19.0+ (with non-fork OpenSSL only), `Zstd_DIR` v1.4.5+

E.g. `-DMbedTLS_DIR=/path/to/mbedtls/lib/cmake/MbedTLS`

These dependencies typically need to be built with CMake to support
this.

Tagged as experimental.

Refs:
#20013 #19156 #19117
https://github.com/curl/curl/pull/20784#issuecomment-3984318492

Depends-on: fad1ebaecc #20840
Follow-up to 91e06fde1b #20784
Follow-up to 26c39d8df1 #20015

Closes #20814
2026-03-21 18:52:31 +01:00
..
cmake_uninstall.in.cmake cmake: match filename suffixes with file content 2025-12-20 11:34:27 +01:00
curl-config.in.cmake cmake: add CMake Config-based dependency detection 2026-03-21 18:52:31 +01:00
CurlSymbolHiding.cmake build: merge TrackMemory (CURLDEBUG) into debug-enabled option 2026-01-19 18:43:17 +01:00
CurlTests.c badwords: avoid 'simply' 2026-03-10 19:34:06 +01:00
FindBrotli.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindCares.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindGnuTLS.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindGSS.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindLDAP.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindLibbacktrace.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindLibgsasl.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindLibidn2.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindLibpsl.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindLibssh2.cmake cmake: add CMake Config-based dependency detection 2026-03-21 18:52:31 +01:00
FindLibssh.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindLibuv.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindMbedTLS.cmake cmake: add CMake Config-based dependency detection 2026-03-21 18:52:31 +01:00
FindNettle.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindNGHTTP2.cmake cmake: add CMake Config-based dependency detection 2026-03-21 18:52:31 +01:00
FindNGHTTP3.cmake cmake: add CMake Config-based dependency detection 2026-03-21 18:52:31 +01:00
FindNGTCP2.cmake cmake: add CMake Config-based dependency detection 2026-03-21 18:52:31 +01:00
FindQuiche.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindRustls.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindWolfSSL.cmake cmake: drop support for CMake 3.17 and older 2026-03-21 13:24:47 +01:00
FindZstd.cmake cmake: add CMake Config-based dependency detection 2026-03-21 18:52:31 +01:00
Macros.cmake cmake: resolve imported targets recursively when generating libcurl.pc 2026-03-16 11:57:56 +01:00
OtherTests.cmake build: check MSG_NOSIGNAL directly, drop detection and interim macro 2026-02-11 14:51:08 +01:00
PickyWarnings.cmake curl/curl.h: replace recursive macros with C++-friendly method to enforce 3 args 2026-03-21 13:21:06 +01:00
unix-cache.cmake build: assume snprintf() in mprintf, drop feature check 2026-03-21 13:30:37 +01:00
Utilities.cmake cmake: fix LOCATION property access condition (debug) 2026-03-06 15:35:27 +01:00
win32-cache.cmake build: drop unused snprintf() feature check on Windows 2026-03-02 22:40:29 +01:00