Installare Adobe Experience Platform Mobile SDK tutorial_install_mobile_sdks

Gestione pacchetti Swift

Invece di utilizzare i CocoaPods e un file Pod (come descritto in Generare istruzioni di installazione di SDK), puoi aggiungere singoli pacchetti utilizzando il gestore di pacchetti Swift nativo di Xcode. Nel progetto Xcode sono già state aggiunte tutte le dipendenze dei pacchetti. La schermata Dipendenze pacchetto di Xcode deve essere simile alla seguente:

{modal="regular"}

In Xcode puoi utilizzare File > Aggiungi pacchetti… per aggiungere pacchetti. La tabella seguente fornisce i collegamenti agli URL da utilizzare per aggiungere pacchetti. I collegamenti ti indirizzano anche a ulteriori informazioni su ciascun pacchetto specifico.

Importare estensioni

Apri in Xcode il progetto nella cartella Start dell'app di esempio.

In Xcode, passa a Luma > Luma > AppDelegate e assicurati che le seguenti importazioni facciano parte di questo file di origine.

// 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

Effettua le stesse operazioni per Luma > Luma > Utils > MobileSDK.

Aggiorna AppDelegate

Passa a Luma > Luma > AppDelegate nel Navigatore progetti Xcode.

1. Sostituire il valore @AppStorage di YOUR_ENVIRONMENT_ID_GOES_HERE per environmentFileId con il valore ID file di ambiente recuperato dai tag nelle istruzioni per l'installazione di SDK.

   code language-swift
   @AppStorage("environmentFileId") private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

2. Aggiungere il codice seguente alla funzione 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) })

Il codice di cui sopra esegue le seguenti operazioni:

1. Registra le estensioni richieste.
2. Configura MobileCore e altre estensioni per utilizzare la configurazione della proprietà tag.
3. Abilita la registrazione di debug. Ulteriori dettagli e opzioni sono disponibili nella documentazione di Adobe Experience Platform Mobile SDK.
4. Avvia il monitoraggio del ciclo di vita. Per ulteriori dettagli, vedi il passaggio Ciclo di vita nell'esercitazione.
5. Imposta il consenso predefinito su sconosciuto. Consulta il passaggio Consenso nell'esercitazione per ulteriori dettagli.

Assicurati di aggiornare MobileCore.configureWith(appId: self.environmentFileId) con appId in base a environmentFileId dall'ambiente di tag che stai creando per (sviluppo, staging o produzione).

Gradle

Le dipendenze vengono utilizzate dalle istruzioni di installazione di Generate SDK per aggiungere singoli pacchetti mediante l'integrazione di Gradle con Android Studio. Il progetto Android Studio presenta già tutte le dipendenze dei pacchetti aggiunte automaticamente.

1. Selezionare come strumento.

2. Seleziona la visualizzazione Android.

3. Seleziona Script Gradle > build.gradle.kts (Modulo :app) dal riquadro a sinistra. Quindi, nel riquadro di destra, scorrere fino a visualizzare dependencies.

   {modal="regular"}

In Android Studio è possibile utilizzare File > Struttura di progetto… per aggiungere dipendenze del modulo. Seleziona Dipendenze, quindi utilizza Moduli per aggiungere moduli. La tabella seguente fornisce collegamenti agli URL da utilizzare per aggiungere moduli di dipendenza. I collegamenti ti indirizzano anche a ulteriori informazioni su ciascun modulo specifico.

Importare estensioni

In Android Studio, passa a app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication e assicurati che le seguenti importazioni facciano parte del file di origine.

import com.adobe.marketing.mobile.Assurance
import com.adobe.marketing.mobile.Edge
import com.adobe.marketing.mobile.Lifecycle
import com.adobe.marketing.mobile.LoggingMode
import com.adobe.marketing.mobile.Messaging
import com.adobe.marketing.mobile.MobileCore
import com.adobe.marketing.mobile.MobilePrivacyStatus
import com.adobe.marketing.mobile.Places
import com.adobe.marketing.mobile.Signal
import com.adobe.marketing.mobile.UserProfile
import com.adobe.marketing.mobile.edge.consent.Consent
import com.adobe.marketing.mobile.edge.identity.Identity
import com.adobe.marketing.mobile.optimize.Optimize

Fai lo stesso per app > kotlin+java > com.adobe.luma.tutorial.android > modelli > MobileSDK.

Aggiorna applicazione Luma

Nella visualizzazione Android, passa a app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication in Android Studio.

1. Sostituisci "YOUR_ENVIRONMENT_FILE_ID" in private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" con il valore ID file di ambiente recuperato dai tag in Genera istruzioni di installazione di SDK.

   code language-kotlin
   private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

2. Aggiungere il codice seguente alla funzione override fun onCreate() in class LumaApplication : Application().

   code language-kotlin

   // Define extensions val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION ) // Register extensions MobileCore.registerExtensions(extensions) { // Use the environment file id assigned to this application via Adobe Experience Platform Data Collection Log.i("Luma", "Using mobile config: $environmentFileId") MobileCore.configureWithAppID(environmentFileId) // set this to true when testing on your device, default is false. //MobileCore.updateConfiguration(mapOf("messaging.useSandbox" to true)) // assume unknown, adapt to your needs. MobileCore.setPrivacyStatus(MobilePrivacyStatus.UNKNOWN) }

   Il codice di cui sopra esegue le seguenti operazioni:

   1. Registra le estensioni richieste.
   2. Configura MobileCore e altre estensioni per utilizzare la configurazione della proprietà tag.
   3. Abilita la registrazione di debug. Ulteriori dettagli e opzioni sono disponibili nella documentazione di Adobe Experience Platform Mobile SDK.
   4. Avvia il monitoraggio del ciclo di vita. Per ulteriori dettagli, vedi il passaggio Ciclo di vita nell'esercitazione.
   5. Imposta il consenso predefinito su sconosciuto. Consulta il passaggio Consenso nell'esercitazione per ulteriori dettagli.

Assicurati di aggiornare MobileCore.configureWith(environmentFileId) con environmentFileId in base all'ID file di ambiente dall'ambiente di tag che stai creando per (sviluppo, staging o produzione).