В этом кратком руководстве показано, как настроить Firebase In-App Messaging и отправить свое первое сообщение.
Прежде чем начать
Прежде чем начать, обязательно добавьте Firebase в свой проект Apple .
Добавьте Firebase In-App Messaging SDK в свой проект.
Используйте Swift Package Manager для установки зависимостей Firebase и управления ими.
- В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .
- При появлении запроса добавьте репозиторий Firebase SDK для платформ Apple:
- Выберите библиотеку In-App Messaging .
- Добавьте флаг
-ObjC
в раздел «Другие флаги компоновщика» настроек сборки вашей цели. - Чтобы использовать In-App Messaging , вам необходимо включить Google Analytics в своем проекте Firebase и добавить Firebase SDK для Google Analytics в свое приложение. Вы можете выбрать библиотеку без коллекции IDFA или с коллекцией IDFA.
- По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.
https://github.com/firebase/firebase-ios-sdk.git
Теперь инициализируйте SDK в своем приложении:
- Импортируйте модуль Firebase в структуру вашего
App
илиUIApplicationDelegate
, если вы еще этого не сделали:Быстрый
import Firebase
Цель-C
@import Firebase;
- Также настройте общий экземпляр
FirebaseApp
, обычно в инициализаторе вашегоApp
или в методе applicationapplication(_:didFinishLaunchingWithOptions:)
делегата вашего приложения, если вы еще этого не сделали:Быстрый
FirebaseApp.configure()
Цель-C
[FIRApp configure];
- Скомпилируйте и запустите ваше приложение.
Отправить тестовое сообщение
Получите идентификатор установки вашего приложения
В целях экономии энергии Firebase In-App Messaging получает сообщения с сервера только один раз в день. Это может затруднить тестирование, поэтому консоль Firebase позволяет вам указать тестовое устройство, которое будет отображать сообщения по запросу.
Это тестовое устройство определяется идентификатором установки Firebase , предоставленным службой установки Firebase . Чтобы найти идентификатор установки вашего тестового приложения, запустите приложение с аргументом команды времени выполнения -FIRDebugEnabled
:
- Открыв проект Xcode, выберите «Продукт» > «Схема» > «Редактировать схему...» в верхней строке меню.
- Откройте вкладку «Аргументы» всплывающего диалогового окна.
- Нажмите + Добавить элементы в разделе «Аргументы, переданные при запуске» .
- Введите «-FIRDebugEnabled» во вновь созданное поле.
- Нажмите «Закрыть» и запустите приложение.
Как только ваше приложение запустится, найдите следующую строку в журналах консоли Xcode:
[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID
Отправьте сообщение на свое тестовое устройство
После того как вы запустили свое приложение на тестируемом устройстве и получили его идентификатор установки Firebase (FID), вы можете опробовать настройку Firebase In-App Messaging , отправив тестовое сообщение:
- В консоли Firebase откройте страницу «Сообщения» .
- Если это ваша первая кампания, нажмите «Создать первую кампанию» .
- Выберите «Сообщения в приложении Firebase» и нажмите «Создать» .
- В противном случае на вкладке «Кампании» нажмите «Новая кампания» .
- Выберите «Сообщения в приложении» .
- Введите заголовок для вашего первого сообщения.
- Нажмите «Проверить на устройстве».
- Введите идентификатор установки Firebase вашего приложения в поле «Добавить идентификатор установки» .
- Нажмите «Тест», чтобы отправить сообщение.
Firebase In-App Messaging отправляет тестовое сообщение, как только вы нажимаете «Тест» . Чтобы увидеть сообщение, вам нужно закрыть, а затем снова открыть приложение на тестовом устройстве.
Чтобы убедиться, что ваше устройство является тестовым, найдите следующее сообщение журнала:
[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.