mirror of
https://github.com/curl/curl.git
synced 2026-04-11 12:01:42 +08:00
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 to91e06fde1b#20784 Follow-up to26c39d8df1#20015 Closes #20814
187 lines
7.2 KiB
CMake
187 lines
7.2 KiB
CMake
#***************************************************************************
|
|
# _ _ ____ _
|
|
# Project ___| | | | _ \| |
|
|
# / __| | | | |_) | |
|
|
# | (__| |_| | _ <| |___
|
|
# \___|\___/|_| \_\_____|
|
|
#
|
|
# Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
#
|
|
# This software is licensed as described in the file COPYING, which
|
|
# you should have received as part of this distribution. The terms
|
|
# are also available at https://curl.se/docs/copyright.html.
|
|
#
|
|
# You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
|
# copies of the Software, and permit persons to whom the Software is
|
|
# furnished to do so, under the terms of the COPYING file.
|
|
#
|
|
# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
# KIND, either express or implied.
|
|
#
|
|
# SPDX-License-Identifier: curl
|
|
#
|
|
###########################################################################
|
|
# Find the ngtcp2 library
|
|
#
|
|
# This module accepts optional COMPONENTS to control the crypto library (these are
|
|
# mutually exclusive):
|
|
#
|
|
# - BoringSSL: Use `libngtcp2_crypto_boringssl`. (also for AWS-LC)
|
|
# - GnuTLS: Use `libngtcp2_crypto_gnutls`.
|
|
# - LibreSSL: Use `libngtcp2_crypto_libressl`. (requires ngtcp2 1.15.0+)
|
|
# - ossl: Use `libngtcp2_crypto_ossl`.
|
|
# - quictls: Use `libngtcp2_crypto_quictls`. (also for LibreSSL with ngtcp2 <1.15.0)
|
|
# - wolfSSL: Use `libngtcp2_crypto_wolfssl`.
|
|
#
|
|
# Input variables:
|
|
#
|
|
# - `NGTCP2_INCLUDE_DIR`: Absolute path to ngtcp2 include directory.
|
|
# - `NGTCP2_LIBRARY`: Absolute path to `ngtcp2` library.
|
|
# - `NGTCP2_CRYPTO_BORINGSSL_LIBRARY`: Absolute path to `ngtcp2_crypto_boringssl` library.
|
|
# - `NGTCP2_CRYPTO_GNUTLS_LIBRARY`: Absolute path to `ngtcp2_crypto_gnutls` library.
|
|
# - `NGTCP2_CRYPTO_LIBRESSL_LIBRARY`: Absolute path to `ngtcp2_crypto_libressl` library.
|
|
# - `NGTCP2_CRYPTO_OSSL_LIBRARY`: Absolute path to `ngtcp2_crypto_ossl` library.
|
|
# - `NGTCP2_CRYPTO_QUICTLS_LIBRARY`: Absolute path to `ngtcp2_crypto_quictls` library.
|
|
# - `NGTCP2_CRYPTO_WOLFSSL_LIBRARY`: Absolute path to `ngtcp2_crypto_wolfssl` library.
|
|
# - `NGTCP2_USE_STATIC_LIBS`: Configure for static ngtcp2 libraries.
|
|
#
|
|
# Defines:
|
|
#
|
|
# - `NGTCP2_FOUND`: System has ngtcp2.
|
|
# - `NGTCP2_VERSION`: Version of ngtcp2.
|
|
# - `CURL::ngtcp2`: ngtcp2 library target.
|
|
|
|
if(NGTCP2_FIND_COMPONENTS)
|
|
set(_ngtcp2_crypto_backend "")
|
|
foreach(_component IN LISTS NGTCP2_FIND_COMPONENTS)
|
|
if(_component MATCHES "^(BoringSSL|GnuTLS|LibreSSL|ossl|quictls|wolfSSL)")
|
|
if(_ngtcp2_crypto_backend)
|
|
message(FATAL_ERROR "NGTCP2: Only one crypto library can be selected")
|
|
endif()
|
|
set(_ngtcp2_crypto_backend ${_component})
|
|
endif()
|
|
endforeach()
|
|
|
|
if(_ngtcp2_crypto_backend)
|
|
string(TOLOWER "ngtcp2_crypto_${_ngtcp2_crypto_backend}" _crypto_library_lower)
|
|
string(TOUPPER "ngtcp2_crypto_${_ngtcp2_crypto_backend}" _crypto_library_upper)
|
|
endif()
|
|
endif()
|
|
|
|
set(_ngtcp2_pc_requires "libngtcp2")
|
|
if(_ngtcp2_crypto_backend)
|
|
list(APPEND _ngtcp2_pc_requires "lib${_crypto_library_lower}")
|
|
endif()
|
|
|
|
set(_tried_pkgconfig FALSE)
|
|
if(NOT DEFINED NGTCP2_INCLUDE_DIR AND
|
|
NOT DEFINED NGTCP2_LIBRARY)
|
|
if(CURL_USE_PKGCONFIG)
|
|
find_package(PkgConfig QUIET)
|
|
pkg_check_modules(_ngtcp2 ${_ngtcp2_pc_requires})
|
|
set(_tried_pkgconfig TRUE)
|
|
endif()
|
|
if(NOT _ngtcp2_FOUND AND CURL_USE_CMAKECONFIG)
|
|
find_package(ngtcp2 CONFIG QUIET)
|
|
# Skip using it if the crypto library target is not available
|
|
if(ngtcp2_CONFIG AND
|
|
NOT TARGET ngtcp2::${_crypto_library_lower}_static AND
|
|
NOT TARGET ngtcp2::${_crypto_library_lower})
|
|
unset(ngtcp2_CONFIG)
|
|
endif()
|
|
endif()
|
|
endif()
|
|
|
|
if(_ngtcp2_FOUND)
|
|
set(NGTCP2_FOUND TRUE)
|
|
set(NGTCP2_VERSION ${_ngtcp2_libngtcp2_VERSION})
|
|
if(NGTCP2_USE_STATIC_LIBS)
|
|
set(_ngtcp2_CFLAGS "${_ngtcp2_STATIC_CFLAGS}")
|
|
set(_ngtcp2_INCLUDE_DIRS "${_ngtcp2_STATIC_INCLUDE_DIRS}")
|
|
set(_ngtcp2_LIBRARY_DIRS "${_ngtcp2_STATIC_LIBRARY_DIRS}")
|
|
set(_ngtcp2_LIBRARIES "${_ngtcp2_STATIC_LIBRARIES}")
|
|
endif()
|
|
message(STATUS "Found NGTCP2 (via pkg-config): ${_ngtcp2_INCLUDE_DIRS} (found version \"${NGTCP2_VERSION}\")")
|
|
elseif(ngtcp2_CONFIG)
|
|
set(NGTCP2_FOUND TRUE)
|
|
set(NGTCP2_VERSION ${ngtcp2_VERSION})
|
|
if(NGTCP2_USE_STATIC_LIBS)
|
|
set(_ngtcp2_LIBRARIES ngtcp2::ngtcp2_static ngtcp2::${_crypto_library_lower}_static)
|
|
else()
|
|
set(_ngtcp2_LIBRARIES ngtcp2::ngtcp2 ngtcp2::${_crypto_library_lower})
|
|
endif()
|
|
message(STATUS "Found NGTCP2 (via CMake Config): ${ngtcp2_CONFIG} (found version \"${NGTCP2_VERSION}\")")
|
|
else()
|
|
find_path(NGTCP2_INCLUDE_DIR NAMES "ngtcp2/ngtcp2.h")
|
|
if(NGTCP2_USE_STATIC_LIBS)
|
|
set(_ngtcp2_CFLAGS "-DNGTCP2_STATICLIB")
|
|
find_library(NGTCP2_LIBRARY NAMES "ngtcp2_static" "ngtcp2")
|
|
else()
|
|
find_library(NGTCP2_LIBRARY NAMES "ngtcp2")
|
|
endif()
|
|
|
|
unset(NGTCP2_VERSION CACHE)
|
|
if(NGTCP2_INCLUDE_DIR AND EXISTS "${NGTCP2_INCLUDE_DIR}/ngtcp2/version.h")
|
|
set(_version_regex "#[\t ]*define[\t ]+NGTCP2_VERSION[\t ]+\"([^\"]*)\"")
|
|
file(STRINGS "${NGTCP2_INCLUDE_DIR}/ngtcp2/version.h" _version_str REGEX "${_version_regex}")
|
|
string(REGEX REPLACE "${_version_regex}" "\\1" _version_str "${_version_str}")
|
|
set(NGTCP2_VERSION "${_version_str}")
|
|
unset(_version_regex)
|
|
unset(_version_str)
|
|
endif()
|
|
|
|
if(_ngtcp2_crypto_backend)
|
|
if(CMAKE_VERSION VERSION_GREATER_EQUAL 3.20)
|
|
cmake_path(GET NGTCP2_LIBRARY PARENT_PATH _ngtcp2_library_dir)
|
|
else()
|
|
get_filename_component(_ngtcp2_library_dir "${NGTCP2_LIBRARY}" DIRECTORY)
|
|
endif()
|
|
if(NGTCP2_USE_STATIC_LIBS)
|
|
find_library(${_crypto_library_upper}_LIBRARY NAMES ${_crypto_library_lower}_static ${_crypto_library_lower}
|
|
HINTS ${_ngtcp2_library_dir})
|
|
else()
|
|
find_library(${_crypto_library_upper}_LIBRARY NAMES ${_crypto_library_lower}
|
|
HINTS ${_ngtcp2_library_dir})
|
|
endif()
|
|
|
|
if(${_crypto_library_upper}_LIBRARY)
|
|
set(NGTCP2_${_ngtcp2_crypto_backend}_FOUND TRUE)
|
|
set(NGTCP2_CRYPTO_LIBRARY ${${_crypto_library_upper}_LIBRARY})
|
|
endif()
|
|
endif()
|
|
|
|
include(FindPackageHandleStandardArgs)
|
|
find_package_handle_standard_args(NGTCP2
|
|
REQUIRED_VARS
|
|
NGTCP2_INCLUDE_DIR
|
|
NGTCP2_LIBRARY
|
|
VERSION_VAR
|
|
NGTCP2_VERSION
|
|
HANDLE_COMPONENTS
|
|
)
|
|
|
|
if(NGTCP2_FOUND)
|
|
set(_ngtcp2_INCLUDE_DIRS ${NGTCP2_INCLUDE_DIR})
|
|
set(_ngtcp2_LIBRARIES ${NGTCP2_LIBRARY} ${NGTCP2_CRYPTO_LIBRARY})
|
|
endif()
|
|
|
|
mark_as_advanced(NGTCP2_INCLUDE_DIR NGTCP2_LIBRARY NGTCP2_CRYPTO_LIBRARY)
|
|
|
|
if(NOT NGTCP2_FOUND AND _tried_pkgconfig) # reset variables to allow another round of detection
|
|
unset(NGTCP2_INCLUDE_DIR CACHE)
|
|
unset(NGTCP2_LIBRARY CACHE)
|
|
endif()
|
|
endif()
|
|
|
|
if(NGTCP2_FOUND)
|
|
if(NOT TARGET CURL::ngtcp2)
|
|
add_library(CURL::ngtcp2 INTERFACE IMPORTED)
|
|
set_target_properties(CURL::ngtcp2 PROPERTIES
|
|
INTERFACE_LIBCURL_PC_MODULES "${_ngtcp2_pc_requires}"
|
|
INTERFACE_COMPILE_OPTIONS "${_ngtcp2_CFLAGS}"
|
|
INTERFACE_INCLUDE_DIRECTORIES "${_ngtcp2_INCLUDE_DIRS}"
|
|
INTERFACE_LINK_DIRECTORIES "${_ngtcp2_LIBRARY_DIRS}"
|
|
INTERFACE_LINK_LIBRARIES "${_ngtcp2_LIBRARIES}")
|
|
endif()
|
|
endif()
|