Migrate to Adobe Experience Platform 4.x SDKs for iOS

SDK versions

Extension	Version
Mobile Core
Rules Engine
Signal
Identity
Lifecycle
Profile
Adobe Experience Platform Assurance
Adobe Experience Platform Edge Network
Identity for Edge Network
Consent for Edge Network
Media for Edge Network
Edge Bridge
Adobe Journey Optimizer
Adobe Journey Optimizer - Decisioning
Places Service
Adobe Analytics
Adobe Analytics - Media Analytics for Audio & Video
Adobe Target
Adobe Campaign Standard
Adobe Campaign Classic
Adobe Audience Manager

Migrate from Adobe Experience Platform 3.x SDKs for iOS

If you have implemented Adobe Experience Platform 3.x SDKs for iOS, then this guide will help you understand the steps required to migrate your implementation to the Experience Platform 4.x SDKs. In summary, you'll need to:

1. Update dependencies
2. Update outdated API references

Update dependencies

Manual library import

If you are importing SDK libraries manually, make sure to update your libraries by downloading the most recent 4.x binaries from their respective Github repositories.

CocoaPods

If you are using CocoaPods to manage your Adobe Experience Platform Mobile SDK dependencies, the following example shows you how to update to Experience Platform 4.x SDKs in your Podfile.

Copy
# Update pod dependencies to 4.x version
# pod 'AEPCore', '~> 3.0'
# pod 'AEPLifecycle', '~> 3.0'
# pod 'AEPIdentity', '~> 3.0'
# pod 'AEPSignal', '~> 3.0'
# pod 'AEPUserProfile', '~> 3.0'

  pod 'AEPCore', '~> 4.0'
  pod 'AEPLifecycle', '~> 4.0'
  pod 'AEPIdentity', '~> 4.0'
  pod 'AEPSignal', '~> 4.0'
  pod 'AEPUserProfile', '~> 4.0'
Copied to your clipboard
# Update pod dependencies to 4.x version
# pod 'AEPCore', '~> 3.0'
# pod 'AEPLifecycle', '~> 3.0'
# pod 'AEPIdentity', '~> 3.0'
# pod 'AEPSignal', '~> 3.0'
# pod 'AEPUserProfile', '~> 3.0'

  pod 'AEPCore', '~> 4.0'
  pod 'AEPLifecycle', '~> 4.0'
  pod 'AEPIdentity', '~> 4.0'
  pod 'AEPSignal', '~> 4.0'
  pod 'AEPUserProfile', '~> 4.0'

Save the Podfile, and run pod repo update to update your local CocoaPods repository.

Once the previous command is complete, run pod install or pod update to update the application dependencies.

Swift Package Manager

If you are using Swift Package Manger (SPM) for managing your app dependencies, you can now include the Experience Platform 4.x SDKs either through Xcode UI, or by declaring them as dependencies in the Package.swift project file. For more details, follow the guide for managing dependencies using Swift Package Manager.

Update outdated API references

Adobe Experience Platform Edge Network

The following APIs have been removed:

Copy
import AEPEdge
let date = Date()
let formattedDate = XDMFormatters.dateToFullDateString(date)
let formattedDateWithMs = XDMFormatters.dateToISO8601String(date)
Copied to your clipboard
import AEPEdge
let date = Date()
let formattedDate = XDMFormatters.dateToFullDateString(date)
let formattedDateWithMs = XDMFormatters.dateToISO8601String(date)

Copy
import AEPServices
let date = Date()
let formattedDate = date.getISO8601FullDate()
let formattedDateWithMs = date.getISO8601UTCDateWithMilliseconds()
Copied to your clipboard
import AEPServices
let date = Date()
let formattedDate = date.getISO8601FullDate()
let formattedDateWithMs = date.getISO8601UTCDateWithMilliseconds()

Copy
import AEPEdge
let date = Date()
let formattedDate = XDMFormatters.dateToFullDateString(date)
let formattedDateWithMs = XDMFormatters.dateToISO8601String(date)
Copied to your clipboard
import AEPEdge
let date = Date()
let formattedDate = XDMFormatters.dateToFullDateString(date)
let formattedDateWithMs = XDMFormatters.dateToISO8601String(date)

Copy
import AEPServices
let date = Date()
let formattedDate = date.getISO8601FullDate()
let formattedDateWithMs = date.getISO8601UTCDateWithMilliseconds()
Copied to your clipboard
import AEPServices
let date = Date()
let formattedDate = date.getISO8601FullDate()
let formattedDateWithMs = date.getISO8601UTCDateWithMilliseconds()

Last updated 11/28/2023

Was this helpful?

Yes

No