Начать работу с Firebase In-App Messaging

В этом кратком руководстве показано, как настроить обмен сообщениями в приложении Firebase и отправить первое сообщение.

Прежде чем вы начнете

Прежде чем вы начнете, вам нужно настроить в своей среде несколько вещей:

• Приложение с включенным Firebase: добавьте Firebase в свой проект iOS, если вы еще этого не сделали.
• Xcode 12.2 или выше: для работы Firebase In-App Messaging требуется относительно последняя версия Xcode. Вы можете найти последнюю версию Xcode на сайте Apple Xcode .
• CocoaPods 1.4.0 или выше: Firebase In-App Messaging использует CocoaPods для управления зависимостями в iOS. Вы можете установить его с сайта CocoaPods .

Добавьте в проект Firebase In-App Messaging SDK.

Для начала добавьте файлы фреймворка Firebase In-App Messaging SDK в свой проект, добавив Firebase In-App Messaging CocoaPods:

1. Откройте новое окно терминала и перейдите в каталог вашего проекта Xcode.
2. Откройте свой Podfile и добавьте выделенные строки:

   # 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. Из вашего терминала установите зависимости модуля:

   pod install

4. Откройте проект вашего приложения в Xcode:

   open YOUR-PROJECT.xcworkspace

5. Импортируйте модуль Firebase в свой UIApplicationDelegate , если вы еще этого не сделали:

   Быстрый

   import Firebase

   Цель-C

   @import Firebase;

6. Также настройте общий экземпляр FirebaseApp , обычно в методе application:didFinishLaunchingWithOptions: вашего приложения, если вы еще этого не сделали:

   Быстрый

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Цель-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

7. Скомпилируйте и запустите ваше приложение.

Отправить тестовое сообщение

Получите идентификатор установки вашего приложения

Для экономии энергии Firebase In-App Messaging получает сообщения с сервера только один раз в день. Это может затруднить тестирование, поэтому консоль Firebase позволяет указать тестовое устройство, которое отображает сообщения по запросу.

Это тестовое устройство определяется идентификатором установки Firebase, предоставленным службой установки Firebase. Чтобы узнать идентификатор установки вашего тестового приложения, запустите приложение с аргументом команды времени выполнения -FIRDebugEnabled :

1. В открытом проекте Xcode выберите Продукт> Схема> Изменить схему ... в верхней строке меню.
2. Откройте вкладку « Аргументы » в появившемся диалоговом окне.
3. Нажмите + Добавить элементы в разделе « Аргументы, переданные при запуске» .
4. Введите "-FIRDebugEnabled" во вновь созданное поле.
5. Нажмите « Закрыть» , затем запустите приложение.

После запуска вашего приложения найдите следующую строку в журналах консоли Xcode:

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

Отправьте сообщение на свое тестовое устройство

После того, как вы запустили свое приложение на тестовом устройстве и у вас есть его установочный идентификатор Firebase (FID), вы можете опробовать настройку Firebase In-App Messaging, отправив тестовое сообщение:

1. В консоли Firebase откройте In-App Messaging .
2. Щелкните Новая кампания .
3. Введите заголовок для вашего первого сообщения.
4. Нажмите Test на вашем устройстве
5. Введите идентификатор установки Firebase вашего приложения в поле Добавить идентификатор установки .
6. Щелкните Test, чтобы отправить сообщение.

Firebase In-App Messaging отправляет ваше тестовое сообщение, как только вы нажимаете Test . Чтобы увидеть сообщение, вам нужно закрыть, а затем снова открыть приложение на тестовом устройстве.

Чтобы убедиться, что ваше устройство является тестовым, найдите в журнале следующее сообщение:

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