Add the SDK Dependency

Updated
  • 1 minute(s) read
Prev Next

Goal of this step

In this step, you add the Mapp Intelligence iOS SDK v5 to your project and prepare your iOS app to load it successfully at runtime.

Before you begin

Make sure your project already meets the requirements described in Requirements & Compatibility.

Note: Carthage is no longer supported (sunset with version 5.0.6, December 2023). Use CocoaPods or Swift Package Manager.

Always check the latest released version on GitHub Releases.

Add the dependency

Pick the package manager that matches your project setup.

CocoaPods

Add the pod to your Podfile:

target 'YourApp' do
    use_frameworks!

    pod 'MappIntelligence' # or pin a version: pod 'MappIntelligence', '~> 5.1'
end

Then run:

pod install

Swift Package Manager (Xcode)

In Xcode 14 and later: File > Add Package Dependencies…, then enter the repository URL:

https://github.com/mapp-digital/MappIntelligence-iOS-v5

The package exposes two products:

  • MappIntelligenceiOS — the iOS-facing target. Link this in most iOS apps.

  • MappIntelligenceSDK — the lower-level core target.

Swift Package Manager (Package.swift)

If you maintain dependencies in a Package.swift manifest:

dependencies: [
    .package(
        url: "https://github.com/mapp-digital/MappIntelligence-iOS-v5.git",
        .upToNextMajor(from: "5.1.1")
    )
]

Confirm package source availability

Make sure your build environment can reach the package source you chose:

  • CocoaPods: CocoaPods Trunk (https://cdn.cocoapods.org) must be reachable.

  • Swift Package Manager: https://github.com must be reachable from the build machine.

Network access on iOS

The SDK sends tracking requests over HTTPS. iOS handles network access at the OS level, so no explicit network permission entry is required in Info.plist. App Transport Security (ATS) enforces HTTPS by default; ensure your Track Domain uses https://.

Use a compatible build toolchain

The SDK targets iOS 12 and later. Configure your Xcode project accordingly:

  • iOS Deployment Target: 12.0 or higher

  • Xcode: 14 or higher (recommended for the modern SPM dialog and Privacy Manifest support)

  • Swift: 5.x

XCFramework distribution

Since version 5.1.0, the SDK can also be distributed as an XCFramework. This simplifies integration in environments such as React Native or in setups with multiple architectures. Drop the .xcframework bundle into your project and link it under General > Frameworks, Libraries, and Embedded Content.

Privacy Manifest

The SDK ships an Apple Privacy Manifest (MappIntelligencePrivacyInfo.xcprivacy). It is included automatically when integrating via CocoaPods or SPM and contributes to your app's aggregated privacy report when you submit to App Store Connect.

What this step should achieve

After this step:

  • the SDK dependency resolves successfully

  • your iOS deployment target and Xcode version match the SDK's requirements

  • your Track Domain uses HTTPS

Next, continue with Initialize the SDK.