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

Dodaj Firebase do projektu aplikacji na Androida, jeśli nie korzystasz w nim jeszcze z tej usługi.

Dodawanie pakietu SDK Firebase In-App Messaging do projektu

W pliku Gradle modułu (na poziomie aplikacji) (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żywanie Firebase Android BoM do kontrolowania obsługi wersji biblioteki.

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. 

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

    // 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")
}

Gdy korzystasz z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

(Alternatywa)  Dodaj zależności biblioteki Firebase bez używania BoM

Jeśli nie zdecydujesz się na użycie Firebase BoM, musisz określić każdą wersję biblioteki Firebase w jej wierszu zależności.

Jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy korzystanie z BoM do zarządzania wersjami bibliotek, co zapewni zgodność wszystkich wersji. 

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:23.0.0")
    implementation("com.google.firebase:firebase-analytics:24.0.0")
}

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 FirebaseInstallations (FID). Znajdź identyfikator FID aplikacji testowej, sprawdzając Logcat w Android Studio pod kątem tego dziennika na poziomie `Info`:

I/FIAM.Headless: Starting InAppMessaging runtime with 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:

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