Bir mesajı birden fazla cihaza hedeflemek için Konu mesajları'nı kullanın. Bu özellik, belirli bir konuyu etkinleştirmiş olan birden fazla cihaza mesaj göndermenize olanak tanır.
Bu eğitim, FCM için Admin SDK veya REST API kullanarak uygulama sunucunuzdan konu mesajları göndermeye ve bu mesajları bir Android uygulamasında almaya ve işlemeye odaklanır. Hem arka planda hem de ön planda olan uygulamalar için mesaj işlemeyi ele alacağız. Bunu başarmak için, kurulumdan doğrulamaya kadar tüm adımlar ele alınmıştır.
SDK'yı ayarlama
Bu bölümde, FCM için bir Android istemci uygulaması kurduysanız veya İlk Mesajınızı Gönderme adımlarını uyguladıysanız daha önce tamamladığınız adımlar ele alınabilir.
Başlamadan önce
Android Studio'yu yükleyin veya en son sürümüne güncelleyin.
Projenizin şu gereklilikleri karşıladığından emin olun (bazı ürünlerin daha katı gereksinimler olabileceğini unutmayın):
- API düzeyi 19 (KitKat) veya üstünü hedefler
- Android 4.4 veya sonraki bir sürümü çalıştıran
- Aşağıdaki sürüm gereksinimlerinin karşılanmasını da içeren Jetpack (AndroidX)
uygulamasını kullanmalıdır:
com.android.tools.build:gradle
7.3.0 veya sonraki sürümlercompileSdkVersion
28 veya üzeri
Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya emülatör kullanın.
Google Play hizmetlerine bağımlılığı olan Firebase SDK'larının, cihaz veya emülatörde Google Play Hizmetleri'nin yüklü olmasını gerektirdiğini unutmayın.Google Hesabınızı kullanarak Firebase'de oturum açın.
Halihazırda bir Android projeniz yoksa ve yalnızca bir Firebase ürününü denemek istiyorsanız hızlı başlangıç örneklerimizden birini indirebilirsiniz.
Firebase projesi oluşturun
Firebase'i Android uygulamanıza ekleyebilmek için önce Android uygulamanıza bağlanacak bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.
Uygulamanızı Firebase'e kaydetme
Android uygulamanızda Firebase'i kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetmek, genellikle uygulamanızı projenize "ekleme" olarak adlandırılır.
Firebase konsoluna gidin.
Projeye genel bakış sayfasının ortasındaki Android simgesini (
) veya kurulum iş akışını başlatmak için Uygulama ekle'yi tıklayın.Android paket adı alanına uygulamanızın paket adını girin.
(İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve SHA-1 imza sertifikası hata ayıklaması.
Uygulamayı kaydet'i tıklayın.
Firebase yapılandırma dosyası ekleyin
Firebase Android yapılandırma dosyasını (
) indirip uygulamanıza ekleyin:google-services.json Firebase Android yapılandırma dosyanızı almak için google-services.json dosyasını indir'i tıklayın.
Yapılandırma dosyanızı, uygulamanızın modül (uygulama düzeyi) kök dizinine taşıyın.
yapılandırma dosyanızdaki değerlere Firebase SDK'ları tarafından erişilebilmesini sağlamak için Google hizmetleri Gradle eklentisine (google-services.json google-services
) ihtiyacınız vardır.Kök düzeyindeki (proje düzeyindeki) Gradle dosyanıza (
<project>/build.gradle.kts
veya<project>/build.gradle
) Google hizmetleri eklentisini bağımlılık olarak ekleyin:Kotlin
plugins { id("com.android.application") version "7.3.0" apply false // ... // Add the dependency for the Google services Gradle plugin id("com.google.gms.google-services") version "4.4.1" apply false }
Groovy
plugins { id 'com.android.application' version '7.3.0' apply false // ... // Add the dependency for the Google services Gradle plugin id 'com.google.gms.google-services' version '4.4.1' apply false }
Modül (uygulama düzeyi) Gradle dosyanıza (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
) Google hizmetleri eklentisini ekleyin:Kotlin
plugins { id("com.android.application") // Add the Google services Gradle plugin id("com.google.gms.google-services") // ... }
Groovy
plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' // ... }
Uygulamanıza Firebase SDK'ları ekleyin
Modül (uygulama düzeyi) Gradle dosyanıza (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
), Android için Firebase Cloud Messaging kitaplığının bağımlılığını ekleyin. Kitaplık sürümü oluşturmayı kontrol etmek için Firebase Android BoM'u kullanmanızı öneririz.Firebase Cloud Messaging ile optimum bir deneyim için Firebase projenizde Google Analytics'i etkinleştirmenizi ve uygulamanıza Google Analytics için Firebase SDK'sını eklemenizi öneririz.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.0.0")) // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-messaging") implementation("com.google.firebase:firebase-analytics") }
Firebase Android BoM kullanıldığında uygulamanız Firebase Android kitaplıklarının her zaman uyumlu sürümlerini kullanır.
(Alternatif) Firebase kitaplığı bağımlılıklarını BoM'u kullanmadan ekleyin
Firebase BoM'yi kullanmamayı seçerseniz her Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.
Uygulamanızda birden fazla Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için tüm sürümlerin uyumlu olmasını sağlamak için BoM kullanmanızı kesinlikle öneririz.
dependencies { // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-messaging:24.0.0") implementation("com.google.firebase:firebase-analytics:22.0.0") }
Android projenizi Gradle dosyalarıyla senkronize edin.
İstemci uygulamasının konuya abone olmasını sağlama
Müşteri uygulamaları mevcut herhangi bir konuya abone olabilir veya yeni bir konu oluşturabilir. Bir istemci uygulaması yeni bir konu adına (Firebase projeniz için halihazırda var olmayan) abone olduğunda FCM'de bu ada sahip yeni bir konu oluşturulur ve ardından herhangi bir istemci bu ada abone olabilir.
İstemci uygulaması, bir konuya abone olmak için FCM konu adıyla Firebase Cloud Messaging subscribeToTopic()
özelliğini çağırır. Bu yöntem, aboneliğin başarılı olup olmadığını belirlemek için tamamlama dinleyicisi tarafından kullanılabilecek bir Task
döndürür:
Kotlin+KTX
Firebase.messaging.subscribeToTopic("weather") .addOnCompleteListener { task -> var msg = "Subscribed" if (!task.isSuccessful) { msg = "Subscribe failed" } Log.d(TAG, msg) Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show() }
Java
FirebaseMessaging.getInstance().subscribeToTopic("weather") .addOnCompleteListener(new OnCompleteListener<Void>() { @Override public void onComplete(@NonNull Task<Void> task) { String msg = "Subscribed"; if (!task.isSuccessful()) { msg = "Subscribe failed"; } Log.d(TAG, msg); Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show(); } });
Abonelikten çıkmak için istemci uygulaması, konu adıyla Firebase Cloud Messaging'i unsubscribeFromTopic()
çağırır.
Konu mesajlarını alma ve işleme
FCM, konu mesajlarını diğer aşağı akış mesajlarıyla aynı şekilde dağıtır.
Mesajları almak için
FirebaseMessagingService
süresini kapsayan bir hizmet kullanın.
Hizmetiniz onMessageReceived
ve onDeletedMessages
geri çağırmalarını geçersiz kılar.
İşletim sistemi gecikmeleri, uygulama başlatma süresi, ana iş parçacığının diğer işlemler tarafından engellenmesi veya çok uzun süren önceki onMessageReceived
çağrıları gibi onMessageReceived
çağrısından önce gerçekleşen gecikmelere bağlı olarak, bir mesajın işlenmesi için gereken süre 20 saniyeden kısa olabilir. Bu süre geçtikten sonra, Android'in işlemi sonlandırma veya Android O'nun
arka planda yürütme sınırları gibi çeşitli işletim sistemi davranışları, işlerinizi tamamlamanızı engelleyebilir.
Aşağıdaki istisnalar hariç çoğu mesaj türü için onMessageReceived
sağlanır:
-
Uygulamanız arka plandayken gönderilen bildirim mesajları. Bu durumda, bildirim cihazın sistem tepsisine gönderilir. Kullanıcı bir bildirime hafifçe dokunduğunda, varsayılan olarak uygulama başlatıcıyı açılır.
-
Arka planda alındığında hem bildirim hem de veri yükü içeren iletiler. Bu durumda, bildirim cihazın sistem tepsisine gönderilir ve veri yükü, başlatıcı Etkinliğinizin amacının ekstralarında iletilir.
Özet olarak:
Uygulama durumu | Bildirim | Veriler | Her ikisi de |
---|---|---|---|
Ön plan | onMessageReceived |
onMessageReceived |
onMessageReceived |
Genel bilgi | Sistem tepsisi | onMessageReceived |
Bildirim: sistem tepsisi Veri: amacın ekstralarında. |
Uygulama manifestini düzenle
FirebaseMessagingService
uygulamasını kullanmak için uygulama manifest dosyanıza aşağıdakileri eklemeniz gerekir:
<service android:name=".java.MyFirebaseMessagingService" android:exported="false"> <intent-filter> <action android:name="com.google.firebase.MESSAGING_EVENT" /> </intent-filter> </service>
Ayrıca, bildirimlerin görünümünü özelleştirmek için varsayılan değerleri ayarlamanız da önerilir. Bildirim yükünde eşdeğer değerler ayarlanmadığında uygulanacak özel bir varsayılan simge ve özel bir varsayılan renk belirleyebilirsiniz.
Özel varsayılan simgeyi ve özel rengi ayarlamak için application
etiketinin içine şu satırları ekleyin:
<!-- Set custom default icon. This is used when no icon is set for incoming notification messages. See README(https://goo.gl/l4GJaQ) for more. --> <meta-data android:name="com.google.firebase.messaging.default_notification_icon" android:resource="@drawable/ic_stat_ic_notification" /> <!-- Set color used with incoming notification messages. This is used when no color is set for the incoming notification message. See README(https://goo.gl/6BKBk7) for more. --> <meta-data android:name="com.google.firebase.messaging.default_notification_color" android:resource="@color/colorAccent" />
Android, ekran görüntüsü için özel varsayılan simgeyi
- Bildirim oluşturucudan gönderilen tüm bildirim mesajları.
- Bildirim yükündeki simgeyi açıkça belirtmeyen herhangi bir bildirim mesajı.
Android şunun için özel varsayılan rengi kullanır:
- Bildirim oluşturucudan gönderilen tüm bildirim mesajları.
- Bildirim yükündeki rengi açıkça belirtmeyen herhangi bir bildirim mesajı.
Varsayılan özel simge ayarlanmazsa ve bildirim yükünde herhangi bir simge ayarlanmazsa Android, uygulama simgesini beyaz renkte görüntüler.
Geçersiz kıl: onMessageReceived
FirebaseMessagingService.onMessageReceived
yöntemini geçersiz kılarak alınan RemoteMessage nesnesine göre işlemler gerçekleştirebilir ve mesaj verilerini alabilirsiniz:
Kotlin+KTX
override fun onMessageReceived(remoteMessage: RemoteMessage) { // TODO(developer): Handle FCM messages here. // Not getting messages here? See why this may be: https://goo.gl/39bRNJ Log.d(TAG, "From: ${remoteMessage.from}") // Check if message contains a data payload. if (remoteMessage.data.isNotEmpty()) { Log.d(TAG, "Message data payload: ${remoteMessage.data}") // Check if data needs to be processed by long running job if (needsToBeScheduled()) { // For long-running tasks (10 seconds or more) use WorkManager. scheduleJob() } else { // Handle message within 10 seconds handleNow() } } // Check if message contains a notification payload. remoteMessage.notification?.let { Log.d(TAG, "Message Notification Body: ${it.body}") } // Also if you intend on generating your own notifications as a result of a received FCM // message, here is where that should be initiated. See sendNotification method below. }
Java
@Override public void onMessageReceived(RemoteMessage remoteMessage) { // TODO(developer): Handle FCM messages here. // Not getting messages here? See why this may be: https://goo.gl/39bRNJ Log.d(TAG, "From: " + remoteMessage.getFrom()); // Check if message contains a data payload. if (remoteMessage.getData().size() > 0) { Log.d(TAG, "Message data payload: " + remoteMessage.getData()); if (/* Check if data needs to be processed by long running job */ true) { // For long-running tasks (10 seconds or more) use WorkManager. scheduleJob(); } else { // Handle message within 10 seconds handleNow(); } } // Check if message contains a notification payload. if (remoteMessage.getNotification() != null) { Log.d(TAG, "Message Notification Body: " + remoteMessage.getNotification().getBody()); } // Also if you intend on generating your own notifications as a result of a received FCM // message, here is where that should be initiated. See sendNotification method below. }
Geçersiz kıl: onDeletedMessages
Bazı durumlarda FCM, iletiyi teslim edemeyebilir. Bu durum, belirli bir cihaz bağlandığında uygulamanız için bekleyen çok fazla mesaj (>100) olduğunda veya cihaz bir aydan uzun bir süredir FCM'ye bağlanmadığında meydana gelir. Bu durumlarda, FirebaseMessagingService.onDeletedMessages()
için bir geri çağırma alabilirsiniz.
Uygulama örneği bu geri çağırmayı aldığında uygulama sunucunuzla tam senkronizasyon gerçekleştirmelidir. Son 4 hafta içinde söz konusu cihazdaki uygulamaya bir mesaj göndermediyseniz FCM, onDeletedMessages()
numaralı telefonu aramaz.
Arka plandaki bir uygulamada bildirim mesajlarını işleme
Android, uygulamanız arka plandayken bildirim mesajlarını sistem tepsisine yönlendirir. Kullanıcı bildirime dokunduğunda varsayılan olarak uygulama başlatıcı açılır.
Buna hem bildirim hem de veri yükünü içeren mesajlar (ve Notifications konsolundan gönderilen tüm mesajlar) dahildir. Bu durumlarda bildirim, cihazın sistem tepsisine gönderilir ve veri yükü, başlatıcı Etkinliğinizin amacının ekstralarında iletilir.
Uygulamanıza mesaj teslimiyle ilgili ayrıntılı bilgi için, Android uygulamaları için "gösterimler" (kullanıcıların gördüğü bildirimler) verileriyle birlikte Apple ve Android cihazlarda gönderilen ve açılan mesajların sayısını kaydeden FCM raporlama kontrol panelini inceleyin.
Derleme gönderme istekleri
Bir konu oluşturduktan sonra, istemci uygulaması örneklerini istemci tarafında konuya abone olarak veya sunucu API'si aracılığıyla ayarlayabilirsiniz. FCM için ilk kez gönderme isteği oluşturuyorsanız önemli arka plan ve kurulum bilgileri için sunucu ortamınız ve FCM'niz kılavuzuna bakın.
Arka uçtaki gönderme mantığınızda, istediğiniz konu adını gösterildiği gibi belirtin:
Node.js
// The topic name can be optionally prefixed with "/topics/".
const topic = 'highScores';
const message = {
data: {
score: '850',
time: '2:45'
},
topic: topic
};
// Send a message to devices subscribed to the provided topic.
getMessaging().send(message)
.then((response) => {
// Response is a message ID string.
console.log('Successfully sent message:', response);
})
.catch((error) => {
console.log('Error sending message:', error);
});
Java
// The topic name can be optionally prefixed with "/topics/".
String topic = "highScores";
// See documentation on defining a message payload.
Message message = Message.builder()
.putData("score", "850")
.putData("time", "2:45")
.setTopic(topic)
.build();
// Send a message to the devices subscribed to the provided topic.
String response = FirebaseMessaging.getInstance().send(message);
// Response is a message ID string.
System.out.println("Successfully sent message: " + response);
Python
# The topic name can be optionally prefixed with "/topics/".
topic = 'highScores'
# See documentation on defining a message payload.
message = messaging.Message(
data={
'score': '850',
'time': '2:45',
},
topic=topic,
)
# Send a message to the devices subscribed to the provided topic.
response = messaging.send(message)
# Response is a message ID string.
print('Successfully sent message:', response)
Go
// The topic name can be optionally prefixed with "/topics/".
topic := "highScores"
// See documentation on defining a message payload.
message := &messaging.Message{
Data: map[string]string{
"score": "850",
"time": "2:45",
},
Topic: topic,
}
// Send a message to the devices subscribed to the provided topic.
response, err := client.Send(ctx, message)
if err != nil {
log.Fatalln(err)
}
// Response is a message ID string.
fmt.Println("Successfully sent message:", response)
C#
// The topic name can be optionally prefixed with "/topics/".
var topic = "highScores";
// See documentation on defining a message payload.
var message = new Message()
{
Data = new Dictionary<string, string>()
{
{ "score", "850" },
{ "time", "2:45" },
},
Topic = topic,
};
// Send a message to the devices subscribed to the provided topic.
string response = await FirebaseMessaging.DefaultInstance.SendAsync(message);
// Response is a message ID string.
Console.WriteLine("Successfully sent message: " + response);
REST
POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1
Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
"message":{
"topic" : "foo-bar",
"notification" : {
"body" : "This is a Firebase Cloud Messaging Topic Message!",
"title" : "FCM Message"
}
}
}
cURL komutu:
curl -X POST -H "Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA" -H "Content-Type: application/json" -d '{
"message": {
"topic" : "foo-bar",
"notification": {
"body": "This is a Firebase Cloud Messaging Topic Message!",
"title": "FCM Message"
}
}
}' https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1
Bir konu kombinasyonuna mesaj göndermek için bir koşul belirtin. Bu, hedef konuları belirten bir boole ifadesidir. Örneğin, aşağıdaki koşul TopicA
ve TopicB
ya da TopicC
abonesi olan cihazlara mesaj gönderir:
"'TopicA' in topics && ('TopicB' in topics || 'TopicC' in topics)"
FCM önce parantez içindeki tüm koşulları değerlendirir, ardından ifadeyi soldan sağa doğru değerlendirir. Yukarıdaki ifadede, herhangi bir konuya abone olan kullanıcı mesajı almaz. Benzer şekilde, TopicA
abonesi olmayan bir kullanıcı da mesajı almaz. Şu kombinasyonlar bunu alır:
TopicA
veTopicB
TopicA
veTopicC
Koşullu ifadenize en fazla beş konu ekleyebilirsiniz.
Bir koşula göndermek için:
Node.js
// Define a condition which will send to devices which are subscribed
// to either the Google stock or the tech industry topics.
const condition = '\'stock-GOOG\' in topics || \'industry-tech\' in topics';
// See documentation on defining a message payload.
const message = {
notification: {
title: '$FooCorp up 1.43% on the day',
body: '$FooCorp gained 11.80 points to close at 835.67, up 1.43% on the day.'
},
condition: condition
};
// Send a message to devices subscribed to the combination of topics
// specified by the provided condition.
getMessaging().send(message)
.then((response) => {
// Response is a message ID string.
console.log('Successfully sent message:', response);
})
.catch((error) => {
console.log('Error sending message:', error);
});
Java
// Define a condition which will send to devices which are subscribed
// to either the Google stock or the tech industry topics.
String condition = "'stock-GOOG' in topics || 'industry-tech' in topics";
// See documentation on defining a message payload.
Message message = Message.builder()
.setNotification(Notification.builder()
.setTitle("$GOOG up 1.43% on the day")
.setBody("$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.")
.build())
.setCondition(condition)
.build();
// Send a message to devices subscribed to the combination of topics
// specified by the provided condition.
String response = FirebaseMessaging.getInstance().send(message);
// Response is a message ID string.
System.out.println("Successfully sent message: " + response);
Python
# Define a condition which will send to devices which are subscribed
# to either the Google stock or the tech industry topics.
condition = "'stock-GOOG' in topics || 'industry-tech' in topics"
# See documentation on defining a message payload.
message = messaging.Message(
notification=messaging.Notification(
title='$GOOG up 1.43% on the day',
body='$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.',
),
condition=condition,
)
# Send a message to devices subscribed to the combination of topics
# specified by the provided condition.
response = messaging.send(message)
# Response is a message ID string.
print('Successfully sent message:', response)
Go
// Define a condition which will send to devices which are subscribed
// to either the Google stock or the tech industry topics.
condition := "'stock-GOOG' in topics || 'industry-tech' in topics"
// See documentation on defining a message payload.
message := &messaging.Message{
Data: map[string]string{
"score": "850",
"time": "2:45",
},
Condition: condition,
}
// Send a message to devices subscribed to the combination of topics
// specified by the provided condition.
response, err := client.Send(ctx, message)
if err != nil {
log.Fatalln(err)
}
// Response is a message ID string.
fmt.Println("Successfully sent message:", response)
C#
// Define a condition which will send to devices which are subscribed
// to either the Google stock or the tech industry topics.
var condition = "'stock-GOOG' in topics || 'industry-tech' in topics";
// See documentation on defining a message payload.
var message = new Message()
{
Notification = new Notification()
{
Title = "$GOOG up 1.43% on the day",
Body = "$GOOG gained 11.80 points to close at 835.67, up 1.43% on the day.",
},
Condition = condition,
};
// Send a message to devices subscribed to the combination of topics
// specified by the provided condition.
string response = await FirebaseMessaging.DefaultInstance.SendAsync(message);
// Response is a message ID string.
Console.WriteLine("Successfully sent message: " + response);
REST
POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1
Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
"message":{
"condition": "'dogs' in topics || 'cats' in topics",
"notification" : {
"body" : "This is a Firebase Cloud Messaging Topic Message!",
"title" : "FCM Message",
}
}
}
cURL komutu:
curl -X POST -H "Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA" -H "Content-Type: application/json" -d '{
"notification": {
"title": "FCM Message",
"body": "This is a Firebase Cloud Messaging Topic Message!",
},
"condition": "'dogs' in topics || 'cats' in topics"
}' https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1
Sonraki adımlar
- İstemci uygulaması örneklerini konulara kaydetmek ve diğer yönetim görevlerini gerçekleştirmek için sunucunuzu kullanabilirsiniz. Sunucudaki konu aboneliklerini yönetme sayfasına göz atın.