Migrating to ParseSwiftOG: From Parse-SDK-iOS-OSX

[cbaker6]

Parse-Swift provides a modernized Swift SDK that allows developers to take advantage of the latest and greatest Swift and SwiftUI has to offer (SwiftUI, Combine, async/await, etc). In addition, Parse-Server 6.0.0+ has been released which has a number of feature additions for querying, live-queries, etc. Parse-Swift^OG is miles ahead of the Parse-SDK-iOS-OSX and by my estimates (I have a solid understanding of all of the major Parse Client SDK's), I would say Parse-Swift^OG 2+ years ahead of Parse-SDK-iOS-OSX in development time. There's one feature the Parse-SDK-iOS-OSX SDK has that Parse-Swift doesn't and that's a local CoreData store. The CoreData store in Parse-SDK-iOS-OSX has a number of noted issues (more in #69) and can't be used when cache is enabled. The caching system in Parse-Swift is native and far better than the custom caching system in Parse-SDK-iOS-OSX. I discuss a better way to Parse-Swift with local storage in #69.

Migrating your project from Parse-SDK-iOS-OSX to Parse-Swift will take some work as the frameworks are completely different along with the design philosophy (see more in README). Nonetheless, migrating your project is possible (see discussion). After converting the code, you will most likely want to access the Keychain from Parse-SDK-iOS-OSX to provide a seamless experience for your users.

Parse-Swift makes this easy, please see the information here and here to learn about the methods available to migrate to Parse-Swift. An example application that demonstrates how to convert from the Objective-C SDK to the Swift SDK can be found at ParseMigrateKeychain. Specifically, look at ContentViewModel.swift for code examples. The basic steps are below:

1. Open your project, click on your project in the Project Navigator panel
2. Select the name of your project under Project in the right panel
3. Click the Package Dependencies tab
4. Add the https://github.com/netreconlab/Parse-Swift/ and for Dependency Rule, select Up to Next Major Version and input 5.1.1 for the specific version and < 6.0.0
5. If the Objective-C SDK was already added via SPM, skip the next 2 steps
6. Remove the Objective-C SDK from your project if it was added via Cocoapods
7. Add the Objective-C SDK to your project using SPM. You can use this repo as you will only need PFUser and PFInstallation
8. Convert your app from using the Objective-C SDK to the Swift SDK
9. Create a User and Installation model that conform to ParseObject
10. Migrate PFUser->User using loginUsingObjCKeychain
11. Migrate PFInstallation->Installation using become
12. Remove the Objective-C SDK from your project after you have migrated all users

[cbaker6]

@ashish-naik if you are migrating your project from the Objective-C SDK, this discussion may be of interest to you.

[ashish-naik]

I am interested but not immediately. I have added to my "want to use" list :)

[cbaker6]

Not a problem, be sure to also checkout #72 to see the feature comparisons with the other Parse SDK's