# The CloudKit Catalog iOS app

This iOS app written in Swift provides code samples of some of the core API methods of the CloudKit Framework. Topics

covered:

1. Requesting discoverability permission and retrieving users' discoverable information.

2. Querying records.

3. CRUD operations on zones.

4. CRUD operations on records.

5. Fetching and paginating through changed records in a zone using CloudKit's syncing capabilities.

6. CRUD operations on subscriptions.

7. Registering for notifications and marking them as read.

## Configuration

Before running the sample app you must change the bundle identifier in the *General* tab of your project settings to a

container identifier that you own. The app requires a record type **Items** with the following fields.

* name : String

* location : Location

* asset : Asset

Create this record type through CloudKit Dashboard if it doesn't already exist. You can also create a couple of public

records through the dashboard and then view them in the Query section of the app.

## Running the app

Whether you are running the app on a simulator or a device, you must be signed in to iCloud to use the CloudKit API methods

other than the query sample which doesn't require authentication.

### Receiving notifications

You must run the app on a device to test CloudKit notifications. You will be prompted to give the app permission to receive 

remote notifications on startup. Then, to test notifications, create a zone-level (for instance) subscription and write

records to that zone using the javascript sample (pointing to the same container - see the corresponding instructions). You

will not be notified of record changes if those changes are made from the same device, so you must either use another device or

the javascript sample. When you have been notified of a change to a zone, you can run the **FetchRecordChanges** operation on 

that zone to get the changed records. This is covered by the **Sync** section of the app.

Copyright (C) 2015 Apple Inc. All rights reserved.