mirror of
https://github.com/apple/swift.git
synced 2025-12-21 12:14:44 +01:00
6afa780fdd
Implementing an initial `Finddispatch.cmake` module to find Dispatch from the system SDK on Apple platforms. Still should implement a basic mechanism for finding it on Windows and Linux. Note that those platforms will likely use the dispatch config mechanism most frequently, but this should still work as a fallback. This mechanism is the only one that works for Apple platforms though as those use libdispatch from the SDK rather than building it with corelibs-libdispatch. When building for Linux and Windows, it is possible to build a custom corelibs-libdispatch runtime with `dispatch_DIR` and avoid this module. This module makes it possible to use a pre-built corelibs-libdispatch when one is available without needing to build it. The module uses the `Swift_SDKROOT` filepath as a hint on where to look for the runtime libraries and the `dispatch_STATIC` boolean to specify whether it should find the dynamic library or the static archive.
124 lines
4.1 KiB
CMake
124 lines
4.1 KiB
CMake
#[=======================================================================[.rst:
|
|
Finddispatch
|
|
------------
|
|
|
|
Find libdispatch, deferring to dispatchConfig.cmake when requested.
|
|
This is meant to find the C implementation of libdispatch for use as the
|
|
executor for Swift concurrency. This library is not intended for use by
|
|
third-party program on Linux or Windows.
|
|
|
|
Imported Targets
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
The following :prop_tgt:`IMPORTED` TARGETS may be defined:
|
|
|
|
``dispatch``
|
|
|
|
Hint Variables
|
|
^^^^^^^^^^^^^^
|
|
|
|
``swift_SDKROOT``
|
|
Set the path to the Swift SDK installation.
|
|
This only affects Linux and Windows builds.
|
|
Apple builds always use the library provided by the SDK.
|
|
|
|
``dispatch_STATIC``
|
|
Look for the libdispatch static archive instead of the dynamic library.
|
|
This only affects Linux. Apple builds always use the
|
|
dynamic library provided by the SDK. Windows does not currently have a static
|
|
libdispatch implementation.
|
|
|
|
Result Variables
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
The module may set the following variables if `dispatch_DIR` is not set.
|
|
|
|
``dispatch_FOUND``
|
|
true if dispatch headers and libraries were found
|
|
|
|
``dispatch_INCLUDE_DIR``
|
|
the directory containing the libdispatch headers
|
|
|
|
``dispatch_LIBRARIES`` OR ``dispatch_IMPLIB``
|
|
the libraries to be linked
|
|
|
|
#]=======================================================================]
|
|
|
|
# If the dispatch_DIR is specified, look there instead. The cmake-generated
|
|
# config file is more accurate, but requires that the SDK has one available.
|
|
if(dispatch_DIR)
|
|
if(dispatch_FIND_REQUIRED)
|
|
list(APPEND args REQUIRED)
|
|
endif()
|
|
if(dispatch_FIND_QUIETLY)
|
|
list(APPEND args QUIET)
|
|
endif()
|
|
find_package(dispatch NO_MODULE ${args})
|
|
return()
|
|
endif()
|
|
|
|
include(FindPackageHandleStandardArgs)
|
|
|
|
if(APPLE)
|
|
# When building for Apple platforms, libdispatch always comes from within the
|
|
# SDK as a tbd for a shared library in the shared cache.
|
|
find_path(dispatch_INCLUDE_DIR "dispatch/dispatch.h")
|
|
find_library(dispatch_IMPLIB
|
|
NAMES "libdispatch.tbd"
|
|
PATH "usr/lib"
|
|
PATH_SUFFIXES system)
|
|
add_library(dispatch SHARED IMPORTED GLOBAL)
|
|
set_target_properties(dispatch PROPERTIES
|
|
IMPORTED_IMPLIB "${dispatch_IMPLIB}"
|
|
INTERFACE_INCLUDE_DIRECTORIES "${dispatch_INCLUDE_DIR}")
|
|
find_package_handle_standard_args(dispatch DEFAULT_MSG
|
|
dispatch_IMPLIB dispatch_INCLUDE_DIR)
|
|
elseif(LINUX)
|
|
if(dispatch_STATIC)
|
|
find_path(dispatch_INCLUDE_DIR
|
|
"dispatch/dispatch.h"
|
|
HINTS "${Swift_SDKROOT}/usr/lib/swift_static")
|
|
find_library(dispatch_LIBRARY
|
|
NAMES "libdispatch.a"
|
|
HINTS "${Swift_SDKROOT}/usr/lib/swift_static/linux")
|
|
add_library(dispatch STATIC IMPORTED GLOBAL)
|
|
else()
|
|
find_path(dispatch_INCLUDE_DIR
|
|
"dispatch/dispatch.h"
|
|
HINTS "${Swift_SDKROOT}/usr/lib/swift")
|
|
find_library(dispatch_LIBRARY
|
|
NAMES "libdispatch.so"
|
|
HINTS "${Swift_SDKROOT}/usr/lib/swift/linux")
|
|
add_library(dispatch SHARED IMPORTED GLOBAL)
|
|
endif()
|
|
set_target_properties(dispatch
|
|
IMPORTED_LOCATION "${dispatch_LIBRARY}"
|
|
INTERFACE_INCLUDE_DIRECTORIES "${dispatch_INCLUDE_DIR}")
|
|
find_package_handle_standard_args(dispatch DEFAULT_MSG
|
|
dispatch_LIBRARY dispatch_INCLUDE_DIR)
|
|
elseif(WIN32)
|
|
find_path(dispatch_INCLUDE_DIR
|
|
"dispatch/dispatch.h"
|
|
HINTS
|
|
"${Swift_SDKROOT}/usr/include"
|
|
"$ENV{SDKROOT}/usr/include")
|
|
find_library(dispatch_LIBRARY
|
|
NAMES "dispatch.lib"
|
|
HINTS
|
|
"${Swift_SDKROOT}/usr/lib/swift/${SwiftCore_PLATFORM_SUBDIR}/${SwiftCore_ARCH_SUBDIR}"
|
|
"${Swift_SDKROOT}/usr/lib/swift"
|
|
"$ENV{SDKROOT}/usr/lib/swift/${SwiftCore_PLATFORM_SUBDIR}/${SwiftCore_ARCH_SUBDIR}"
|
|
"$ENV{SDKROOT}/usr/lib/swift")
|
|
|
|
add_library(dispatch SHARED IMPORTED GLOBAL)
|
|
set_target_properties(dispatch
|
|
IMPORTED_IMPLIB "${dispatch_LIBRARY}"
|
|
INTERFACE_INCLUDE_DIRECTORIES "${dispatch_INCLUDE_DIR}")
|
|
find_package_handle_standard_args(dispatch DEFAULT_MSG
|
|
dispatch_IMPLIB dispatch_INCLUDE_DIR)
|
|
else()
|
|
message(FATAL_ERROR "Finddispatch.cmake module search not implemented for targeted platform\n"
|
|
" Build corelibs libdispatch for your platform and set `dispatch_DIR` to"
|
|
" the directory containing dispatchConfig.cmake\n")
|
|
endif()
|