Cette page a été traduite par l'API Cloud Translation.
Switch to English

Premiers pas avec la messagerie intégrée Firebase

Ce guide de démarrage rapide vous montre comment configurer la messagerie Firebase In-App et envoyer votre premier message.

Avant que tu commences

Avant de commencer, vous devez configurer quelques éléments dans votre environnement:

  • Une application avec Firebase activé: si vous ne l'avez pas déjà fait, ajoutez Firebase à votre projet iOS .
  • Xcode 11.0 ou version ultérieure: Firebase In-App Messaging nécessite une version relativement récente de Xcode pour fonctionner. Vous pouvez trouver la dernière version de Xcode sur le site Xcode d'Apple .
  • CocoaPods 1.4.0 ou supérieur: Firebase In-App Messaging utilise CocoaPods pour gérer les dépendances sur iOS. Vous pouvez l'installer à partir du site CocoaPods .

Ajouter le SDK Firebase In-App Messaging à votre projet

Pour commencer, ajoutez les fichiers de structure du SDK Firebase In-App Messaging à votre projet en ajoutant les CocoaPods Firebase In-App Messaging:

  1. Ouvrez une nouvelle fenêtre de terminal et accédez au répertoire de votre projet Xcode.
  2. Ouvrez votre Podfile et ajoutez les lignes en surbrillance:
    # Uncomment the next line to define a global platform for your project
    # platform :ios, '9.0'
    
    target 'YourProject' do
    # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
    use_frameworks!
    
    # Pods for YourProject
    pod 'Firebase'
    pod 'Firebase/InAppMessaging'
    pod 'Firebase/Analytics'
    end
  3. Depuis votre terminal, installez les dépendances du pod:
    pod install
  4. Ouvrez le projet de votre application dans Xcode:
    open YOUR-PROJECT.xcworkspace
  5. Importez le module Firebase dans votre UIApplicationDelegate , si vous ne l'avez pas encore fait:
    Rapide
    import Firebase
    Objectif c
    @import Firebase;
  6. Configurez également une instance partagée FirebaseApp , généralement dans l'application de votre application:didFinishLaunchingWithOptions: method, si vous ne l'avez pas encore fait:
    Rapide
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    Objectif c
    // Use Firebase library to configure APIs
    [FIRApp configure];
  7. Compilez et exécutez votre application.

Envoyer un message de test

Obtenez l'ID d'installation de votre application

Pour économiser l'énergie, Firebase In-App Messaging ne récupère les messages du serveur qu'une fois par jour. Cela peut rendre les tests difficiles, la console Firebase vous permet donc de spécifier un périphérique de test qui affiche les messages à la demande.

Ce périphérique de test est déterminé par un ID d'installation Firebase fourni par le service d'installation Firebase. Pour trouver l'ID d'installation de votre application de test, exécutez l'application avec l'argument de commande d'exécution -FIRDebugEnabled :

  1. Une fois votre projet Xcode ouvert, sélectionnez Produit> Schéma> Modifier le schéma ... dans la barre de menu supérieure.
  2. Ouvrez l'onglet Arguments de la boîte de dialogue qui apparaît.
  3. Cliquez sur + Ajouter des éléments sous Arguments transmis au lancement .
  4. Entrez "-FIRDebugEnabled" dans le champ nouvellement créé.
  5. Cliquez sur Fermer , puis exécutez votre application.

Une fois que votre application démarre, recherchez la ligne suivante dans les journaux de la console Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_APP_ID

Envoyez un message à votre appareil de test

Une fois que vous avez lancé votre application sur l'appareil de test et que vous avez son ID d'installation Firebase (FID), vous pouvez essayer la configuration de la messagerie Firebase In-App en envoyant un message de test:

  1. Dans la console Firebase, ouvrez la messagerie intégrée à l'application .
  2. Une fois là-bas, cliquez sur Nouvelle campagne .
  3. Entrez un titre pour votre premier message.
  4. Cliquez sur Test sur votre appareil
  5. Saisissez l'ID d'installation Firebase de votre application dans le champ Ajouter un ID d'installation .
  6. Cliquez sur Test pour envoyer le message.

Firebase In-App Messaging envoie votre message de test dès que vous cliquez sur Test . Pour le voir, fermez, puis rouvrez l'application sur votre appareil de test.

Pour vérifier si votre appareil est un appareil de test, recherchez le message de journal suivant:

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.