[Runtimes][FindSwiftCore] Find Shims, OnoneSupport and Concurrency

This way we will match most of the targets that would be exported via
SwiftCoreTargets.cmake.

Take the chance to expand the documentation of the find module.

Addresses rdar://151700875

Author: edymtt

Runtimes/Supplemental/cmake/modules/FindSwiftCore.cmake

@@ -24,17 +24,73 @@ Hint Variables
    This only affects Linux and Windows builds.
    Apple builds always use the library provided by the SDK.
 
+ ``SwiftCore_USE_STATIC_LIBS``
+   Set to boolean true to find static libraries. If not
+   set explicitly this is inferred from the value of
+   `BUILD_SHARED_LIBS` and the current platform.
+
+ ``SwiftCore_INCLUDE_DIR_HINTS``
+   Additional paths to search the swiftmodules into. These
+   are prepended to the ones searched by this find module
+
+ ``SwiftCore_LIBRARY_HINTS``
+   Additional paths to search the libraries into. These
+   are prepended to the ones searched by this find module
+
+ ``SwiftShims_INCLUDE_DIR_HINTS``
+   Additional paths to search the shims into. These
+   are prepended to the ones searched by this find module
+
+ ``SwiftCore_NAMES``
+   Additional names for the Core library
+
+ ``SwiftOnoneSupport_NAMES``
+   Additional names for the SwiftOnoneSupport library
+
+ ``SwiftConcurrency_NAMES``
+   Additional names for the Swift_Concurrency library
+
+Result targets
+^^^^^^^^^^^^^^
+
+If no error is generated, the following targets are available to the users
+
+  * ``swiftCore``
+  * ``swiftSwiftOnoneSupport``
+  * ``swift_Concurrency``
+  * ``swiftShims``
+
 Result Variables
 ^^^^^^^^^^^^^^^^
 
 The module may set the following variables if `SwiftCore_DIR` is not set.
+(although we suggest relying on the targets above instead)
 
  ``SwiftCore_FOUND``
    true if core was found
 
  ``SwiftCore_INCLUDE_DIR``
    the directory containing the Swift.swiftmodule folder
 
+ ``SwiftCore_LIBRARY``
+   path to the swiftCore library
+
+ ``SwiftOnoneSupport_INCLUDE_DIR``
+   the directory containing the SwiftOnoneSupport.swiftmodule folder
+
+ ``SwiftOnoneSupport_LIBRARY``
+   path to the SwiftOnoneSupport library
+
+ ``SwiftConcurrency_INCLUDE_DIR``
+   the directory containing the _Concurrency.swiftmodule folder
+
+ ``SwiftConcurrency_LIBRARY``
+   path to the swift_Concurrency library
+
+ ``SwiftShims_INCLUDE_DIR``
+   the directory containing the Swift shims directory
+   (i.e. .../usr/lib/swift, not .../usr/lib/swift/shims)
+
 #]=======================================================================]
 
 include_guard(GLOBAL)
@@ -72,22 +128,35 @@ if(APPLE)
     "${CMAKE_OSX_SYSROOT}/usr/lib/swift")
   list(APPEND SwiftCore_LIBRARY_HINTS
     "${CMAKE_OSX_SYSROOT}/usr/lib/swift")
+  list(APPEND SwiftShims_INCLUDE_DIR_HINTS
+    "${CMAKE_OSX_SYSROOT}/usr/lib/swift")
   # When building for Apple platforms, SwiftCore always comes from within the
   # SDK as a tbd for a shared library in the shared cache.
   list(APPEND SwiftCore_NAMES libswiftCore.tbd)
+  list(APPEND SwiftOnoneSupport_NAMES libswiftSwiftOnoneSupport.tbd)
+  list(APPEND SwiftConcurrency_NAMES libswift_Concurrency.tbd)
 elseif(LINUX)
   if (SwiftCore_USE_STATIC_LIBS)
     list(APPEND SwiftCore_INCLUDE_DIR_HINTS
       "${Swift_SDKROOT}/usr/lib/swift_static/linux-static")
     list(APPEND SwiftCore_LIBRARY_HINTS
       "${Swift_SDKROOT}/usr/lib/swift_static/linux-static")
+    list(APPEND SwiftShims_INCLUDE_DIR_HINTS
+      "${Swift_SDKROOT}/usr/lib/swift_static"
+      "${Swift_SDKROOT}/usr/lib/swift")
     list(APPEND SwiftCore_NAMES libswiftCore.a)
+    list(APPEND SwiftOnoneSupport_NAMES libswiftSwiftOnoneSupport.a)
+    list(APPEND SwiftConcurrency_NAMES libswift_Concurrency.a)
   else()
     list(APPEND SwiftCore_INCLUDE_DIR_HINTS
       "${Swift_SDKROOT}/usr/lib/swift/linux")
     list(APPEND SwiftCore_LIBRARY_HINTS
       "${Swift_SDKROOT}/usr/lib/swift/linux")
+    list(APPEND SwiftShims_INCLUDE_DIR_HINTS
+      "${Swift_SDKROOT}/usr/lib/swift")
     list(APPEND SwiftCore_NAMES libswiftCore.so)
+    list(APPEND SwiftOnoneSupport_NAMES libswiftSwiftOnoneSupport.so)
+    list(APPEND SwiftConcurrency_NAMES libswift_Concurrency.so)
   endif()
 elseif(WIN32)
   list(APPEND SwiftCore_INCLUDE_DIR_HINTS
@@ -98,10 +167,17 @@ elseif(WIN32)
     "${Swift_SDKROOT}/usr/lib/swift"
     "$ENV{SDKROOT}/usr/lib/swift/${${PROJECT_NAME}_PLATFORM_SUBDIR}/${${PROJECT_NAME}_ARCH_SUBDIR}"
     "$ENV{SDKROOT}/usr/lib/swift")
+  list(APPEND SwiftShims_INCLUDE_DIR_HINTS
+    "${Swift_SDKROOT}/usr/lib/swift"
+    "$ENV{SDKROOT}/usr/lib/swift")
   if (SwiftCore_USE_STATIC_LIBS)
     list(APPEND SwiftCore_NAMES libswiftCore.lib)
+    list(APPEND SwiftOnoneSupport_NAMES libswiftSwiftOnoneSupport.lib)
+    list(APPEND SwiftConcurrency_NAMES libswift_Concurrency.lib)
   else()
     list(APPEND SwiftCore_NAMES swiftCore.lib)
+    list(APPEND SwiftOnoneSupport_NAMES swiftSwiftOnoneSupport.lib)
+    list(APPEND SwiftConcurrency_NAMES swift_Concurrency.lib)
   endif()
 elseif(ANDROID)
   if (SwiftCore_USE_STATIC_LIBS)
@@ -113,7 +189,11 @@ elseif(ANDROID)
       "${Swift_SDKROOT}/usr/lib/swift_static"
       "$ENV{SDKROOT}/usr/lib/swift_static/android/${${PROJECT_NAME}_ARCH_SUBDIR}"
       "$ENV{SDKROOT}/usr/lib/swift_static")
+    list(APPEND SwiftShims_INCLUDE_DIR_HINTS
+      "${Swift_SDKROOT}/usr/lib/swift_static")
     list(APPEND SwiftCore_NAMES libswiftCore.a)
+    list(APPEND SwiftOnoneSupport_NAMES libswiftSwiftOnoneSupport.a)
+    list(APPEND SwiftConcurrency_NAMES libswift_Concurrency.a)
   else()
     list(APPEND SwiftCore_INCLUDE_DIR_HINTS
       "${Swift_SDKROOT}/usr/lib/swift/android"
@@ -123,7 +203,11 @@ elseif(ANDROID)
       "${Swift_SDKROOT}/usr/lib/swift"
       "$ENV{SDKROOT}/usr/lib/swift/android/${${PROJECT_NAME}_ARCH_SUBDIR}"
       "$ENV{SDKROOT}/usr/lib/swift")
+    list(APPEND SwiftShims_INCLUDE_DIR_HINTS
+      "${Swift_SDKROOT}/usr/lib/swift")
     list(APPEND SwiftCore_NAMES libswiftCore.so)
+    list(APPEND SwiftOnoneSupport_NAMES libswiftSwiftOnoneSupport.so)
+    list(APPEND SwiftConcurrency_NAMES libswift_Concurrency.so)
   endif()
 else()
   message(FATAL_ERROR "FindSwiftCore.cmake module search not implemented for targeted platform\n"
@@ -143,22 +227,71 @@ find_library(SwiftCore_LIBRARY
   HINTS
     ${SwiftCore_LIBRARY_HINTS})
 
+find_path(SwiftOnoneSupport_INCLUDE_DIR
+  "SwiftOnoneSupport.swiftmodule"
+  NO_CMAKE_FIND_ROOT_PATH
+  HINTS
+    ${SwiftCore_INCLUDE_DIR_HINTS})
+find_library(SwiftOnoneSupport_LIBRARY
+  NAMES
+    ${SwiftOnoneSupport_NAMES}
+  NO_CMAKE_FIND_ROOT_PATH
+  HINTS
+    ${SwiftCore_LIBRARY_HINTS})
+
+find_path(SwiftConcurrency_INCLUDE_DIR
+  "_Concurrency.swiftmodule"
+  NO_CMAKE_FIND_ROOT_PATH
+  HINTS
+    ${SwiftCore_INCLUDE_DIR_HINTS})
+find_library(SwiftConcurrency_LIBRARY
+  NAMES
+    ${SwiftConcurrency_NAMES}
+  NO_CMAKE_FIND_ROOT_PATH
+  HINTS
+    ${SwiftCore_LIBRARY_HINTS})
+
 if(SwiftCore_USE_STATIC_LIBS)
   add_library(swiftCore STATIC IMPORTED GLOBAL)
+  add_library(swiftSwiftOnoneSupport STATIC IMPORTED GLOBAL)
+  add_library(swift_Concurrency STATIC IMPORTED GLOBAL)
 else()
   add_library(swiftCore SHARED IMPORTED GLOBAL)
+  add_library(swiftSwiftOnoneSupport SHARED IMPORTED GLOBAL)
+  add_library(swift_Concurrency SHARED IMPORTED GLOBAL)
 endif()
 
 set_target_properties(swiftCore PROPERTIES
   INTERFACE_INCLUDE_DIRECTORIES "${SwiftCore_INCLUDE_DIR}")
+set_target_properties(swiftSwiftOnoneSupport PROPERTIES
+  INTERFACE_INCLUDE_DIRECTORIES "${SwiftOnoneSupport_INCLUDE_DIR}")
+set_target_properties(swift_Concurrency PROPERTIES
+  INTERFACE_INCLUDE_DIRECTORIES "${SwiftConcurrency_INCLUDE_DIR}")
 
 if(LINUX OR ANDROID)
   set_target_properties(swiftCore PROPERTIES
     IMPORTED_LOCATION "${SwiftCore_LIBRARY}")
+  set_target_properties(swiftSwiftOnoneSupport PROPERTIES
+    IMPORTED_LOCATION "${SwiftOnoneSupport_LIBRARY}")
+  set_target_properties(swift_Concurrency PROPERTIES
+    IMPORTED_LOCATION "${SwiftConcurrency_LIBRARY}")
 else()
   set_target_properties(swiftCore PROPERTIES
     IMPORTED_IMPLIB "${SwiftCore_LIBRARY}")
+  set_target_properties(swiftSwiftOnoneSupport PROPERTIES
+    IMPORTED_IMPLIB "${SwiftOnoneSupport_LIBRARY}")
+  set_target_properties(swift_Concurrency PROPERTIES
+    IMPORTED_IMPLIB "${SwiftConcurrency_LIBRARY}")
 endif()
 
+find_path(SwiftShims_INCLUDE_DIR "shims/module.modulemap" HINTS
+  ${SwiftShims_INCLUDE_DIR_HINTS})
+add_library(swiftShims INTERFACE IMPORTED GLOBAL)
+set_target_properties(swiftShims PROPERTIES
+  INTERFACE_INCLUDE_DIRECTORIES "${SwiftShims_INCLUDE_DIR}/shims")
+
 find_package_handle_standard_args(SwiftCore DEFAULT_MSG
-  SwiftCore_LIBRARY SwiftCore_INCLUDE_DIR)
+  SwiftCore_LIBRARY SwiftCore_INCLUDE_DIR
+  SwiftShims_INCLUDE_DIR
+  SwiftOnoneSupport_LIBRARY SwiftOnoneSupport_INCLUDE_DIR
+  SwiftConcurrency_LIBRARY SwiftConcurrency_INCLUDE_DIR)