export

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

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

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

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

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

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

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) ничего не сделает.