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 ha creado 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 de Mobile.
- Se descargó el vacío aplicación de ejemplo.
- 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), puede agregar paquetes individuales utilizando el gestor de paquetes Swift nativo de Xcode. El proyecto Xcode ya tiene todas las dependencias de paquetes agregadas para usted. El Xcode Dependencias del paquete La pantalla debería tener un aspecto similar al siguiente:
{zoomable="yes"}
En Xcode, puede utilizar 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.
El AEPCore
, AEPServices
, y AEPIdentity
Las extensiones 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.
AEPCore
contiene la implementación del centro de eventos. 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.AEPServices
proporciona varias implementaciones reutilizables necesarias para la compatibilidad con la plataforma, incluidas las de red, acceso a disco y administración de bases de datos.AEPIdentity
implementa la integración con los servicios de Adobe Experience Platform ID.AEPSignal
representa 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.AEPLifecycle
representa 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 instalación o actualizació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 aplicaciones.
AEPEdge
) 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 Edge Network es una extensión para el SDK de Adobe Experience Platform y requiere lo siguiente
AEPCore
y AEPServices
extensiones para la gestión de eventos, así como el AEPEdgeIdentity
extensión para recuperar las identidades, como ECID.AEPEdgeIdentity
) permite la administración de datos de identidad de usuario desde una aplicación móvil al utilizar el SDK de Adobe Experience Platform y la extensión de red perimetral.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 red perimetral.AEPUserProfile
) es una extensión para administrar perfiles de usuario para el SDK de Adobe Experience Platform.AEPPlaces
) le permite realizar un seguimiento de los eventos de geolocalización tal como se definen en la interfaz Lugares 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. Requiere AEPCore
y AEPEdge
extensiones para enviar eventos de consulta de personalización a la red de Experience Edge.AEPAssurance
) para ayudarle a inspeccionar, probar, simular y validar la forma en que recopila datos o sirve 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
@AppStorage
valorYOUR_ENVIRONMENT_ID_GOES_HERE
paraenvironmentFileId
al 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"
-
Añada el siguiente código a
application(_, didFinishLaunchingWithOptions)
función.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 Ciclo de vida paso en el tutorial para obtener más información.
- Establece el consentimiento predeterminado como desconocido. Consulte Consentimiento paso en el tutorial para obtener más información.
MobileCore.configureWith(appId: self.environmentFileId)
con el appId
basado en el environmentFileId
desde el entorno de etiquetas que está creando para (desarrollo, ensayo o producción).Siguiente: Configurar Assurance