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.