Adobe Experience Platform Mobile SDK's installeren
Leer hoe u de Adobe Experience Platform Mobile SDK in een mobiele app implementeert.
Vereisten
- Er is een tagbibliotheek gemaakt met de extensies die in het dialoogvenster vorige les.
- Bestandsidentiteitskaart voor ontwikkelomgeving van de Instructies voor mobiele installatie.
- Lege bestanden gedownload voorbeeldapp.
- Ervaring met Xcode.
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 CocoaPods en een podbestand te gebruiken (zoals beschreven in SDK-installatie-instructies genereren), voegt u afzonderlijke pakketten toe met gebruik van de native Swift Package Manager van Xcode. Het Xcode-project heeft al alle pakketafhankelijkheden die voor u zijn toegevoegd. De Xcode Pakketafhankelijke onderdelen scherm moet er als volgt uitzien:
{modal="regular"}
In Xcode kunt u Bestand > Pakketten toevoegen… pakketten toevoegen. 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 AEPCore
, AEPServices
, en AEPIdentity
extensies vormen de basis voor de SDK van Adobe Experience Platform. Elke toepassing die de SDK gebruikt, moet deze bevatten. Deze modules bevatten een gemeenschappelijke reeks functionaliteit en diensten die door alle uitbreidingen van SDK worden vereist.
AEPCore
Bevat implementatie van de Hub van de Gebeurtenis. 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.AEPServices
verstrekt verscheidene herbruikbare implementaties nodig voor platformsteun, met inbegrip van voorzien van een netwerk, schijftoegang, en gegevensbestandbeheer.AEPIdentity
implementeert de integratie met Adobe Experience Platform Identity-services.AEPSignal
vertegenwoordigt de Adobe Experience Platform SDKs Signal extension die marketers toestaat een "signaal"naar hun apps te verzenden om gegevens naar externe bestemmingen te verzenden of URLs te openen.AEPLifecycle
vertegenwoordigt de Levenscyclusuitbreiding van SDKs van Adobe Experience Platform die helpt metriek van de toepassingslevenscyclus zoals toepassingsinstallatie of verbeteringsinformatie, toepassingslancering en zittingsinformatie, apparateninformatie, en om het even welke extra die contextgegevens verzamelen 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 extensie van Edge Network is een extensie voor de Adobe Experience Platform SDK en vereist de opdracht
AEPCore
en AEPServices
extensies voor gebeurtenisafhandeling en de AEPEdgeIdentity
voor het ophalen van de identiteiten, zoals ECID.AEPEdgeIdentity
) maakt het mogelijk om identiteitsgegevens van gebruikers van een mobiele toepassing af te handelen wanneer de SDK van Adobe Experience Platform en de extensie Edge Network worden gebruikt.AEPConsent
) schakelt de verzameling met voorkeuren voor toestemming van de mobiele toepassing in als u de SDK van Adobe Experience Platform en de extensie Edge Network gebruikt.AEPUserProfile
) is een extensie voor het beheren van gebruikersprofielen voor de Adobe Experience Platform SDK.AEPPlaces
) kunt u geolocatiegebeurtenissen bijhouden zoals gedefinieerd in de interface Plaatsen van Adoben en in de regels voor de tag voor gegevensverzameling van Adoben.AEPMessaging
) kunt u tokens voor pushmeldingen en doorklikfeedback voor pushmeldingen naar de Adobe Experience Platform sturen.AEPOptimize
) bevat API's waarmee u realtime workflows voor personalisatie kunt inschakelen in de Adobe Experience Platform Mobile SDK's met Adobe Target of Adobe Journey Optimizer Offer decisioning. Hiervoor is AEPCore
en AEPEdge
extensies om verpersoonlijkingsquerygebeurtenissen naar het Edge-netwerk van Experience te verzenden.AEPAssurance
) om u te helpen bij het inspecteren, testen, simuleren en valideren van de manier waarop u gegevens verzamelt of ervaringen opdoet in uw mobiele app. Met deze extensie wordt uw app voor betrouwbaarheidsverklaring ingeschakeld.Extensies importeren
Navigeer in Xcode naar Luma > Luma > AppDelegate en zorg ervoor dat 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 het zelfde voor Luma > Luma > Utils > MobileSDK.
AppDelegate bijwerken
Navigeren naar Luma > Luma > AppDelegate in de Xcode-projectnavigator.
-
Vervang de
@AppStorage
valueYOUR_ENVIRONMENT_ID_GOES_HERE
forenvironmentFileId
naar de waarde voor het bestand-id van de ontwikkelomgeving die u hebt opgehaald van de tags in SDK-installatie-instructies genereren.code language-swift @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"
-
Voeg de volgende code toe aan de
application(_, didFinishLaunchingWithOptions)
functie.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 opties vindt u in het gedeelte Adobe Experience Platform Mobile SDK-documentatie.
- Start levenscycluscontrole. Zie Levenscyclus voor meer informatie.
- Hiermee stelt u de standaardtoestemming in op onbekend. Zie Toestemming voor meer informatie.
MobileCore.configureWith(appId: self.environmentFileId)
met de appId
op basis van de environmentFileId
vanuit de tagomgeving waarvoor u ontwikkelt (ontwikkelen, opvoeren of produceren).Volgende: Betrouwbaarheid instellen