Installation des SDK mobiles Adobe Experience Platform tutorial_install_mobile_sdks

Gestionnaire de packages Swift

Au lieu d’utiliser des CocoaPods et un fichier Pod (comme indiqué dans Instructions d’installation de Generate SDK), vous pouvez ajouter des packages individuels à l’aide du gestionnaire de packages Swift natif de Xcode. Toutes les dépendances de packages ont déjà été ajoutées pour vous dans le projet Xcode. L’écran Xcode Dépendances de packages doit se présenter comme suit :

{modal="regular"}

Dans Xcode, vous pouvez utiliser Fichier > Ajouter des packages… pour ajouter des packages. Le tableau ci-dessous fournit des liens vers les URL que vous pouvez utiliser pour ajouter des packages. Les liens vous redirigent également vers des informations supplémentaires sur chaque package spécifique.

Importer des extensions

Ouvrez dans Xcode le projet dans le dossier Start de l’exemple d’application.

Dans Xcode, accédez à Luma > Luma > AppDelegate et assurez-vous que les importations suivantes font partie de ce fichier source.

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

Faites de même pour Luma > Luma > Utils > MobileSDK.

Mettre à jour AppDelegate

Accédez à Luma > Luma > AppDelegate dans le navigateur de projet Xcode.

1. Remplacez la valeur @AppStorage YOUR_ENVIRONMENT_ID_GOES_HERE pour environmentFileId par la valeur de l’identifiant du fichier d’environnement que vous avez récupérée à partir des balises dans Instructions d’installation de Generate SDK.

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

2. Ajoutez le code suivant à la fonction 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) })

Le code ci-dessus effectue les opérations suivantes :

1. Enregistre les extensions requises.
2. Configure MobileCore et d’autres extensions pour utiliser la configuration de propriété de balise.
3. Active la journalisation du débogage. Vous trouverez plus d’informations et d’options dans la documentation de Adobe Experience Platform Mobile SDK 🔗.
4. Démarre la surveillance du cycle de vie. Voir l’étape Cycle de vie du tutoriel pour plus d’informations.
5. Définit le consentement par défaut sur inconnu. Voir l’étape Consentement du tutoriel pour plus d’informations.

Veillez à mettre à jour les MobileCore.configureWith(appId: self.environmentFileId) avec le appId en fonction des environmentFileId de l’environnement de balises pour lequel vous créez des ressources (développement, évaluation ou production).

Gradle

Utilisez les dépendances des instructions d’installation Generate SDK pour ajouter des packages individuels à l’aide de l’intégration de Gradle à Android Studio. Le projet Android Studio comporte déjà toutes les dépendances de packages ajoutées pour vous.

1. Sélectionnez comme outil.

2. Sélectionnez la vue Android.

3. Sélectionnez Scripts Gradle > build.gradle.kts (Module :app) dans le volet gauche. Ensuite, dans le volet de droite, faites défiler l’écran jusqu’à ce que dependencies s’affiche.

   {modal="regular"}

Dans Android Studio, vous pouvez utiliser Fichier > Structure de projet… pour ajouter des dépendances de module. Sélectionnez Dépendances puis utilisez Modules pour ajouter des modules. Le tableau ci-dessous fournit des liens vers les URL que vous pouvez utiliser pour ajouter des modules de dépendance. Les liens vous redirigent également vers des informations supplémentaires sur chaque module spécifique.

Importer des extensions

Dans Android Studio, accédez à app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication et assurez-vous que les imports ci-dessous font partie du fichier source.

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

Faites de même pour app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK.

Mettre à jour l’application Luma

Dans la vue Android, accédez à app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication dans Android Studio.

1. Remplacez "YOUR_ENVIRONMENT_FILE_ID" dans private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE" par la valeur de l’identifiant du fichier d’environnement que vous avez récupérée à partir des balises dans Générer les instructions d’installation de SDK.

   code language-kotlin
   private var environmentFileId = "YOUR_ENVIRONMENT_ID_GOES_HERE"

2. Ajoutez le code suivant à override fun onCreate() fonction dans 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) }

   Le code ci-dessus effectue les opérations suivantes :

   1. Enregistre les extensions requises.
   2. Configure MobileCore et d’autres extensions pour utiliser la configuration de propriété de balise.
   3. Active la journalisation du débogage. Vous trouverez plus d’informations et d’options dans la documentation de Adobe Experience Platform Mobile SDK 🔗.
   4. Démarre la surveillance du cycle de vie. Voir l’étape Cycle de vie du tutoriel pour plus d’informations.
   5. Définit le consentement par défaut sur inconnu. Voir l’étape Consentement du tutoriel pour plus d’informations.

Veillez à mettre à jour MobileCore.configureWith(environmentFileId) avec le environmentFileId en fonction de l’identifiant de fichier d’environnement de l’environnement de balises pour lequel vous créez des balises (développement, évaluation ou production).