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

Dodaj Firebase do swojego projektu Android, chyba że masz to już za sobą.

Dodawanie pakietu SDK Firebase In-App Messaging do projektu

w pliku Gradle (na poziomie aplikacji) modułu, (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle), dodaj zależność z biblioteką In-App Messaging na Androida. Zalecamy użycie metody Firebase Android BoM aby kontrolować obsługę wersji biblioteki.

Aby używać In-App Messaging, musisz włączyć Google Analytics w projekcie Firebase i dodać do aplikacji pakiet SDK Firebase dla Google Analytics. 

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.3.0"))

    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display")
    implementation("com.google.firebase:firebase-analytics")
}

Dzięki użyciu Firebase Android BoMaplikacja zawsze będzie używać zgodnych wersji bibliotek Firebase na Androida.

(Wersja alternatywna) Dodaj zależności biblioteki Firebase bez użycia komponentu BoM

Jeśli nie chcesz używać biblioteki Firebase BoM, musisz określić każdą wersję biblioteki Firebase w wierszu zależności.

Pamiętaj, że jeśli używasz wielu bibliotek Firebase w aplikacji, zalecamy korzystanie z BoM do zarządzania wersjami biblioteki. Dzięki temu wszystkie wersje są zgodne. 

dependencies {
    // Add the dependencies for the In-App Messaging and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-inappmessaging-display:21.0.0")
    implementation("com.google.firebase:firebase-analytics:22.1.0")
}
Szukasz modułu biblioteki dla Kotlina? Od października 2023 r. (Firebase BoM 32.5.0) deweloperzy Kotlina i Java mogą korzystać z głównego modułu biblioteki (szczegółowe informacje znajdziesz w często zadawanych pytaniach dotyczących tej inicjatywy).

Wyślij wiadomość testową

Pobieranie identyfikatora instalacji aplikacji

Aby oszczędzać energię, Firebase In-App Messaging pobiera wiadomości z serwera tylko raz dziennie. To może utrudniać testowanie, więc Konsola Firebase umożliwia określenie urządzenia testowego wyświetlającego komunikaty na żądanie.

Urządzenie testowe jest określane przez FirebaseInstallations lub FID. Aby znaleźć FID aplikacji testowej, sprawdź okno Logcat. Android Studio dla tego logu poziomu `Info`:

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

Wysyłanie wiadomości 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ę Wiadomości.
  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. Wpisz identyfikator instalacji aplikacji Firebase w polu Dodaj pole identyfikatora instalacji.
  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:

I/FIAM.Headless: Setting this device as a test device