Updating Your SDK

Learn how to update the SDK for each platform your app supports.

The latest ContextSDK version is 5.4.0 and was released on March 13, 2025.

iOS

Swift Package Manager (SPM)

SPM has a few issues when it comes to caching its dependencies, so please be sure to follow all the steps below:

• Trigger an update of SPM using your preferred method ( Right Click → Update Package or Swift Packages → Update to Latest Package Versions)

• Clear Derived Data

• Clean Build

• Run the app again, and verify ContextManager.sdkVersion() is the latest version.

Alternatively, you can also specify the specific version of ContextSDK you want to use in your Package.swift or Xcode SPM settings.

CocoaPods

Run pod update, or if you specified a specific version in your Podfile, run pod update ContextSDK.

Manually

1. Download the latest release: https://storage.googleapis.com/de73e410-context-sdk-releases/latest/ContextSDK.zip

2. Drag & Drop the ContextSDK.xcframework folder into the Xcode file list

3. Go to your project settings, scroll down to Frameworks, Libraries, and Embedded Content, add ContextSDK.xcframework, and select Embed & Sign

If you want to download a specific version, you can replace latest with the desired version number, e.g. https://storage.googleapis.com/de73e410-context-sdk-releases/5.0.0/ContextSDK.zip

Android

Kotlin

Update the version specified in your module-level build.gradle.kts:

build.gradle.kts

dependencies {
    // …
    implementation("com.contextsdk:contextsdk:1.0.0")
    // …
}

And run a Gradle sync to install the latest version of ContextSDK.

Java

Update the version specified in your module-level build.gradle:

build.gradle

dependencies {
    // …
    implementation 'com.contextsdk:contextsdk:1.0.0'
    // …
}

And run a Gradle sync to install the latest version of ContextSDK.

Flutter

1. Update the context_sdk version in your pubspec.yaml to the latest version.

2. Run flutter pub get

3. Run pod update in the ios/ directory

Unity

1. Download the latest version of ContextSDK: ContextSDK.zip.

2. In your Unity project, drag ContextSDK.xcframework into the Assets/Plugins/iOS folder.

3. Add the ContextSDKBinding.cs script in the same folder.

To download a specific version, replace latest in the download URL with the desired version number. For example, to download version 5.1.0:

https://storage.googleapis.com/de73e410-context-sdk-releases/5.1.0/ContextSDK.zip

React Native

npm

npm install react-native-context-sdk@latest

yarn

yarn up react-native-context-sdk

Validate the installation

After updating the SDK, please take a minute to go through the release checklist again, to ensure the SDK is correctly installed and configured, using the validate method. Just following the first step of the release checklist will prevent almost all potential integration errors.