Skip to content


Intégration manuelle

Étape 1 : Téléchargement du SDK Braze

Option 1 : XCFramework dynamique

  1. Téléchargez Appboy_iOS_SDK.xcframework.zip depuis la page de publication et extrayez le fichier.
  2. Dans Xcode, faites glisser et déposez .xcframework dans votre projet.
  3. Sous l’onglet Général du projet, sélectionnez **Intégrer le signe & ** pour Appboy_iOS_SDK.xcframework.

Option 2 : XCFramework statique pour l’intégration statique

  1. Téléchargez Appboy_iOS_SDK.zip à partir de la page de version.

  2. Dans Xcode, à partir du navigateur de projet, sélectionnez le projet ou le groupe de destination pour Braze

  3. Naviguez vers Fichier > Ajouter des fichiers > Project_Name.

  4. Ajoutez les dossiers AppboyKit et AppboyUI de votre projet en tant que groupe.
    • Assurez-vous que l’option Copier les éléments dans le dossier du groupe de destination est sélectionnée si vous effectuez l’intégration pour la première fois. Développez Options dans le sélecteur de fichiers pour sélectionner Copier les éléments si nécessaire et Créer des groupes.
    • Supprimer les répertoires AppboyKit/include et AppboyUI/include.

  5. (Facultatif) Si l’un des éléments suivants s’applique à vous :
    • Vous souhaitez uniquement bénéficier des fonctionnalités d’analyse de base du SDK et n’utilisez aucune fonctionnalité de l’interface utilisateur (par exemple, les messages in-app ou les cartes de contenu).
    • Vous disposez d’une interface utilisateur personnalisée pour les fonctionnalités de Braze UI et gérez vous-même le téléchargement des images.

      Vous pouvez utiliser la version principale du SDK en supprimant le fichier ABKSDWebImageProxy.m et Appboy.bundle. Cela supprimera la dépendance du framework SDWebImage et toutes les ressources liées à l’interface utilisateur (par exemple, les fichiers Nib, les images, les fichiers de localisation) du SDK.

Étape 2 : Ajouter les bibliothèques iOS requises

  1. Cliquez sur la cible de votre projet (en utilisant la navigation de gauche), et sélectionnez l’onglet Phases de création.

  2. Cliquez sur le bouton sous Lien binaire avec les bibliothèques.

  3. Dans le menu, sélectionnez SystemConfiguration.framework.

  4. Marquez cette bibliothèque comme requise à l’aide du menu déroulant à côté de SystemConfiguration.framework.

  5. Répétez l’opération pour ajouter chacun des frameworks suivants à votre projet, en les marquant comme « requis ».
    • QuartzCore.framework
    • libz.tbd
    • CoreImage.framework
    • CoreText.framework
    • WebKit.framework

  6. Ajoutez les infrastructures suivantes et marquez-les comme facultatif :
    • CoreTelephony.framework

  7. Sélectionnez l’onglet Build Settings (Paramètres de création). Dans la section Liaison, localisez le paramètre Autres indicateurs de lien et ajoutez l’indicateur -ObjC.

  8. Le cadre SDWebImage est nécessaire pour les cartes de contenu et les messages in-app pour fonctionner correctement. SDWebImage est utilisé pour télécharger et afficher l’image, y compris les GIF. Si vous avez l’intention d’utiliser les cartes de contenu ou les messages in-app, suivez les étapes d’intégration SDWebImage.

Intégration de SDWebImage

Pour installer SDWebImage, suivez les instructions, puis faites glisser et déposez le XCFramework créé dans votre projet.

Suivi facultatif de la localisation

  1. Ajouter le CoreLocation.framework pour activer le suivi de la localisation.
  2. Vous devez autoriser la localisation de vos utilisateurs à l’aide de CLLocationManager dans votre application.

Étape 3 : Objective-C bridging header

Si votre projet utilise Swift, vous aurez besoin d’un fichier d’en-tête de pont.

Si vous n’avez pas de fichier d’en-tête de pontage, créez-en un et nommez-le your-product-module-name-Bridging-Header.h en choisissant Fichier > Nouveau > Fichier > (iOS ou OS X) > Source > Fichier d’en-tête. Ajoutez ensuite la ligne de code suivante au haut de votre fichier d’en-tête de pont :

1

#import "AppboyKit.h"

Dans les paramètres de création de votre projet, ajoutez le chemin relatif de votre fichier d’en-tête au paramètre de création Objective-C Bridging Header sous Swift Compiler - Code Generation.

Étapes suivantes

Suivez les instructions pour terminer l’intégration.
New Stuff!