Spec-Zone.ru › CMake 3.20

экспорт

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

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. Если цель библиотеки включена в экспорт, но цель, к которой она ссылается, не включена, поведение не определено.

Примечание

Объектные библиотеки под Xcode имеют специальную обработку, если в CMAKE_OSX_ARCHITECTURES указано несколько архитектур. В этом случае они будут экспортированы как Интерфейсные библиотеки без доступных объектных файлов для клиентов. Это достаточно для удовлетворения требований по транзитивному использованию других целей, которые ссылаются на объектные библиотеки в их реализации.

export(PACKAGE <PackageName>)

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

Изменено в версии 3.1: Если переменная CMAKE_EXPORT_NO_PACKAGE_REGISTRY включена, команда export(PACKAGE) ничего не сделает.

Изменено в версии 3.15: По умолчанию команда export(PACKAGE) ничего не делает (см. политику CMP0090), потому что заполнение реестра пакетов пользователя имеет последствия за пределами дерева исходных и сборки. Установите переменную CMAKE_EXPORT_PACKAGE_REGISTRY, чтобы добавить директории сборки в реестр пакетов CMake.

export(TARGETS [target1 [target2 [...]]]  [ANDROID_MK <filename>])

Добавлена в версии 3.7.

Эта сигнатура экспортирует скомпилированные CMake-цели в систему сборки Android ndk, создавая файл Android.mk, который ссылается на предварительно скомпилированные цели. Android NDK поддерживает использование предварительно скомпилированных библиотек, как статических, так и динамических. Это позволяет CMake компилировать библиотеки проекта и сделать их доступными для системы сборки ndk, включая транзитивные зависимости, флаги включения и определения, необходимые для использования библиотек. Сигнатура принимает список целей и помещает их в файл Android.mk, указанный параметром <filename> . Эта сигнатура может быть использована только в том случае, если политика CMP0022 установлена в NEW для всех заданных целей. Будет выдано сообщение об ошибке, если эта политика установлена в OLD для одной из целей.

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.20/command/export.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API