Instalación de SDK de Adobe Experience Platform Mobile
Obtenga información sobre cómo implementar el SDK de Adobe Experience Platform Mobile en una aplicación móvil.
Requisitos previos
- Se creó correctamente una biblioteca de etiquetas con las extensiones descritas en la lección anterior.
- ID de archivo del entorno de desarrollo de Instrucciones de instalación móvil.
- Descargó la aplicación de ejemplo vacía.
- Experiencia con Xcode.
Objetivos de aprendizaje
En esta lección, deberá hacer lo siguiente:
- Añada los SDK necesarios al proyecto mediante el Administrador de paquetes de Swift.
- Registre las extensiones.
Administrador De Paquetes Swift
En lugar de usar CocoaPods y un archivo Pod (como se describe en Generar instrucciones de instalación del 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:
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.
Las extensiones AEPCore, AEPServices y AEPIdentity representan la base del SDK de Adobe Experience Platform; todas las aplicaciones que utilicen el SDK deben incluirlas. Estos módulos contienen un conjunto común de funcionalidades y servicios que son necesarios para todas las extensiones de SDK.
AEPCorecontiene la implementación de Event Hub. Event Hub es el mecanismo que se utiliza para enviar eventos entre la aplicación y el SDK. Event Hub también se utiliza para compartir datos entre extensiones.AEPServicesproporciona varias implementaciones reutilizables necesarias para la compatibilidad con la plataforma, incluidas la red, el acceso a disco y la administración de bases de datos.AEPIdentityimplementa la integración con los servicios de identidad de Adobe Experience Platform.AEPSignalrepresenta la extensión de señal del SDK de Adobe Experience Platform que permite a los especialistas en marketing enviar una "señal" a sus aplicaciones para enviar datos a destinos externos o para abrir direcciones URL.AEPLifecyclerepresenta la extensión del ciclo vital de los SDK de Adobe Experience Platform que ayuda a recopilar métricas del ciclo vital de la aplicación, como información de actualización o instalación de aplicaciones, información de inicio y sesión de aplicaciones, información del dispositivo y cualquier dato de contexto adicional proporcionado por el desarrollador de la aplicación.
AEPEdge) le permite enviar datos a Adobe Edge Network desde una aplicación móvil. Esta extensión le permite implementar las funcionalidades de Adobe Experience Cloud de una manera más sólida, ofrecer varias soluciones de Adobe a través de una llamada de red y enviar simultáneamente esta información a Adobe Experience Platform.La extensión móvil de Edge Network es una extensión para el SDK de Adobe Experience Platform y requiere las extensiones
AEPCore y AEPServices para la administración de eventos, así como la extensión AEPEdgeIdentity para recuperar las identidades, como ECID.AEPEdgeIdentity) permite administrar los datos de identidad de usuario desde una aplicación móvil al utilizar el SDK de Adobe Experience Platform y la extensión de Edge Network.AEPConsent) habilita la recopilación de preferencias de consentimiento de la aplicación móvil al utilizar el SDK de Adobe Experience Platform y la extensión de Edge Network.AEPUserProfile) es una extensión para administrar perfiles de usuario para el SDK de Adobe Experience Platform.AEPPlaces) le permite rastrear eventos de geolocalización según se definen en la interfaz de Places de Adobe y en las reglas de etiquetas de recopilación de datos de Adobe.AEPMessaging) le permite enviar tokens de notificaciones push y comentarios sobre clics en notificaciones push a Adobe Experience Platform.AEPOptimize) proporciona API para habilitar flujos de trabajo de personalización en tiempo real en los SDK de Adobe Experience Platform Mobile mediante Adobe Target o Adobe Journey Optimizer Offer Decisioning. Se requieren las extensiones AEPCore y AEPEdge para enviar eventos de consulta de personalización a la red de Experience Edge.AEPAssurance) que le ayudará a inspeccionar, probar, simular y validar la forma en que recopila datos o sirve las experiencias en su aplicación móvil. Esta extensión habilita la aplicación para Assurance.Importar extensiones
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.
-
Reemplace el valor
@AppStorageYOUR_ENVIRONMENT_ID_GOES_HEREparaenvironmentFileIdpor el valor de ID de archivo del entorno de desarrollo que recuperó de las etiquetas en Generar instrucciones de instalación del SDK.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" -
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:
- Registra las extensiones necesarias.
- Configura MobileCore y otras extensiones para utilizar la configuración de propiedad de etiquetas.
- Habilita el registro de depuración. Encontrará más detalles y opciones en la documentación del SDK de Adobe Experience Platform Mobile.
- Inicia la supervisión del ciclo vital. Consulte el paso Ciclo vital en el tutorial para obtener más información.
- Establece el consentimiento predeterminado como desconocido. Consulte el paso Consentimiento en el tutorial para obtener más información.
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).Siguiente: Configurar Assurance