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

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


Zanim zaczniesz

Zanim zaczniesz, dodaj Firebase do projektu Apple.

Dodawanie pakietu SDK Firebase In-App Messaging do projektu

Do instalowania zależności Firebase i zarządzania nimi używaj menedżera pakietów Swift.

  1. W Xcode, gdy projekt aplikacji jest otwarty, kliknij File > Add Packages (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
  3. Wybierz bibliotekę In-App Messaging.
  4. Dodaj flagę -ObjC do sekcji Other Linker Flags (Inne flagi łączące) w ustawieniach kompilacji celu.
  5. Aby korzystać z usługi 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 identyfikatorów IDFA lub ze zbieraniem identyfikatorów 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 przetwarzać i pobierać zależności w tle.

Teraz zainicjuj pakiet SDK w aplikacji:

  1. Zaimportuj moduł Firebase w strukturze App lub UIApplicationDelegate, jeśli jeszcze nie zostało to zrobione:
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. Skonfiguruj też udostępnioną instancję FirebaseApp, zwykle w inicjatorze App lub metodzie application(_:didFinishLaunchingWithOptions:) delegata aplikacji, jeśli jeszcze nie zostało to zrobione:
    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 dostarczanego przez usługę instalacji Firebase. Aby znaleźć identyfikator instalacji aplikacji testowej, uruchom aplikację z argumentem polecenia środowiska wykonawczego -FIRDebugEnabled:

  1. Po otwarciu projektu Xcode na górnym pasku menu kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat)….
  2. W wyświetlonym oknie otwórz kartę Arguments (Argumenty).
  3. W sekcji Arguments Passed On Launch (Argumenty przekazywane przy uruchamianiu) kliknij + Add items (+ Dodaj elementy).
  4. W nowo utworzonym polu wpisz „-FIRDebugEnabled”.
  5. Kliknij Zamknij, a następnie uruchom aplikację.

Po uruchomieniu aplikacji 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

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

  1. W konsoli Firebase kliknij DevOps i zaangażowanie > Komunikacja.

  2. Uruchom proces konfiguracji nowej kampanii:

    • Jeśli to Twoja pierwsza kampania:

      1. Kliknij Utwórz pierwszą kampanię.
      2. Wybierz Wiadomości w aplikacji Firebase i kliknij Utwórz.

    • Jeśli masz już utworzone kampanie:

      1. Na karcie Kampanie kliknij Nowa kampania.
      2. Wybierz In-App Messaging.

  3. Wpisz tytuł pierwszej wiadomości.

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

  5. W polu Dodaj identyfikator instalacji wpisz identyfikator instalacji Firebase Firebase aplikacji.

  6. Aby wysłać wiadomość, kliknij Test. Wiadomość zostanie 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.