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

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

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

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

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

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

1. В Xcode откройте проект приложения и перейдите в Файл > Добавить пакеты .
2. При появлении запроса добавьте репозиторий Firebase Apple Platforms SDK:

  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 или с его сбором. См. раздел часто задаваемых вопросов о текущей организации модулей в Google Analytics для Firebase SDK .
6. После завершения Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

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

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

   Быстрый

   import Firebase

   Objective-C

   @import Firebase;

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

   Быстрый

   FirebaseApp.configure()

   Objective-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 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.