Прежде чем вы начнете
Прежде чем вы начнете, вам нужно настроить в своей среде несколько вещей:
- Приложение с включенным Firebase: добавьте Firebase в свой проект iOS, если вы еще этого не сделали.
- Xcode 12.2 или выше: для работы Firebase In-App Messaging требуется относительно последняя версия Xcode. Вы можете найти последнюю версию Xcode на сайте Apple Xcode .
- CocoaPods 1.4.0 или выше: Firebase In-App Messaging использует CocoaPods для управления зависимостями в iOS. Вы можете установить его с сайта CocoaPods .
Добавьте в проект Firebase In-App Messaging SDK.
Для начала добавьте файлы фреймворка Firebase In-App Messaging SDK в свой проект, добавив Firebase In-App Messaging CocoaPods:
- Откройте новое окно терминала и перейдите в каталог вашего проекта Xcode.
- Откройте свой Podfile и добавьте выделенные строки:
# Uncomment the next line to define a global platform for your project # platform :ios, '9.0' target 'YourProject' do # Comment the next line if you're not using Swift and don't want to use dynamic frameworks use_frameworks! # Pods for YourProject pod 'Firebase' pod 'Firebase/InAppMessaging' pod 'Firebase/Analytics' end
- Из вашего терминала установите зависимости модуля:
pod install
- Откройте проект вашего приложения в Xcode:
open YOUR-PROJECT.xcworkspace
- Импортируйте модуль Firebase в свой
UIApplicationDelegate
, если вы еще этого не сделали:Быстрый
import Firebase
Цель-C
@import Firebase;
- Также настройте общий экземпляр
FirebaseApp
, обычно в методеapplication:didFinishLaunchingWithOptions:
вашего приложения, если вы еще этого не сделали:Быстрый
// Use Firebase library to configure APIs FirebaseApp.configure()
Цель-C
// Use Firebase library to configure APIs [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_APP_ID
Отправьте сообщение на свое тестовое устройство
После того, как вы запустили свое приложение на тестовом устройстве и у вас есть его установочный идентификатор Firebase (FID), вы можете опробовать настройку Firebase In-App Messaging, отправив тестовое сообщение:
- В консоли Firebase откройте In-App Messaging .
- Щелкните Новая кампания .
- Введите заголовок для вашего первого сообщения.
- Нажмите Test на вашем устройстве
- Введите идентификатор установки Firebase вашего приложения в поле Добавить идентификатор установки .
- Щелкните Test, чтобы отправить сообщение.
Firebase In-App Messaging отправляет ваше тестовое сообщение, как только вы нажимаете Test . Чтобы увидеть сообщение, вам нужно закрыть, а затем снова открыть приложение на тестовом устройстве.
Чтобы убедиться, что ваше устройство является тестовым, найдите в журнале следующее сообщение:
[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.