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

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

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

Прежде чем начать, обязательно добавьте Firebase в свой проект Apple .

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

Используйте Swift Package Manager для установки зависимостей Firebase и управления ими.

  1. В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .
  2. При появлении запроса добавьте репозиторий Firebase SDK для платформ Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Выберите библиотеку сообщений в приложении.
  5. Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» настроек сборки вашей цели.
  6. Чтобы использовать обмен сообщениями в приложении, вам необходимо включить Google Analytics в своем проекте Firebase и добавить Firebase SDK для Google Analytics в свое приложение. Вы можете выбрать библиотеку без коллекции IDFA или с коллекцией IDFA.
  7. По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Теперь инициализируйте SDK в своем приложении:

  1. Импортируйте модуль Firebase в структуру вашего App или UIApplicationDelegate , если вы еще этого не сделали:
    Быстрый
    import Firebase
    Цель-C
    @import Firebase;
  2. Также настройте общий экземпляр FirebaseApp , обычно в инициализаторе вашего App или application(_:didFinishLaunchingWithOptions:) делегата вашего приложения, если вы еще этого не сделали:
    Быстрый
    FirebaseApp.configure()
    Цель-C
    [FIRApp configure];
  3. Скомпилируйте и запустите ваше приложение.

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

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

В целях экономии энергии 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_INSTALLATION_ID

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

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

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

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

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

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