[5.9] Add visionOS as a platform alongside iOS, tvOS, watchOS, and the others (#6663)

Add new enum constants for visionOS in all the places where it is appropriate.

This includes the `platforms` parameter in the manifest, whose purpose is to list the minimum deployment targets that a package requires. Since there is initially only visionOS 1.0, and because absence of a platform in the `platforms` parameter means that the default version is supported (not that the platform is unsupported), all packages implicitly support visionOS 1.0 whether or not they list it in the `platforms` parameter. But having the enum constant alongside those for the other Apple platforms makes everything consistent, and will become important for any future versions.

This change also makes the `visionOS` platform available for use in conditional target dependencies.

rdar://107064954
(cherry picked from commit 809cb15)

Author: abertelrud

Sources/PackageCollections/Providers/JSONPackageCollectionProvider.swift

@@ -480,6 +480,8 @@ extension PackageModel.Platform {
             self = PackageModel.Platform.tvOS
         case let name where name.contains("watchos"):
             self = PackageModel.Platform.watchOS
+        case let name where name.contains("visionos"):
+            self = PackageModel.Platform.visionOS
         case let name where name.contains("driverkit"):
             self = PackageModel.Platform.driverKit
         case let name where name.contains("linux"):

Sources/PackageDescription/PackageDescription.docc/Curation/SupportedPlatforms.md

@@ -23,6 +23,13 @@
 - <doc:/documentation/PackageDescription/Platform/watchOS>
 - ``WatchOSVersion``
 
+### Supporting visionOS
+
+- ``visionOS(_:)-3ip0z``
+- ``visionOS(_:)-6ur2u``
+- <doc:/documentation/PackageDescription/Platform/visionOS>
+- ``VisionOSVersion``
+
 ### Supporting tvOS
 
 - ``tvOS(_:)-6931l``

Sources/PackageDescription/SupportedPlatforms.swift

@@ -45,6 +45,9 @@ public struct Platform: Equatable {
     /// The watchOS platform.
     public static let watchOS: Platform = Platform(name: "watchos")
 
+    /// The visionOS platform.
+    public static let visionOS: Platform = Platform(name: "visionos")
+
     /// The DriverKit platform
     public static let driverKit: Platform = Platform(name: "driverkit")
 
@@ -224,6 +227,33 @@ public struct SupportedPlatform: Equatable {
         return SupportedPlatform(platform: .watchOS, version: SupportedPlatform.WatchOSVersion(string: versionString).version)
     }
 
+    /// Configure the minimum deployment target version for the visionOS
+    /// platform.
+    ///
+    /// - Since: First available in PackageDescription 5.9
+    ///
+    /// - Parameter version: The minimum deployment target that the package supports.
+    /// - Returns: A `SupportedPlatform` instance.
+    @available(_PackageDescription, introduced: 5.9)
+    public static func visionOS(_ version: SupportedPlatform.VisionOSVersion) -> SupportedPlatform {
+        return SupportedPlatform(platform: .visionOS, version: version.version)
+    }
+
+    /// Configure the minimum deployment target version for the visionOS
+    /// platform using a custom version string.
+    ///
+    /// The version string must be a series of two or three dot-separated integers, such as `1.0` or `1.0.0`.
+    ///
+    /// - Since: First available in PackageDescription 5.9
+    ///
+    /// - Parameter versionString: The minimum deployment target as a string
+    ///     representation of two or three dot-separated integers, such as `1.0.0`.
+    /// - Returns: A `SupportedPlatform` instance.
+    @available(_PackageDescription, introduced: 5.9)
+    public static func visionOS(_ versionString: String) -> SupportedPlatform {
+        return SupportedPlatform(platform: .visionOS, version: SupportedPlatform.VisionOSVersion(string: versionString).version)
+    }
+
     /// Configures the minimum deployment target version for the DriverKit platform.
     ///
     /// - Parameter version: The minimum deployment target that the package supports.
@@ -594,6 +624,25 @@ extension SupportedPlatform {
         public static let v10: WatchOSVersion = .init(string: "10.0")
     }
 
+    /// The supported visionOS version.
+    public struct VisionOSVersion: AppleOSVersion {
+        fileprivate static let name = "visionOS"
+        fileprivate static let minimumMajorVersion = 1
+
+        /// The underlying version representation.
+        let version: String
+
+        fileprivate init(uncheckedVersion version: String) {
+            self.version = version
+        }
+
+        /// The value that represents visionOS 1.0.
+        ///
+        /// - Since: First available in PackageDescription 5.9.
+        @available(_PackageDescription, introduced: 5.9)
+        public static let v1: VisionOSVersion = .init(string: "1.0")
+    }
+
     /// The supported DriverKit version.
     public struct DriverKitVersion: AppleOSVersion {
         fileprivate static let name = "DriverKit"

Sources/PackageModel/ManifestSourceGeneration.swift

@@ -142,6 +142,8 @@ fileprivate extension SourceCodeFragment {
             self.init(enum: "tvOS", string: platform.version)
         case "watchos":
             self.init(enum: "watchOS", string: platform.version)
+        case "visionos":
+            self.init(enum: "visionOS", string: platform.version)
         case "driverkit":
             self.init(enum: "driverKit", string: platform.version)
         default:
@@ -367,6 +369,7 @@ fileprivate extension SourceCodeFragment {
             case "ios": return SourceCodeFragment(enum: "iOS")
             case "tvos": return SourceCodeFragment(enum: "tvOS")
             case "watchos": return SourceCodeFragment(enum: "watchOS")
+            case "visionos": return SourceCodeFragment(enum: "visionOS")
             case "driverkit": return SourceCodeFragment(enum: "driverKit")
             default: return SourceCodeFragment(enum: platformName)
             }

Sources/PackageModel/MinimumDeploymentTarget.swift

@@ -81,6 +81,8 @@ private extension PackageModel.Platform {
             return ("appletvos", "TVOS")
         case .watchOS:
             return ("watchos", "WATCHOS")
+        case .visionOS:
+            return ("xros", "XROS")
         case .driverKit:
             return nil // DriverKit does not support XCTest.
         default:

Sources/PackageModel/Platform.swift

@@ -38,6 +38,7 @@ public struct Platform: Equatable, Hashable, Codable {
     public static let iOS: Platform = Platform(name: "ios", oldestSupportedVersion: "11.0")
     public static let tvOS: Platform = Platform(name: "tvos", oldestSupportedVersion: "11.0")
     public static let watchOS: Platform = Platform(name: "watchos", oldestSupportedVersion: "4.0")
+    public static let visionOS: Platform = Platform(name: "visionos", oldestSupportedVersion: "1.0")
     public static let driverKit: Platform = Platform(name: "driverkit", oldestSupportedVersion: "19.0")
     public static let linux: Platform = Platform(name: "linux", oldestSupportedVersion: .unknown)
     public static let android: Platform = Platform(name: "android", oldestSupportedVersion: .unknown)

Sources/PackageModel/PlatformRegistry.swift

@@ -31,6 +31,6 @@ public final class PlatformRegistry {
 
     /// The static list of known platforms.
     private static var _knownPlatforms: [Platform] {
-        return [.macOS, .macCatalyst, .iOS, .tvOS, .watchOS, .linux, .windows, .android, .wasi, .driverKit, .openbsd]
+        return [.macOS, .macCatalyst, .iOS, .tvOS, .watchOS, .visionOS, .linux, .windows, .android, .wasi, .driverKit, .openbsd]
     }
 }

Sources/Workspace/InitPackage.swift

@@ -781,6 +781,8 @@ extension PackageModel.Platform {
             return "tvOS"
         case .watchOS:
             return "watchOS"
+        case .visionOS:
+            return "visionOS"
         case .driverKit:
             return "DriverKit"
         default:
@@ -816,6 +818,8 @@ extension SupportedPlatform {
             return (9...14).contains(version.major)
         case .watchOS:
             return (2...7).contains(version.major)
+        case .visionOS:
+            return (1...1).contains(version.major)
         case .driverKit:
             return (19...20).contains(version.major)
 

Sources/XCBuildSupport/PIF.swift

@@ -953,6 +953,7 @@ public enum PIF {
             case USE_HEADERMAP
             case USES_SWIFTPM_UNSAFE_FLAGS
             case WATCHOS_DEPLOYMENT_TARGET
+            case XROS_DEPLOYMENT_TARGET
             case MARKETING_VERSION
             case CURRENT_PROJECT_VERSION
             case SWIFT_EMIT_MODULE_INTERFACE

Sources/XCBuildSupport/PIFBuilder.swift

@@ -273,6 +273,7 @@ final class PackagePIFProjectBuilder: PIFProjectBuilder {
         settings[.IPHONEOS_DEPLOYMENT_TARGET, for: .macCatalyst] = package.platforms.deploymentTarget(for: .macCatalyst)
         settings[.TVOS_DEPLOYMENT_TARGET] = package.platforms.deploymentTarget(for: .tvOS)
         settings[.WATCHOS_DEPLOYMENT_TARGET] = package.platforms.deploymentTarget(for: .watchOS)
+        settings[.XROS_DEPLOYMENT_TARGET] = package.platforms.deploymentTarget(for: .visionOS)
         settings[.DRIVERKIT_DEPLOYMENT_TARGET] = package.platforms.deploymentTarget(for: .driverKit)
         settings[.DYLIB_INSTALL_NAME_BASE] = "@rpath"
         settings[.USE_HEADERMAP] = "NO"
@@ -430,6 +431,7 @@ final class PackagePIFProjectBuilder: PIFProjectBuilder {
             settings[.IPHONEOS_DEPLOYMENT_TARGET] = mainTarget.platforms.deploymentTarget(for: .iOS)
             settings[.TVOS_DEPLOYMENT_TARGET] = mainTarget.platforms.deploymentTarget(for: .tvOS)
             settings[.WATCHOS_DEPLOYMENT_TARGET] = mainTarget.platforms.deploymentTarget(for: .watchOS)
+            settings[.XROS_DEPLOYMENT_TARGET] = mainTarget.platforms.deploymentTarget(for: .visionOS)
         }
 
         if product.type == .executable {