Installera Adobe Experience Platform Mobile SDKs
Lär dig hur du implementerar Adobe Experience Platform Mobile SDK i en mobilapp.
Förutsättningar
- Ett taggbibliotek med tilläggen som beskrivs i föregående lektion.
- Fil-ID för utvecklingsmiljö från Instruktioner för mobilinstallation.
- Tomma filer har hämtats exempelapp.
- 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
Istället för att använda CocoaPods och en Pod-fil (enligt beskrivningen i Generera installationsanvisningar för SDK) kan du lägga till enskilda paket med Xcodes inbyggda Swift Package Manager. Xcode-projektet har redan alla paketberoenden tillagda. Xcode Paketberoenden ska se ut så här:
I Xcode kan du använda Fil > Lägg till paket… 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.
The AEPCore, AEPServicesoch AEPIdentity tillägg 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 för 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 Adobe Experience Platform SDK:s signaltillägg som gör att marknadsförarna kan skicka en signal till sina appar för att skicka data till externa destinationer eller till öppna URL:er.AEPLifecyclerepresenterar Adobe Experience Platform SDK:s Lifecycle-tillägg som hjälper till att samla in uppgifter om programmets livscykel, t.ex. information om installation eller uppgradering, 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.Det mobila tillägget Edge Network är ett tillägg till Adobe Experience Platform SDK och kräver
AEPCore och AEPServices tillägg för händelsehantering samt AEPEdgeIdentity tillägg för att hämta identiteter, som ECID.AEPEdgeIdentity) används för att hantera användaridentitetsdata från ett mobilprogram när Adobe Experience Platform SDK och Edge Network-tillägget används.AEPConsent) aktiverar insamling av medgivandeinställningar från mobilprogrammet när du använder Adobe Experience Platform SDK och Edge Network-tillägget.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 Adobe Platser-gränssnittet och i Adobe Data Collection Tag-reglerna.AEPMessaging) kan du skicka push-meddelandetokens och skicka vidare klickningsfeedback till Adobe Experience Platform.AEPOptimize) innehåller API:er för att möjliggöra personalisering i realtid i Adobe Experience Platform Mobile SDK:er med Adobe Target eller Adobe Journey Optimizer Offer decisioning. Den kräver AEPCore och AEPEdge tillägg för att skicka personaliseringsfrågehändelser till Experience Edge-nätverket.AEPAssurance) för att hjälpa er att inspektera, bevisa, simulera och validera hur ni samlar in data eller levererar upplevelser i er mobilapp. Det här tillägget aktiverar din app för Assurance.Importera tillägg
I Xcode navigerar du till Luma > Luma > AppDelegate och se 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 på samma sätt för Luma > Luma > Utils > MobileSDK.
Uppdatera AppDelegate
Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.
-
Ersätt
@AppStoragevalueYOUR_ENVIRONMENT_ID_GOES_HEREforenvironmentFileIdtill det fil-ID för utvecklingsmiljön som du hämtade från taggar i Generera installationsanvisningar för SDK.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" -
Lägg till följande kod i
application(_, didFinishLaunchingWithOptions)funktion.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 Dokumentation för Adobe Experience Platform Mobile SDK.
- Startar livscykelövervakning. Se Livscykel i självstudiekursen för mer information.
- Anger okänt standardsamtycke. Se Godkännande i självstudiekursen för mer information.
MobileCore.configureWith(appId: self.environmentFileId) med appId baserat på environmentFileId från den taggmiljö du bygger för (utveckling, staging eller produktion).Nästa: Ställ in försäkring