Skip to content

AccessorySetupKit macOS xcode26.0 b2

Rolf Bjarne Kvinge edited this page Aug 13, 2025 · 3 revisions

#AccessorySetupKit.framework https://github.com/dotnet/macios/pull/23528

diff -ruN /Applications/Xcode_26.0.0-beta.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessory.h /Applications/Xcode_26.0.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessory.h
--- /Applications/Xcode_26.0.0-beta.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessory.h	2025-05-23 07:54:48
+++ /Applications/Xcode_26.0.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessory.h	2025-06-13 05:34:25
@@ -16,13 +16,15 @@
 @class ASPickerDisplayItem;
 
 //---------------------------------------------------------------------------------------------------------------------------
-/*!    @brief        Authorized Accessory State
-*/
+/// A type that defines values for the state of an accessory.
 typedef NS_ENUM( NSInteger, ASAccessoryState )
 {
-    ASAccessoryStateUnauthorized            = 0,    // Invalid or Unauthorized Accessory.
-    ASAccessoryStateAwaitingAuthorization   = 10,   // Selected by user but pending for full authorization.
-    ASAccessoryStateAuthorized              = 20,   // Authorized and available Accessory.
+    /// The accessory is invalid or unauthorized.
+    ASAccessoryStateUnauthorized            = 0,
+    /// The accessory is selected, but full authorization is still pending.
+    ASAccessoryStateAwaitingAuthorization   = 10,
+    /// The accessory is authorized and available.
+    ASAccessoryStateAuthorized              = 20,
 } NS_SWIFT_NAME(ASAccessory.AccessoryState);
 
 //---------------------------------------------------------------------------------------------------------------------------
diff -ruN /Applications/Xcode_26.0.0-beta.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessorySession.h /Applications/Xcode_26.0.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessorySession.h
--- /Applications/Xcode_26.0.0-beta.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessorySession.h	2025-05-23 07:54:48
+++ /Applications/Xcode_26.0.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASAccessorySession.h	2025-06-13 11:01:35
@@ -34,7 +34,9 @@
 /// To monitor for changes in this list, use your event handler to watch for the events ``ASAccessoryEventType/accessoryAdded``, ``ASAccessoryEventType/accessoryChanged``, and ``ASAccessoryEventType/accessoryRemoved``.
 @property (readonly, copy, nonatomic) NSArray *accessories;
 
-/// Picker display settings to modify discovery timeout.
+/// Settings that affect the display of the accessory picker.
+///
+/// Use this property to configure settings like the picker timeout.
 @property (readwrite, copy, nullable, nonatomic) ASPickerDisplaySettings *pickerDisplaySettings
 API_AVAILABLE( ios( 26.0 ) ) API_UNAVAILABLE(macos, macCatalyst, watchos, tvos, visionos);
 
@@ -110,10 +112,12 @@
 
 /// Displays a view to upgrade an accessory with additional technology permissions.
 ///
+/// Call this method to upgrade previously-added SSID-based accessories to use WiFi Aware.
+///
 /// - Parameters:
-///   - accessory: The accessory to be updated
-///   - descriptor: An updated descriptor that the picker uses to add new technology authorization for provided accessory.
-///   - completionHandler: A block or closure that executes after the picker is shown. The completion handler receives an  instance if the upgrade operation encounters an error.
+///   - accessory: The accessory to update.
+///   - descriptor: An updated descriptor that the picker uses to add new technology authorization for the provided accessory.
+///   - completionHandler: A block or closure that executes after the picker is shown. The completion handler receives an  instance if the upgrade operation encounters an error. In Swift, you can omit the completion handler by calling the method asynchronously and catching any error thrown by the method.
 - (void) updateAuthorization:(ASAccessory *) accessory
                   descriptor:(ASDiscoveryDescriptor *) descriptor
            completionHandler:(void(^)(NSError * _Nullable error)) completionHandler
diff -ruN /Applications/Xcode_26.0.0-beta.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASCommon.h /Applications/Xcode_26.0.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASCommon.h
--- /Applications/Xcode_26.0.0-beta.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASCommon.h	2025-05-23 07:54:48
+++ /Applications/Xcode_26.0.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASCommon.h	2025-06-13 05:34:25
@@ -34,20 +34,28 @@
 
 // MARK: == Constants and Types ==
 
+/// The type used to identify a Bluetooth accessory provider.
 typedef uint16_t ASBluetoothCompanyIdentifier NS_TYPED_EXTENSIBLE_ENUM;
 
 // MARK: - Interfaces
 //===========================================================================================================================
 
+/// A type that specifies how to filter a property against a given string and comparison options.
 AS_EXTERN
 API_AVAILABLE( ios( 26.0 ) ) API_UNAVAILABLE(macos, macCatalyst, watchos, tvos, visionos)
 NS_SWIFT_SENDABLE
-@interface ASPropertyCompareString : NSObject 
+@interface ASPropertyCompareString : NSObject
 
+/// The string to compare against.
 @property (readonly, copy, nonatomic) NSString *string;
 
+/// Comparison options to apply when comparing strings.
 @property (readonly, assign, nonatomic) NSStringCompareOptions compareOptions;
 
+/// Creates a property compare string instance with the given string and comparison options.
+/// - Parameters:
+///   - string: The string to compare against.
+///   - compareOptions: Options to apply when comparing strings.
 - (instancetype)initWithString:(NSString *) string compareOptions:(NSStringCompareOptions) compareOptions
     NS_DESIGNATED_INITIALIZER;
 
diff -ruN /Applications/Xcode_26.0.0-beta.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASDiscoveryDescriptor.h /Applications/Xcode_26.0.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASDiscoveryDescriptor.h
--- /Applications/Xcode_26.0.0-beta.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASDiscoveryDescriptor.h	2025-05-23 07:54:48
+++ /Applications/Xcode_26.0.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASDiscoveryDescriptor.h	2025-06-13 11:01:35
@@ -29,11 +29,12 @@
 } NS_SWIFT_NAME(ASDiscoveryDescriptor.Range);
 
 //---------------------------------------------------------------------------------------------------------------------------
-/*!    @brief        Wi-Fi Aware Service's Role
-*/
+/// A type that defines service roles for Wi-Fi Aware accessories.
 typedef NS_ENUM( NSInteger, ASDiscoveryDescriptorWiFiAwareServiceRole )
 {
+    /// The subscriber service role.
     ASDiscoveryDescriptorWiFiAwareServiceRoleSubscriber       = 10,
+    /// The publisher service role.
     ASDiscoveryDescriptorWiFiAwareServiceRolePublisher        = 20,
 } NS_SWIFT_NAME(ASDiscoveryDescriptor.WiFiAwareServiceRole);
 
@@ -83,7 +84,9 @@
 @property (readwrite, copy, nullable, nonatomic) NSString *wifiAwareServiceName
 API_AVAILABLE( ios( 26.0 ) ) API_UNAVAILABLE(macos, macCatalyst, watchos, tvos, visionos);
 
-/// The accessory's Wi-Fi Aware's service. Default is `ASDiscoveryDescriptorWiFiAwareServiceRoleSubscriber`
+/// The role of the accessory's Wi-Fi Aware's service.
+///
+/// This property defaults to ``ASDiscoveryDescriptor/WiFiAwareServiceRole/subscriber``
 @property (readwrite, assign, nonatomic) ASDiscoveryDescriptorWiFiAwareServiceRole wifiAwareServiceRole
 API_AVAILABLE( ios( 26.0 ) ) API_UNAVAILABLE(macos, macCatalyst, watchos, tvos, visionos);
 
@@ -91,7 +94,7 @@
 @property (readwrite, copy, nullable, nonatomic) ASPropertyCompareString *wifiAwareModelNameMatch
 API_AVAILABLE( ios( 26.0 ) ) API_UNAVAILABLE(macos, macCatalyst, watchos, tvos, visionos);
 
-/// The accessory's Wi-Fi Aware vendor name  and matching options.
+/// The accessory's Wi-Fi Aware vendor name and matching options.
 @property (readwrite, copy, nullable, nonatomic) ASPropertyCompareString *wifiAwareVendorNameMatch
 API_AVAILABLE( ios( 26.0 ) ) API_UNAVAILABLE(macos, macCatalyst, watchos, tvos, visionos);
 
diff -ruN /Applications/Xcode_26.0.0-beta.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplaySettings.h /Applications/Xcode_26.0.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplaySettings.h
--- /Applications/Xcode_26.0.0-beta.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplaySettings.h	2025-05-23 07:54:48
+++ /Applications/Xcode_26.0.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AccessorySetupKit.framework/Headers/ASPickerDisplaySettings.h	2025-06-13 05:34:25
@@ -13,17 +13,18 @@
 NS_ASSUME_NONNULL_BEGIN
 
 //---------------------------------------------------------------------------------------------------------------------------
-/*!    @brief        Discovery Timeout
-*/
+
+/// The type used for the accessory picker's discovery timeout value.
 typedef NSTimeInterval ASPickerDisplaySettingsDiscoveryTimeout NS_TYPED_ENUM NS_SWIFT_NAME(ASPickerDisplaySettings.DiscoveryTimeout) API_AVAILABLE( ios( 26.0 ) );
 
-/// Picker discovery timeout for about 60 seconds.
+/// A picker discovery timeout value that times out after about about 60 seconds.
 AS_EXTERN ASPickerDisplaySettingsDiscoveryTimeout const ASPickerDisplaySettingsDiscoveryTimeoutShort API_AVAILABLE( ios( 26.0 ) );
-/// Picker discovery timeout for about 2 minutes.
+/// A picker discovery timeout value that times out after about two minutes.
 AS_EXTERN ASPickerDisplaySettingsDiscoveryTimeout const ASPickerDisplaySettingsDiscoveryTimeoutMedium API_AVAILABLE( ios( 26.0 ) );
-/// Picker discovery timeout for about 5 minutes.
+/// A picker discovery timeout value that times out after about five minutes.
 AS_EXTERN ASPickerDisplaySettingsDiscoveryTimeout const ASPickerDisplaySettingsDiscoveryTimeoutLong API_AVAILABLE( ios( 26.0 ) );
 
+/// A type that contains settings to customize the display of the accessory picker
 AS_EXTERN
 API_AVAILABLE( ios( 26.0 ) ) API_UNAVAILABLE(macos, macCatalyst, watchos, tvos, visionos)
 NS_SWIFT_SENDABLE

Clone this wiki locally