Install Adobe Experience Platform Mobile SDKs

Learn how to implement the Adobe Experience Platform Mobile SDK in a mobile app.

Prerequisites

• Successfully built tag library with the extensions described in the previous lesson.
• Development Environment File ID from the Mobile Install Instructions.
• Downloaded, empty sample app.
• Experience with XCode.
• Basic command-line knowledge.

Learning objectives

In this lesson, you will:

• Update your CocoaPod file.
• Import the required SDKs.
• Register the extensions.

Update PodFile

1. If you aren’t familiar with CocoaPods, please review the official getting started guide.

   Install is usually a simple sudo command:

   $ sudo gem install cocoapods

2. Once you have CocoaPods installed, open the PodFile:
   

3. Update the file to include the following pods:

       pod 'AEPCore', '~> 3'
       pod 'AEPEdge', '~> 1'
       pod 'AEPUserProfile', '~> 3'
       pod 'AEPAssurance', '~> 3'
       pod 'AEPServices', '~> 3'
       pod 'AEPIdentity', '~> 3'
       pod 'AEPEdgeConsent', '~> 1'
       pod 'AEPLifecycle', '~>3'
       pod 'AEPMessaging', '~>1'
       pod 'AEPEdgeIdentity', '~>1'
       pod 'AEPSignal', '~>3'
   

   AEPMessaging is only required if you plan to implement push messaging via Adobe Journey Optimizer as described here.

4. Save the Podfile.

5. Navigate to the folder with your project run the following command: pod install

   You should get output that looks something like this:
   

   If you are getting an error “No Podfile found in the project directory.” then your terminal is in the wrong folder. Navigate to the folder with the Podfile you updated and try again.

Build CocoaPods

1. Open Luma.xcworkspace.

2. From the Xcode menu, select Product > Clean Build Folder.

3. You’ll likely need to set Build Active Architecture Only to No.

   1. Select the Pods project from the project navigator.
   2. Select Build Settings.
   3. Set Build Active Architecture to No.

4. Build and run.
   

Import extensions

In each of the .swift files, add the following imports. Start by adding to AppDelegate.swift.

import AEPUserProfile
import AEPAssurance
import AEPEdge
import AEPCore
import AEPEdgeIdentity
import AEPEdgeConsent
import AEPIdentity
import AEPLifecycle
import AEPMessaging //Optional, used for AJO push messaging
import AEPSignal
import AEPServices

Update AppDelegate

In the AppDelegate.swift file, add the following code to didFinishLaunchingWithOptions. Replace currentAppId with the Development Environment File ID value that you retrieved from tags in the previous lesson.

let currentAppId = "b5cbd1a1220e/bae66382cce8/launch-88492c6dcb6e-development"

let extensions = [Edge.self, Assurance.self, Lifecycle.self, UserProfile.self, Consent.self, AEPEdgeIdentity.Identity.self, AEPIdentity.Identity.self, Messaging.self]

MobileCore.setLogLevel(.trace)

MobileCore.registerExtensions(extensions, {
    MobileCore.configureWith(appId: currentAppId)
})

Messaging.self is only required if you plan to implement push messaging via Adobe Journey Optimizer as described here.

The above code does the following:

• Registers the required extensions.
• Configures MobileCore and other extensions to use your tag property configuration.
• Enables debug logging. More details and options can be found in the Mobile SDK documentation.

Next: Set up Assurance