mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
655d89b146
Add support in the driver and frontend for macCatalyst target targets and library search paths. The compiler now adds two library search paths for overlays when compiling for macCatalyst: one for macCatalyst libraries and one for zippered macOS libraries. The macCatalyst path must take priority over the normal macOS path so that in the case of 'unzippered twins' the macCatalyst library is found instead of the macOS library. To support 'zippered' builds, also add support for a new -target-variant flag. For zippered libraries, the driver invocation takes both a -target and a -target-variant flag passes them along to the frontend. We support builds both when the target is a macOS triple and the target variant is macCatalyst and also the 'reverse zippered' configuration where the target is macCatalyst and the target-variant is macOS.
113 lines
4.2 KiB
C++
113 lines
4.2 KiB
C++
//===--- Platform.h - Helpers related to target platforms -------*- C++ -*-===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2014 - 2017 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef SWIFT_BASIC_PLATFORM_H
|
|
#define SWIFT_BASIC_PLATFORM_H
|
|
|
|
#include "swift/Basic/LLVM.h"
|
|
#include "swift/Config.h"
|
|
#include "llvm/ADT/StringRef.h"
|
|
|
|
namespace llvm {
|
|
class Triple;
|
|
class VersionTuple;
|
|
}
|
|
|
|
namespace swift {
|
|
|
|
enum class DarwinPlatformKind : unsigned {
|
|
MacOS,
|
|
IPhoneOS,
|
|
IPhoneOSSimulator,
|
|
TvOS,
|
|
TvOSSimulator,
|
|
WatchOS,
|
|
WatchOSSimulator
|
|
};
|
|
|
|
/// Returns true if the given triple represents iOS running in a simulator.
|
|
bool tripleIsiOSSimulator(const llvm::Triple &triple);
|
|
|
|
/// Returns true if the given triple represents AppleTV running in a simulator.
|
|
bool tripleIsAppleTVSimulator(const llvm::Triple &triple);
|
|
|
|
/// Returns true if the given triple represents watchOS running in a simulator.
|
|
bool tripleIsWatchSimulator(const llvm::Triple &triple);
|
|
|
|
/// Return true if the given triple represents any simulator.
|
|
bool tripleIsAnySimulator(const llvm::Triple &triple);
|
|
|
|
/// Returns true if the given triple represents a macCatalyst environment.
|
|
bool tripleIsMacCatalystEnvironment(const llvm::Triple &triple);
|
|
|
|
/// Returns true if the given -target triple and -target-variant triple
|
|
/// can be zippered.
|
|
bool triplesAreValidForZippering(const llvm::Triple &target,
|
|
const llvm::Triple &targetVariant);
|
|
|
|
/// Returns true if the given triple represents an OS that ships with
|
|
/// ABI-stable swift libraries (eg. in /usr/lib/swift).
|
|
bool tripleRequiresRPathForSwiftInOS(const llvm::Triple &triple);
|
|
|
|
/// Returns the platform name for a given target triple.
|
|
///
|
|
/// For example, the iOS simulator has the name "iphonesimulator", while real
|
|
/// iOS uses "iphoneos". OS X is "macosx". (These names are intended to be
|
|
/// compatible with Xcode's SDKs.)
|
|
///
|
|
/// If the triple does not correspond to a known platform, the empty string is
|
|
/// returned.
|
|
StringRef getPlatformNameForTriple(const llvm::Triple &triple);
|
|
|
|
/// Returns the platform Kind for Darwin triples.
|
|
DarwinPlatformKind getDarwinPlatformKind(const llvm::Triple &triple);
|
|
|
|
/// Maps an arbitrary platform to its non-simulator equivalent.
|
|
///
|
|
/// If \p platform is not a simulator platform, it will be returned as is.
|
|
DarwinPlatformKind getNonSimulatorPlatform(DarwinPlatformKind platform);
|
|
|
|
/// Returns the architecture component of the path for a given target triple.
|
|
///
|
|
/// Typically this is used for mapping the architecture component of the
|
|
/// path.
|
|
///
|
|
/// For example, on Linux "armv6l" and "armv7l" are mapped to "armv6" and
|
|
/// "armv7", respectively, within LLVM. Therefore the component path for the
|
|
/// architecture specific objects will be found in their "mapped" paths.
|
|
///
|
|
/// This is a stop-gap until full Triple support (ala Clang) exists within swiftc.
|
|
StringRef getMajorArchitectureName(const llvm::Triple &triple);
|
|
|
|
/// Computes the normalized target triple used as the most preferred name for
|
|
/// module loading.
|
|
///
|
|
/// For platforms with fat binaries, this canonicalizes architecture,
|
|
/// vendor, and OS names, strips OS versions, and makes inferred environments
|
|
/// explicit. For other platforms, it returns the unmodified triple.
|
|
///
|
|
/// The input triple should already be "normalized" in the sense that
|
|
/// llvm::Triple::normalize() would not affect it.
|
|
llvm::Triple getTargetSpecificModuleTriple(const llvm::Triple &triple);
|
|
|
|
/// Computes the target triple without version information.
|
|
llvm::Triple getUnversionedTriple(const llvm::Triple &triple);
|
|
|
|
/// Get the Swift runtime version to deploy back to, given a deployment target expressed as an
|
|
/// LLVM target triple.
|
|
Optional<llvm::VersionTuple>
|
|
getSwiftRuntimeCompatibilityVersionForTarget(const llvm::Triple &Triple);
|
|
} // end namespace swift
|
|
|
|
#endif // SWIFT_BASIC_PLATFORM_H
|
|
|