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.