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 projektu Apple.

Dodawanie pakietu Firebase In-App Messaging SDK do projektu

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 > Add Packages (Plik > Dodaj pakiety).
2. Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:

  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 linkera) w ustawieniach kompilacji projektu.
5. Aby korzystać z 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ę bez zbierania identyfikatora IDFA lub z jego zbieraniem. Zapoznaj się z naszymi odpowiedziami na najczęstsze pytania dotyczące najnowszej organizacji modułów w Google Analytics dla pakietu SDK Firebase.
6. Gdy skończysz, Xcode zacznie automatycznie wyszukiwać 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 tego nie zrobiono:

   Swift

   import Firebase

   Objective-C

   @import Firebase;

2. Skonfiguruj też FirebaseApp wspólne wystąpienie, zwykle w inicjatorze App lub w 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

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 Firebasekonsola umożliwia określenie urządzenia testowego, które wyświetla wiadomości na żądanie.

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

1. Po otwarciu projektu Xcode na pasku menu u góry kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat)…
2. Otwórz kartę Arguments (Argumenty) w wyświetlonym oknie.
3. W sekcji Argumenty przekazywane podczas uruchamiania kliknij + Dodaj elementy.
4. W nowo utworzonym polu wpisz „-FIRDebugEnabled”.
5. Kliknij Zamknij, a potem 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 (FID) możesz przetestować konfigurację, wysyłając wiadomość testową:FirebaseFirebase In-App Messaging

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

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

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

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