Swift Package Manager Distribution for Salesforce Mobile SDK for iOS

June 10, 2026 · View on GitHub

Pre-built XCFramework distribution of the Salesforce Mobile SDK for iOS, compatible with Swift Package Manager (SPM).

Overview

This repository provides pre-built binary frameworks (XCFrameworks) for the Salesforce Mobile SDK for iOS. It offers an alternative to CocoaPods for integrating the SDK into your Swift projects using Xcode's native Swift Package Manager.

Installation

Via Xcode (Recommended)

In Xcode, go to File → Add Package Dependencies

Enter the repository URL:

https://github.com/forcedotcom/SalesforceMobileSDK-iOS-SPM.git

Select version or branch (e.g., 13.2.1 or master)
Choose which libraries to add to your target:
- SalesforceAnalytics - Telemetry and analytics
- SalesforceSDKCommon - Shared utilities
- SalesforceSDKCore - OAuth and REST API
- SmartStore - Encrypted local storage
- MobileSync - Data synchronization

Via Package.swift

For Swift packages, add this dependency to your Package.swift:

dependencies: [
    .package(
        url: "https://github.com/forcedotcom/SalesforceMobileSDK-iOS-SPM.git",
        from: "13.2.0"
    )
]

Then add products to your targets:

targets: [
    .target(
        name: "MyApp",
        dependencies: [
            .product(name: "MobileSync", package: "SalesforceMobileSDK-iOS-SPM"),
            .product(name: "SmartStore", package: "SalesforceMobileSDK-iOS-SPM"),
            .product(name: "SalesforceSDKCore", package: "SalesforceMobileSDK-iOS-SPM")
        ]
    )
]

Available Libraries

Product	Description
SalesforceAnalytics	Telemetry, instrumentation, and analytics event tracking
SalesforceSDKCommon	Shared utilities, crypto helpers, and base protocols
SalesforceSDKCore	OAuth2 authentication, REST client, account management, push notifications
SmartStore	Encrypted on-device SQLite storage (SQLCipher-backed)
MobileSync	Bidirectional data sync between device and Salesforce cloud

Platform Support

This package supports:

Platform	Minimum Version
iOS	17.0
watchOS	8.0
visionOS	2.0
macCatalyst	13.0

Usage Example

import SalesforceSDKCore
import MobileSync

// Configure SDK
SalesforceSDKManager.shared.connectedAppId = "YOUR_CONSUMER_KEY"
SalesforceSDKManager.shared.connectedAppCallbackUri = "sfdc://oauth/success"
SalesforceSDKManager.shared.authScopes = ["api", "web", "refresh_token"]

// Launch SDK
SalesforceSDKManager.shared.launch { [weak self] (launchActionList) in
    // SDK is ready
    self?.setupRootViewController()
}

// Use REST API
let request = RestClient.shared.request(
    forQuery: "SELECT Id, Name FROM Account LIMIT 10",
    apiVersion: nil
)

RestClient.shared.send(request: request) { result in
    switch result {
    case .success(let response):
        print("Accounts:", response.asJsonDictionary())
    case .failure(let error):
        print("Error:", error)
    }
}

What's Inside?

This repository contains:

Pre-built XCFrameworks: Binary frameworks for all supported architectures (arm64 device, arm64/x86_64 simulator)
Package.swift: Swift Package Manager manifest
Dependencies: Automatic integration of SQLCipher and FMDB (for SmartStore)

Architecture Support

Each XCFramework includes slices for:

iOS Devices: arm64 (iPhone, iPad)
iOS Simulator: arm64 (Apple Silicon Macs) + x86_64 (Intel Macs)
Mac Catalyst: arm64 + x86_64 (native Mac apps)
visionOS Device: arm64 (Apple Vision Pro)
visionOS Simulator: arm64 (Apple Silicon Macs only)

Binary vs Source Distribution

This Repository (Binary)

✅ Faster integration (pre-compiled)
✅ Smaller git clone
✅ No build time for SDK libraries
❌ Cannot debug into SDK source
❌ Cannot modify SDK code

Source Repository

For SDK development or source-level debugging, use:

SalesforceMobileSDK-iOS - Source code repository

Alternative: CocoaPods

If you prefer CocoaPods over Swift Package Manager, see:

SalesforceMobileSDK-iOS-Specs - CocoaPods specs repository

Version Compatibility

SPM Package	iOS SDK	Swift	Xcode	iOS Min
14.0.0	14.0.0	5.0+	16+	18.0
13.2.0	13.2.0	5.0+	16+	17.0
13.1.0	13.1.0	5.0+	16+	17.0
13.0.0	13.0.0	5.0+	16+	17.0

See release notes for detailed version history.

Dependencies

This package automatically includes:

SQLCipher: 4.10.0 (13.x) / 4.16.0 (14.x) - SQLite encryption (for SmartStore)
FMDB: 2.7.12-sqlcipher - Objective-C SQLite wrapper

These are managed automatically by Swift Package Manager.

Documentation

For SDK Maintainers

Branch Model

This repo follows the same two-branch workflow as all other Mobile SDK repos:

master — stable, tagged release snapshots only
dev — active development for the next release

At release time, release.js in the Package repo merges dev → master, builds xcframeworks, commits, tags, then merges master → dev. For patch releases, changes are cherry-picked directly to master (no dev merge).

Building XCFrameworks

XCFramework builds are automated by release.js. To build manually:

# Build XCFrameworks from iOS SDK release tag
./build_xcframeworks.sh -r forcedotcom -b master

# Commit and tag (release.js does this automatically)
git add archives/ Package.swift
git commit -m "Mobile SDK 13.2.1"
git tag 13.2.1  # Note: no 'v' prefix for SPM tags
git push origin master
git push origin 13.2.1

Important: SPM tags must NOT have a v prefix (e.g., use 13.2.1, not v13.2.1).

iOS SDK (source): https://github.com/forcedotcom/SalesforceMobileSDK-iOS
iOS Specs (CocoaPods): https://github.com/forcedotcom/SalesforceMobileSDK-iOS-Specs
iOS Hybrid: https://github.com/forcedotcom/SalesforceMobileSDK-iOS-Hybrid
Templates: https://github.com/forcedotcom/SalesforceMobileSDK-Templates

Support

Issues: GitHub Issues
Questions: Salesforce Stack Exchange
Community: Trailblazer Community

License

Salesforce Mobile SDK License. See LICENSE.md for details.