Install Adobe Experience Platform Mobile SDKs tutorial_install_mobile_sdks

Swift Package Manager

Instead of using CocoaPods and a Pod file (as outlined in Generate SDK install instructions), you add individual packages using Xcode’s native Swift Package Manager. The Xcode project already has all packages dependencies added for you. The Xcode Package Dependencies screen should look like:

{modal="regular"}

In Xcode, you can use File > Add Packages… to add packages. The table below provides links to the URLs you would use to add packages. The links also direct you to more information about each specific package.

Import extensions

Open in Xcode the project in the Start folder of the sample app.

In Xcode, navigate to Luma > Luma > AppDelegate and ensure that the following imports are part of this source file.

// import AEP MobileSDK libraries
import AEPCore
import AEPServices
import AEPIdentity
import AEPSignal
import AEPLifecycle
import AEPEdge
import AEPEdgeIdentity
import AEPEdgeConsent
import AEPUserProfile
import AEPPlaces
import AEPMessaging
import AEPOptimize
import AEPAssurance

Do the same for Luma > Luma > Utils > MobileSDK.

Update AppDelegate

Navigate to Luma > Luma > AppDelegate in the Xcode Project navigator.

1. Replace the @AppStorage value YOUR_ENVIRONMENT_ID_GOES_HERE for environmentFileId with the Environment File ID value that you retrieved from tags in Generate SDK install instructions.

   code language-swift
   @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

2. Add the following code to the application(_, didFinishLaunchingWithOptions) function.

   code language-swift

   // Define extensions let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ] // Register extensions MobileCore.registerExtensions(extensions, { // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection Logger.aepMobileSDK.info("Luma - using mobile config: \(self.environmentFileId)") MobileCore.configureWith(appId: self.environmentFileId) // set this to false or comment it when deploying to TestFlight (default is false), // set this to true when testing on your device. MobileCore.updateConfigurationWith(configDict: ["messaging.useSandbox": true]) if appState != .background { // only start lifecycle if the application is not in the background MobileCore.lifecycleStart(additionalContextData: nil) } // assume unknown, adapt to your needs. MobileCore.setPrivacyStatus(.unknown) })

The above code does the following:

1. Registers the required extensions.
2. Configures MobileCore and other extensions to use your tag property configuration.
3. Enables debug logging. More details and options can be found in the Adobe Experience Platform Mobile SDK documentation.
4. Starts lifecycle monitoring. See Lifecycle step in the tutorial for more details.
5. Sets the default consent to unknown. See Consent step in the tutorial for more details.

Ensure you update MobileCore.configureWith(appId: self.environmentFileId) with the appId based on the environmentFileId from the tag environment you are building for (development, staging, or production).

Gradle

You use the dependencies from the Generate SDK install instructions to add individual packages using Gradle’s integration with Android Studio, The Android Studio project already has all packages dependencies added for you.

1. Select as the tool.

2. Select Android view.

3. Select Gradle scripts > build.gradle.kts (Module :app) from the left pane. Then, in the right pane, scroll until you see dependencies.

   {modal="regular"}

In Android Studio, you can use File > Project Structure… to add module dependencies. Select Dependencies and then use Modules to add modules. The table below provides links to the URLs you would use to add dependency modules. The links also direct you to more information about each specific module.

Import extensions

In Android Studio, navigate to app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication and ensure that the following imports are part of the source file.

import com.adobe.marketing.mobile.Assurance
import com.adobe.marketing.mobile.Edge
import com.adobe.marketing.mobile.Lifecycle
import com.adobe.marketing.mobile.LoggingMode
import com.adobe.marketing.mobile.Messaging
import com.adobe.marketing.mobile.MobileCore
import com.adobe.marketing.mobile.MobilePrivacyStatus
import com.adobe.marketing.mobile.Places
import com.adobe.marketing.mobile.Signal
import com.adobe.marketing.mobile.UserProfile
import com.adobe.marketing.mobile.edge.consent.Consent
import com.adobe.marketing.mobile.edge.identity.Identity
import com.adobe.marketing.mobile.optimize.Optimize

Do the same for app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK.

Update LumaApplication

In the Android view, navigate to app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication in Android Studio.

1. Replace "YOUR_ENVIRONMENT_FILE_ID" in private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" with the Environment File ID value that you retrieved from tags in Generate SDK install instructions.

   code language-kotlin
   private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

2. Add the following code to override fun onCreate() function in class LumaApplication : Application().

   code language-kotlin

   // Define extensions val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION ) // Register extensions MobileCore.registerExtensions(extensions) { // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection Log.i("Luma", "Using mobile config: $environmentFileId") MobileCore.configureWithAppID(environmentFileId) // set this to true when testing on your device, default is false. //MobileCore.updateConfiguration(mapOf("messaging.useSandbox" to true)) // assume unknown, adapt to your needs. MobileCore.setPrivacyStatus(MobilePrivacyStatus.UNKNOWN) }

   The above code does the following:

   1. Registers the required extensions.
   2. Configures MobileCore and other extensions to use your tag property configuration.
   3. Enables debug logging. More details and options can be found in the Adobe Experience Platform Mobile SDK documentation.
   4. Starts lifecycle monitoring. See Lifecycle step in the tutorial for more details.
   5. Sets the default consent to unknown. See Consent step in the tutorial for more details.

Ensure you update MobileCore.configureWith(environmentFileId) with the environmentFileId based on the Environment File ID from the tag environment you are building for (development, staging, or production).