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, upewnij się, że dodasz Firebase do projektu Apple.

Dodawanie do projektu pakowanie SDK Firebase In-App Messaging

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

  1. Po otwarciu projektu aplikacji wybierz w Xcode opcję File (Plik) > Add Packages (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
  3. Wybierz bibliotekę In-App Messaging.
  4. Dodaj flagę -ObjC do sekcji Other Linker Flags w ustawieniach kompilacji celu.
  5. Aby korzystać z funkcji In-App Messaging, musisz włączyć Google Analytics w projekcie w Firebase i dodać do aplikacji [pakiet] SDK Firebase dla Google Analytics. Możesz wybrać bibliotekę bez zbierania IDFA lub ze zbieraniem IDFA. Zapoznaj się z najczęstszymi pytaniami dotyczącymi najnowszej organizacji modułów w pakiecie SDK Google Analytics dla Firebase.
  6. Gdy skończysz, Xcode zacznie automatycznie wyszukiwać i pobierać Twoje zależności w tle.

Teraz zainicjuj pakiet SDK w aplikacji:

  1. Jeśli nie masz jeszcze zaimportowanego modułu Firebase w strukturze App lub UIApplicationDelegate, zrób to teraz:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Jeśli nie masz jeszcze skonfigurowanej współdzielonej instancji FirebaseApp , skonfiguruj ją (zwykle w inicjatorze App's lub w metodzie application(_:didFinishLaunchingWithOptions:) delegata aplikacji):
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. Skompiluj i uruchom aplikację.

Wysyłanie wiadomości testowej

Pobieranie 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 w Firebase konsoli możesz określić urządzenie testowe, które będzie wyświetlać wiadomości na żądanie.

Urządzenie testowe jest określane przez identyfikator instalacji Firebase podany przez usługę instalacji Firebase. Aby znaleźć identyfikator instalacji aplikacji testowej, uruchom aplikację z argumentem wiersza poleceń -FIRDebugEnabled:

  1. Po otwarciu projektu Xcode w menu u góry wybierz Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat)… z menu u góry.
  2. Otwórz kartę Arguments (Argumenty) w wyświetlonym oknie.
  3. W sekcji Arguments Passed On Launch (Argumenty przekazywane podczas uruchamiania) kliknij + Add items (\+ Dodaj elementy).
  4. W nowo utworzonym polu wpisz „-FIRDebugEnabled”.
  5. Kliknij Close (Zamknij), a następnie uruchom aplikację.

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

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

Wysyłanie wiadomości na urządzenie testowe

Gdy uruchomisz aplikację na urządzeniu testowym i masz jej Firebase identyfikator instalacji (FID), możesz przetestować swoją Firebase In-App Messaging konfigurację, wysyłając wiadomość testową:

  1. W konsoli Firebase otwórz DevOps & Engagement (DevOps i zaangażowanie) > Messaging (Wysyłanie wiadomości).

  2. Uruchom proces konfigurowania nowej kampanii:

    • Jeśli jest to Twoja pierwsza kampania:

      1. Kliknij Create your first campaign (Utwórz pierwszą kampanię).
      2. Wybierz Firebase In-App messages (Wiadomości w aplikacji Firebase) i kliknij Create (Utwórz).

    • Jeśli masz już utworzone kampanie:

      1. Na karcie Campaigns (Kampanie) kliknij New campaign (Nowa kampania).
      2. Wybierz In-App Messaging (Wysyłanie wiadomości w aplikacji).

  3. Wpisz Title (Tytuł) pierwszej wiadomości.

  4. Kliknij Test on Device (Testuj na urządzeniu).

  5. W polu Add an installation ID wpisz identyfikator instalacji Firebase aplikacji Firebase.

  6. Aby wysłać wiadomość, kliknij Test (Testuj). Zostanie ona wysłana natychmiast.

  7. Aby zobaczyć wiadomość na urządzeniu testowym, musisz zamknąć, a następnie ponownie otworzyć aplikację na tym urządzeniu.

Aby sprawdzić, czy 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.