Adobe Experience Platform Mobile SDK's installeren
Leer hoe u de Adobe Experience Platform Mobile SDK in een mobiele app implementeert.
Vereisten
- Opvolger bouwde met succes een markeringsbibliotheek met de uitbreidingen die in de vorige lesworden beschreven.
- Identiteitskaart van het Dossier van het Milieu van de ontwikkeling van Mobiele Installatieinstructies.
- Gedownload lege steekproef app{target=“_blank”}.
- Ervaring met Xcode{target=“_blank”}.
Leerdoelstellingen
In deze les zult u:
- Voeg de vereiste SDKs aan uw project toe gebruikend de Swift Manager van het Pakket.
- Registreer de extensies.
Swift Package Manager
In plaats van het gebruiken van CocoaPods en een dossier van de Pod (zoals die in worden geschetst produceert SDK installeert instructies), voegt u individuele pakketten toe gebruikend de inheemse Manager van het Pakket van Xcode Swift. Het Xcode-project heeft al alle pakketafhankelijkheden die voor u zijn toegevoegd. Het scherm Xcode Package Dependencies moet er als volgt uitzien:
In Xcode kunt u File > Add Packages… gebruiken om pakketten toe te voegen. De onderstaande tabel bevat koppelingen naar de URL's die u zou gebruiken om pakketten toe te voegen. De koppelingen leiden u ook naar meer informatie over elk specifiek pakket.
De extensies AEPCore , AEPServices en AEPIdentity vertegenwoordigen de basis van de SDK van Adobe Experience Platform. Elke toepassing die de SDK gebruikt, moet deze bevatten. Deze modules bevatten een gemeenschappelijke reeks functionaliteit en de diensten die door alle uitbreidingen van SDK worden vereist.
AEPCorebevat implementatie van de gebeurtenishub. De hub van de Gebeurtenis is het mechanisme dat voor het leveren van gebeurtenissen tussen app en SDK wordt gebruikt. De hub van de Gebeurtenis wordt ook gebruikt voor het delen van gegevens tussen uitbreidingen.AEPServicesbiedt verschillende herbruikbare implementaties die nodig zijn voor platformondersteuning, zoals netwerken, schijftoegang en databasebeheer.AEPIdentityimplementeert de integratie met Adobe Experience Platform Identity-services.AEPSignalstaat voor de Adobe Experience Platform SDK's Signal-extensie waarmee marketers een "signaal" naar hun apps kunnen sturen om gegevens naar externe doelen te verzenden of om URL's te openen.AEPLifecyclevertegenwoordigt de Levenscyclusuitbreiding van SDK van Adobe Experience Platform die helpt metriek van de toepassingslevenscyclus zoals toepassingsinstallatie of verbeteringsinformatie, toepassingslancering en zittingsinformatie, apparateninformatie, en om het even welke extra contextgegevens te verzamelen die door de toepassingsontwikkelaar worden verstrekt.
AEPEdge ) kunt u gegevens naar het Adobe Edge-netwerk verzenden vanuit een mobiele toepassing. Deze uitbreiding staat u toe om de mogelijkheden van Adobe Experience Cloud op een robuustere manier uit te voeren, veelvoudige oplossingen van de Adobe door middel van één netwerkvraag te dienen, en deze informatie gelijktijdig door te sturen aan Adobe Experience Platform.de mobiele uitbreiding van de Edge Network is een uitbreiding voor Adobe Experience Platform SDK en vereist
AEPCore en AEPServices uitbreidingen voor gebeurtenis behandeling, evenals de AEPEdgeIdentity uitbreiding voor het terugwinnen van de identiteiten, zoals ECID.AEPEdgeIdentity) kunnen identiteitsgegevens van gebruikers van een mobiele toepassing worden verwerkt wanneer de SDK van Adobe Experience Platform en de extensie van Edge Network worden gebruikt.AEPConsent) laat de inzameling van de toestemmingsvoorkeur van de mobiele toepassing toe wanneer het gebruiken van de SDK van Adobe Experience Platform en de uitbreiding van de Edge Network.AEPUserProfile) is een extensie voor het beheren van gebruikersprofielen voor de Adobe Experience Platform SDK.AEPPlaces) staat u toe om geolocatiegebeurtenissen te volgen zoals die in de interface van Plaatsen van de Adobe en in de regels van de Markering van de Inzameling van Gegevens van de Adobe worden bepaald.AEPMessaging ) kunt u tokens voor pushmeldingen verzenden en doorklikken op pushberichten naar de Adobe Experience Platform.AEPOptimize) biedt API's om realtime workflows voor personalisatie in de Adobe Experience Platform Mobile SDK's mogelijk te maken met Adobe Target of Adobe Journey Optimizer Offer decisioning. Voor deze functie zijn AEPCore - en AEPEdge -extensies nodig om verpersoonlijkingsquery-gebeurtenissen naar het Experience Edge-netwerk te verzenden.AEPAssurance) om u te helpen inspecteren, beproeven, simuleren, en bevestigen hoe u gegevens verzamelt of ervaringen in uw mobiele app dient. Met deze extensie wordt uw app voor betrouwbaarheidsverklaring ingeschakeld.Extensies importeren
Navigeer in Xcode naar Luma > Luma > AppDelegate en controleer of de volgende importbewerkingen deel uitmaken van dit bronbestand.
// 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
Doe hetzelfde voor Luma > Luma > Utils > MobileSDK .
AppDelegate bijwerken
Navigeer aan Luma > Luma > AppDelegate in de navigator van het Project van Xcode.
-
Vervang de
@AppStoragewaardeYOUR_ENVIRONMENT_ID_GOES_HEREvoorenvironmentFileIdaan de waarde van identiteitskaart van het Dossier van het Milieu van de Ontwikkelomgeving die u van markeringen in teruggewonnen produceert SDK installeert instructies.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" -
Voeg de volgende code toe aan de functie
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) })
De bovenstaande code doet het volgende:
- Registreert de vereiste extensies.
- Vormt MobileCore en andere uitbreidingen om uw configuratie van het markeringsbezit te gebruiken.
- Schakelt foutopsporingslogbestand in. Meer details en de opties kunnen in de Mobiele documentatie van SDK van Adobe Experience Platformworden gevonden.
- Start levenscycluscontrole. Zie Levenscyclusstap in het leerprogramma voor meer details.
- Hiermee stelt u de standaardtoestemming in op onbekend. Zie 🔗 stap 0} van de Toestemming {in het leerprogramma voor meer details.
MobileCore.configureWith(appId: self.environmentFileId) bijwerkt met de appId op basis van de environmentFileId -code uit de tagomgeving waarvoor u ontwikkelt (ontwikkelen, opvoeren of produceren).Volgende: de Verzekering van de opstelling