Instalar los SDK móviles de Adobe Experience Platform tutorial_install_mobile_sdks

Administrador De Paquetes Swift

En lugar de usar CocoaPods y un archivo Pod (como se describe en Generar instrucciones de instalación de SDK), agrega paquetes individuales usando el administrador de paquetes Swift nativo de Xcode. El proyecto Xcode ya tiene todas las dependencias de paquetes agregadas para usted. La pantalla de Xcode Dependencias del paquete debe tener un aspecto similar al siguiente:

{modal="regular"}

En Xcode, puede usar Archivo > Agregar paquetes… para agregar paquetes. La siguiente tabla proporciona vínculos a las direcciones URL que utilizaría para agregar paquetes. Los vínculos también le dirigen a más información sobre cada paquete específico.

Importar extensiones

Abra en Xcode el proyecto en la carpeta Start de la aplicación de ejemplo.

En Xcode, vaya a Luma > Luma > AppDelegate y asegúrese de que las siguientes importaciones formen parte de este archivo de origen.

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

Haga lo mismo para Luma > Luma > Utils > MobileSDK.

Actualizar AppDelegate

Vaya a Luma > Luma > AppDelegate en el navegador del proyecto Xcode.

1. Reemplace el valor @AppStorage YOUR_ENVIRONMENT_ID_GOES_HERE para environmentFileId por el valor de Id. de archivo de entorno que recuperó de las etiquetas en Generar instrucciones de instalación de SDK.

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

2. Agregue el siguiente código a la función 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) })

El código anterior hace lo siguiente:

1. Registra las extensiones necesarias.
2. Configura MobileCore y otras extensiones para utilizar la configuración de propiedad de etiquetas.
3. Habilita el registro de depuración. Encontrará más detalles y opciones en la documentación de Adobe Experience Platform Mobile SDK.
4. Inicia la supervisión del ciclo vital. Consulte el paso Ciclo vital en el tutorial para obtener más información.
5. Establece el consentimiento predeterminado como desconocido. Consulte el paso Consentimiento en el tutorial para obtener más información.

Asegúrese de actualizar MobileCore.configureWith(appId: self.environmentFileId) con appId en función de environmentFileId desde el entorno de etiqueta para el que está creando (desarrollo, ensayo o producción).

Gradle

Utiliza las dependencias de Generate SDK install instructions para agregar paquetes individuales mediante la integración de Gradle con Android Studio. El proyecto de Android Studio ya tiene todas las dependencias de paquetes agregadas para usted.

1. Seleccione como herramienta.

2. Seleccione la vista Android.

3. Seleccione Gradle scripts > build.gradle.kts (Módulo :app) en el panel izquierdo. A continuación, en el panel derecho, desplácese hasta que vea dependencies.

   {modal="regular"}

En Android Studio, puede usar Archivo > Estructura del proyecto… para agregar dependencias de módulo. Seleccione Dependencias y luego use Módulos para agregar módulos. La siguiente tabla proporciona vínculos a las direcciones URL que utilizaría para agregar módulos de dependencia. Los vínculos también le dirigen a más información sobre cada módulo específico.

Importar extensiones

En Android Studio, vaya a app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication y asegúrese de que las siguientes importaciones formen parte del archivo de origen.

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

Haga lo mismo para app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK.

Actualizar aplicación de Luma

En la vista de Android, vaya a aplicación > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication en Android Studio.

1. Reemplace "YOUR_ENVIRONMENT_FILE_ID" en private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" por el valor de Id. de archivo de entorno que recuperó de las etiquetas en Generar instrucciones de instalación de SDK.

   code language-kotlin
   private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

2. Agregue el siguiente código a la función override fun onCreate() en 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) }

   El código anterior hace lo siguiente:

   1. Registra las extensiones necesarias.
   2. Configura MobileCore y otras extensiones para utilizar la configuración de propiedad de etiquetas.
   3. Habilita el registro de depuración. Encontrará más detalles y opciones en la documentación de Adobe Experience Platform Mobile SDK.
   4. Inicia la supervisión del ciclo vital. Consulte el paso Ciclo vital en el tutorial para obtener más información.
   5. Establece el consentimiento predeterminado como desconocido. Consulte el paso Consentimiento en el tutorial para obtener más información.

Asegúrese de actualizar MobileCore.configureWith(environmentFileId) con environmentFileId en función del ID de archivo de entorno del entorno de etiqueta para el que está creando (desarrollo, ensayo o producción).