CMP0114

ExternalProject шаги полностью принимают свои шаги.

Команда ExternalProject_Add() STEP_TARGETS параметр и функция ExternalProject_Add_StepTargets() могут использоваться для создания целевых объектов сборки для отдельных шагов внешнего проекта.

В CMake 3.18 и ниже, целевые объекты шагов имеют некоторые ограничения:

• Целевые объекты шагов всегда зависят от целевых объектов, именованных с помощью параметра ExternalProject_Add() DEPENDS, даже если не все шаги их нуждаются. Для того, чтобы разрешить создание целевых объектов шагов без этих зависимостей, можно использовать параметр ExternalProject_Add() INDEPENDENT_STEP_TARGETS или параметр ExternalProject_Add_StepTargets() NO_DEPENDS. Однако добавление таких "независимых" целевых объектов шагов имеет смысл только для определенных шагов, таких как download, update, и patch, так как они не нуждаются ни в каких зависимостях сборки внешнего проекта. Кроме того, не имеет смысла создавать независимые целевые объекты шагов для шагов, которые зависят от зависимых шагов. Такие правила не применяются, и проекты, которые не следуют им, могут генерировать системы сборки с непонятным и специфичным для генератора поведением.

• Целевые объекты шагов содержат копии пользовательских команд, реализующих их шаги, которые отделены от копий в основном целевом объекте, созданном командой ExternalProject_Add(), и основной целевой объект не зависит от целевых объектов шагов. При параллельной сборке, которая одновременно запускает основной целевой объект и целевые объекты шагов, может выполняться несколько копий команд шагов одновременно и конкурировать друг с другом.

  Кроме того, до политики CMP0113, целевые объекты шагов, сгенерированные генераторами Makefile, также содержат все пользовательские команды, от которых зависит их шаг. Это может привести к повторному выполнению этих шагов даже в последовательной сборке.

В CMake 3.19 и выше, модуль ExternalProject предпочитает переработанный дизайн для решения этих проблем:

• Каждый шаг классифицируется как "независимый", если он не зависит от других целевых объектов, именованных с помощью параметра ExternalProject_Add() DEPENDS. По умолчанию предварительно определенные шаги автоматически классифицируются:

  • Шаги download, update, и patch являются независимыми.
  • Шаги configure, build, test, и install не являются.

  Для пользовательских шагов команда ExternalProject_Add_Step() предоставляет параметр INDEPENDENT для их маркировки как независимых. Ошибка возникает, если шаг помечается как независимый, если он зависит от других шагов, которые не являются независимыми. Обратите внимание, что это использование термина "независимый" относится только к независимости от внешних целевых объектов и ортогонально зависимостям шага от других шагов.

• Целевые объекты шагов, созданные параметром ExternalProject_Add() STEP_TARGETS или функцией ExternalProject_Add_Step(), являются независимыми тогда и только тогда, когда их шаги помечены как независимые. Параметр ExternalProject_Add() INDEPENDENT_STEP_TARGETS и параметр ExternalProject_Add_StepTargets() NO_DEPENDS больше не разрешены.

• Целевые объекты шагов, при создании, полностью отвечают за хранение пользовательских команд, реализующих их шаги. Основной целевой объект, созданный командой ExternalProject_Add(), зависит от целевых объектов шагов, а целевые объекты шагов зависят друг от друга. Зависимости на уровне целевых объектов соответствуют зависимостям на уровне файлов, используемым пользовательскими командами для каждого шага.

  Когда используется параметр ExternalProject_Add() UPDATE_DISCONNECTED или TEST_EXCLUDE_FROM_MAIN или параметр ExternalProject_Add_Step() EXCLUDE_FROM_MAIN, для пользовательского шага, некоторые целевые объекты шагов могут быть созданы автоматически. Они необходимы для хранения шагов, на которые обычно опирается основной целевой объект и отсоединенные целевые объекты шагов.

Политика CMP0114 обеспечивает совместимость для проектов, которые не были обновлены, чтобы ожидать нового поведения. Поведение OLD для этой политики заключается в использовании описанного выше поведения с 3.18 и ниже. Поведение NEW для этой политики заключается в использовании описанного выше поведения, предпочтительного для 3.19 и выше.

Эта политика была введена в версии CMake 3.19. Версия CMake 3.21.0-rc3 предупреждает, когда политика не задана, и использует поведение OLD. Используйте команду cmake_policy() для явного задания ее значения на OLD или NEW.