CMakeLists.txt

cmake_minimum_required(VERSION 3.14)

project(
    example
    VERSION 0.1.0
    LANGUAGES CXX
)

include(cmake/project-is-top-level.cmake)
include(cmake/variables.cmake)

# ---- Declare library ----

add_library(example_example source/main.cpp)
add_library(example::example ALIAS example_example)

include(GenerateExportHeader)

generate_export_header(
    example_example
    BASE_NAME example
    EXPORT_FILE_NAME include/example/example_export.h
)

if(NOT BUILD_SHARED_LIBS)
  target_compile_definitions(example_example PUBLIC EXAMPLE_STATIC_DEFINE)
endif()

set_target_properties(
    example_example PROPERTIES
    CXX_VISIBILITY_PRESET hidden
    VISIBILITY_INLINES_HIDDEN YES
    VERSION "${PROJECT_VERSION}"
    SOVERSION "${PROJECT_VERSION_MAJOR}"
    EXPORT_NAME example
    OUTPUT_NAME example
)

target_include_directories(
    example_example ${example_warning_guard}
    PUBLIC
    "$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/include>"
    "$<BUILD_INTERFACE:${PROJECT_BINARY_DIR}/include>"
)

target_compile_features(example_example PUBLIC cxx_std_14)

# ---- Install ----

if(PROJECT_IS_TOP_LEVEL)
  set(CMAKE_INSTALL_INCLUDEDIR "include/example" CACHE PATH "")
endif()

include(CMakePackageConfigHelpers)
include(GNUInstallDirs)

install(
    DIRECTORY
    "${PROJECT_SOURCE_DIR}/include/"
    "${PROJECT_BINARY_DIR}/include/"
    DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
    COMPONENT example_Development
)

install(
    TARGETS example_example
    EXPORT exampleTargets
    RUNTIME #
    COMPONENT example_Runtime
    LIBRARY #
    COMPONENT example_Runtime
    NAMELINK_COMPONENT example_Development
    ARCHIVE #
    COMPONENT example_Development
    INCLUDES #
    DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
)

write_basic_package_version_file(
    exampleConfigVersion.cmake
    COMPATIBILITY SameMajorVersion
)

set(
    example_INSTALL_CMAKEDIR "${CMAKE_INSTALL_LIBDIR}/cmake/example"
    CACHE STRING "CMake package config location relative to the install prefix"
)
mark_as_advanced(example_INSTALL_CMAKEDIR)

install(
    FILES
    "${PROJECT_SOURCE_DIR}/cmake/exampleConfig.cmake"
    "${PROJECT_BINARY_DIR}/exampleConfigVersion.cmake"
    DESTINATION "${example_INSTALL_CMAKEDIR}"
    COMPONENT example_Development
)

install(
    EXPORT exampleTargets
    NAMESPACE example::
    DESTINATION "${example_INSTALL_CMAKEDIR}"
    COMPONENT example_Development
)

if(PROJECT_IS_TOP_LEVEL)
  include(CPack)
endif()

# ---- Developer mode ----

if(NOT example_DEVELOPER_MODE)
  return()
elseif(NOT PROJECT_IS_TOP_LEVEL)
  message(AUTHOR_WARNING "Developer mode is intended for developers of example")
endif()

include(CTest)
if(BUILD_TESTING)
  add_subdirectory(test)
endif()