CMP0168

Модуль FetchContent реализует шаги напрямую, а не через подмодуль.

CMake 3.29 и ниже реализуют FetchContent как отдельный подмодуль. Это требовало конфигурации этого отдельного проекта и использования инструмента сборки. Этот подход может быть очень медленным с некоторыми генераторами и операционными системами. CMake 3.30 и выше предпочитают реализовывать шаги загрузки, обновления и патчинга напрямую как часть основного проекта.

Поведение NEW имеет следующие характеристики:

• Подмодуль не используется. Все операции выполняются непосредственно из шага конфигурации CMake основного проекта. При выполнении в режиме скрипта CMake инструмент сборки не нужен.
• Выражения генератора и переменные GNU Make вида $(SOMEVAR) не поддерживаются. Их не следует использовать ни в каком аргументе к FetchContent_Declare() или FetchContent_Populate().
• Все опции LOG_... и USES_TERMINAL_..., опция QUIET, и переменная FETCHCONTENT_QUIET игнорируются. Вывод FetchContent всегда является частью вывода конфигурации основного проекта. Это также означает, что теперь он учитывает уровень ведения сообщений (см. CMAKE_MESSAGE_LOG_LEVEL и --log-level). Уровень ведения сообщений по умолчанию должен быть сопоставим с использованием QUIET с настройкой политики OLD, за исключением того, что теперь будут отображаться предупреждения.
• Опции PREFIX, TMP_DIR, STAMP_DIR, LOG_DIR, и DOWNLOAD_DIR и соответствующие им свойства каталогов игнорируются. Модуль FetchContent управляет этими расположениями внутри.
• cmake --fresh удалит метки и скриптовые файлы, используемые для отслеживания и заполнения зависимости. Это принудительно выполнит шаги загрузки, обновления и патчинга зависимости. Каталог, используемый для загрузок, не затрагивается параметром cmake --fresh, поэтому любые ранее загруженные файлы для метода загрузки URL все еще могут быть повторно использованы.

Поведение OLD имеет следующие характеристики:

• Для реализации шагов загрузки, обновления и патчинга всегда используется подмодуль. Инструмент сборки должен быть доступен, даже при использовании FetchContent_Populate() в режиме скрипта CMake.
• Выражения генератора и переменные GNU Make вида $(SOMEVAR) могут использоваться, хотя такое использование почти всегда нецелесообразно. Они вычисляются в подмодуле, поэтому они не видят никакой информации из основного модуля.
• Поддерживается ведение всех журналов, управление терминалом и опции каталогов, связанные с загрузкой, обновлением или патчингом.
• Если используется опция QUIET или переменная FETCHCONTENT_QUIET установлена в значение true, предупреждения не будут отображаться в выводе.
• cmake --fresh не влияет на метки или скриптовые файлы зависимости. Предыдущие шаги будут повторно выполнены только в случае изменения данных о зависимости.

Вероятность того, что пользователи смогут установить переменную CMAKE_POLICY_DEFAULT_CMP0168 в значение NEW для глобального переключения на поведение NEW при ожидании обновления проекта и его зависимостей, достаточно высока. По умолчанию используется настройка политики NEW. Проекты обычно не используют функции, которые больше не поддерживаются поведением NEW, и даже те проекты, которые это делают, часто по-прежнему работают нормально, когда эти опции игнорируются. Перед глобальным установлением этого поведения проверьте, использует ли какой-либо вызов FetchContent_Declare() или FetchContent_Populate() игнорируемые опции таким образом, который изменит наблюдаемое поведение, кроме размещения временных или внутренне сгенерированных файлов в разных местах.

Эта политика была введена в CMake версии 3.30. Она может быть установлена с помощью cmake_policy() или cmake_minimum_required(). Если она не установлена, CMake не выводит предупреждение и использует поведение OLD.