mparticle-integrations/mp-apple-integration-onetrust

OneTrust SDK Version

OneTrust uses a constrained versioning model defined in app.onetrust.com. Partners must specify the OneTrust SDK version they require in their app's dependency configuration; the kit does not pin a specific version by default.

• Source-based distribution (SPM, CocoaPods): Add OTPublishersHeadlessSDK and OTPublishersHeadlessSDKtvOS as direct dependencies with the version that matches your OneTrust configuration.
• Binary distribution (XCFramework, vendored frameworks): Pre-built binaries are built with a specific OneTrust SDK version baked in at build time. Binary releases use the latest OneTrust SDK version available when the kit was built. If you need a different version, use source-based distribution and pin the version yourself.

Installation

Swift Package Manager

Add the OneTrust kit package dependency in Xcode or in your Package.swift. Swift Package Manager resolves the mParticle SDK automatically as a transitive dependency, so you do not need a separate .package entry for mparticle-apple-sdk.

Add the OneTrust SDK as a direct dependency with the version from your OneTrust configuration:

let mParticleVersion: Version = "9.0.0"

.package(
    url: "https://github.com/mparticle-integrations/mp-apple-integration-onetrust",
    .upToNextMajor(from: mParticleVersion)
),
.package(
    url: "https://github.com/Zentrust/OTPublishersHeadlessSDK",
    .exact("202502.1.0")  // Use the version from your OneTrust UI
),
.package(
    url: "https://github.com/Zentrust/OTPublishersHeadlessSDKtvOS",
    .exact("202502.1.0")  // Must match your iOS SDK version
),

Then add mParticle-OneTrust and the OneTrust SDK products as dependencies of your target.

CocoaPods

Add the kit and pin the OneTrust SDK to the version from your OneTrust configuration:

pod 'mParticle-OneTrust', '~> 9.0'
pod 'OTPublishersHeadlessSDK', '202502.1.0'  # Use the version from your OneTrust UI

Verifying the Integration

After installing, rebuild and launch your app. With the mParticle log level set to Debug or higher, you should see the following in your Xcode console:

Included kits: { OneTrust }

Platform Support

| Platform | Minimum Version | | -------- | --------------- | | iOS | 15.0 | | tvOS | 15.0 |

Documentation

• mParticle OneTrust Integration Guide
• mParticle iOS SDK Documentation
• OneTrust Developer Portal: iOS SDK

Issues

Please report bugs and feature requests to the mparticle-apple-sdk repository. This mirror repository is not actively monitored for issues.

License

Apache License 2.0

Package Metadata

Repository: mparticle-integrations/mp-apple-integration-onetrust

Default branch: main

README: README.md