-
Notifications
You must be signed in to change notification settings - Fork 549
CloudKit iOS xcode26.0 b5
Alex Soto edited this page Aug 5, 2025
·
2 revisions
#CloudKit.framework
diff -ruN /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKAllowedSharingOptions.h /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKAllowedSharingOptions.h
--- /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKAllowedSharingOptions.h 2025-07-16 00:55:42
+++ /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKAllowedSharingOptions.h 2025-07-31 01:26:32
@@ -43,8 +43,9 @@
@property (assign) CKSharingParticipantPermissionOption allowedParticipantPermissionOptions;
@property (assign) CKSharingParticipantAccessOption allowedParticipantAccessOptions;
-/// Defaults to `NO`. If set, the system sharing UI will allow the user to choose whether added participants can invite others to the share.
-/// Shares with ``.administrator`` participants will be returned as read-only to devices running OS versions prior to the ``.administrator`` role being introduced. The ``.administrator`` participants on these read-only shares will be returned as ``.privateUser``.
+/// Default value is `NO`. If set, the system sharing UI will allow the user to choose whether added participants can invite others to the share.
+/// Shares with ``CloudKit/CKShareParticipantRole/CKShareParticipantRoleAdministrator`` participants will be returned as read-only to devices running OS versions prior to this role being introduced.
+/// Administrator participants on these read-only shares will be returned as ``CloudKit/CKShareParticipantRole/CKShareParticipantRolePrivateUser``.
@property (assign) BOOL allowsParticipantsToInviteOthers API_AVAILABLE(macos(26.0), ios(26.0), visionos(26.0)) API_UNAVAILABLE(tvos, watchos);
/*!
Standard allowed options are most permissive i.e. @c allowedParticipantPermissionOptions = @c CKSharingParticipantPermissionOptionAny
diff -ruN /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShare.h /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShare.h
--- /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShare.h 2025-07-11 22:43:13
+++ /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShare.h 2025-07-31 01:30:37
@@ -122,61 +122,79 @@
/// A list of all uninvited users who have requested access to this share.
///
-/// When share access requests are allowed, uninvited users can attempt to join the share
-/// by sending an access request. Those pending requests appear in this array.
-/// Share owners or administrators can approve the requester or use ``denyRequesters(_:)`` to respond
-/// to these access requests. Requesters are always returned with name components and either an email or phone number.
-/// Requesters can be approved by running ``CKFetchShareParticipantsOperation`` with the requester's ``CKShareAccessRequester/participantLookupInfo``
-/// and adding the resulting participant to the share.
+/// When share access requests are allowed, uninvited users can request to join the share.
+/// All pending access requests appear in this array. Each requester is returned with name components
+/// and either an email or phone number.
+///
+/// Either share owners or administrators can respond to these access requests.
+///
+/// ### Responding to Access Requests:
+///
+/// - **Approve Requesters:**
+/// - Fetch the participant information by running ``CKFetchShareParticipantsOperation`` with
+/// the requester's ``CKShareAccessRequester/participantLookupInfo``.
+/// - Add the resulting participant to the share.
+///
+/// - **Deny Requesters:**
+/// - Use ``CloudKit/CKShare/denyRequesters:`` to remove the requester from the requesters list.
+///
+/// - **Block Requesters:**
+/// - Use ``CloudKit/CKShare/blockRequesters:`` to block requesters.
+/// - Blocking a requester prevents them from sending future access requests to the share.
@property (readonly, copy) NSArray<CKShareAccessRequester *> *requesters CKSHARE_REQUEST_ACCESS_INTERFACES_AVAILABILITY;
/// A list of users blocked from requesting access to this share.
///
-/// Identities remain in this list until a user calls ``unblockIdentities(_:)``.
+/// Identities remain in this list until an owner or administrator calls ``CloudKit/CKShare/unblockIdentities:``.
@property (readonly, copy) NSArray<CKShareBlockedIdentity *> *blockedIdentities CKSHARE_REQUEST_ACCESS_INTERFACES_AVAILABILITY;
/// Indicates whether uninvited users can request access to this share.
///
-/// By default, allows access requests is `NO`
-/// When `YES`, uninvited users can submit an access request to the share
-/// if they discover the share URL. When `NO`, the server does not allow uninvited users
-/// to request access and does not reveal whether the share exists. This property can only be
-/// modified by the share owner or an admin. Attempting to change its value as any other
-/// participant will result in an exception.
+/// By default, this property is set to `NO`. When set to `YES`, uninvited users can request
+/// access to the share if they discover the share URL. When set to `NO`, the server prevents uninvited users
+/// from requesting access and does not indicate whether the share exists.
+///
+/// Only the share owner or an administrator can modify this property. Attempts by other participants
+/// to modify this property result in an exception.
@property (readwrite, assign) BOOL allowsAccessRequests CKSHARE_REQUEST_ACCESS_INTERFACES_AVAILABILITY;
-/// Denies share access to the specified requesters.
+/// Denies access requests from specified users.
///
-/// Use this method to reject pending requests from one or more uninvited users.
-/// Denied requesters are removed from the ``requesters`` array.
-/// You must save the share to the server after denying to persist the changes.
-/// Once saved, these requesters are not given access to the share, but they may attempt to request
-/// access again unless you block them. This method can only be used by the share owner or an
-/// admin. Attempting to use it as any other participant will result in an exception.
+/// Use this method to deny pending access requests from uninvited users. Denied requesters are removed
+/// from the ``CloudKit/CKShare/requesters`` array. To persist the changes, save the share to the server
+/// after calling this method.
///
-/// - Parameters:
-/// - requesters: An array of ``CKShareAccessRequester`` objects to deny.
+/// After denial, requesters can still submit new access requests unless explicitly blocked using
+/// ``CloudKit/CKShare/blockRequesters:``.
+///
+/// Only the share owner or an administrator can invoke this method. Attempts by other participants
+/// result in an exception.
+///
+/// - Parameter requesters: An array of ``CKShareAccessRequester`` objects to deny.
- (void)denyRequesters:(NSArray<CKShareAccessRequester *> *)requesters CKSHARE_REQUEST_ACCESS_INTERFACES_AVAILABILITY;
-/// Blocks the specified requesters from requesting access to this share.
+/// Blocks specified users from requesting access to this share.
///
-/// This method permanently prevents the listed requesters from requesting access to the share in the future.
-/// Blocked requesters appear in the ``blockedIdentities`` array.
-/// The share must be saved to the server after blocking to persist the changes. This method can only be used
-/// by the share owner or an admin. Attempting to use it as any other participant will result in an exception.
-/// Blocking an existing participant removes the participant from the share.
+/// Blocking prevents users from submitting future access requests and removes existing participants from the share.
+/// Blocked requesters appear in the ``CloudKit/CKShare/blockedIdentities`` array.
///
-/// - Parameters:
-/// - requesters: An array of ``CKShareAccessRequester`` objects to block.
+/// To persist this change, save the share to the server after calling this method.
+///
+/// Only the share owner or an administrator can invoke this method. Attempts by other participants
+/// result in an exception.
+///
+/// - Parameter requesters: An array of ``CKShareAccessRequester`` objects to block.
- (void)blockRequesters:(NSArray<CKShareAccessRequester *> *)requesters CKSHARE_REQUEST_ACCESS_INTERFACES_AVAILABILITY;
-/// Unblocks previously blocked identities, allowing them to request access again.
+/// Unblocks previously blocked users, allowing them to request access again.
///
-/// Call this method to remove the specified identities from the ``blockedIdentities`` array.
-/// Once unblocked, those identities are free to request access to the share unless access
-/// requests are disabled. You must save the share to commit this change to the server.
-/// This method can only be used by the share owner or an admin. Attempting to use it as any
-/// other participant will result in an exception.
+/// Use this method to remove specified identities from the ``CloudKit/CKShare/blockedIdentities`` array.
+/// Unblocked identities can request access again if access requests are enabled.
+///
+/// To persist this change, save the share to the server after calling this method.
+///
+/// Only the share owner or an administrator can invoke this method. Attempts by other participants
+/// result in an exception.
///
/// - Parameter blockedIdentities: An array of ``CKShareBlockedIdentity`` objects to unblock.
- (void)unblockIdentities:(NSArray<CKShareBlockedIdentity *> *)blockedIdentities CKSHARE_REQUEST_ACCESS_INTERFACES_AVAILABILITY;
diff -ruN /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareAccessRequester.h /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareAccessRequester.h
--- /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareAccessRequester.h 2025-07-16 00:55:41
+++ /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareAccessRequester.h 2025-07-31 01:26:31
@@ -24,18 +24,21 @@
+ (instancetype)new NS_UNAVAILABLE;
- (instancetype)init NS_UNAVAILABLE;
-/// The user identity this share access requester represents.
+/// The identity of the user requesting access to the share.
@property (readonly, copy) CKUserIdentity *userIdentity;
-/// Convenience method to get the requester's lookup info.
-/// This lookup info can be used in ``CKFetchShareParticipantsOperation`` to approve the requester by fetching the corresponding participant and adding the participant to the share.
+/// Lookup information for the requester.
+///
+/// Use this lookup info with ``CKFetchShareParticipantsOperation`` to fetch the corresponding participant.
+/// Once fetched, add the participant to the share to approve the requester.
@property (nonatomic, readonly, copy) CKUserIdentityLookupInfo *participantLookupInfo;
#if !TARGET_OS_TV
-/// Returns a displayable `CNContact` for the requester, or a new `CNContact` if none exists in the user's contacts.
-/// Provides a standardized format for the requester's underlying lookup info in the user identity.
-/// Use when displaying the requester information to other participants and approvers in application UI.
+/// A displayable `CNContact` representing the requester.
+///
+/// If the requester doesn't exist in the user's contacts or is not accessible, returns a newly created `CNContact`.
+/// This provides formatted requester information suitable for display in the application's UI.
@property (nonatomic, readonly, copy) CNContact *contact;
#endif
diff -ruN /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareBlockedIdentity.h /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareBlockedIdentity.h
--- /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareBlockedIdentity.h 2025-07-16 00:55:42
+++ /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareBlockedIdentity.h 2025-07-31 01:26:33
@@ -24,14 +24,15 @@
+ (instancetype)new NS_UNAVAILABLE;
- (instancetype)init NS_UNAVAILABLE;
-/// The user identity this blocked identity represents.
+/// The identity of the user who has been blocked from requesting access to the share.
@property (readonly, copy, nonatomic) CKUserIdentity *userIdentity;
#if !TARGET_OS_TV
-/// Returns a displayable `CNContact` for the blocked identity, or a new `CNContact` if none exists in the user's contacts.
-/// Provides a standardized format for the blocked identity's underlying lookup info in the user identity.
-/// Use when displaying the blocked identity information to other participants in application UI.
+/// A displayable `CNContact` representing the blocked user.
+///
+/// If the blocked identity does not exist in the user's contacts or is not accessible, returns a newly created `CNContact`.
+/// This provides formatted blocked identity information suitable for display in the application's UI.
@property (nonatomic, readonly, copy) CNContact *contact;
#endif
diff -ruN /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareParticipant.h /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareParticipant.h
--- /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareParticipant.h 2025-07-11 22:57:06
+++ /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareParticipant.h 2025-07-31 02:13:45
@@ -31,8 +31,9 @@
/// - `privateUser`: Can access the share.
/// - `publicUser`: Self-added when accessing the share URL (owners cannot add public users).
/// - `administrator`: Can add and remove participants and change their permissions.
-
-/// Shares with ``.administrator`` participants will be returned as read-only to devices running OS versions prior to the ``.administrator`` role being introduced. The ``.administrator`` participants on these read-only shares will be returned as ``.privateUser``.
+///
+/// Shares with ``CloudKit/CKShareParticipantRole/CKShareParticipantRoleAdministrator`` participants will be returned as read-only to devices running OS versions prior to this role being introduced.
+/// Administrator participants on these read-only shares will be returned as ``CloudKit/CKShareParticipantRole/CKShareParticipantRolePrivateUser``.
typedef NS_ENUM(NSInteger, CKShareParticipantRole) {
CKShareParticipantRoleUnknown = 0,
CKShareParticipantRoleOwner = 1,
@@ -62,7 +63,7 @@
/*! The default participant role is @c CKShareParticipantRolePrivateUser. */
@property (assign) CKShareParticipantRole role API_AVAILABLE(macos(10.14), ios(12.0), tvos(12.0), watchos(5.0));
-/// The default participant type is ``CKShareParticipantTypePrivateUser``.
+/// The default participant type is ``CloudKit/CKShareParticipantType/CKShareParticipantTypePrivateUser``.
@property (assign) CKShareParticipantType type API_OBSOLETED_WITH_REPLACEMENT("role", macos(10.12, 10.14, 16.0), ios(10.0, 12.0, 19.0), tvos(10.0, 12.0, 19.0), watchos(3.0, 5.0, 12.0));
@property (readonly, assign) CKShareParticipantAcceptanceStatus acceptanceStatus;
@@ -73,10 +74,12 @@
/*! A unique identifier for this participant. */
@property (readonly, copy) NSString *participantID API_AVAILABLE(macos(10.12), ios(10.0), tvos(10.0), watchos(3.0)) NS_REFINED_FOR_SWIFT;
-/// `YES` if this participant was a requester before getting added to the share
+/// Indicates whether the participant was originally a requester who was approved to join the share.
@property (readonly, assign, nonatomic) BOOL isApprovedRequester API_AVAILABLE(macos(26.0), ios(26.0), tvos(26.0), watchos(26.0), visionos(26.0));
-/// The timestamp when the participant was added, set when the share is saved to the server.
+/// The date and time when the participant was added to the share.
+///
+/// This timestamp is set when the share is successfully saved to the server.
@property (nullable, readonly, copy, nonatomic) NSDate *dateAddedToShare API_AVAILABLE(macos(26.0), ios(26.0), tvos(26.0), watchos(26.0), visionos(26.0));
/// Generate a unique URL for inviting a participant without knowing their handle
diff -ruN /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareRequestAccessOperation.h /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareRequestAccessOperation.h
--- /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareRequestAccessOperation.h 2025-07-16 00:55:42
+++ /Applications/Xcode_26.0.0-beta5.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/CloudKit.framework/Headers/CKShareRequestAccessOperation.h 2025-07-31 01:26:32
@@ -15,36 +15,34 @@
API_AVAILABLE(macos(26.0), ios(26.0), tvos(26.0), watchos(26.0), visionos(26.0))
@interface CKShareRequestAccessOperation : CKOperation
-/// - Returns: A new ``CKShareRequestAccessOperation`` instance.
+/// Creates a new, empty share request access operation.
- (instancetype)init NS_DESIGNATED_INITIALIZER;
-/// Creates a ``CKShareRequestAccessOperation`` for requesting access to the specified shares.
+/// Creates a share request access operation configured with specified share URLs.
///
-/// - Parameter shareURLs: An array of `NSURL` objects for shares you wish to request access to
-/// - Returns: A ``CKShareRequestAccessOperation`` instance configured with the given share URLs.
+/// - Parameter shareURLs: An array of `NSURL` objects representing the shares to request access to.
+/// - Returns: A configured ``CKShareRequestAccessOperation`` instance.
- (instancetype)initWithShareURLs:(NSArray<NSURL *> *)shareURLs NS_SWIFT_NAME(init(shareURLs:));
-/// The share URLs for which access is being requested.
+/// The URLs of the shares to request access to.
///
-/// If requesting access to multiple shares, include multiple `NSURL` objects.
-/// The server processes them independently.
+/// Include multiple URLs to request access to multiple shares simultaneously. The server processes each URL independently.
@property (nullable, copy, nonatomic) NSArray<NSURL *> *shareURLs;
-/// A block that is called once for each share URL processed by the server.
+/// A completion block called once for each processed share URL.
///
-/// - Parameters:
-/// - shareURL: The URL of the processed share.
-/// - shareRequestAccessError: If non-nil, an error describing why the request failed for this share.
+/// The server does not disclose share existence to protect user privacy.
///
-/// The server does **not** reveal share existence to the requester to protect privacy.
+/// - Parameters:
+/// - shareURL: The URL of the share that was processed.
+/// - shareRequestAccessError: An error describing why the access request failed, or `nil` if successful.
@property (nullable, copy, nonatomic) void (^perShareAccessRequestCompletionBlock)(NSURL *shareURL, NSError * _Nullable shareRequestAccessError) NS_REFINED_FOR_SWIFT;
-/// A block that is called when the entire operation completes.
+/// A completion block called when the entire operation finishes.
///
-/// - Parameter operationError: If non-nil, an error describing why the request failed.
+/// - Parameter operationError: An error describing the overall operation failure, or `nil` if successful.
///
-/// If operationError is CKErrorPartialFailure, the userInfo dictionary
-/// contains per-share errors under ``CKPartialErrorsByItemIDKey``.
+/// If `operationError` is `CKErrorPartialFailure`, the `userInfo` dictionary contains detailed errors for each share under ``CKPartialErrorsByItemIDKey``.
@property (nullable, copy, nonatomic) void (^shareRequestAccessCompletionBlock)(NSError * _Nullable operationError) NS_REFINED_FOR_SWIFT;
@end