registerCloudKitShare(_:container:)
Registers a CloudKit share for the user to modify.
Declaration
func registerCloudKitShare(_ share: CKShare, container: CKContainer)Parameters
- share:
The CloudKit share to modify.
- container:
The CloudKit container that stores the shared records.
Discussion
Use this method when the CloudKit share already exists on the server and you want to update it. The behavior of the sharing service depends on the role of the current user. An owner can edit the share’s configuration, which includes managing participants and their permissions. A participant can view the share’s configuration and choose to stop participating.
If you’re unsure which container to use, fetch the share’s metadata using CKFetchShareMetadataOperation. Then initialize an instance of CKContainer using the metadata’s containerIdentifier property.
Use the NSCloudSharingServiceDelegate protocol to respond to any changes the sharing service makes.
The following example shows how to create an item provider with an existing share. It then invokes the cloud-sharing service with the provider and presents the share’s configuration to the user.
func modifyShare(_ share: CKShare, in container: CKContainer) {
// Create an item provider and register a share that
// already exists on the server.
let itemProvider = NSItemProvider()
itemProvider.registerCloudKitShare(share, container: container)
// Create and invoke the cloud-sharing service to
// present the share configuration to the user.
if let service = NSSharingService(named: .cloudSharing),
service.canPerform(withItems: [itemProvider]) {
service.perform(withItems: [itemProvider])
}
}