Migrate All Apps from 12.2 to 13.0

Mobile SDK 13.0 migration is easiest if you use the Salesforce CLI plugin or the Mobile SDK npm scripts.

Before you begin upgrading, read about new 13.0 features in What’s New in Mobile SDK 13.0.

Native iOS (Swift, Objective-C)

Make sure that you installed the supported versions of iOS and Xcode. See iOS Basic Requirements, or use the Set Up Your Mobile SDK Developer Tools Trailhead project.
Choose one of these options.
- (Recommended) Use the Salesforce CLI Mobile SDK plugin or the forceios npm script: Recreate your app. For Saleforce CLI, follow the instructions at the command line by typing: sfdx mobilesdk:ios:create help For forceios, follow the instructions in “Updating Native and React Native Apps” at Updating Mobile SDK Apps (5.0 and Later).
- Use CocoaPods: If you created your app manually by using CocoaPods, see Refreshing Mobile SDK Pods.
- Do it manually: Manually create a new native template app in Swift. Follow the instructions in Creating an iOS Swift Project Manually.

After you recreate your app:

Migrate your app’s artifacts into the new template.
Review the list of APIs deprecated for future removal, and address any items that affect your codebase. See iOS Current Deprecations.
After a successful build, check compiler warnings for deprecations or other Mobile SDK issues that you missed.
Consider adopting new features. See What’s New in Mobile SDK 13.0.

Native Android (Java, Kotlin)

Make sure that you installed the supported versions of Android SDK and Android Studio. See Native Android Requirements, or use the Set Up Your Mobile SDK Developer Tools Trailhead project.
Choose one of these options.
- (Recommended) Use the Salesforce CLI Mobile SDK plugin or forcedroid npm script: Recreate your app. For Saleforce CLI, follow the instructions at the command line by typing: sfdx mobilesdk:android:create help For forcedroid, follow the instructions in “Updating Native and React Native Apps” at Updating Mobile SDK Apps (5.0 and Later).
- Use Maven: If you created your app manually by using Maven, see Using Maven to Update Mobile SDK Libraries in Android Apps.

After you recreate your app:

Migrate your app’s artifacts into the new template.
Review the list of APIs deprecated for future removal, and address any items that affect your codebase until your build succeeds. See Android Current Deprecations.
After a successful build, check the compiler warnings for deprecations or other Mobile SDK issues that you missed.
Consider adopting new features. See What’s New in Mobile SDK 13.0.

React Native

Recreate your app with the Salesforce CLI Mobile SDK plug-in or the forcereact npm script. For Saleforce CLI, follow the instructions at the command line by typing: sfdx mobilesdk:reactnative:create help For forcereact, follow the instructions in “Updating Native and React Native Apps” at Updating Mobile SDK Apps (5.0 and Later).

After you recreate your app:

Migrate your app’s artifacts into the new template.
Make sure that you installed the supported versions of the mobile platforms that you’re targeting. See the Set Up Your Mobile SDK Developer Tools Trailhead project.
Consider adopting new features. See What’s New in Mobile SDK 13.0.

Hybrid

Make sure that you installed the supported versions of the mobile platforms that you’re targeting. See the Set Up Your Mobile SDK Developer Tools Trailhead project.
Recreate your app with the Salesforce CLI Mobile SDK plug-in or the forcehybrid npm script. For Saleforce CLI, follow the instructions at the command line by typing: sfdx mobilesdk:hybrid:create help For forcehybrid, follow the instructions in “Updating Hybrid Apps” at Updating Mobile SDK Apps (5.0 and Later).
After you recreate your app:
- Migrate your app’s artifacts into the new template.
- Make sure that you installed the supported versions of the mobile platforms that you’re targeting. See the Set Up Your Mobile SDK Developer Tools Trailhead project.
- Consider adopting new features. See What’s New in Mobile SDK 13.0.