安装 Adobe Experience Platform Mobile SDK tutorial_install_mobile_sdks

Swift包管理器

使用Xcode的原生Swift包管理器添加单个包，而不使用CocoaPods和Pod文件(如生成SDK安装说明中所述)。 Xcode项目已经为您添加了所有包依赖项。 Xcode 包依赖项 ​屏幕应如下所示：

{modal="regular"}

在Xcode中，您可以使用​ 文件 > 添加包…… ​来添加包。 下表提供了用于添加包的URL的链接。 这些链接还将引导您了解有关每个特定包的更多信息。

导入扩展

在Xcode中打开示例应用程序的​ 开始 ​文件夹中的项目。

在Xcode中，导航到​ Luma > Luma > AppDelegate，并确保以下导入是此源文件的一部分。

// 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

对​ Luma > Luma > Utils > MobileSDK ​执行相同操作。

更新AppDelegate

在Xcode项目导航器中导航到​ Luma > Luma > AppDelegate。

1. 将@AppStorage的YOUR_ENVIRONMENT_ID_GOES_HERE值environmentFileId替换为您从生成SDK安装说明中的标记检索到的环境文件ID值。

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

2. 将以下代码添加到application(_, didFinishLaunchingWithOptions)函数。

   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) })

上述代码执行以下操作：

1. 注册所需的扩展。
2. 配置MobileCore和其他扩展以使用标记属性配置。
3. 启用调试日志记录。 有关更多详细信息和选项，请参阅Adobe Experience Platform Mobile SDK文档。
4. 启动生命周期监控。 有关更多详细信息，请参阅本教程中的生命周期步骤。
5. 将默认同意设置为“未知”。 有关更多详细信息，请参阅教程中的同意步骤。

确保基于您为了（开发、暂存或生产）构建的标记环境中的MobileCore.configureWith(appId: self.environmentFileId)，使用appId更新environmentFileId。

Gradle

您使用生成SDK安装说明中的依赖项通过Gradle与Android Studio的集成来添加单个包，Android Studio项目已经为您添加了所有包依赖项。

1. 选择 作为工具。

2. 选择​ Android ​视图。

3. 从左窗格中选择​ Gradle脚本 > build.gradle.kts （模块:app）。 然后，在右侧窗格中，滚动直到看到dependencies为止。

   {modal="regular"}

在Android Studio中，您可以使用​ 文件 > 项目结构…… ​来添加模块依赖项。 选择​ 依赖项，然后使用​ 模块 添加模块。 下表提供了用于添加依赖关系模块的URL的链接。 这些链接还将引导您了解关于每个特定模块的更多信息。

导入扩展

在Android Studio中，导航到​ 应用程序 > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication，并确保源文件中包含下列导入。

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

对​ 应用程序 > kotlin+java > com.adobe.luma.tutorial.android > 模型 > MobileSDK ​执行相同的操作。

更新LumaApplication

在​ Android ​视图中，导航到Android Studio中的​ 应用程序 > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication。

1. 将"YOUR_ENVIRONMENT_FILE_ID"中的private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"替换为您从生成SDK安装说明中的标记检索到的环境文件ID值。

   code language-kotlin
   private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

2. 将以下代码添加到override fun onCreate()中的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) }

   上述代码执行以下操作：

   1. 注册所需的扩展。
   2. 配置MobileCore和其他扩展以使用标记属性配置。
   3. 启用调试日志记录。 有关更多详细信息和选项，请参阅Adobe Experience Platform Mobile SDK文档。
   4. 启动生命周期监控。 有关更多详细信息，请参阅本教程中的生命周期步骤。
   5. 将默认同意设置为“未知”。 有关更多详细信息，请参阅教程中的同意步骤。

确保根据您为了（开发、暂存或生产）构建的标记环境中的环境文件ID，使用MobileCore.configureWith(environmentFileId)更新environmentFileId。