Multiplatform Phase 3 - Expose support in ProjectDescription

Sources/ProjectDescription/Dependencies/Dependencies.swift

@@ -25,7 +25,7 @@ public struct Dependencies: Codable, Equatable {
     public let swiftPackageManager: SwiftPackageManagerDependencies?
 
     /// List of platforms for which you want to install dependencies.
-    public let platforms: Set<Platform>
+    public let platforms: Set<PackagePlatform>
 
     /// Creates a new `Dependencies` manifest instance.
     /// - Parameters:
@@ -37,7 +37,7 @@ public struct Dependencies: Codable, Equatable {
     public init(
         carthage: CarthageDependencies? = nil,
         swiftPackageManager: SwiftPackageManagerDependencies? = nil,
-        platforms: Set<Platform> = Set(Platform.allCases)
+        platforms: Set<PackagePlatform> = Set(PackagePlatform.allCases)
     ) {
         self.carthage = carthage
         self.swiftPackageManager = swiftPackageManager

Sources/ProjectDescription/DeploymentDevice.swift

@@ -3,6 +3,7 @@ import Foundation
 // MARK: - DeploymentDevice
 
 /// A supported deployment device.
+@available(*, deprecated)
 public struct DeploymentDevice: OptionSet, Codable, Hashable {
     /// An iPhone device.
     public static let iphone = DeploymentDevice(rawValue: 1 << 0)

Sources/ProjectDescription/DeploymentTarget.swift

@@ -3,6 +3,7 @@ import Foundation
 // MARK: - DeploymentTarget
 
 /// A supported minimum deployment target.
+@available(*, deprecated)
 public enum DeploymentTarget: Codable, Hashable {
     /// The minimum iOS version, the list of devices your product will support, and whether or not the target should run on mac
     /// devices.

Sources/ProjectDescription/DeploymentTargets.swift

@@ -0,0 +1,54 @@
+import Foundation
+
+// MARK: - DeploymentTargets
+
+public struct DeploymentTargets: Hashable, Codable {
+    public let iOS: String?
+    public let macOS: String?
+    public let watchOS: String?
+    public let tvOS: String?
+    public let visionOS: String?
+
+    public init(iOS: String? = nil, macOS: String? = nil, watchOS: String? = nil, tvOS: String? = nil, visionOS: String? = nil) {
+        self.iOS = iOS
+        self.macOS = macOS
+        self.watchOS = watchOS
+        self.tvOS = tvOS
+        self.visionOS = visionOS
+    }
+
+    public subscript(platform: Platform) -> String? {
+        switch platform {
+        case .iOS:
+            return iOS
+        case .macOS:
+            return macOS
+        case .watchOS:
+            return watchOS
+        case .tvOS:
+            return tvOS
+        case .visionOS:
+            return visionOS
+        }
+    }
+
+    public static func iOS(_ version: String) -> DeploymentTargets {
+        DeploymentTargets(iOS: version)
+    }
+
+    public static func macOS(_ version: String) -> DeploymentTargets {
+        DeploymentTargets(macOS: version)
+    }
+
+    public static func watchOS(_ version: String) -> DeploymentTargets {
+        DeploymentTargets(watchOS: version)
+    }
+
+    public static func tvOS(_ version: String) -> DeploymentTargets {
+        DeploymentTargets(tvOS: version)
+    }
+
+    public static func visionOS(_ version: String) -> DeploymentTargets {
+        DeploymentTargets(visionOS: version)
+    }
+}

Sources/ProjectDescription/Destination.swift

@@ -0,0 +1,46 @@
+import Foundation
+
+public typealias Destinations = Set<Destination>
+
+extension Destinations {
+    public static var watchOS: Destinations = [.appleWatch]
+    public static var iOS: Destinations = [.iPhone, .iPad, .macWithiPadDesign]
+    public static var macOS: Destinations = [.mac]
+    public static var tvOS: Destinations = [.appleTv]
+    public static var visionOS: Destinations = [.appleVision]
+}
+
+extension Destinations {
+    public var platforms: Set<Platform> {
+        let platforms = map(\.platform)
+        return Set<Platform>(platforms)
+    }
+}
+
+/// A supported platform representation.
+public enum Destination: String, Codable, Equatable, CaseIterable {
+    case iPhone
+    case iPad
+    case mac
+    case macWithiPadDesign
+    case macCatalyst
+    case appleWatch
+    case appleTv
+    case appleVision
+    case appleVisionWithiPadDesign
+
+    public var platform: Platform {
+        switch self {
+        case .iPad, .iPhone, .macCatalyst, .macWithiPadDesign, .appleVisionWithiPadDesign:
+            return .iOS
+        case .mac:
+            return .macOS
+        case .appleTv:
+            return .tvOS
+        case .appleWatch:
+            return .watchOS
+        case .appleVision:
+            return .visionOS
+        }
+    }
+}

Sources/ProjectDescription/Multiplatform.swift

@@ -0,0 +1,3 @@
+import Foundation
+
+public enum Multiplatform {}

Sources/ProjectDescription/MultiplatformTarget.swift

@@ -0,0 +1,112 @@
+import Foundation
+
+extension Multiplatform {
+    /// A target which supports multiple platforms
+    public struct Target: Codable, Equatable {
+        /// The name of the target. Also, the product name if not specified with ``productName``.
+        public let name: String
+
+        /// The destinations this target supports
+        public let destinations: Destinations
+
+        /// The type of build product this target will output.
+        public let product: Product
+
+        /// The built product name. If nil, it will be equal to ``name``.
+        public let productName: String?
+
+        /// The product bundle identifier.
+        public let bundleId: String
+
+        /// The minimum deployment target your product will support.
+        public let deploymentTargets: DeploymentTargets?
+
+        /// The Info.plist representation.
+        public let infoPlist: InfoPlist?
+
+        /// The source files of the target.
+        /// Note: any playgrounds matched by the globs used in this property will be automatically added.
+        public let sources: SourceFilesList?
+
+        /// The resource files of target.
+        /// Note: localizable files, `*.lproj`, are supported.
+        public let resources: ResourceFileElements?
+
+        /// The build phase copy files actions for the target.
+        public let copyFiles: [CopyFilesAction]?
+
+        /// The headers for the target.
+        public let headers: Headers?
+
+        /// The entitlements file path for the target.
+        public let entitlements: Entitlements?
+
+        /// The build phase scripts actions for the target.
+        public let scripts: [TargetScript]
+
+        /// The target's dependencies.
+        public let dependencies: [TargetDependency]
+
+        /// The target's settings.
+        public let settings: Settings?
+
+        /// The Core Data models.
+        public let coreDataModels: [CoreDataModel]
+
+        /// The environment variables. Used by autogenerated schemes for the target.
+        public let environmentVariables: [String: EnvironmentVariable]
+
+        /// The launch arguments. Used by autogenerated schemes for the target.
+        public let launchArguments: [LaunchArgument]
+
+        /// The additional files for the target. For project's additional files, see ``Project/additionalFiles``.
+        public let additionalFiles: [FileElement]
+
+        /// The build rules used for transformation of source files during compilation.
+        public let buildRules: [BuildRule]
+
+        public init(
+            name: String,
+            destinations: Destinations,
+            product: Product,
+            productName: String? = nil,
+            bundleId: String,
+            deploymentTargets: DeploymentTargets? = nil,
+            infoPlist: InfoPlist? = .default,
+            sources: SourceFilesList? = nil,
+            resources: ResourceFileElements? = nil,
+            copyFiles: [CopyFilesAction]? = nil,
+            headers: Headers? = nil,
+            entitlements: Entitlements? = nil,
+            scripts: [TargetScript] = [],
+            dependencies: [TargetDependency] = [],
+            settings: Settings? = nil,
+            coreDataModels: [CoreDataModel] = [],
+            environmentVariables: [String: EnvironmentVariable] = [:],
+            launchArguments: [LaunchArgument] = [],
+            additionalFiles: [FileElement] = [],
+            buildRules: [BuildRule] = []
+        ) {
+            self.name = name
+            self.destinations = destinations
+            self.bundleId = bundleId
+            self.productName = productName
+            self.product = product
+            self.infoPlist = infoPlist
+            self.entitlements = entitlements
+            self.dependencies = dependencies
+            self.settings = settings
+            self.sources = sources
+            self.resources = resources
+            self.copyFiles = copyFiles
+            self.headers = headers
+            self.scripts = scripts
+            self.coreDataModels = coreDataModels
+            self.environmentVariables = environmentVariables
+            self.launchArguments = launchArguments
+            self.deploymentTargets = deploymentTargets
+            self.additionalFiles = additionalFiles
+            self.buildRules = buildRules
+        }
+    }
+}

Sources/ProjectDescription/Platform.swift

@@ -15,3 +15,19 @@ public enum Platform: String, Codable, Equatable, CaseIterable {
     /// The visionOS platform
     case visionOS = "visionos"
 }
+
+/// A supported platform representation.
+public enum PackagePlatform: String, Codable, Equatable, CaseIterable {
+    /// The iOS platform
+    case iOS = "ios"
+    /// The macOS platform
+    case macOS = "macos"
+    /// The macOS platform
+    case macCatalyst = "maccatalyst"
+    /// The watchOS platform
+    case watchOS = "watchos"
+    /// The tvOS platform
+    case tvOS = "tvos"
+    /// The visionOS platform
+    case visionOS = "visionos"
+}

Sources/ProjectDescription/PlatformFilter.swift

@@ -0,0 +1,15 @@
+public typealias PlatformFilters = Set<PlatformFilter>
+
+extension PlatformFilters {
+    public static let all = Set(PlatformFilter.allCases)
+}
+
+public enum PlatformFilter: Comparable, Hashable, Codable, CaseIterable {
+    case ios
+    case macos
+    case tvos
+    case catalyst
+    case driverkit
+    case watchos
+    case visionos
+}

Sources/ProjectDescription/Project.swift

@@ -71,6 +71,8 @@ public struct Project: Codable, Equatable {
     public let packages: [Package]
     /// The targets of the project.
     public let targets: [Target]
+    /// The targets of the project.
+    public let multiplatformTargets: [Multiplatform.Target]
     /// The custom schemes for the project. Default schemes for each target are generated by default.
     public let schemes: [Scheme]
     /// The build settings and configuration for the project.
@@ -89,6 +91,7 @@ public struct Project: Codable, Equatable {
         packages: [Package] = [],
         settings: Settings? = nil,
         targets: [Target] = [],
+        multiplatformTargets: [Multiplatform.Target] = [],
         schemes: [Scheme] = [],
         fileHeaderTemplate: FileHeaderTemplate? = nil,
         additionalFiles: [FileElement] = [],
@@ -99,6 +102,7 @@ public struct Project: Codable, Equatable {
         self.options = options
         self.packages = packages
         self.targets = targets
+        self.multiplatformTargets = multiplatformTargets
         self.schemes = schemes
         self.settings = settings
         self.additionalFiles = additionalFiles