Начните работу с обменом сообщениями внутри приложений Firebase

В этом кратком руководстве показано, как настроить Firebase In-App Messaging и отправить первое сообщение.


Прежде чем начать

Установите и инициализируйте SDK Firebase для Flutter, если вы еще этого не сделали.

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

  1. Для установки плагина Firebase In-App Messaging выполните следующую команду в корневом каталоге вашего Flutter-проекта:

    flutter pub add firebase_in_app_messaging

  2. Перестройте свой проект:

    flutter run

  3. Импортируйте плагин Firebase In-App Messaging:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';

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

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

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

Устройство тестирования определяется по идентификатору FID. Найти идентификатор FID вашего тестового приложения можно, проверив вывод консоли при запуске приложения.

На Android это сообщение выглядит следующим образом:

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

На iOS запустите приложение с аргументом команды выполнения -FIRDebugEnabled :

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

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

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

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

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

  1. В консоли Firebase откройте раздел «Сообщения» .
  2. Если это ваша первая кампания, нажмите «Создать свою первую кампанию» .
    1. Выберите сообщения Firebase In-App и нажмите «Создать» .
  3. В противном случае, на вкладке «Кампании» нажмите «Новая кампания» .
    1. Выберите «Сообщения в приложении» .
  4. Введите заголовок для вашего первого сообщения.
  5. Нажмите «Тест» на вашем устройстве.
  6. Введите идентификатор установки вашего приложения в Firebase в поле «Добавить идентификатор установки» .
  7. Нажмите «Тест» , чтобы отправить сообщение.

Функция Firebase In-App Messaging отправляет тестовое сообщение сразу после нажатия кнопки «Тест» . Чтобы увидеть сообщение, необходимо закрыть, а затем снова открыть приложение на тестовом устройстве.

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

Android

I/FIAM.Headless: Setting this device as a test device

iOS

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