iOS SDK Module Prerequisites & Dependencies
Before integrating the Indigitall iOS SDK (indigitall-ios) into your application, ensure your project meets the following requirements.
1. Environment & Compatibility
- Minimum iOS Deployment Target: iOS 15.6 or higher (as declared in the podspec).
- Swift Version: Swift 5.0 or higher.
- Objective-C Compatibility: The SDK is written in Objective-C with full Swift interoperability via module maps.
- Package Manager: CocoaPods or Swift Package Manager (SPM) — both are supported.
- Xcode: Xcode 13 or later is recommended to guarantee compatibility with the Swift tools version (
swift-tools-version:5.5) declared inPackage.swift.
2. Integration Options
CocoaPods
CocoaPods support is available through version 6.21.4. Constrain CocoaPods dependencies to < 6.21.5.
Add the following to your Podfile:
platform :ios, '15.6 '
target 'YourApp' do
use_frameworks!
pod 'indigitall-ios', '< 6.21.5'
endThen run:
pod installSwift Package Manager
Starting with version 6.21.5, add the package in Xcode via File → Add Package Dependencies using https://github.com/indigitall/ios-sdk-spm.git. Select the Indigitall product and add it to your app target.
3. Required Internal Modules
The full SDK (indigitall-ios) bundles all Indigitall sub-modules. Including it will make the following components available:
- Core (
IndigitallCore): Base infrastructure — network request layer, local data persistence, configuration (INCoreConfig) and device management. - Push (
IndigitallPush): Push notification handling, APNs token registration, permission management and notification delivery. - InApp (
IndigitallInApp): In-app message rendering and display lifecycle management. - Inbox (
IndigitallInbox): Notification history retrieval and inbox message management. - Customer (
IndigitallCustomer): Mapping device records to specific user profiles and custom user attributes.
4. Required Apple Capabilities
Enable the following capabilities in your Xcode project target:
- Push Notifications — Required to receive remote push notifications from APNs.
- Background Modes → Remote notifications — Required for silent push processing and background sync.
- Background Modes → Background fetch — Used by the SDK to perform periodic background syncs (configurable via
minimumBackgroundFetchIntervalinINPushConfig).
