Salesforce Mobile SDK 10.0.0

What's New in Salesforce Mobile SDK 10.0.0

Mobile SDK 10.0 is a major trust release. It includes breaking API changes, bug fixes, performance enhancements, minor feature additions, and updates. In major releases, we remove items in native libraries that were deprecated in interim releases. For your convenience, we've compiled lists of deprecated and removed native APIs.

What’s New for Native iOS

Binary Storage in Key-Value Stores

Key-value stores now support secure binary storage with new Mobile SDK APIs. See Using Key-Value Stores for Secure Data Storage.

Widgets in the MobileSyncExplorerSwift Template App

We've added a Recent Contacts widget to this template.

iOS and Xcode Version Updates

• Deployment target: 14
• Base SDK version: 15
• Xcode: 13

Removed APIs

See iOS APIs Removed in Mobile SDK 10.0.

Deprecated APIs

Check your compiler warnings, or see iOS Current Deprecations.

SmartStore Updates

Feature Deprecations

Due to improvements in third-party modules, SmartStore is now fully capable of handling large data sets. Therefore, the external storage feature and the SoupSpec class have been deprecated for removal in Mobile SDK 11.0. See iOS Current Deprecations.

External Component Version Updates

SQLCipher: 4.5.0
SQLite: 3.36.0
React Native: 0.67.1
Cordova command line: 11.0.0
node.js: 12.0 to latest LTS version

How to Upgrade Your Apps

For information on upgrading your apps, follow the instructions at Migrate All Apps from 9.2 to 10.0.

v9.2.1

What's New in Salesforce Mobile SDK 9.2.1

Mobile SDK 9.2.1 features minor internal bug fixes for iOS 15 compatibility.

• Updated the default keychain and file protection levels to improve support for background operations
• Minor improvements to the navigation bar appearance and the URL cache

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.

Salesforce Mobile SDK 9.2.0

What's New in Salesforce Mobile SDK 9.2 for iOS

Mobile SDK 9.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

Passcode Removal

We’ve removed app-specific passcodes from iOS apps in favor of mobile operating system security. Mobile SDK still honors an org’s passcode requirement but ignores passcode length, passcode timeout, and biometric settings from a connected app. For customers who’ve already configured a device lock screen or biometric unlock, this upgrade is seamless. For others, the new app lock screen prompts the customer to configure an authentication mode. When the customer reactivates the app from the background, the device passcode, rather than an app-specific passcode, is required. See About Logins and Passcode.

iOS 15 Compatibility

We’ve successfully tested Mobile SDK for compatibility with iOS 15. See iOS and iPadOS 15 Release Notes.

Encryption Upgrade

We’ve updated the default encryption from AES-CBC to AES-GCM. For most apps, Mobile SDK handles this upgrade silently with no app changes. For a few cases, though, you’ll need to perform a minor upgrade step. See Secure Key Storage in iOS.

External Component Version Updates

• Cordova-iOS: 6.2.0
• React Native: 0.66.0
• SQLite: 3.34.1
• SQLCipher: 4.4.3

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.

Salesforce Mobile SDK 9.1.1

What's New in Salesforce Mobile SDK 9.1.1

Mobile SDK 9.1.1 is a patch release that features SmartStore performance enhancements and minor bug fixes. This release does not break code compatibility.

How to Upgrade Your Apps

If you've upgraded to Mobile SDK 9.0 or later, update your Podfile and run pod update. Otherwise, follow the instructions at Migrating from the Previous Release.

Deprecations
Check your compiler warnings, or see iOS Current Deprecations in the Mobile SDK Development Guide.

Salesforce Mobile SDK 9.1

What's New in Salesforce Mobile SDK 9.1

Mobile SDK 9.1.0 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.

How to Upgrade Your Apps

To upgrade your Mobile SDK apps, follow the instructions at Migrating from the Previous Release.

General Updates

Catalyst Support

• Mobile SDK 9.1 brings Catalyst support to its iOS native libraries. You can now build your iPad apps to run on Intel and Silicon Macs.

iPad Support in Sample Apps

• The MobileSyncExplorerSwift template app now supports Catalyst and multiple windows for iPad.
• The RestAPIExplorer sample app now supports Catalyst.

REST API Wrapper Update

• We’ve added a batchSize parameter to requestForQuery methods of SFRestApi (Objective-C) and RestClient (Swift). Use this parameter to specify a preferred number of records to be returned in each fetch. Permissible values range from 200 to 2,000
  (default setting). To allow for run-time performance adjustments, Mobile SDK doesn’t guarantee that your requested size will be the
  actual batch size.

SmartStore Query Enhancement

• Smart SQL no longer requires index paths for fields referenced in SELECT or WHERE clauses.

Key-Value Stores, Version 2

• Key-value store version 2 debuts in 9.1. With version 2, you can use key-value store APIs to retrieve all keys from the store.
• The Inspect Key-Value Store option of the Dev Support menu now lets you search for all keys that match a given partial or whole key name.

SOQL Sync Down Target Enhancement

• You can now configure the size for SOQL sync down batches. You can specify any value from 200 to 2,000 (default value).

Deprecations

• Check your compiler warnings, or see iOS Current Deprecations in the Mobile SDK Development Guide.

Salesforce Mobile SDK 9.0

What's New

iPadOS Support

• Implemented multiple window support for iPadOS. This new feature requires changes to existing apps that intend to run on iPads.
• Improved support for landscape mode on iPadOS. (Other than updating to Mobile SDK 9.0, no app changes required.)

Mobile Sync

• Parent-Child sync-up now supports an external ID field to help prevent the creation of duplicated records. See Syncing Up by External ID.

React Native

• React Native for Mobile SDK now supports TypeScript for development, in addition to plain JavaScript. Mobile SDK components have been updated to use types. See React Native Development.
• Dependencies are auto-linked in applications generated by forcereact.

Miscellaneous

• The Dev Support menu offers a new utility: Inspect Key-Value Store. Use this tool to see what's in your app's key-value store during debugging. See In-App Developer Support.

Version Updates

• Deployment target: iOS 13
• Base SDK: iOS 14
• Xcode 12
• CocoaPods 1.8.0 (no maximum)
• Cordova 6.1.1
• Cordova Command Line 10.0.0
• SQLCipher: 4.4.2
• SQLite 3.33.0
• React Native: 0.63.4
• yarn 1.2.2
• TypeScript compiler 4.1.2

Salesforce Mobile SDK 8.3

What's New

• Successfully tested Mobile SDK and our sample apps on Xcode 12 and iOS 14.
• Added the userInterfaceStyle property to SFSDKWindowManager to allow you to override the user interface mode.

Version Updates

• React Native: 0.63.2

Salesforce Mobile SDK 8.2

What's New

• Added an encrypted key-value store as a performance-oriented storage option that complements relational SmartStore soups. Key-value stores offer a simple, non-relational, opaque collection of values that you can reference only by key.
• Added REST API wrappers to support Notification Builder API resources.
• Added decryption of Notification Builder push notifications. To support decrypted push notifications, your app must incorporate a
  boilerplate iOS class extension.
• New Swift template app that provides a boilerplate decryption extension for notifications: iOSNativeSwiftEncryptedNotificationTemplate.
• Updated Swift template app that demonstrates a custom Notification Builder notifications tray: MobileSyncExplorerSwift.
• Improved REST API methods with full response in error callback.

Version Updates

• SQLCipher: 4.4
• SQLite: 3.31.0
• CocoaPods: Minimum 1.7.2, no declared maximum
• React Native: 0.62.2

Hybrid

• A solution for running Lightning Web Components in Mobile SDK hybrid remote apps, using Lightning Out in Visualforce.
• New template app demonstrating Lightning Web Components in a hybrid remote app: HybridLwcTemplate
• Richer error messages for network calls made through the Salesforce Cordova plugin.

React Native

• New template app demonstrating deferred login: ReactNativeDeferredTemplate
• Richer error messages for network calls made through the Salesforce network module.

Mobile Sync Enhancements

• Improved LayoutSyncManager functionality to support all parameters of the underlying Salesforce API.
• Richer (and parsable) error captured in __last_error__ field.

Salesforce Mobile SDK 8.1

What’s New

Mobile SDK 8.1 is an interim release that addresses the upcoming App Store deadlines for deprecating UIWebView usage.

Version Updates

• Cordova: v 5.1.1 (Hybrid only)

Hybrid

Mobile SDK 8.1 for iOS removes all remaining references to the UIWebView control. To submit new or updated iOS hybrid apps to the App Store after the App Store deadlines, you must upgrade them to Mobile SDK 8.1 or later. For details, see this Apple Developer News release.

Due to the removal of UIWebView, hybrid remote apps can no longer use localhost to store resources on the mobile device. Reconfigure these apps to store and access resources on the server.

Deprecations

SalesforceSDKManager

@property (nonatomic, assign) BOOL encryptURLCache;:

• Deprecated in Mobile SDK 8.1 for removal in Mobile SDK
  9.0.

• Comments: Use URLCacheType instead.

SFSDKWebViewStateManager

+ (void)resetSessionWithNewAccessToken:(NSString *)accessToken isSecureProtocol:(BOOL)isSecure;:

• Deprecated in Mobile SDK 8.1 for removal in Mobile SDK
  9.0.

• Comments: Use resetSessionCookie instead.

Removed in Mobile SDK 8.1

All references to UIWebView (deprecated in Mobile SDK 6) have now
been removed.

Check your compiler warnings, or see iOS Current Deprecations.

Salesforce Mobile SDK 8.0

What’s New

• Swift extensions for iOS 12 and iOS 13. For iOS 13, these
  extensions use publishers for Combine and SwiftUI.

• New iOS 13 template demonstrating offline features,
  master-detail views for Account and related Contact records,
  SwiftUI, SceneDelegate, and publishers for REST APIs, , and Mobile Sync.

• For logins and authentication, replaced SFAuthenticationSession with ASWebAuthenticationSession.

• Full content notification support.

• Dark mode support, demonstrated in updated templates and sample
  apps.

• New classes for batch and composite requests. See

  • BatchRequest

  • BatchResponse

  • CompositeRequest

  • CompositeResponse

Version Updates

• iOS deployment target: 12.2

• iOS base SDK: 13

• Xcode: 11

SmartStore Enhancements

• Queries can return either a JSON object (best choice for native) or a String (best choice for hybrid and RN).

• Swift extensions for iOS 12 and iOS 13 (publishers for Combine
  and SwiftUI)

• Validation tool for JSON configuration files.

Mobile Sync Enhancements

• Sync up by external ID: For locally created, updated, or deleted SmartStore records that specify an external ID field and provide its value, Mobile SDK performs an upsert instead of an update. However, if the record also contains a Salesforce ID, Mobile Sync performs an update.

• Swift extensions for iOS 12 and iOS 13 (publishers for Combine
  and SwiftUI)

• Validation tool for JSON configuration files.

Deprecations

Check your compiler warnings, or see iOS Current
Deprecations.