Integration with AccessorySetupKit

.github/workflows/build-and-test.yml

@@ -16,14 +16,32 @@ on:
   workflow_dispatch:
 
 jobs:
-  packageios:
+  package_ios:
     name: Build and Test Swift Package iOS
     uses: StanfordSpezi/.github/.github/workflows/xcodebuild-or-fastlane.yml@v2
     with:
       runsonlabels: '["macOS", "self-hosted", "spezi"]'
       scheme: SpeziBluetooth-Package
-      artifactname: SpeziBluetooth-Package.xcresult
-      resultBundle: SpeziBluetooth-Package.xcresult
+      artifactname: SpeziBluetooth-iOS.xcresult
+      resultBundle: SpeziBluetooth-iOS.xcresult
+  buildandtest_visionos:
+    name: Build and Test Swift Package visionOS
+    uses: StanfordSpezi/.github/.github/workflows/xcodebuild-or-fastlane.yml@v2
+    with:
+      runsonlabels: '["macOS", "self-hosted"]'
+      scheme: SpeziBluetooth-Package
+      destination: 'platform=visionOS Simulator,name=Apple Vision Pro'
+      resultBundle: SpeziBluetooth-visionOS.xcresult
+      artifactname: SpeziBluetooth-visionOS.xcresult
+  buildandtest_watchos:
+    name: Build and Test Swift Package watchOS
+    uses: StanfordSpezi/.github/.github/workflows/xcodebuild-or-fastlane.yml@v2
+    with:
+      runsonlabels: '["macOS", "self-hosted"]'
+      scheme: SpeziBluetooth-Package
+      destination: 'platform=watchOS Simulator,name=Apple Watch Series 10 (46mm)'
+      resultBundle: SpeziBluetooth-watchOS.xcresult
+      artifactname: SpeziBluetooth-watchOS.xcresult
   ios:
     name: Build and Test iOS
     uses: StanfordSpezi/.github/.github/workflows/xcodebuild-or-fastlane.yml@v2
@@ -48,9 +66,9 @@ jobs:
     secrets: inherit
   uploadcoveragereport:
     name: Upload Coverage Report
-    needs: [packageios, ios, macos]
+    needs: [package_ios, buildandtest_visionos, buildandtest_watchos, ios, macos]
     uses: StanfordSpezi/.github/.github/workflows/create-and-upload-coverage-report.yml@v2
     with:
-      coveragereports: SpeziBluetooth-Package.xcresult TestApp-iOS.xcresult TestApp-macOS.xcresult
+      coveragereports: SpeziBluetooth-iOS.xcresult SpeziBluetooth-visionOS.xcresult SpeziBluetooth-watchOS.xcresult TestApp-iOS.xcresult TestApp-macOS.xcresult
     secrets:
       token: ${{ secrets.CODECOV_TOKEN }}

Package.swift

@@ -2,9 +2,9 @@
 
 //
 // This source file is part of the Stanford Spezi open source project
-// 
+//
 // SPDX-FileCopyrightText: 2022 Stanford University and the project authors (see CONTRIBUTORS.md)
-// 
+//
 // SPDX-License-Identifier: MIT
 //
 
@@ -18,16 +18,20 @@ let package = Package(
     platforms: [
         .iOS(.v17),
         .macCatalyst(.v17),
-        .macOS(.v14)
+        .macOS(.v14),
+        .visionOS(.v1),
+        .watchOS(.v10),
+        .tvOS(.v17)
     ],
     products: [
         .library(name: "SpeziBluetoothServices", targets: ["SpeziBluetoothServices"]),
         .library(name: "SpeziBluetooth", targets: ["SpeziBluetooth"])
     ],
     dependencies: [
-        .package(url: "https://github.com/StanfordSpezi/SpeziFoundation", from: "2.0.0-beta.1"),
-        .package(url: "https://github.com/StanfordSpezi/Spezi", from: "1.7.1"),
-        .package(url: "https://github.com/StanfordSpezi/SpeziNetworking", from: "2.1.0"),
+        .package(url: "https://github.com/StanfordSpezi/SpeziFoundation.git", from: "2.0.0"),
+        .package(url: "https://github.com/StanfordSpezi/Spezi.git", from: "1.8.0"),
+        .package(url: "https://github.com/StanfordSpezi/SpeziViews.git", from: "1.7.0"),
+        .package(url: "https://github.com/StanfordSpezi/SpeziNetworking.git", from: "2.1.0"),
         .package(url: "https://github.com/apple/swift-nio.git", from: "2.59.0"),
         .package(url: "https://github.com/apple/swift-collections.git", from: "1.0.4"),
         .package(url: "https://github.com/apple/swift-atomics.git", from: "1.2.0"),
@@ -38,6 +42,7 @@ let package = Package(
             name: "SpeziBluetooth",
             dependencies: [
                 .product(name: "Spezi", package: "Spezi"),
+                .product(name: "SpeziViews", package: "SpeziViews"),
                 .product(name: "NIO", package: "swift-nio"),
                 .product(name: "OrderedCollections", package: "swift-collections"),
                 .product(name: "SpeziFoundation", package: "SpeziFoundation"),

Sources/SpeziBluetooth/AccessorySetupKit/ASAccessoryEventType+Description.swift

@@ -0,0 +1,51 @@
+//
+// This source file is part of the Stanford Spezi open-source project
+//
+// SPDX-FileCopyrightText: 2024 Stanford University and the project authors (see CONTRIBUTORS.md)
+//
+// SPDX-License-Identifier: MIT
+//
+
+#if canImport(AccessorySetupKit) && !os(macOS)
+import AccessorySetupKit
+
+
+extension ASAccessoryEventType: @retroactive CustomStringConvertible, @retroactive CustomDebugStringConvertible {
+    public var description: String {
+        switch self {
+        case .unknown:
+            "unknown"
+        case .activated:
+            "activated"
+        case .invalidated:
+            "invalidated"
+        case .migrationComplete:
+            "migrationComplete"
+        case .accessoryAdded:
+            "accessoryAdded"
+        case .accessoryRemoved:
+            "accessoryRemoved"
+        case .accessoryChanged:
+            "accessoryChanged"
+        case .pickerDidPresent:
+            "pickerDidPresent"
+        case .pickerDidDismiss:
+            "pickerDidDismiss"
+        case .pickerSetupBridging:
+            "pickerSetupBridging"
+        case .pickerSetupFailed:
+            "pickerSetupFailed"
+        case .pickerSetupPairing:
+            "pickerSetupPairing"
+        case .pickerSetupRename:
+            "pickerSetupRename"
+        @unknown default:
+            "ASAccessoryEventType(rawValue: \(rawValue))"
+        }
+    }
+
+    public var debugDescription: String {
+        description
+    }
+}
+#endif

Sources/SpeziBluetooth/AccessorySetupKit/ASDiscoveryDescriptor.Range+Description.swift

@@ -0,0 +1,32 @@
+//
+// This source file is part of the Stanford Spezi open-source project
+//
+// SPDX-FileCopyrightText: 2024 Stanford University and the project authors (see CONTRIBUTORS.md)
+//
+// SPDX-License-Identifier: MIT
+//
+
+#if canImport(AccessorySetupKit) && !os(macOS)
+import AccessorySetupKit
+
+
+@available(iOS 18, *)
+@available(macCatalyst, unavailable)
+@available(visionOS, unavailable)
+extension ASDiscoveryDescriptor.Range: @retroactive CustomStringConvertible, @retroactive CustomDebugStringConvertible {
+    public var description: String {
+        switch self {
+        case .default:
+            "default"
+        case .immediate:
+            "immediate"
+        @unknown default:
+            "Range(rawValue: \(rawValue))"
+        }
+    }
+
+    public var debugDescription: String {
+        description
+    }
+}
+#endif

Sources/SpeziBluetooth/AccessorySetupKit/AccessoryEventRegistration.swift

@@ -0,0 +1,51 @@
+//
+// This source file is part of the Stanford Spezi open-source project
+//
+// SPDX-FileCopyrightText: 2024 Stanford University and the project authors (see CONTRIBUTORS.md)
+//
+// SPDX-License-Identifier: MIT
+//
+
+import Foundation
+
+
+/// An event handler registration for accessory events.
+///
+/// It automatically cancels the subscription once this value is de-initialized.
+public struct AccessoryEventRegistration: ~Copyable, Sendable {
+    private let id: UUID
+    private weak var setupKit: (AnyObject & Sendable)? // type erased as AccessorySetupKit is only available on iOS 18 platform.
+
+    @available(iOS 18.0, *)
+    @available(macCatalyst, unavailable)
+    init(id: UUID, setupKit: AccessorySetupKit?) {
+        self.id = id
+        self.setupKit = setupKit
+    }
+
+    static func cancel(id: UUID, setupKit: (AnyObject & Sendable)?, isolation: isolated (any Actor)? = #isolation) {
+#if os(iOS) && !targetEnvironment(macCatalyst)
+        guard #available(iOS 18, *) else {
+            return
+        }
+
+        guard let setupKit, let typedSetupKit = setupKit as? AccessorySetupKit else {
+            return
+        }
+
+        typedSetupKit.cancelHandler(for: id)
+#else
+        preconditionFailure("Not available on this platform!")
+#endif
+    }
+
+    /// Cancel the subscription.
+    /// - Parameter isolation: Inherits the current actor isolation. If running on the MainActor cancellation is processed instantly.
+    public func cancel(isolation: isolated (any Actor)? = #isolation) {
+        Self.cancel(id: id, setupKit: setupKit)
+    }
+
+    deinit {
+        Self.cancel(id: id, setupKit: setupKit)
+    }
+}