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

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


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

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

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

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

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

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

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

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

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

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

Это тестовое устройство определяется идентификатором установки Firebase , предоставленным службой установок Firebase . Чтобы узнать идентификатор установки вашего тестового приложения, запустите приложение с аргументом команды выполнения -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 In-App Messaging , отправив тестовое сообщение:

  1. В консоли Firebase откройте страницу «Сообщения» .
  2. Если это ваша первая кампания, нажмите «Создать свою первую кампанию» .
    1. Выберите сообщения Firebase In-App и нажмите «Создать» .
  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.