Installare gli SDK di Adobe Experience Platform Mobile
Scopri come implementare l’SDK di Adobe Experience Platform Mobile in un’app mobile.
Prerequisiti
- Creazione di una libreria di tag con le estensioni descritte nella lezione precedente completata.
- ID del file dell'ambiente di sviluppo dalle istruzioni di installazione per dispositivi mobili.
- Scarica l'app di esempio vuota.
- Esperienza con Xcode.
Obiettivi di apprendimento
In questa lezione verranno fornite le seguenti informazioni:
- Aggiungi gli SDK richiesti al progetto utilizzando Gestione pacchetti Swift.
- Registra le estensioni.
Gestione pacchetti Swift
Invece di utilizzare i CocoaPods e un file Pod (come descritto in Generare istruzioni di installazione SDK), puoi aggiungere singoli pacchetti utilizzando il gestore di pacchetti Swift nativo di Xcode. Nel progetto Xcode sono già state aggiunte tutte le dipendenze dei pacchetti. La schermata Dipendenze pacchetto di Xcode deve essere simile alla seguente:
In Xcode puoi utilizzare File > Aggiungi pacchetti… per aggiungere pacchetti. La tabella seguente fornisce i collegamenti agli URL da utilizzare per aggiungere pacchetti. I collegamenti ti indirizzano anche a ulteriori informazioni su ciascun pacchetto specifico.
Le estensioni AEPCore, AEPServices e AEPIdentity rappresentano le basi dell'SDK di Adobe Experience Platform. Ogni app che utilizza l'SDK deve includerle. Questi moduli contengono un set comune di funzionalità e servizi richiesti da tutte le estensioni SDK.
AEPCorecontiene l'implementazione dell'hub eventi. L’hub eventi è il meccanismo utilizzato per la trasmissione degli eventi tra l’app e l’SDK. L’hub eventi viene utilizzato anche per condividere i dati tra le estensioni.AEPServicesfornisce diverse implementazioni riutilizzabili necessarie per il supporto della piattaforma, tra cui rete, accesso al disco e gestione del database.AEPIdentityimplementa l'integrazione con i servizi Adobe Experience Platform Identity.AEPSignalrappresenta l'estensione Segnale degli SDK di Adobe Experience Platform che consente agli addetti al marketing di inviare un "segnale" alle proprie app per inviare dati a destinazioni esterne o per aprire URL.AEPLifecyclerappresenta l'estensione del ciclo di vita degli SDK di Adobe Experience Platform che consente di raccogliere le metriche del ciclo di vita dell'applicazione, ad esempio le informazioni relative all'installazione o all'aggiornamento dell'applicazione, all'avvio e alla sessione dell'applicazione, alle informazioni sul dispositivo e a qualsiasi dato di contesto aggiuntivo fornito dallo sviluppatore dell'applicazione.
AEPEdge) consente di inviare dati alla rete Adobe Edge da un'app mobile. Questa estensione consente di implementare le funzionalità di Adobe Experience Cloud in modo più affidabile, distribuire più soluzioni di Adobe tramite una chiamata di rete e inoltrare simultaneamente queste informazioni a Adobe Experience Platform.L'estensione Edge Network per dispositivi mobili è un'estensione per Adobe Experience Platform SDK e richiede le estensioni
AEPCore e AEPServices per la gestione degli eventi, nonché l'estensione AEPEdgeIdentity per il recupero delle identità, ad esempio ECID.AEPEdgeIdentity) consente la gestione dei dati di identità utente da un'app mobile quando si utilizzano l'SDK di Adobe Experience Platform e l'estensione di Edge Network.AEPConsent) abilita la raccolta delle preferenze di consenso dall'app mobile quando si utilizza l'SDK di Adobe Experience Platform e l'estensione di Edge Network.AEPUserProfile) è un'estensione per la gestione dei profili utente per l'SDK di Adobe Experience Platform.AEPPlaces) consente di tenere traccia degli eventi di geolocalizzazione definiti nell'interfaccia Adobe Places e nelle regole dei tag di raccolta dati Adobe.AEPMessaging) consente di inviare token di notifica push e feedback click-through di notifica push a Adobe Experience Platform.AEPOptimize) fornisce API per abilitare i flussi di lavoro di personalizzazione in tempo reale negli SDK di Adobe Experience Platform Mobile tramite Adobe Target o Adobe Journey Optimizer Offer Decisioning. Sono necessarie le estensioni AEPCore e AEPEdge per inviare eventi di query di personalizzazione alla rete Experience Edge.AEPAssurance) che consente di controllare, verificare, simulare e convalidare le modalità di raccolta dei dati o di gestione delle esperienze nell'app mobile. Questa estensione abilita l’app per Assurance.Importare estensioni
In Xcode, passa a Luma > Luma > AppDelegate e assicurati che le seguenti importazioni facciano parte di questo file di origine.
// 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
Effettua le stesse operazioni per Luma > Luma > Utils > MobileSDK.
Aggiorna AppDelegate
Passa a Luma > Luma > AppDelegate nel Navigatore progetti Xcode.
-
Sostituire il valore
YOUR_ENVIRONMENT_ID_GOES_HEREdi@AppStorageperenvironmentFileIdcon il valore ID file dell'ambiente di sviluppo recuperato dai tag nelle istruzioni di installazione SDK di generazione.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" -
Aggiungere il codice seguente alla funzione
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) })
Il codice di cui sopra esegue le seguenti operazioni:
- Registra le estensioni richieste.
- Configura MobileCore e altre estensioni per utilizzare la configurazione della proprietà tag.
- Abilita la registrazione di debug. Ulteriori dettagli e opzioni sono disponibili nella documentazione dell'SDK di Adobe Experience Platform Mobile.
- Avvia il monitoraggio del ciclo di vita. Per ulteriori dettagli, vedi il passaggio Ciclo di vita nell'esercitazione.
- Imposta il consenso predefinito su sconosciuto. Consulta il passaggio Consenso nell'esercitazione per ulteriori dettagli.
MobileCore.configureWith(appId: self.environmentFileId) con appId in base a environmentFileId dall'ambiente di tag che stai creando per (sviluppo, staging o produzione).Successivo: Configura Assurance