Releases: forcedotcom/SalesforceMobileSDK-iOS
Salesforce Mobile SDK 13.0.0
What's New in Mobile SDK 13.0.0
Mobile SDK 13.0 is a major release that features user experience improvements, asynchronous REST API requests, REST wrappers for SFAP APIs, JWT-based access tokens support, LogReceiver support, and SmartStore support for several SQLCipher editions.
In major releases, we typically remove items that have been deprecated. To learn about new features and breaking changes that can affect your app, read the rest of this article. In every release, be sure to check your compiler logs for deprecation warnings so that you can address these changes before they go into effect.
Add Connection Screen Redesign
We redesigned the Add Connection screen for better accessibility.
Note: The updated screen comes with new localizable strings. If your app supports localization, see our updated list of Localizable.strings and localize the latest additions.
Asynchronous REST API Requests
We updated the way REST API requests are handled in the RestClient class.
- To streamline error handling, we replaced the callback-based patterns used in previous versions with Swift’s asynchronous concurrency model.
- We refactored our network requests to use
asyncandawaitmethods instead of completion handlers. - We’re deprecating completion-based methods in favor of
asyncandawaitmethods. See iOS Current Deprecations.
Hybrid Remote Application Session Management
In hybrid remote applications, we now use session IDs, sourced from the login and refresh token endpoints, to load the app’s start page. This replaces the behavior in previous versions, which relied on a frontdoor URL to establish a UI session.
Note: This feature requires hybrid authentication, which is enabled by default. To verify the hybrid authentication setting, ensure that the useHybridAuthentication property in SalesforceSDKManager is set to true.
REST Wrappers for SFAP APIs
We introduced REST wrappers for SFAP APIs in the SfapClient class. SFAP requires JWT-based access tokens, which we now support. See REST Wrappers for SFAP APIs.
Receive Logs with LogReceiver
You can now receive logs with LogReceiver. See Receiving Logs with LogReceiver.
SmartStore Support for SQLCipher Editions
Smartstore now supports SQLCipher Commercial, Enterprise, and Enterprise FIPS. See Using SQLCipher with SmartStore.
Version Updates
- Deployment target: 17
- Base SDK version: 18
- Xcode: 16
External Component Version Updates
- React Native: 0.74.7
Removed APIs
See iOS APIs Removed in Mobile SDK 13.0.
Deprecated APIs
Check your compiler warnings, or see iOS Current Deprecations.
How to Upgrade Your Apps
For information on upgrading Mobile SDK apps, follow the instructions at Migrating from the Previous Release.
Salesforce Mobile SDK 12.2.0
What's New in Salesforce Mobile SDK 12.2.0
Mobile SDK 12.2 is a minor release that features QR code login, visionOS support, refresh behavior enhancements, and modernized support for iOS.
In interim releases, we often deprecate items in native libraries for removal in an upcoming major release. Be sure to check your compiler logs for deprecation warnings so that you can address any changes before they go into effect.
iOS 18 Compatibility
We’ve successfully tested Mobile SDK for compatibility with iOS 18 and XCode 16.
Single Access UI Bridge API
When displaying a Salesforce UI in a webview or external browser without requiring users to re-enter their credentials, we now use the Single Access UI Bridge API (UI Bridge API for short) to construct the frontdoor URL, which was previously constructed manually. See also:
QR Code Login
With the help of Apex classes, Visualforce Pages, UI Bridge API, and new Mobile SDK methods, we can now log users in with a QR code. To learn more about QR code login and how to set it up, see:
Refresh Behavior Enhancements
We enhanced our token refresh behavior for 403 (Bad_OAuth_Token) responses. Where apps previously managed a 403 response by performing a preliminary REST call to update the access token, we now refresh the token automatically.
The new refresh behavior impacts the /service/oauth2 endpoint and helps with our new REST wrapper for UI Bridge API.
visionOS Support
We added support for visionOS. See Add visionOS as a supported destination for your app in Apple’s documentation.
External Component Version Updates
- React Native: 0.74.5
How to Upgrade Your Apps
For information on upgrading Mobile SDK apps, follow the instructions at Migrating from the Previous Release.
Salesforce Mobile SDK 12.1.1
What's New in Salesforce Mobile SDK 12.1.1
Mobile SDK 12.1.1 is a minor patch release that features these changes.
- SQLCipher upgrade: 4.6.1 - see the SQLCipher release notes.
How to Upgrade Your Apps
For information on upgrading Mobile SDK apps, follow the instructions at Migrating from the Previous Release.
Salesforce Mobile SDK 12.1.0
What's New in Salesforce Mobile SDK 12.1.0
Mobile SDK 12.1 is a minor release that introduces user-registration and password-reset flows to the native login suite for Experience Cloud.
In interim releases, we often deprecate items in native libraries for removal in an upcoming major release. Be sure to check your compiler logs for deprecation warnings so that you can address any changes before they go into effect.
Native User Registration and Password Reset
We added user-registration and password-reset support for Experience Cloud sites, which means you can now fully customize the UI for these flows.
External Component Version Updates
- SQLCipher: 4.6.0
- Cordova: 7.1.1
- React Native: 0.74.3
How to Upgrade Your Apps
For information on upgrading Mobile SDK apps, follow the instructions at Migrating from the Previous Release.
Salesforce Mobile SDK 12.0.1
What's New in Salesforce Mobile SDK 12.0.1
Mobile SDK 12.0.1 is a minor patch release that features these changes.
- A Privacy Manifest update that's now compatible with a recent change in Apple's Static Analyzer.
- An upgrade to SQLCipher 4.5.7, which comes with Privacy Manifests. See the SQLCipher release notes at SQLCipher 4.5.7.
How to Upgrade Your Apps
For information on upgrading Mobile SDK apps, follow the instructions at Migrating from the Previous Release.
Salesforce Mobile SDK 12.0.0
What's New in Salesforce Mobile SDK 12.0.0
Mobile SDK 12.0 is a major release that provides support for native login for Experience Cloud, including passwordless login.
In major releases, we typically remove items that have been deprecated for removal. Read the following information to learn about new features and breaking changes that can affect your app. In every release, be sure to check your compiler logs for deprecation warnings so that you can address these changes before they go into effect.
How to Upgrade Your Apps
For information on upgrading Mobile SDK apps, follow the instructions at Migrating from the Previous Release.
Privacy Manifests
We've included privacy manifests in all of our libraries and upgraded our dependencies to a version that includes privacy manifests. For more information, see Apple's doc on privacy manifest files.
Encrypted Push Notifications Change
Starting in summer 2024, we’re using a new cipher mode for encrypting push notifications on the server.
- The server will only understand the new cipher mode after summer 2025.
- Mobile apps using Mobile SDK 12.0 can handle both the legacy and new cipher mode.
- To keep using encrypted push notifications, upgrade your mobile apps to Mobile SDK 12.0 (or a later version) before summer 2025.
Login Updates
-
We’ve added configurable URL handling for login, which allows apps to control how links on the login screen are handled. For example, a phone number on the login screen can now be configured to launch the device’s phone application.
-
We’ve fixed a bug that caused the biometric authentication opt-in status to be reset on login.
Version Updates
- Deployment target: 16
- Base SDK version: 17
- Xcode: 15
External Component Version Updates
- SQLCipher: 4.5.6
- SQLite: 3.44.2
- FMDB: 2.7.10
- React Native: 0.73.6
- Cordova iOS: 7.1.0
- sf (previously sfdx): v2
Removed APIs
See iOS APIs Removed in Mobile SDK 12.0.
Deprecated APIs
Check your compiler warnings, or see iOS Current Deprecations.
Salesforce Mobile SDK 11.1.0
What's New in Salesforce Mobile SDK 11.1.0
Mobile SDK 11.1.0 is a minor release that features modernized support for iOS.
In interim releases, we often deprecate items in native libraries for removal in an upcoming major release. Be sure to check your compiler logs for deprecation warnings so that you can address any changes before they go into effect.
iOS 17 Compatibility
We’ve successfully tested Mobile SDK for compatibility with iOS 17 and XCode 15.
Swift Package Manager Support
We’ve introduced Swift Package Manager (SPM) support, which can now be used to bring the Mobile SDK into applications.
Binary frameworks for Mobile SDK are hosted on a new repo: https://github.com/forcedotcom/SalesforceMobileSDK-iOS-SPM.
We added a new iOSNativeSwiftPackageManager template, which pulls its dependencies through Swift Package Manager.
See also: Creating an iOS Swift Project Manually, Add Mobile SDK Libraries to Your Project, Creating an iOS Project with Forceios.
External Component Version Updates
- React Native: 0.70.14
- Cordova iOS: 7.0.1
Deprecated APIs
Check your compiler warnings, or see iOS Current Deprecations.
How to Upgrade Your Apps
For information on upgrading Mobile SDK apps, follow the instructions at Migrating from the Previous Release.
Salesforce Mobile SDK 11.0.1
What's New in Salesforce Mobile SDK 11.0.1
Mobile SDK 11.0.1 is a minor patch release that features these changes.
- Bug fixes for login and refresh with custom domain and enhanced domain
- Access token re-hydration in hybrid apps and when using an IDP flow
- Improved read performance for Key-Value Stores
How to Upgrade Your Apps
For information on upgrading Mobile SDK apps, follow the instructions at Migrating from the Previous Release.
Salesforce Mobile SDK 11.0.0
What's New in Salesforce Mobile SDK 11.0.0
Mobile SDK 11.0 is a major release that modernizes several authentication flows. In major releases, we typically remove items that have been deprecated for removal. Read the following information to learn about new features and breaking changes that can affect your app. In every release, be sure to check your compiler logs for deprecation warnings so that you can address these changes before they go into effect.
How to Upgrade Your Apps
For information on upgrading Mobile SDK apps, follow the instructions at Migrating from the Previous Release.
General Updates in Mobile SDK 11.0
These changes apply to more than one platform.
- The default authentication now uses Web Server Flow instead of User-Agent Flow.
- Device system biometric authentication for logins.
- Reworked multi-app SSO flows and configurations with identity providers.
Version Updates
- Deployment target: 15
- Base SDK version: 16
- Xcode: 14
External Component Version Updates
- SQLCipher: 4.5.4
- SQLite: 3.41.2
- React Native: 0.70.6
- Cordova Command Line: 12.0.0
- Cordova iOS: 6.3.0
Removed APIs
See iOS APIs Removed in Mobile SDK 11.0.
Deprecated APIs
Check your compiler warnings, or see iOS Current Deprecations.
Salesforce Mobile SDK 10.2.0
What's New in Salesforce Mobile SDK 10.2 for iOS
Mobile SDK 10.2 is an interim release that features non-breaking API changes and modernized iOS support. In interim releases, we often deprecate items in native libraries for removal in an upcoming major release. Be sure to check your compiler logs for deprecation warnings so that you can address any changes before they go into effect.
Feature Updates
iOS 16 Compatibility
We’ve successfully tested Mobile SDK for compatibility with iOS 16. See iOS 16 Release Notes.
Note
Apple has not released iPadOS 16 at this time. The latest release of iPadOS is 15.6. Mobile SDK remains compatible with this release.
External Component Version Updates
- SQLite: 3.39.2
- SQLCipher: 4.5.2
- React Native: 0.70.1
- ShellJS: 0.8.5 (for command line tools)
- TypeScript: 4.8.3 (for React Native)
How to Upgrade Your Apps
For information on upgrading Mobile SDK apps, follow the instructions at Migrating from the Previous Release.
Deprecations
Check your compiler warnings, or see iOS Current Deprecations.