mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
e727252733
The magic symbols specify a version range where clients should reference a @rpath relative path to libswift_Concurrency.dylib instead of the standard absolute path. This version range started at macOS 10.15 and aligned versions, which is the oldest target supported by Concurrency. However, clients that use Concurrency can target earlier OSes as long as they availability-check their use of Concurrency. When targeting something earlier than 10.15, they'd reference the absolute path, then fail to find the back-deployment Concurrency runtime on OS versions that need it. Fix this by setting the start of the range to macOS 10.9 and aligned, which is the oldest target supported by Swift. rdar://140476764
83 lines
4.2 KiB
C
83 lines
4.2 KiB
C
//===--- magic-symbols-for-install-name.c - Magic linker directive symbols ===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2021 Apple Inc. and the Swift project authors
|
|
// Licensed under Apache License v2.0 with Runtime Library Exception
|
|
//
|
|
// See https://swift.org/LICENSE.txt for license information
|
|
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// A file containing magic symbols that instruct the linker to use a
|
|
// different install name when targeting older OSes. This file gets
|
|
// compiled into all of the libraries that are embedded for backward
|
|
// deployment.
|
|
//
|
|
// This file is specific to the Concurrency library; there is a matching file
|
|
// for the standard library with the same name.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#if defined(__APPLE__) && defined(__MACH__) && SWIFT_STDLIB_SUPPORT_BACK_DEPLOYMENT
|
|
|
|
#include <mach-o/loader.h>
|
|
#include <TargetConditionals.h>
|
|
#include "swift/shims/Visibility.h"
|
|
|
|
// Concurrency was supported as an embedded library in macOS 10.15, iOS 13.0, watchOS 6.0, tvOS 13.0. It
|
|
// became part of the OS in macOS 12.0, iOS 15.0, watchOS 8.0, tvOS 15.0. Projects can continue to embed
|
|
// Concurrency, but the linker will see the OS version and try to link on that by default. In order to
|
|
// support back deployment, add a magic symbol to the OS library so that back deployment will link on the
|
|
// embedded library instead. When running on a newer OS, the OS version of the library will be used due to
|
|
// Xcode inserting a runpath search path of /usr/lib/swift based on the deployment target being less than
|
|
// SupportedTargets[target][SwiftConcurrencyMinimumDeploymentTarget] in SDKSettings.plist.
|
|
|
|
// Clients can back deploy to OS versions that predate Concurrency as an embedded library, and conditionally
|
|
// use it behind an #availability check. Such clients will still need to link the embedded library instead
|
|
// of the OS version. To support that, set the start version to Swift's first supported versions: macOS (née
|
|
// OS X) 10.9, iOS 7.0, watchOS 2.0, tvOS 9.0 rather than Concurrency's first supported versions listed
|
|
// above.
|
|
|
|
// The linker uses a specially formatted symbol to do the back deployment:
|
|
// $ld$previous$<install-name>$<compatibility-version>$<platform>$<start-version>$<end-version>$<symbol-name>$
|
|
// compatibility-version and symbol-name are left off to apply to all library versions and symbols.
|
|
// This symbol isn't a legal C identifier, so it needs to be specified with __asm.
|
|
#define RPATH_PREVIOUS_DIRECTIVE_IMPL(name, platform, startVersion, endVersion) \
|
|
SWIFT_RUNTIME_EXPORT const char ld_previous_ ## platform \
|
|
__asm("$ld$previous$@rpath/lib" __STRING(name) ".dylib$$" __STRING(platform) "$" __STRING(startVersion) "$" __STRING(endVersion) "$$"); \
|
|
const char ld_previous_ ## platform = 0;
|
|
// Using the __STRING macro is important so that name and platform get expanded before being
|
|
// stringified. The versions could just be #version, __STRING is only used for consistency.
|
|
|
|
#define RPATH_PREVIOUS_DIRECTIVE(platform, startVersion, endVersion) \
|
|
RPATH_PREVIOUS_DIRECTIVE_IMPL(SWIFT_TARGET_LIBRARY_NAME, platform, startVersion, endVersion)
|
|
|
|
#if TARGET_OS_OSX || TARGET_OS_MACCATALYST
|
|
RPATH_PREVIOUS_DIRECTIVE(PLATFORM_MACOS, 10.9, 12.0)
|
|
RPATH_PREVIOUS_DIRECTIVE(PLATFORM_MACCATALYST, 13.1, 15.0)
|
|
#elif TARGET_OS_IOS && !TARGET_OS_VISION
|
|
#if TARGET_OS_SIMULATOR
|
|
RPATH_PREVIOUS_DIRECTIVE(PLATFORM_IOSSIMULATOR, 7.0, 15.0)
|
|
#else
|
|
RPATH_PREVIOUS_DIRECTIVE(PLATFORM_IOS, 7.0, 15.0)
|
|
#endif
|
|
#elif TARGET_OS_WATCH
|
|
#if TARGET_OS_SIMULATOR
|
|
RPATH_PREVIOUS_DIRECTIVE(PLATFORM_WATCHOSSIMULATOR, 2.0, 8.0)
|
|
#else
|
|
RPATH_PREVIOUS_DIRECTIVE(PLATFORM_WATCHOS, 2.0, 8.0)
|
|
#endif
|
|
#elif TARGET_OS_TV
|
|
#if TARGET_OS_SIMULATOR
|
|
RPATH_PREVIOUS_DIRECTIVE(PLATFORM_TVOSSIMULATOR, 9.0, 15.0)
|
|
#else
|
|
RPATH_PREVIOUS_DIRECTIVE(PLATFORM_TVOS, 9.0, 15.0)
|
|
#endif
|
|
#endif
|
|
// Concurrency wasn't supported as an embedded library in any other OS, so no need to create back deployment
|
|
// symbols for any of the other ones.
|
|
|
|
#endif // defined(__APPLE__) && defined(__MACH__) && SWIFT_STDLIB_SUPPORT_BACK_DEPLOYMENT
|