2022-10-01 13:42:36 +00:00
|
|
|
|
#[=======================================================================[.rst:
|
|
|
|
|
myx_add_library
|
|
|
|
|
---------------
|
|
|
|
|
|
|
|
|
|
Вспомогательная функция для создания библиотеки::
|
|
|
|
|
|
|
|
|
|
myx_add_library(NAME TYPE)
|
|
|
|
|
|
|
|
|
|
Обязательные параметры: `NAME` - имя библиотеки и `TYPE` - тип цели.
|
|
|
|
|
Все остальные параметры передаются стандартной функции `add_library()`
|
|
|
|
|
|
|
|
|
|
#]=======================================================================]
|
|
|
|
|
|
2022-09-29 10:34:57 +00:00
|
|
|
|
include_guard(GLOBAL)
|
|
|
|
|
|
|
|
|
|
include(GenerateExportHeader)
|
|
|
|
|
|
2022-10-01 13:42:36 +00:00
|
|
|
|
function(myx_add_library NAME TYPE)
|
2022-09-29 10:34:57 +00:00
|
|
|
|
set(options)
|
2022-10-01 13:42:36 +00:00
|
|
|
|
set(oneValueArgs)
|
|
|
|
|
set(multiValueArgs)
|
2022-09-29 10:34:57 +00:00
|
|
|
|
|
2022-10-01 13:42:36 +00:00
|
|
|
|
cmake_parse_arguments(ARG "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN})
|
|
|
|
|
|
|
|
|
|
# Вызов стандартной функции `add_library()`
|
|
|
|
|
add_library(${NAME} ${TYPE} ${ARG_UNPARSED_ARGUMENTS})
|
2022-09-29 10:34:57 +00:00
|
|
|
|
|
2022-10-01 13:42:36 +00:00
|
|
|
|
# Если вызов был выполнен не из проекта верхнего уровня,
|
|
|
|
|
# то созданная цель исключается из цели `all`.
|
|
|
|
|
# При этом сама цель `${NAME}` может участвовать в сборке,
|
|
|
|
|
# если окажется в перечне зависимостей.
|
|
|
|
|
if(NOT PROJECT_IS_TOP_LEVEL)
|
|
|
|
|
set_target_properties(${NAME} PROPERTIES
|
|
|
|
|
EXCLUDE_FROM_ALL True
|
|
|
|
|
)
|
|
|
|
|
endif()
|
2022-09-29 10:34:57 +00:00
|
|
|
|
|
2022-10-01 13:42:36 +00:00
|
|
|
|
if(TYPE STREQUAL INTERFACE)
|
|
|
|
|
# Стандартные пути к заголовочным файлам
|
2022-09-29 14:20:02 +00:00
|
|
|
|
target_include_directories(${NAME}
|
2022-09-29 10:34:57 +00:00
|
|
|
|
INTERFACE
|
|
|
|
|
$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/include>
|
|
|
|
|
$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>
|
|
|
|
|
)
|
|
|
|
|
else()
|
2022-09-29 14:20:02 +00:00
|
|
|
|
string(TOUPPER ${NAME} PROJECT_NAME_UPPER)
|
2022-09-29 12:42:22 +00:00
|
|
|
|
# Опция для разрешения сборки разделяемой библиотеки
|
|
|
|
|
option(${PROJECT_NAME_UPPER}_BUILD_SHARED "Build shared library" ON)
|
|
|
|
|
# Опция для разрешения сборки статической библиотеки
|
|
|
|
|
option(${PROJECT_NAME_UPPER}_BUILD_STATIC "Build static library" ON)
|
|
|
|
|
|
2022-10-01 13:42:36 +00:00
|
|
|
|
# Стандартные пути к заголовочным файлам
|
2022-09-29 14:20:02 +00:00
|
|
|
|
target_include_directories(${NAME}
|
2022-09-29 10:34:57 +00:00
|
|
|
|
PUBLIC
|
|
|
|
|
$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/include>
|
|
|
|
|
PRIVATE
|
2022-10-01 13:42:36 +00:00
|
|
|
|
$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/src>
|
2022-09-29 10:34:57 +00:00
|
|
|
|
$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>
|
|
|
|
|
)
|
|
|
|
|
|
2022-09-29 14:20:02 +00:00
|
|
|
|
set_target_properties(${NAME} PROPERTIES POSITION_INDEPENDENT_CODE ON)
|
2022-09-29 10:34:57 +00:00
|
|
|
|
|
2022-09-29 14:20:02 +00:00
|
|
|
|
string(TOUPPER ${NAME} suffix)
|
|
|
|
|
generate_export_header(${NAME}
|
2022-10-01 13:42:36 +00:00
|
|
|
|
BASE_NAME ${suffix}
|
|
|
|
|
EXPORT_MACRO_NAME "EXPORT_${suffix}"
|
|
|
|
|
DEPRECATED_MACRO_NAME "DEPRECATED_${suffix}"
|
|
|
|
|
NO_DEPRECATED_MACRO_NAME "NO_DEPRECATED_${suffix}"
|
|
|
|
|
NO_EXPORT_MACRO_NAME "NO_EXPORT_${suffix}"
|
|
|
|
|
STATIC_DEFINE "STATIC_DEFINE_${suffix}"
|
|
|
|
|
EXPORT_FILE_NAME "${PROJECT_SOURCE_DIR}/include/${NAME}/${NAME}_export.hpp"
|
|
|
|
|
DEFINE_NO_DEPRECATED
|
2022-09-29 10:34:57 +00:00
|
|
|
|
)
|
2022-09-29 11:19:40 +00:00
|
|
|
|
|
|
|
|
|
# Цель для создания разделяемой библиотеки из объектных файлов
|
|
|
|
|
if(${PROJECT_NAME_UPPER}_BUILD_SHARED)
|
2022-09-29 14:20:02 +00:00
|
|
|
|
# Для создания разделяемой библиотеки используются объектные файлы цели ${NAME}
|
|
|
|
|
add_library(${NAME}_shared SHARED $<TARGET_OBJECTS:${NAME}>)
|
|
|
|
|
# Установка дополнительных свойств для цели ${NAME}_shared
|
2022-09-29 11:19:40 +00:00
|
|
|
|
# OUTPUT_NAME: базовое имя выходного файла (без учёта расширения)
|
|
|
|
|
# VERSION: версия библиотеки
|
|
|
|
|
# SOVERSION: мажорная версия библиотеки
|
2022-09-29 14:20:02 +00:00
|
|
|
|
set_target_properties(${NAME}_shared
|
2022-09-29 11:19:40 +00:00
|
|
|
|
PROPERTIES
|
|
|
|
|
VERSION ${PROJECT_VERSION}
|
|
|
|
|
SOVERSION ${PROJECT_VERSION_MAJOR}
|
2022-09-29 14:20:02 +00:00
|
|
|
|
OUTPUT_NAME ${NAME})
|
2022-09-29 11:19:40 +00:00
|
|
|
|
endif()
|
|
|
|
|
|
|
|
|
|
# Цель для создания статической библиотеки из объектных файлов
|
|
|
|
|
if(${PROJECT_NAME_UPPER}_BUILD_STATIC)
|
2022-09-29 14:20:02 +00:00
|
|
|
|
# Для создания статической библиотеки используются объектные файлы цели ${NAME}
|
|
|
|
|
add_library(${NAME}_static STATIC $<TARGET_OBJECTS:${NAME}>)
|
|
|
|
|
# Установка дополнительных свойств для цели ${NAME}_static
|
2022-09-29 11:19:40 +00:00
|
|
|
|
# OUTPUT_NAME: базовое имя выходного файла (без учёта расширения)
|
2022-09-29 14:20:02 +00:00
|
|
|
|
set_target_properties(${NAME}_static
|
2022-09-29 11:19:40 +00:00
|
|
|
|
PROPERTIES
|
2022-09-29 14:20:02 +00:00
|
|
|
|
OUTPUT_NAME ${NAME})
|
2022-09-29 11:19:40 +00:00
|
|
|
|
endif()
|
2022-09-29 10:34:57 +00:00
|
|
|
|
endif()
|
|
|
|
|
endfunction()
|