summaryrefslogtreecommitdiffstats
path: root/Help/release/dev/FetchContent_find_package_integration.rst
blob: 4ca7afc1e7daa03d3a181816e5c8717df027b49a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
FetchContent_find_package_integration
-------------------------------------

* Integration has been added between the :module:`FetchContent` module and the
  :command:`find_package` command, enabling the following new capabilities:

  * :command:`FetchContent_MakeAvailable` can now try to satisfy a dependency
    by calling :command:`find_package` first.  A new
    :variable:`FETCHCONTENT_TRY_FIND_PACKAGE_MODE` variable controls whether
    this is done by default for all dependencies, is opt-in per dependency,
    or is disabled entirely.

  * :command:`find_package` can be re-routed to call
    :command:`FetchContent_MakeAvailable` instead.  A new read-only
    :variable:`CMAKE_FIND_PACKAGE_REDIRECTS_DIR` variable points to a
    directory where config package files can be located to facilitate these
    re-routed calls.