Installera Adobe Experience Platform Mobile SDKs
Lär dig hur du implementerar Adobe Experience Platform Mobile SDK i en mobilapp.
Förhandskrav
- Ett taggbibliotek med tilläggen som beskrivs i föregående lektion har skapats.
- Fil-ID för utvecklingsmiljö från Mobile Install Instructions.
- Den tomma exempelappen hämtades.
- Upplev Xcode.
Utbildningsmål
I den här lektionen kommer du att:
- Lägg till önskade SDK:er i projektet med Swift Package Manager.
- Registrera tilläggen.
Swift Package Manager
I stället för att använda CocoaPods och en Pod-fil (som beskrivs i Generera installationsanvisningar för SDK), lägger du till enskilda paket med Xcodes inbyggda Swift Package Manager. Xcode-projektet har redan alla paketberoenden tillagda. Xcode Package Dependencies-skärmen ska se ut så här:
I Xcode kan du använda File > Add Packages… för att lägga till paket. Tabellen nedan innehåller länkar till de URL:er som du skulle använda för att lägga till paket. Länkarna visar även mer information om varje paket.
Tilläggen AEPCore, AEPServices och AEPIdentity utgör grunden för Adobe Experience Platform SDK - alla program som använder SDK måste innehålla dem. Dessa moduler innehåller en gemensam uppsättning funktioner och tjänster som krävs av alla SDK-tillägg.
AEPCoreinnehåller implementering av händelsehubben. Händelsehubben är den mekanism som används för att leverera händelser mellan appen och SDK:n. Händelsehubben används också för att dela data mellan tillägg.AEPServicesinnehåller flera återanvändbara implementeringar som krävs för plattformsstöd, inklusive nätverk, diskåtkomst och databashantering.AEPIdentityimplementerar integreringen med Adobe Experience Platform Identity Services.AEPSignalrepresenterar signeringstillägget för Adobe Experience Platform SDK:er som gör att marknadsförarna kan skicka en signal till sina appar för att skicka data till externa mål eller öppna URL:er.AEPLifecyclerepresenterar Adobe Experience Platform SDKs Lifecycle-tillägget som hjälper till att samla in livscykelvärden för program, som installations- eller uppgraderingsinformation för program, information om programstart och session, enhetsinformation och eventuella ytterligare kontextdata från programutvecklaren.
AEPEdge) kan du skicka data till Adobe Edge Network från ett mobilprogram. Med det här tillägget kan du implementera Adobe Experience Cloud-funktioner på ett mer robust sätt, leverera flera Adobe-lösningar via ett nätverksanrop och samtidigt vidarebefordra informationen till Adobe Experience Platform.Mobiltillägget Edge Network är ett tillägg för Adobe Experience Platform SDK och kräver
AEPCore och AEPServices för händelsehantering samt AEPEdgeIdentity-tillägget för hämtning av identiteter, till exempel ECID.AEPEdgeIdentity) kan du hantera användaridentitetsdata från ett mobilprogram när du använder Adobe Experience Platform SDK och tillägget Edge Network.AEPConsent) aktiverar insamling av medgivandeinställningar från mobilprogrammet när du använder Adobe Experience Platform SDK och tillägget Edge Network.AEPUserProfile) är ett tillägg för att hantera användarprofiler för Adobe Experience Platform SDK.AEPPlaces) kan du spåra geopositioneringshändelser enligt definitionen i gränssnittet Adobe Platser och i taggreglerna för Adobe-datainsamling.AEPMessaging) kan du skicka push-meddelandetokens och push-meddelanden via-feedback till Adobe Experience Platform.AEPOptimize) innehåller API:er för att aktivera arbetsflöden för personalisering i realtid i Adobe Experience Platform Mobile SDK:er med Adobe Target eller Adobe Journey Optimizer Offer decisioning. Det krävs AEPCore och AEPEdge tillägg för att skicka personaliseringsfrågehändelser till Experience Edge-nätverket.AEPAssurance) som hjälper dig att inspektera, granska, simulera och validera hur du samlar in data eller levererar upplevelser i din mobilapp. Det här tillägget aktiverar din app för Assurance.Importera tillägg
I Xcode går du till Luma > Luma > AppDelegate och ser till att följande importer ingår i den här källfilen.
// 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
Gör samma sak för Luma > Luma > Utils > MobileSDK.
Uppdatera AppDelegate
Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.
-
Ersätt
@AppStorage-värdetYOUR_ENVIRONMENT_ID_GOES_HEREförenvironmentFileIdmed det fil-ID för utvecklingsmiljö som du hämtade från taggar i Skapa installationsanvisningar för SDK.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" -
Lägg till följande kod i funktionen
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) })
Koden ovan gör följande:
- Registrerar nödvändiga tillägg.
- Konfigurerar MobileCore och andra tillägg så att taggegenskapskonfigurationen används.
- Aktiverar felsökningsloggning. Mer information och alternativ finns i dokumentationen för Adobe Experience Platform Mobile SDK.
- Startar livscykelövervakning. Mer information finns i steget Livscykel i självstudiekursen.
- Anger okänt standardsamtycke. Mer information finns i steget Medgivande i självstudiekursen.
MobileCore.configureWith(appId: self.environmentFileId) med appId baserat på environmentFileId från den taggmiljö som du skapar för (utveckling, mellanlagring eller produktion).Nästa: Konfigurera försäkring