Update the Connect iOS library

There are three ways to update the Connect library integrated into your native iOS app.

If you added the Connect library as a Swift Package, you can update it in the following way.

Under Package Dependencies, right-click (or Control-click) on the Connect package.
Select Update Package from the context menu.

If Update Package resolves to an older version than you expected, your project's Dependency Rule is likely excluding newer versions. For example, projects originally configured for Connect iOS SDK 1.x typically have a rule like "Up to Next Major Version" with the range 1.0.6 < 2.0.0, which prevents the package from updating to any 2.x version.

To change which version of the Connect library your project uses:

Select your project file in Project Navigator.
In the editor, select your project under PROJECT (not a target).
On the Package Dependencies tab, change the dependency rule.
Go to File > Packages > Update to Latest Package Versions.

📘
Note
For the list of available versions, see Release notes for mobile Connect SDKs.

Upgrading to Connect iOS SDK 2.0.8

In April 2026, we introduced a new generation of the Connect SDK with structural updates and improvements to behavior analytics for all iOS apps, and push notification support for Swift and SwiftUI apps.

Swift and SwiftUI apps

Update the SDK to version 2.0.8.
Update your SDK initialization snippet and remove the EOCore and Tealeaf imports after upgrading. The import Connect statement is sufficient.
If you are enabling push notifications, update to the new ConnectSDK API — this is required. Otherwise, updating the API is recommended but not required.

import Connect
import EOCore
import Tealeaf
import UIKit

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
    ) -> Bool {
        let connectApplicationHelperObj = ConnectApplicationHelper()
        connectApplicationHelperObj.enableFramework("YOUR_APP_KEY", withPostMessageUrl: "YOUR_COLLECTOR_URL")
        return true
    }
}

import Connect
import UIKit

class AppDelegate: UIResponder, UIApplicationDelegate {
    @MainActor
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
    ) -> Bool {
        ConnectSDK.shared.enable(
            appKey: "YOUR_APP_KEY",
            postURL: "YOUR_COLLECTOR_URL"
        )
        return true
    }
}

import Connect
import UIKit

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
    ) -> Bool {
        let connectApplicationHelperObj = ConnectApplicationHelper()
        connectApplicationHelperObj.enableFramework("YOUR_APP_KEY", withPostMessageUrl: "YOUR_COLLECTOR_URL")
        return true
    }
}

(Optional) Enable push notifications in your project. For end-to-end instructions, see Enable push notifications in a native iOS app.

Objective-C apps

If you have integrated the Connect SDK using Swift Package Manager or Carthage, replace the legacy TLFApplicationHelper initialization call with ConnectApplicationHelper after upgrading. In some configurations, the SDK may not find its configuration files if this step is skipped.

@import Tealeaf;
@import Connect;

[[TLFApplicationHelper sharedInstance] enableTealeafFramework:@"YOUR_APP_KEY"
                                            withPostMessageUrl:@"YOUR_COLLECTOR_URL"];

@import Tealeaf;
@import Connect;

[[ConnectApplicationHelper sharedInstance] enableFramework:@"YOUR_APP_KEY"
                                         withPostMessageUrl:@"YOUR_COLLECTOR_URL"];

Push notifications are not supported for Objective-C apps.