Pierwsze kroki z wysyłaniem wiadomości w aplikacji za pomocą Firebase

Z tego krótkiego przewodnika dowiesz się, jak skonfigurować Firebase In-App Messaging i wysłać pierwszą wiadomość.


Zanim zaczniesz

Zanim zaczniesz, dodaj Firebase do swojego projektu Apple.

Dodawanie pakietu SDK Firebase In-App Messaging do projektu

Do instalacji zależności Firebase i zarządzania nimi możesz używać menedżera pakietów Swift.

  1. Po otwarciu projektu aplikacji w Xcode wybierz Plik > Dodaj pakiety.
  2. Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Wybierz bibliotekę In-App Messaging.
  5. Dodaj flagę -ObjC do sekcji Inne flagi łączące w ustawieniach kompilacji celu.
  6. Aby używać In-App Messaging, musisz włączyć Google Analytics w projekcie Firebase i dodać do aplikacji pakiet SDK Firebase dla Google Analytics. Możesz wybrać bibliotekę z lub bez kolekcji IDFA.
  7. Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie zależności w tle.

Teraz zainicjuj pakiet SDK w aplikacji:

  1. Zaimportuj moduł Firebase w strukturze App lub UIApplicationDelegate, jeśli jeszcze tego nie zrobiono:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Skonfiguruj też współdzielony obiekt FirebaseApp, zwykle w inicjalizatorze App lub metodzie application(_:didFinishLaunchingWithOptions:) delegata aplikacji, jeśli jeszcze tego nie zrobiono:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Skompiluj i uruchom aplikację.

Wysyłanie wiadomości testowej

Uzyskiwanie identyfikatora instalacji aplikacji

Aby oszczędzać energię, Firebase In-App Messaging pobiera wiadomości z serwera tylko raz dziennie. Może to utrudniać testowanie, dlatego konsola Firebase umożliwia określenie urządzenia testowego, które wyświetla wiadomości na żądanie.

Urządzenie testowe jest określane na podstawie identyfikatora instalacji Firebase dostarczonego przez usługę instalacji Firebase. Aby znaleźć identyfikator instalacji aplikacji testowej, uruchom aplikację z argumentem polecenia środowiska wykonawczego -FIRDebugEnabled:

  1. Po otwarciu projektu Xcode z górnego paska menu wybierz Produkt > Schemat > Edytuj schemat....
  2. W wyświetlonym oknie otwórz kartę Argumenty.
  3. Kliknij + Dodaj elementy w sekcji Argumenty przekazane przy uruchomieniu.
  4. W nowo utworzonym polu wpisz „-FIRDebugEnabled”.
  5. Kliknij Zamknij i uruchom aplikację.

Gdy aplikacja zacznie działać, w logach konsoli Xcode poszukaj tego wiersza:

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

Wysyłanie wiadomości na urządzenie testowe

Po uruchomieniu aplikacji na urządzeniu testowym i uzyskaniu identyfikatora instalacji Firebase (FID) możesz przetestować konfigurację Firebase In-App Messaging, wysyłając wiadomość testową:

  1. W konsoli Firebase otwórz stronę Komunikacja.
  2. Jeśli jest to Twoja pierwsza kampania, kliknij Utwórz pierwszą kampanię.
    1. Kliknij Wiadomości w aplikacji FirebaseUtwórz.
  3. Jeśli nie, na karcie Kampanie kliknij Nowa kampania.
    1. Wybierz Komunikacja w aplikacji.
  4. Wpisz tytuł pierwszej wiadomości.
  5. Kliknij Testuj na urządzeniu.
  6. W polu Dodaj identyfikator instalacji wpisz identyfikator instalacji aplikacji Firebase.
  7. Aby wysłać wiadomość, kliknij Test.

Firebase In-App Messaging wyśle wiadomość testową, gdy tylko klikniesz Przetestuj. Aby zobaczyć tę wiadomość, zamknij aplikację i ponownie ją otwórz na urządzeniu testowym.

Aby sprawdzić, czy Twoje urządzenie jest urządzeniem testowym, poszukaj tego komunikatu logu:

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