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

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


Zanim zaczniesz

Przed rozpoczęciem dodaj Firebase do projektu Apple.

Dodaj do projektu pakiet SDK Firebase In-App Messaging

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

  1. W Xcode po otwarciu projektu aplikacji przejdź do File > 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 w sekcji Inne flagi linkera w ustawieniach kompilacji docelowej.
  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 lub zależności w tle.

Teraz zainicjuj pakiet SDK w swojej 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ż FirebaseApp instancji współdzielonej, zwykle w inicjatorze App lub w inicjatorze aplikacji application(_:didFinishLaunchingWithOptions:) metody:
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. skompilować i uruchomić aplikację;
.

Wyślij wiadomość testową

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 runtime: -FIRDebugEnabled:

  1. Po otwarciu projektu Xcode na górnym pasku menu kliknij 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, a następnie uruchom aplikację.

Po uruchomieniu aplikacji znajdź ten wiersz w logach konsoli Xcode:

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

Wyślij wiadomość na urządzenie testowe

Gdy opublikujesz aplikację na urządzeniu testowym i masz już Identyfikator instalacji aplikacji Firebase (FID), możesz wypróbować urządzenie Firebase In-App Messaging Aby skonfigurować konto, wyślij 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 Wysyłanie wiadomości w aplikacji.
  4. Wpisz tytuł pierwszej wiadomości.
  5. Kliknij Przetestuj na urządzeniu.
  6. W polu Dodaj identyfikator instalacji wpisz identyfikator instalacji Firebase aplikacji.
  7. Aby wysłać wiadomość, kliknij Test.

Firebase In-App Messaging wyśle wiadomość testową, gdy tylko klikniesz Przetestuj. Aby wyświetlić musisz zamknąć i ponownie otworzyć aplikację na urządzeniu testowym.

Aby sprawdzić, czy urządzenie jest urządzeniem testowym, poszukaj tego komunikatu w logach:

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