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

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

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

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

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

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

В Xcode, открыв проект приложения, перейдите в меню File > Add Packages .
При появлении запроса добавьте репозиторий Firebase Apple Platforms SDK:

  https://github.com/firebase/firebase-ios-sdk.git

Выберите библиотеку In-App Messaging .
Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» в настройках сборки вашей целевой системы.
Для использования In-App Messaging необходимо включить Google Analytics в вашем проекте Firebase и добавить Firebase SDK для Google Analytics в ваше приложение. Вы можете выбрать библиотеку без сбора данных IDFA или с сбором данных IDFA. См. раздел часто задаваемых вопросов (FAQ) о последней организации модулей в Google Analytics для Firebase SDK .
После завершения Xcode автоматически начнет разрешение и загрузку ваших зависимостей в фоновом режиме.

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

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

Примечание: Для Firebase In-App Messaging требуется Firebase версии 5.6.0 или выше. Если у вас возникли проблемы с компиляцией приложения, попробуйте выполнить команду pod update в каталоге проекта вашего приложения. Однако имейте в виду, что эта команда обновляет все зависимости вашего приложения, а не только зависимости Firebase.

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

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

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

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

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

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

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

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

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

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

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

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

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