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 SDK Firebase In-App Messaging do projektu
Użyj menedżera pakietów Swift, aby zainstalować zależności Firebase i nimi zarządzać.
- Po otwarciu projektu aplikacji w Xcode wybierz Plik > Dodaj pakiety.
- Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:
- Wybierz bibliotekę In-App Messaging.
- Dodaj flagę
-ObjC
w sekcji Inne flagi linkera w ustawieniach kompilacji docelowej. - 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.
- Gdy to zrobisz, Xcode automatycznie zacznie wyszukiwać i pobierać zależności w tle.
https://github.com/firebase/firebase-ios-sdk.git
Teraz zainicjuj pakiet SDK w aplikacji:
- Zaimportuj moduł Firebase w strukturze
App
lubUIApplicationDelegate
, jeśli jeszcze tego nie zrobiono:Swift
import Firebase
Objective-C
@import Firebase;
- Skonfiguruj też współdzieloną instancję
FirebaseApp
, zwykle w inicjatorzeApp
lub w metodzieapplication(_:didFinishLaunchingWithOptions:)
przedstawiciela aplikacji, jeśli jeszcze nie zostało to zrobione:Swift
FirebaseApp.configure()
Objective-C
[FIRApp configure];
- Skompiluj i uruchom 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 udostępnianego przez usługę instalacji Firebase. Aby znaleźć identyfikator instalacji aplikacji testowej, uruchom aplikację z argumentem polecenia runtime: -FIRDebugEnabled
.
- Po otwarciu projektu Xcode na górnym pasku menu kliknij Produkt > Schemat > Edytuj schemat….
- W wyświetlonym oknie otwórz kartę Argumenty.
- Kliknij + Dodaj elementy w sekcji Argumenty przekazane przy uruchomieniu.
- W nowo utworzonym polu wpisz „-FIRDebugEnabled”.
- 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
Wysyłanie wiadomości na urządzenie testowe
Gdy uruchomisz aplikację na urządzeniu testowym i masz już Firebaseidentyfikator instalacji (FID), możesz wypróbować konfigurację Firebase In-App Messaging, wysyłając wiadomość testową:
- W konsoli Firebase otwórz stronę Komunikacja.
- Jeśli jest to Twoja pierwsza kampania, kliknij Utwórz pierwszą kampanię.
- Kliknij Wiadomości w aplikacji Firebase i Utwórz.
- Jeśli nie, na karcie Kampanie kliknij Nowa kampania.
- Wybierz Komunikacja w aplikacji.
- Wpisz tytuł pierwszej wiadomości.
- Kliknij Przetestuj na urządzeniu.
- W polu Dodaj identyfikator instalacji wpisz identyfikator instalacji Firebase aplikacji.
- Kliknij Przetestuj, aby wysłać wiadomość.
Firebase In-App Messaging wysyła wiadomość testową, gdy tylko klikniesz Test. Aby zobaczyć ten komunikat, musisz zamknąć aplikację i otworzyć ją ponownie 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.