export

Экспорт целей из дерева построения для использования внешними проектами.

export(EXPORT <export-name> [NAMESPACE <namespace>] [FILE <filename>])

Создайте файл <filename> , который может быть включен внешними проектами для импорта целей из дерева построения текущего проекта. Это полезно при кросс-компиляции для построения утилитных исполняемых файлов, которые могут работать на платформе хоста в одном проекте, а затем импортировать их в другой проект, компилируемый для целевой платформы. Если задан параметр NAMESPACE, строка <namespace> будет добавлен в начало всех имён целей, записанных в файл.

Установки целей связаны с экспортом <export-name> с помощью параметра EXPORT команды install(TARGETS).

Файл, созданный этой командой, специфичен для дерева построения и никогда не должен устанавливаться. См. команду install(EXPORT) для экспорта целей из дерева установки.

Свойства, установленные для сгенерированных целей IMPORTED, будут иметь такие же значения, как конечные значения входных целей TARGETS.

export(TARGETS [target1 [target2 [...]]] [NAMESPACE <namespace>]
       [APPEND] FILE <filename> [EXPORT_LINK_INTERFACE_LIBRARIES])

Эта сигнатура похожа на сигнатуру EXPORT, но цели перечислены явно, а не указаны как имя экспорта. Если задан параметр APPEND, сгенерированный код будет добавлен в файл вместо перезаписи. Ключевое слово EXPORT_LINK_INTERFACE_LIBRARIES, если оно присутствует, вызывает экспорт содержимого свойств, соответствующих (IMPORTED_)?LINK_INTERFACE_LIBRARIES(_<CONFIG>)?, когда политика CMP0022 имеет значение NEW. Если целевая библиотека включена в экспорт, но цель, к которой она ссылается, не включена, поведение не определено.

export(PACKAGE <name>)

Сохраните текущий каталог построения в реестре пакетов пользователя CMake для пакета <name>. Команда find_package может учитывать каталог при поиске пакета <name>. Это помогает зависимым проектам находить и использовать пакет из дерева построения текущего проекта без помощи пользователя. Обратите внимание, что запись в реестре пакетов, создаваемая этой командой, работает только в сочетании с файлом конфигурации пакета (<name>Config.cmake), который работает с деревом построения. В некоторых случаях, например, для пакетирования и системных установок, нежелательно записывать в реестр пакетов пользователя. Если переменная CMAKE_EXPORT_NO_PACKAGE_REGISTRY включена, команда export(PACKAGE) ничего не сделает.