Adobe Experience Platform Mobile SDK's installeren

Leer hoe u de Adobe Experience Platform Mobile SDK in een mobiele app implementeert.

Vereisten

Leerdoelstellingen

In deze les zult u:

  • Werk het CocoaPod-bestand bij.
  • Importeer de vereiste SDK's.
  • Registreer de extensies.
OPMERKING

In een mobiele app-implementatie zijn de termen "extensies" en "SDK's" bijna uitwisselbaar.

PodFile bijwerken

OPMERKING

Als u niet bekend bent met CocoaPods, raadpleeg dan de officiële gids Aan de slag.

Installeren is doorgaans een eenvoudige sudo-opdracht:

sudo gem install cocoapods

Als u CocoaPods hebt geïnstalleerd, opent u het Podfile.

eerste podbestand

Werk het bestand bij en voeg de volgende pods toe:

pod 'AEPCore', '~> 3'
pod 'AEPEdge', '~> 1'
pod 'AEPUserProfile', '~> 3'
pod 'AEPAssurance', '~> 3'
pod 'AEPServices', '~> 3'
pod 'AEPEdgeConsent', '~> 1'
pod 'AEPLifecycle', '~>3'
pod 'AEPMessaging', '~>1'
pod 'AEPEdgeIdentity', '~>1'
pod 'AEPSignal', '~>3'
OPMERKING

AEPMessaging is alleen vereist als u pushberichten wilt implementeren met Adobe Journey Optimizer. Lees de zelfstudie op pushberichten implementeren met Adobe Journey Optimizer voor meer informatie .

Nadat u de wijzigingen in het Podfile hebt opgeslagen, navigeert u samen met uw project naar de map en voert u de opdracht pod install om uw wijzigingen te installeren.

pod installeren

OPMERKING

Als u "Geen Podfile gevonden in de projectfolder krijgt." fout, is uw terminal in de verkeerde omslag. Navigeer naar de map met het Podfile dat u hebt bijgewerkt en probeer het opnieuw.

Als u wilt upgraden naar de nieuwste versie, voert u de opdracht pod update gebruiken.

INFO

Als u CocoaPods niet kunt gebruiken in uw eigen toepassingen, kunt u meer informatie over andere toepassingen ondersteunde implementaties in het GitHub-project.

CocoaPods maken

Om CocoaPods te bouwen, open Luma.xcworkspaceen selecteert u Product, gevolgd door Opbouwmap opschonen.

OPMERKING

U moet mogelijk instellen Alleen actieve architectuur maken tot Nee. Om dit te doen, selecteer het project van Pods van de projectnavigator, uitgezocht Instellingen samenstellen en stelt de Actieve architectuur maken tot Nee.

U kunt het project nu bouwen en in werking stellen.

build-instellingen

OPMERKING

Het Luma-project is gemaakt met Xcode v12.5 op een M1-chipset en wordt uitgevoerd op de iOS-simulator. Als u een verschillende opstelling gebruikt, kunt u uw bouwstijlmontages moeten veranderen om op uw architectuur te wijzen.

Als uw build niet is gelukt, probeert u de Actieve architectuur maken > Foutopsporing instellen op Ja.

Simulatorconfiguratie "iPod touch (7e generatie)" werd gebruikt tijdens het ontwerpen van deze zelfstudie.

Extensies importeren

In elk van de .swift voegt u de volgende importbewerkingen toe. Starten door aan toe te voegen AppDelegate.swift.

import AEPUserProfile
import AEPAssurance
import AEPEdge
import AEPCore
import AEPEdgeIdentity
import AEPEdgeConsent
import AEPLifecycle
import AEPMessaging //Optional, used for AJO push messaging
import AEPSignal
import AEPServices

AppDelegate bijwerken

In de AppDelegate.swift bestand, voeg de volgende code toe aan didFinishLaunchingWithOptions. Vervang currentAppId door de waarde voor het bestand-id van de ontwikkelomgeving die u hebt opgehaald van de tags in het dialoogvenster vorige les.

let currentAppId = "b5cbd1a1220e/bae66382cce8/launch-88492c6dcb6e-development"

let extensions = [Edge.self, Assurance.self, Lifecycle.self, UserProfile.self, Consent.self, AEPEdgeIdentity.Identity.self, Messaging.self]

MobileCore.setLogLevel(.trace)

MobileCore.registerExtensions(extensions, {
    MobileCore.configureWith(appId: currentAppId)
})

Messaging.self is alleen vereist als u pushberichten via Adobe Journey Optimizer wilt implementeren zoals beschreven hier.

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 Mobiele SDK-documentatie.
BELANGRIJK

In een productie-app moet u van appId wisselen op basis van de huidige omgeving (dev/stag/prod).

Volgende: Betrouwbaarheid instellen

OPMERKING

Bedankt dat u tijd hebt geïnvesteerd in het leren van Adobe Experience Platform Mobile SDK. Als u vragen hebt, algemene feedback wilt delen of suggesties voor toekomstige inhoud hebt, kunt u deze delen over deze Experience League Communautaire discussiestuk

Op deze pagina