SDK Download

Version 3.3.6 - Jan 11, 2017
or download the library directly
Download

Changelog

Want to see how the rest of your backend is evolving? Check out the timeline.

Language / VersionKinvey SDK VersionLatest Version
Swift 33.3Download Version 3.3.6
Swift 2.33.2Download Version 3.2.6
Swift 2.23.1 (deprecated)Download Version 3.1.0
Objective-C1.x (deprecated)Download Version 1.41.4

Swift 2.3 Deprecation

Xcode 8.2 is now out. Apple has announced that Xcode 8.2 will be the last release to support Swift 2.3. Read Xcode 8.2 Release Notes for more details. Please migrate your projects from Swift 2.3 to Swift 3 as soon as possible, by selecting Edit > Convert > To Current Swift Syntax when you open your project.

3.3.6
- Jan 11, 2017

  • Improvement: CustomEndpoint has now support for arrays and custom types
  • Bug fix: Updates of existing objects causing a crash
  • Bug fix: KinveyDateTransform missing a public constructor
  • Bug fix: UserMetadata properties without a public access
  • Bug fix: FileStore.getInstance() crashing if called before a creation of a DataStore instance
  • Deploy fix: zip distribution of SDK was missing XCGLogger 3rd party library

3.2.6
- Jan 11, 2017

  • Bug fix: KinveyDateTransform missing a public constructor
  • Bug fix: UserMetadata properties without a public access

3.3.5
- Dec 19, 2016

  • Improvement: throws an error if super.propertyMapping() was not called inside of the propertyMapping() method for a Entity subclass
  • Improvement: logging is now done by a 3rd party library called XCGLogger.
  • Improvement: Push now supports the new Push API in iOS 10. A new method was added for apps to register for push: Push.registerForNotifications() (all parameters optional). The previous method Push.registerForPush() is now deprecated for iOS 10 and above.
Kinvey.sharedClient.push.registerForNotifications { granted, error in
    if granted {
        //registered successfully
    } else {
        //failed to register
    }
}

3.2.5
- Dec 19, 2016

  • Bug fix: User object nil even when MIC login succeed

3.3.4
- Dec 8, 2016

  • Improvement: Kinvey.Error now implements CustomStringConvertible and CustomDebugStringConvertible which means you can now print() and debugPrint() errors. Also, errors now have the httpResponse and data properties, which allows you to check http status codes and the response body.
  • Deprecation: class method User.resetPassword(email:) and User.resetPassword(username:) are now deprecated. Please use the class method User.resetPassword(usernameOrEmail:) instead.
  • Bug fix: Fix for CocoaPods and Carthage.
  • Bug fix: Temporary _ids values are being sent to the backend.
  • Bug fix: If a migration schema block is not provided, the local cache is deleted on a schema mismatch between versions.
  • Bug fix: Progress not being reported if the Content-Length header was not present in the response.

3.2.4
- Dec 8, 2016

  • Improvement: Kinvey.Error now implements CustomStringConvertible and CustomDebugStringConvertible which means you can now print() and debugPrint() errors. Also errors now also have the httpResponse and data properties allowing you to check things like http status codes and the response body for example.

3.3.3
- Nov 21, 2016

  • Improvement: adding custom fields during sign up.
client.userType = MyUser.self

let user = MyUser()
user.foo = "bar"
User.signup(user: user) { user, error in
    if let user = user {
        //success
    } else {
        //failure
    }
}
  • Bug fix: updated the following request headers -
    • User-Agent
    • X-Kinvey-Client-App-Version
    • X-Kinvey-Device-Information
  • Enhancement: New API added for the developer to set an app version. This value is sent to the backend as the X-Kinvey-Client-App-Version request header.
Kinvey.sharedClient.clientAppVersion = "1.0.0"
  • Bug fix: migration schema not being executed is now fixed. If you made changes to your entity classes, make sure that you increase the schema version and provide a migration block as shown below:
// Version 1
class Person: Entity {

    dynamic var firstName: String?
    dynamic var lastName: String?

    override class func collectionName() -> String {
        return "Person"
    }

    override func propertyMapping(_ map: Map) {
        super.propertyMapping(map)

        firstName <- map["firstName"]
        lastName <- map["lastName"]
    }

}

// Version 2
class Person: Entity {

    dynamic var fullName: String?

    override class func collectionName() -> String {
        return "Person"
    }

    override func propertyMapping(_ map: Map) {
        super.propertyMapping(map)

        fullName <- map["fullName"]
    }

}

// Migrating your data during client initialization
Kinvey.sharedClient.initialize(appKey: "<#appKey#>", appSecret: "<#appSecret#>", schemaVersion: 2) { migration, oldSchemaVersion in
    migration.execute(Person.self) { (oldEntity) in
        var newEntity = oldEntity
        if oldSchemaVersion < 2 {
            newEntity["fullName"] = "\(oldEntity["firstName"]!) \(oldEntity["lastName"]!)"
            newEntity.removeValue(forKey: "firstName")
            newEntity.removeValue(forKey: "lastName")
        }

        return newEntity
    }
}

3.2.3
- Nov 21, 2016

  • Same changes presented in the 3.3.3 version, but for projects using Swift 2.3

3.3.2
- Oct 28, 2016

  • Support for Xcode 8.1 and Swift 3.0.1
  • Minimum iOS version is now iOS 9
  • Improvement: User.presentMICViewController() now uses SFSafariViewController as the default option to login using MIC. To explore other options add the parameter micUserInterface using one of the options in the MICUserInterface enum.
User.presentMICViewController(redirectURI: URL(string: "<#myRedirectURL://#>")!) { (user, error) -> Void in
    if let user = user {
        self.userIdLabel.text = user.userId
    }
    self.completionHandler?(user, error)
}

If you are using the default .safari option for the micUserInterface, remember to add the code below in your app delegate.

func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
    if User.login(redirectURI: URL(string: "<#myRedirectURL://#>")!, micURL: url) {
        return true
    }

    return false
}

3.2.2
- Oct 28, 2016

  • Minimum iOS version is now iOS 9
  • Improvement: User.presentMICViewController() now uses SFSafariViewController as the default option to login using MIC. To explore other options add the parameter micUserInterface using one of the options in the MICUserInterface enum.
User.presentMICViewController(redirectURI: NSURL(string: "<#myRedirectURL://#>")!) { (user, error) -> Void in
    if let user = user {
        self.userIdLabel.text = user.userId
    }
    self.completionHandler?(user, error)
}

If you are using the default .Safari option for the micUserInterface, remember to add the code below in your app delegate.

func application(application: UIApplication, openURL url: NSURL, sourceApplication: String?, annotation: AnyObject) -> Bool {
    if User.login(redirectURI: NSURL(string: "<#myRedirectURL://#>")!, micURL: url) {
        return true
    }

    return false
}

3.3.1
- Oct 20, 2016

  • Fix for CocoaPods

3.2.1
- Oct 21, 2016

  • Fix for CocoaPods

3.3.0
- Sep 15, 2016

  • Support for Swift 3 and Xcode 8

  • This version of the SDK requires Swift 3 and XCode 8 (or above).

  • Known issue: several Kinvey app developers have reported seeing a Keychain issue when the app logs in a user on iOS 10 Simulator. The error message looks like the following: Terminating app due to uncaught exception 'KinveyException', reason: 'Could not write token to keychain. Err (null) (-34018)' This is a known issue with the iOS 10 simulator. To work around it, you can share the keychain.

3.2.0
- Sep 14, 2016

  • Support for Swift 2.3 and Xcode 8

  • This version of the SDK requires Swift 2.3 and XCode 8 (or above). If you are using Swift 2.2, please refer to the SDK release 3.1.x.

3.1.0
- Sep 12, 2016

  • Bug fix: Regular expressions for Query objects not working properly

3.0.25
- Aug 25, 2016

  • Improvement: Upload, download and a few DataStore operations like find() and pull() can now report progress of the request
let request = store.find() { (events, error) in
    //completion handler
}

request.progress = {
    //progress handler
    print("Progress: \($0.countOfBytesReceived)/\($0.countOfBytesExpectedToReceive)")
}
  • Improvement: New method DataStore.count() returns the total number of records in a colletion.
let store = DataStore<Event>.collection(.Network)
store.count { (count, error) in
    //completion handler
}
  • Improvement: Query now supports skip and limit modifiers, enabling support for pagination.
let query = Query {
    $0.skip = 10
    $0.limit = 50
}

store.find(query) {
    //it will get max of 50 results starting from the 11th record
}
User.loginWithAuthorization(redirectURI: "myRedirectURI://", username: "myUsername", password: "myPassword") { user, error in
    if (user != nil) {
        //logged in successfully
    } else if (error != nil) {
        //something went wrong if the error object is not nil
    } else {
        //should never happen!
    }
}
  • Bug fix: find() operations returning wrong results for StoreType.Network

3.0.24
- Aug 12, 2016

  • Improvement: Forgot username method is now available:
User.forgotUsername(email: "your@email.com") { error in
}
  • Improvement: User lookup method is now available:
let userQuery = UserQuery {
    $0.username = username
}
user.lookup(userQuery) { users, error in
}
  • Improvement: Files are now cached by default:
let file: File = ...
fileStore.download(file) { (file, url: NSURL?, error) in
    //file is now cached
}

With an optional parameter to not cache the downloaded files:

let file: File = ...
fileStore.download(file, storeType: .Network) { (file, url: NSURL?, error) in
    //file is not cached
}
  • Improvement: MIC API Version is not available:
client.micApiVersion = "v2" //v1 is the default value
  • Improvement: Better errro handling returning more appropriate error types
  • Bugfix: deltaSet parameter was not being considered for sync operations
  • Bugfix: custom User types are not working correctly
  • Bugfix: DeltaSet requests being wrongly built
  • Bugfix: Pull requests are now consistent between platforms

3.0.23
- Jul 18, 2016

  • Fixing dependencies for CocoaPods spec.

3.0.22
- Jul 15, 2016

  • API breaking changes:
    • Object Mapping has changed: Please check out our Data Store Guide how to do object mapping now.
    • Method renaming: To get an instance of DataStore you now have to call the collection() method instead of getInstance()
  • Improvement: Change user's password
let user: User = ...
user.changePassword(newPassword: "myNewPassword") { user, error in
}
  • Improvement: Send user's email verification
let user: User = ...
user.sendEmailConfirmation { error in
}
  • Improvement: Social login for Facebook, Twitter, Google+ and LinkedIn
User.login(authSource: .Facebook, facebookAuthDictionary) { user, error in
}

3.0.21 Beta
- Jun 21, 2016

  • Improvement: Added support for push(), pull(), sync() and purge() operations on DataStoreType.Cache
  • Improvement: DataStore.syncCount() method added
  • Improvement: Client.logNetworkEnabled enables the ability of log network requests and responses. Default value is false
Kinvey.sharedClient.logNetworkEnabled = true //it will start log network requests and responses
  • Improvement: Better error handling checking pre-required conditions
  • Bugfix: not crashing for non-supported types and support for NSCoding objects, more support types to come

3.0.20 Beta
- May 24, 2016

  • Bug fix: Login with MIC sending wrong authorization headers.

3.0.19 Beta
- May 20, 2016

  • Support for split the local cache data in multiple files using tags. For example: DataStore<MyCollection>.getInstance(.Network, tag: "MyCustomDataContainer")

3.0.18 Beta
- May 19, 2016

  • Acl now includes readers and writers permissions.
  • Error now includes a localized description error. Available only in English for now.
  • FileStore now supports resumable uploads and downloads.
  • Delta Set Cache is not enabled by default anymore. To enable Delta Set Cache now you can call something like DataStore<MyCollection>.getInstance(.Network, deltaSet: true)
  • Bug fix: Login with MIC when the user does not exists yet.

3.0.17 Beta
- Apr 28, 2016

  • Bug fix: returning wrong results when there's an empty DataStore with delta set cache enabled.

3.0.16 Beta
- Apr 27, 2016

  • Allow encryption on your local DataStores
  • Better handling for push() method
  • Bug fix: returning wrong results when there's no change in a DataStore with delta set cache enabled.

3.0.15 Beta
- Apr 21, 2016

  • Performance improvements on delta set caching
  • Bug fix: allow custom serialize and deserialize Persistable objects using fromJson() and toJson() methods

3.0.14 Beta
- Apr 18, 2016

  • Add support for custom endpoints
  • Allow custom file path for DataStore
let store = DataStore<MyPersistableClass>.getInstance(filePath: customPath)
  • Bug fixes
    • Logout User
    • ACL as a mandatory field
    • Register for Push

3.0.13 Beta
- Mar 22, 2016

  • Bug fixes
  • Xcode 7.3 and Swift 2.2 ready

3.0.11 Beta
- Mar 21, 2016

  • Delta Set Cache implemented
  • Bug fixes

3.0.7 Beta
- Mar 2, 2016

  • Universal binary Framework available
  • Bug fixes:
    • Purge, push and sync reviewed
    • Metadata entities removed when related entities are removed
    • Some queries causing crashes

3.0 Beta
- Feb 25, 2016

The beta version of the iOS 3.0 SDK is now available!

New in this release:

  • Full support for data synchronization between your app and backend. Refer to the Data Store Guide to learn how to use the new data manipulation APIs.

  • We've simplified data stores and caching policies, making it easier for you to start building apps with caching and offline built in.

  • The Kinvey framework is now a published as a module.

Code samples and API docs for Objective-C are coming soon.

Download Older Versions

We recommend using the latest version.

Version Download Date
3.3.6 Download Jan 11, 2017
3.2.6 Download Jan 11, 2017
3.3.5 Download Dec 19, 2016
3.2.5 Download Dec 19, 2016
3.3.4 Download Dec 8, 2016
3.2.4 Download Dec 8, 2016
3.3.3 Download Nov 21, 2016
3.2.3 Download Nov 21, 2016
3.3.2 Download Oct 28, 2016
3.2.2 Download Oct 28, 2016
3.3.1 Download Oct 20, 2016
3.2.1 Download Oct 21, 2016
3.3.0 Download Sep 15, 2016
3.2.0 Download Sep 14, 2016
3.1.0 Download Sep 12, 2016
3.0.25 Download Aug 25, 2016
3.0.24 Download Aug 12, 2016
3.0.23 Download Jul 18, 2016
3.0.22 Download Jul 15, 2016
3.0.21 Beta Download Jun 21, 2016
3.0.20 Beta Download May 24, 2016
3.0.19 Beta Download May 20, 2016
3.0.18 Beta Download May 19, 2016
3.0.17 Beta Download Apr 28, 2016
3.0.16 Beta Download Apr 27, 2016
3.0.15 Beta Download Apr 21, 2016
3.0.14 Beta Download Apr 18, 2016
3.0.13 Beta Download Mar 22, 2016
3.0.11 Beta Download Mar 21, 2016
3.0.7 Beta Download Mar 2, 2016
3.0 Beta Download Feb 25, 2016
Got a question?