Avertissement

AppboyKit (également connu sous le nom de SDK Objective-C) n’est plus pris en charge et a été remplacé par Swift SDK. Il ne recevra plus de nouvelles fonctionnalités, de corrections de bugs, de mises à jour de sécurité ou d’assistance technique - cependant, la messagerie et l’analyse continueront à fonctionner normalement. Pour en savoir plus, consultez Présentation du nouveau SDK Braze Swift.

Intégration du gestionnaire de paquets Swift

L’installation du SDK iOS via le gestionnaire de paquets Swift (SPM) automatise la majeure partie du processus d’installation. Avant de commencer, assurez-vous que vous utilisez Xcode 12 ou une version ultérieure.

Remarque

tvOS n’est pas disponible actuellement via le gestionnaire de paquets Swift.

Étape 1 : Ajouter la dépendance à votre projet

Importer la version du SDK

Ouvrez votre projet et accédez aux paramètres de votre projet. Sélectionnez l’onglet Swift Packages et cliquez sur le bouton d’ajout sous la liste des paquets.

Lors de l’importation de la version 3.33.1 ou ultérieure du SDK, saisissez l’URL de notre dépôt SDK iOS (https://github.com/braze-inc/braze-ios-sdk) dans le champ de texte et cliquez sur Next.

Pour les versions 3.29.0 à 3.32.0, utilisez l’URL https://github.com/Appboy/Appboy-ios-sdk.

Sur l’écran suivant, sélectionnez la version du SDK et cliquez sur Next. Les versions 3.29.0 et ultérieures sont compatibles avec le gestionnaire de paquets Swift.

Sélectionner les paquets

Sélectionnez le paquet qui correspond le mieux à vos besoins et cliquez sur Finish. Assurez-vous de sélectionner soit AppboyKit, soit AppboyUI. Inclure les deux paquets peut entraîner un comportement indésirable :

• AppboyUI
  • Convient mieux si vous prévoyez d’utiliser des composants d’interface utilisateur fournis par Braze.
  • Inclut automatiquement AppboyKit.
• AppboyKit
  • Convient mieux si vous n’avez pas besoin d’utiliser les composants d’interface utilisateur fournis par Braze (par exemple, Content Cards, messages in-app, etc.).
• AppboyPushStory
  • Incluez ce paquet si vous avez intégré Push Stories dans votre application. Cela est pris en charge à partir de la version 3.31.0.
  • Dans le menu déroulant sous Add to Target, sélectionnez votre cible ContentExtension plutôt que la cible de votre application principale.

Étape 2 : Configurer votre projet

Ensuite, accédez aux paramètres de build de votre projet et ajoutez l’indicateur -ObjC au paramètre Other Linker Flags. Cet indicateur doit être ajouté et toutes les erreurs résolues pour pouvoir poursuivre l’intégration du SDK.

Remarque

Si vous n’ajoutez pas l’indicateur -ObjC, certaines parties de l’API pourront manquer et le comportement sera indéfini. Vous pourriez rencontrer des erreurs inattendues telles qu’un « sélecteur non reconnu envoyé à la classe », des plantages de l’application et d’autres problèmes.

Étape 3 : Modifier le schéma de la cible

Important

Si vous utilisez Xcode 12.5 ou une version plus récente, ignorez cette étape.

Si vous utilisez Xcode 12.4 ou une version antérieure, modifiez le schéma de la cible incluant le paquet Appboy (élément de menu Product > Scheme > Edit Scheme) :

1. Développez le menu Build et sélectionnez Post-actions. Appuyez sur le bouton plus (+) et sélectionnez New Run Script Action.
2. Dans le menu déroulant Provide build settings from, sélectionnez la cible de votre application.
3. Copiez ce script dans le champ ouvert :

   1
   2
   3
   4
   # iOS
   bash "$BUILT_PRODUCTS_DIR/Appboy_iOS_SDK_AppboyKit.bundle/Appboy.bundle/appboy-spm-cleanup.sh"
   # macOS (if applicable)
   bash "$BUILT_PRODUCTS_DIR/Appboy_iOS_SDK_AppboyKit.bundle/Contents/Resources/Appboy.bundle/appboy-spm-cleanup.sh"
   

Étapes suivantes

Suivez les instructions pour terminer l’intégration.