Mobile SDK Development Guide

Introduction to Mobile Development
Introduction to Salesforce Mobile SDK Development
What’s New in Mobile SDK 11.1
Getting Started With Mobile SDK 11.1 for iOS and Android
Updating Apps (5.0 and Later) Apps (5.0 and Later)
Native iOS Development
iOS Native Quick Start
iOS Basic Requirements
Creating an iOS Project with Forceios
Creating an iOS Swift Project Manually
Create an Xcode Swift Project
Add Mobile SDK Libraries to Your Project
Configure Your Project’s Build Settings
Option 1: Import Mobile SDK Template Files
Option 2: Add Mobile SDK Setup Code Manually
Use with with
Using Carthage with Mobile SDK (Not Supported)
Developing a Native iOS App
Supporting iPadOS in Mobile SDK Apps
Supporting Catalyst in Mobile SDK Apps
Using iOS App Extensions with
Profiling with Signposts
iOS Sample Applications
Native Android Development
HTML5 and Hybrid Development
Using Lightning Web Components in Hybrid Apps
React Native Development
Offline Management
Files and Networking
Push Notifications and
Authentication, Security, and Identity in Mobile Apps
Login Screen Customization
Identity Provider Apps
Using Key-Value Stores for Secure Data Storage
Dark Mode and Dark Theme Settings
Using Experience Cloud Sites With Mobile SDK Apps
Multi-User Support in Mobile SDK
Mobile SDK Tools for Developers
Logging and Analytics
Migrating from the Previous Release
Reference
iOS Current Deprecations
iOS APIs Removed in Mobile SDK 11.0
Android Current Deprecations
Android APIs Removed in Mobile SDK 11.0
Trademark Attributions
Removing UIWebView from iOS Hybrid Apps
PDF

Configure Your Project’s Build Settings

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

Important

Prerequisites

  1. Create an Xcode Swift Project
  2. Add Mobile SDK Libraries to Your Project

Customize Your Project’s Build Configuration

  1. In Project Navigator, select the top-level project.
  2. In the Project Editor, select Build Phases.
  3. Under Dependencies, click Add Items (+).
  4. Use Command+Click to multi-select the gold briefcase icons for all five Mobile SDK libraries, then click Add.
    When you’ve finished, you see the following:
    Build Phases showing Mobile SDK libraries as target dependencies
  5. In the Project Editor, select General.
  6. Scroll to Frameworks, Binaries, and Embedded Content.
  7. Click Add items (+) and add the following frameworks:
    • SalesforceSDKCommon.framework
    • SalesforceAnalytics.framework
    • SalesforceSDKCore.framework
    • SmartStore.framework
    • MobileSync.framework

    List of Mobile SDK frameworks under Embedded Binaries

    Be sure to add each framework only once. If you accidentally add duplicates, select the extraneous ones and click Remove items (-).

    Important

  8. Run a test build.
    • The result of this build isn’t a functional Mobile SDK app. You’re only checking to see if the libraries built properly. When the app runs, you still see just a blank white screen that says “Hello, world!”
    • If you get a warning about a missing image file:
    1. In Terminal, navigate to <your selected local path>/MyMobileSDKApp/SalesforceMobileSDK-iOS/
    2. Run ./install.sh

    Note

  9. In Xcode, click Stop.
At this point, Mobile SDK is available in your app, but your app can’t yet use it. Using Mobile SDK requires coding to initialize the SDK and integrate its services into your app’s sessions. To finish setting up Mobile SDK, you have a choice of two options:
Option 1: Import Mobile SDK Template Files
This option is the quicker, easier route. In your project you remove certain Xcode template files and add files from the iOS native Swift template. Voilà! Your app is ready to use Mobile SDK.
Option 2: Add Mobile SDK Setup Code Manually
This hands-on coding option gives you a front-row seat to the code changes required for Mobile SDK integration. Along the way, you also might discover some useful customization opportunities. This option doesn’t ask you to import template files into your project. However, you’ll still benefit from copying a few boilerplate functions found in the iOS native Swift template.