Installieren von Adobe Experience Platform Mobile SDKs tutorial_install_mobile_sdks
Erfahren Sie, wie Sie das Adobe Experience Platform Mobile SDK in einer App implementieren.
Voraussetzungen
- Eine Tag-Bibliothek mit den in der vorherigen Lektion beschriebenen Erweiterungen wurde erstellt.
- Datei-ID der Entwicklungsumgebung aus der Installationsanweisungen für Mobilgeräte.
- Leere (BeispielApp heruntergeladen.
- Erfahrung mit Xcode.
Lernziele
In dieser Lektion erfahren Sie Folgendes:
- Fügen Sie Ihrem Projekt die erforderlichen SDKs mithilfe von Swift Package Manager hinzu.
- Registrieren Sie die Erweiterungen.
Swift Package Manager
Anstatt CocoaPods und eine Pod-Datei zu verwenden (wie unter Generate SDK install instructions beschrieben), fügen Sie einzelne Pakete mit dem nativen Swift Package Manager von Xcode hinzu. Dem Xcode-Projekt wurden bereits alle Paketabhängigkeiten hinzugefügt. Der Bildschirm Xcode Paketabhängigkeiten sollte wie folgt aussehen:
In Xcode können Sie Datei > Pakete hinzufügen… verwenden. Die nachstehende Tabelle enthält Links zu den URLs, die Sie zum Hinzufügen von Paketen verwenden würden. Über die Links gelangen Sie zu weiteren Informationen zu den einzelnen Paketen.
Die AEPCore-, AEPServices- und AEPIdentity-Erweiterungen bilden die Grundlage des Adobe Experience Platform SDKS. Jede App, die SDK verwendet, muss diese Erweiterungen enthalten. Diese Module enthalten einen gemeinsamen Satz von Funktionen und Services, die für alle SDK-Erweiterungen erforderlich sind.
AEPCoreenthält die Implementierung des Event Hub. Der Event Hub ist der Mechanismus, der zum Bereitstellen von Ereignissen zwischen der Mobile App und der SDK verwendet wird. Der Event Hub wird auch für die Datenfreigabe zwischen Erweiterungen verwendet.AEPServicesbietet mehrere wiederverwendbare Implementierungen, die für die Plattformunterstützung erforderlich sind, einschließlich Netzwerk, Festplattenzugriff und Datenbankverwaltung.AEPIdentityimplementiert die Integration mit Adobe Experience Platform Identity Services.AEPSignalstellt die Signalerweiterung der Adobe Experience Platform SDKs dar, die es Marketing-Experten ermöglicht, ein „Signal“ an ihre Apps zu senden, um Daten an externe Ziele zu senden oder URLs zu öffnen.AEPLifecyclestellt die Adobe Experience Platform SDKs-Lebenszykluserweiterung dar, mit der Lebenszyklusmetriken von Anwendungen wie Informationen zur Anwendungsinstallation oder -aktualisierung, Informationen zum Anwendungsstart und zur Sitzung, Geräteinformationen und zusätzliche vom Anwendungsentwickler bereitgestellte Kontextdaten erfasst werden können.
AEPEdge) können Sie Daten von einer Mobile App an das Adobe Edge-Netzwerk senden. Mit dieser Erweiterung können Sie Adobe Experience Cloud-Funktionen robuster implementieren, mehrere Adobe-Lösungen über einen Netzwerkaufruf bereitstellen und diese Informationen gleichzeitig an Adobe Experience Platform weiterleiten.Die Edge Network Mobile-Erweiterung ist eine Erweiterung für Adobe Experience Platform SDK und erfordert die
AEPCore- und AEPServices-Erweiterungen für die Ereignisverarbeitung sowie die AEPEdgeIdentity zum Abrufen der Identitäten (z. B. ECID).AEPEdgeIdentity) ermöglicht die Verarbeitung von Benutzeridentitätsdaten aus einer Mobile App unter Verwendung der Adobe Experience Platform SDK und der Edge Network-Erweiterung.AEPConsent) ermöglicht die Erfassung von Einverständnisvoreinstellungen über die Mobile App bei Verwendung der Adobe Experience Platform SDK und der Edge Network-Erweiterung.AEPUserProfile) ist eine Erweiterung zur Verwaltung von Benutzerprofilen für die Adobe Experience Platform SDK.AEPPlaces) können Sie Geolokalisierungsereignisse verfolgen, wie sie in der Adobe Places-Benutzeroberfläche und in den Tag-Regeln für das Adobe der Datenerfassung definiert sind.AEPMessaging) können Sie Push-Benachrichtigungs-Token und Clickthrough-Feedback für Push-Benachrichtigungen an die Adobe Experience Platform senden.AEPOptimize) bietet APIs, um Echtzeit-Personalisierungs-Workflows in den Adobe Experience Platform Mobile SDKs mithilfe von Adobe Target oder Adobe Journey Optimizer Offer decisioning zu ermöglichen. Es sind AEPCore- und AEPEdge-Erweiterungen erforderlich, um Personalisierungsabfrageereignisse an das Experience Edge-Netzwerk zu senden.AEPAssurance), mit der Sie die Datenerfassung und die Bereitstellung von Erlebnissen in Ihrer Mobile App untersuchen, testen, simulieren und validieren können. Diese Erweiterung aktiviert Ihre App für Assurance.Erweiterungen importieren
Navigieren Sie in Xcode zu Luma > Luma > AppDelegate und stellen Sie sicher, dass die folgenden Importe Teil dieser Quelldatei sind.
// 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
Tun Sie dasselbe für Luma > Luma > Utils > MobileSDK.
AppDelegate aktualisieren
Navigieren Sie im Xcode-Projekt Navigator zu Luma > Luma > AppDelegate.
-
Ersetzen Sie den
@AppStorage-Wert, der fürenvironmentFileIdauf den Datei-ID-Wert der EntwicklungsumgebungYOUR_ENVIRONMENT_ID_GOES_HEREist, den Sie von Tags in Installationsanweisungen für SDK generieren abgerufen haben.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" -
Fügen Sie der
application(_, didFinishLaunchingWithOptions)-Funktion den folgenden Code hinzu.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) })
Der obige Code bewirkt Folgendes:
- Registriert die erforderlichen Erweiterungen.
- Konfiguriert MobileCore und andere Erweiterungen für die Verwendung Ihrer Tag-Eigenschaftskonfiguration.
- Aktiviert die Debug-Protokollierung. Weitere Informationen und Optionen finden Sie in der Dokumentation zu Adobe Experience Platform Mobile SDK.
- Startet die Lebenszyklusüberwachung. Weitere finden SieSchritt „Lebenszyklus“ im Tutorial .
- Setzt das Standard-Einverständnis auf unbekannt. Weitere finden SieSchritt „Einverständnis“ im Tutorial .
MobileCore.configureWith(appId: self.environmentFileId) mit der appId aktualisieren, basierend auf der environmentFileId aus der Tag-Umgebung, für die Sie sie erstellen (Entwicklung, Staging oder Produktion).Weiter: Einrichten von Assurance