---
title: "Add the SDK Dependency"
slug: "mapp-intelligence-ios-sdk-v5-add-sdk-dependency"
updated: 2026-04-30T11:50:10Z
published: 2026-04-30T11:50:10Z
canonical: "docs.mapp.com/mapp-intelligence-ios-sdk-v5-add-sdk-dependency"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add the SDK Dependency

## 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](/v1/docs/mapp-intelligence-ios-sdk-v5-requirements-compatibility).

> [!NOTE]
> **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](https://github.com/mapp-digital/MappIntelligence-iOS-v5/releases).

---

## Add the dependency

Pick the package manager that matches your project setup.

### CocoaPods

Add the pod to your `Podfile`:

```ruby
target 'YourApp' do
    use_frameworks!

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

Then run:

```bash
pod install
```

### Swift Package Manager (Xcode)

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

```plaintext
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:

```swift
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*. See [XCFramework Integration](/v1/docs/mapp-intelligence-ios-sdk-v5-xcframework-integration) for details.

---

## 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](/v1/docs/mapp-intelligence-ios-sdk-v5-initialize-sdk).

---

## Related

- [Requirements & Compatibility](/v1/docs/mapp-intelligence-ios-sdk-v5-requirements-compatibility)
- [Initialize the SDK](/v1/docs/mapp-intelligence-ios-sdk-v5-initialize-sdk)
- [Configure Global Tracking](/v1/docs/mapp-intelligence-ios-sdk-v5-configure-global-tracking)
- [XCFramework Integration](/v1/docs/mapp-intelligence-ios-sdk-v5-xcframework-integration)
- [Releases & Changelog](/v1/docs/mapp-intelligence-ios-sdk-v5-releases-changelog)

Specify your Mapp Intelligence track domain. This information is provided by your account manager.