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

1. Başlamadan önce

Bu codelab'de, ister uygulamanızı ön planda kullanıyor olsun, ister uygulamanız arka planda olsun, kullanıcılarla etkileşim kurma yeteneğini 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ını ekleyin
  • Uygulamanıza test FCM mesajı gönderin
  • Uygulamanıza test FIAM mesajı gönderin

İhtiyacınız olan şey

  • Android Stüdyosu 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

Android Studio'dan codelab-fcm-and-fiam dizinini seçin ( android_studio_folder.png ). Bu, önceki adımda kopyalanan olacaktır ( Dosya > > .../codelab-fcm-and-fiam).

Artık FcmAndFiam projesini Android Studio'da açmalı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ı izleyin ve ardından Proje oluştur'u (veya mevcut bir Google projesini kullanıyorsanız Firebase Ekle'yi) tıklayın.
  5. Kurulum iş akışını başlatmak için yeni projenizin genel bakış ekranından Android simgesine tıklayın.
  6. Codelab'in paket adını girin: com.google.firebase.codelab.fcmandfiam

Google-services.json dosyasını uygulamanıza ekleyin

Paket adını ekledikten sonra Uygulamayı Kaydet'e tıklayın, ardından Firebase Android yapılandırma dosyanızı almak için google-services.json'u İndir'e tıklayın ve 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 (bu adımlar sizin için build-android-start projesinde zaten yapılmıştır).

Uygulamanıza Google hizmetleri eklentisini ekleyin

Google-services eklentisi, uygulamanızı Firebase'i 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 eklenmelidir. Aşağıdaki girişleri onaylayın:

build.gradle

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

app/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ın uygulama düzeyinde derleme dosyasına zaten eklenmiş olması gerekir. Aşağıdaki bağımlılıkların eklendiğini doğrulayın:

app/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ızda tüm bağımlılıkların mevcut olduğundan emin olmak için bu noktada projenizi gradle dosyalarıyla senkronize etmelisiniz. Android Studio araç çubuğundan Dosya > Projeyi Gradle Dosyalarıyla Eşitle'yi seçin.

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

Firebase Cloud Messaging ve Firebase In App Messaging'in her ikisi de 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. MainActivity.kt , mesaj göndermek için gereken tanımlayıcıları günlüğe kaydetmek için TODO'yu 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üt.png )Android Studio araç çubuğunda. Günlük Tanımlayıcıları düğmesine dokunulduğunda FCM kayıt jetonu ve Firebase Kurulum Kimliği logcat'e kaydedilir. Çıktı şu şekilde görünmelidir:
D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
  FCM registration token: emMc5LART6GV7...r0Q

5. Test FCM mesajını gönderin

FCM mesajları hem Firebase konsolundan hem de FCM REST API'sinden gönderilebilir. Bu codelab'de bir FCM bildirim mesajı oluşturup cihazımıza göndereceğiz. Bildirim mesajları sistemin bildirim alanında görüntülenen mesajlardır. Aşağıdaki yöntemle bir test FCM mesajı gönderin:

  1. Uygulamanın arka planda olduğundan emin olun (ana ekrana gidin)
  2. Firebase konsoluna gidin ve sol gezinme bölmesinde 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 ve ardından Test mesajı gönder'e tıklayın.

207ced65f5245ada.png

  1. FCM kayıt jetonunu ekleyin ve ardından test'e tıklayın

f3556c6a8a6453fe.png

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

6. Test FIAM mesajını gönderin

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

  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. Üst banner kampanyasını seçin ve mesajın başlığını ve metnini girin
  5. Cihazda test et'e tıklayın

69f6ea5efff240d1.png

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

24b101edfab47144.png

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

7. Tebrikler

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

daha fazla okuma

Sıradaki ne

  • Kullanıcılara kendi Android uygulamanızdan mesaj gönderin.

Referans belgeleri