Kullanıcılara mesaj göndermek için FCM ve FIAM kullanın

1. Başlamadan önce

Bu codelab'de, uygulamanızı ister ön planda ister arka planda kullanıyor olsunlar, kullanıcılarla etkileşim kurma becerisini nasıl ekleyeceğinizi öğreneceksiniz.

206c7ecece550bde.png

Önkoşullar

Hiçbiri

ne öğreneceksin

  • Firebase'i Android Uygulamanıza ekleyin
  • FCM ve FIAM bağımlılıkları ekleyin
  • Uygulamanıza test FCM mesajı gönderin
  • Uygulamanıza test FIAM mesajı gönderin

Neye ihtiyacın olacak

  • Android Stüdyo 4.1
  • Android cihaz veya emülatör

2. Başlayın

Örnek kodu alın

GitHub deposunu komut satırından kopyalayın:

Başlangıç ​​uygulamasını içe aktarın

Android Studio'dan codelab-fcm-and-fiam dizinini ( android_studio_folder.png ). Bir önceki adımda klonlanan olacaktır ( Dosya > > .../codelab-fcm-and-fiam).

Artık FcmAndFiam projesini Android Studio'da açmış olmalısınız. Bir google-services.json dosyasının eksik olduğuna dair bir uyarı görürseniz endişelenmeyin. Bir sonraki adımda eklenecektir.

3. Firebase konsol projesi oluşturun

Firebase'i projeye ekleyin

  1. Firebase konsoluna gidin.
  2. Proje ekle'yi seçin.
  3. Bir Proje adı seçin veya girin.
  4. Firebase konsolunda kalan kurulum adımlarını uygulayın, ardından Proje oluştur'u (veya mevcut bir Google projesi kullanıyorsanız Firebase Ekle'yi) tıklayın.
  5. Yeni projenizin genel bakış ekranından, kurulum iş akışını başlatmak için Android simgesine tıklayın.
  6. Codelab'in paket adını girin: com.google.firebase.codelab.fcmandfiam

Uygulamanıza google-services.json dosyasını ekleyin

Paket adını ekledikten sonra , Uygulamayı Kaydet'i ve ardından Google-services.json'u İndir'i tıklayarak Firebase Android yapılandırma dosyanızı edinin, ardından google-services.json dosyasını projenizdeki app dizinine kopyalayın. Dosya indirildikten sonra, konsolda gösterilen sonraki adımlar için Atla'ya tıklayabilirsiniz (bunlar sizin için build-android-start projesinde zaten yapılmıştır).

Uygulamanıza google hizmetleri eklentisi ekleyin

google-services eklentisi, uygulamanızı Firebase kullanacak şekilde yapılandırmak için google-services.json dosyasını kullanır. Google hizmetleri eklenti bağımlılığı ve eklentinin kendisi, sırasıyla proje ve uygulama düzeyinde derleme dosyalarına zaten eklenmiş olmalıdır. Aşağıdaki girişleri onaylayın:

build.gradle

buildscript {
  ...
  dependencies {
    ...
    classpath 'com.google.gms:google-services:4.3.8'
  }
}

uygulama/build.gradle

plugins {
  ...
  id: 'com.google.gms.google-services'
}

Bağımlılıklar ekle

FCM ve FIAM aşağıdaki bağımlılıkları gerektirir. Bu bağımlılıklar, uygulama düzeyinde derleme dosyasına zaten eklenmiş olmalıdır. Aşağıdaki bağımlılıkların eklendiğini onaylayın:

uygulama/build.gradle

dependencies {
  ...
  implementation platform('com.google.firebase:firebase-bom:28.4.2')
  implementation 'com.google.firebase:firebase-analytics'
  implementation 'com.google.firebase:firebase-messaging'
  implementation 'com.google.firebase:firebase-inappmessaging-display'
}

Projenizi gradle dosyalarıyla senkronize edin

Uygulamanız için tüm bağımlılıkların mevcut olduğundan emin olmak için, projenizi bu noktada gradle dosyalarıyla senkronize etmelisiniz. Android Studio araç çubuğundan Dosya > Projeyi Gradle Dosyalarıyla Senkronize Et'i seçin.

4. Günlük Tanımlayıcıları

Firebase Bulut Mesajlaşma ve Firebase Uygulama İçi Mesajlaşma, uygulamalara mesaj göndermek için tanımlayıcıları kullanır. FCM bir kayıt belirteci kullanır ve FIAM bir kurulum kimliği kullanır.

  1. Mesajları göndermek için gereken tanımlayıcıları günlüğe kaydetmek için MainActivity.kt YAPILACAKLAR'ı aşağıdaki kodla değiştirin:
FirebaseMessaging.getInstance().token.addOnCompleteListener { regTokenTask ->
   if (regTokenTask.isSuccessful) {
       Log.d(TAG, "FCM registration token: ${regTokenTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve registration token",
           regTokenTask.exception)
   }
}
FirebaseInstallations.getInstance().id.addOnCompleteListener { installationIdTask ->
   if (installationIdTask.isSuccessful) {
       Log.d(TAG, "Firebase Installations ID: ${installationIdTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve installations ID",
           installationIdTask.exception)
   }
}
  1. Android cihazınızı bağlayın ve Çalıştır'a tıklayın ( yürütme.png ) Android Studio araç çubuğunda. Günlük Tanımlayıcıları düğmesine dokunmak, FCM kayıt belirtecini ve Firebase Kurulum Kimliğini logcat'e kaydeder. Çıktı şöyle görünmelidir:
D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
  FCM registration token: emMc5LART6GV7...r0Q

5. Test FCM mesajı gönderin

FCM mesajları hem Firebase konsolundan hem de FCM REST API'sinden gönderilebilir. Bu codelab'de bir FCM bildirim mesajı oluşturacağız ve bunu cihazımıza göndereceğiz. Bildirim mesajları, sistemin bildirim alanında görüntülenenlerdir. Bir test FCM mesajı gönder:

  1. Uygulamanın arka planda olduğundan emin olun (ana ekrana gidin)
  2. Firebase konsoluna gidin ve sol gezinme panelinde Bulut Mesajlaşma'yı seçin
  3. İlk mesajınızı gönderin'i seçin
  4. Mesaj için bir başlık ve gövde ekleyin, ardından Test mesajı gönder'e tıklayın

207ced65f5245ada.png

  1. FCM kayıt jetonunu ekleyin, ardından teste tıklayın

f3556c6a8a6453fe.png

  1. Cihazda ekran bildirimini gözlemleyin
  2. Bildirime dokunduğunuzda uygulama açılır

6. Test FIAM mesajı gönder

Firebase Uygulama İçi Mesajlaşma, çeşitli kullanıcı etkinliklerinin bir sonucu olarak tetiklenebilir. Test mesajı, Uygulama İçi Mesajı tetiklemek için uygulama açma olayını kullanır. Bir test FIAM mesajı gönder:

  1. Uygulamanın arka planda olduğundan emin olun (ana ekrana gidin)
  2. Firebase konsoluna gidin ve sol gezinme bölmesinde Uygulama İçi Mesajlaşma'yı seçin
  3. İlk kampanyanızı oluşturun'u seçin
  4. En üstteki banner kampanyasını seçin ve mesajın başlığını ve gövdesini girin
  5. Cihazda test et'e tıklayın

69f6ea5efff240d1.png

  1. Kurulum Kimliği ekleyin ve Test Et'e tıklayın

24b101edfab47144.png

  1. Uygulamayı yeniden aç
  2. Uygulama mesajında ​​gözlemleyin

7. Tebrikler

Tebrikler, hem FCM hem de FIAM mesajlarını başarıyla gönderdiniz. Artık, uygulamanızı ister ön planda ister arka planda kullanıyor olsunlar, kullanıcılarınızla nasıl etkileşim kuracağınızı biliyorsunuz.

daha fazla okuma

Sıradaki ne

  • Kendi Android uygulamanızda kullanıcılara mesaj gönderin.

referans dokümanlar