Android API düzeyi 26'dan itibaren, ön plan hizmetleri için kalıcı bildirimler gereklidir. Bu şartın amacı, özellikle pil olmak üzere sistem kaynaklarını aşırı derecede zorlayabilecek hizmetleri gizlemenizin önüne geçmektir. Bu şart, olası bir soruna yol açar: Birden fazla ön plan hizmeti olan bir uygulama, bildirimi tüm hizmetler arasında paylaşılacak şekilde dikkatli bir şekilde yönetmezse birden fazla kalıcı, kapatılamaz bildirim olabilir. Bu da etkin bildirim listesinde istenmeyen dağınıklığa neden olur.
Bu sorun, ön plan hizmetlerini uygulamadan bağımsız olarak çalıştıran ve kendi bağımsız kalıcı bildirimlerine sahip olan Navigasyon SDK'sı gibi SDK'lar kullanıldığında daha da zorlaşır. Bu da bildirimlerin birleştirilmesini zorlaştırır.
Bu sorunları gidermek için Navigation SDK'sı 1.11 sürümü, SDK dahil olmak üzere uygulama genelinde kalıcı bildirimleri yönetmeye yardımcı olacak basit bir API kullanıma sundu.
Bileşenler
Ön plan hizmet yöneticisi, Android ön plan hizmet sınıfı ve kalıcı bildirim sınıfı etrafında bir sarmalayıcı sağlar. Bu sarmalayıcının ana işlevi, bildirimin yöneticiyi kullanarak tüm ön plan hizmetlerinde paylaşılması için bildirim kimliğinin yeniden kullanılmasını zorunlu kılmaktır.
Navigation SDK'sı, ForegroundServiceManager tekil nesnesi için ilk başlatma ve alma işlemlerini içeren statik yöntemler içerir. Bu tekil nesne, Navigation SDK'sının ömrü boyunca yalnızca bir kez başlatılabilir. Bu nedenle, başlatma çağrılarından birini (initForegroundServiceManagerMessageAndIntent() veya initForegroundServiceManagerProvider()) kullanıyorsanız bu yol yeniden girilebileceği için çağrıyı bir try-catch bloğuyla çevrelemeniz gerekir. Gezinme SDK'sı, önce ForegroundServiceManager ile ilgili tüm referansları temizlemedikçe ve her bir sonraki çağrıdan önce clearForegroundServiceManager()'ı çağırmadıysanız iki yöntemi de birden fazla kez çağırırsanız bir çalışma zamanı istisnası oluşturur.
initForegroundServiceManagerMessageAndIntent()'ün dört parametresi application, notificationId, defaultMessage ve resumeIntent'dir. Son üç parametre null ise bildirim, standart Navigation SDK bildirimidir. Uygulamadaki diğer ön plan hizmetlerini bu bildirimin arkasına gizlemek yine de mümkündür. notificationId parametresi, bildirim için kullanılması gereken bildirim kimliğini belirtir. Boşsa rastgele bir değer kullanılır. Başka bir SDK'dan gelenler gibi diğer bildirimlerle çakışmaları önlemek için bu değeri açıkça ayarlayabilirsiniz. defaultMessage, sistem gezinmediğinde gösterilen bir dizedir. resumeIntent, bildirim tıklandığında tetiklenen bir intent'tir. resumeIntent null ise bildirim tıklamaları yoksayılır.
initForegroundServiceManagerProvider()'ün üç parametresi application, notificationId ve notificationProvider'tır. Son iki parametre null ise bildirim, standart Navigation SDK bildirimidir. notificationId parametresi, bildirim için kullanılması gereken bildirim kimliğini belirtir. Boşsa rastgele bir değer kullanılır. Başka bir SDK'dan gelenler gibi diğer bildirimlerle çakışmaları önlemek için bu değeri açıkça ayarlayabilirsiniz. notificationProvider ayarlanmışsa oluşturulacak bildirimi oluşturmaktan her zaman sağlayıcı sorumludur.
Navigation SDK'sı getForegroundServiceManager() yöntemi, ön plan hizmet yöneticisi tekil nesnesi döndürür. Henüz oluşturmadıysanız notificationId, defaultMessage ve resumeIntent için null parametreleriyle initForegroundServiceManagerMessageAndIntent() çağrılmasına eşdeğerdir.
ForegroundServiceManager için üç basit yöntem vardır. İlk ikisi, bir hizmeti ön plana taşımak ve ön plandan çıkarmak içindir ve genellikle oluşturulan hizmetten çağrılır. Bu yöntemleri kullanmak, hizmetlerin paylaşılan kalıcı bildirimle ilişkilendirilmesini sağlar. Son yöntem olan updateNotification(), yöneticiye bildirimin değiştiğini ve yeniden oluşturulması gerektiğini işaretler.
Paylaşılan kalıcı bildirim üzerinde tam kontrole ihtiyacınız varsa API, bildirim sağlayıcıyı tanımlamak için bir NotificationContentProvider arayüzü sağlar. Bu arayüzde, mevcut içeriği içeren bir bildirim almak için tek bir yöntem bulunur. Ayrıca, sağlayıcıyı tanımlamaya yardımcı olmak için isteğe bağlı olarak kullanabileceğiniz bir temel sınıf da sağlar. Temel sınıfın temel amaçlarından biri, ForegroundServiceManager'a erişmek zorunda kalmadan updateNotification()'ü çağırma yöntemi sunmasıdır. Yeni bildirim mesajları almak için bildirim sağlayıcısının bir örneğini kullanıyorsanız mesajı bildirimde oluşturmak için doğrudan bu dahili yöntemi çağırabilirsiniz.
Kullanım senaryoları
Bu bölümde, paylaşılan kalıcı bildirimlerin kullanım senaryoları ayrıntılı olarak açıklanmıştır.
- Diğer uygulama ön plan hizmetlerinin kalıcı bildirimlerini gizleme
- En kolay senaryo, mevcut davranışı korumak ve yalnızca Navigation SDK bilgilerini oluşturmak için kalıcı bildirimi kullanmaktır. Diğer hizmetler, ön plan hizmet yöneticisi
startForeground()vestopForeground()yöntemlerini kullanarak bu bildirimin arkasına gizlenebilir. - Diğer uygulama ön plan hizmetlerinin kalıcı bildirimlerini gizleyin ancak gezinme
- İkinci en kolay senaryo, mevcut davranışı korumak ve sistem gezinmediğinde hariç olmak üzere yalnızca Navigation SDK bilgilerini oluşturmak için kalıcı bildirimi kullanmaktır. Sistem gezinmediğinde, "Google Haritalar"dan bahseden varsayılan Navigation SDK dizesi yerine
initForegroundServiceManagerMessageAndIntent()için sağlanan dize gösterilir. Bildirim tıklandığında tetiklenen devam ettirme intent'ini ayarlamak için de bu çağrıyı kullanabilirsiniz. - Kalıcı bildirimin oluşturulmasını tam olarak kontrol etme
- Son senaryoda, bir bildirim sağlayıcı tanımlayıp oluşturmak ve
initForegroundServiceManagerProvider()kullanarakForegroundServiceManager'e iletmeniz gerekir. Bu seçenek, bildirimde nelerin oluşturulacağı konusunda tam kontrol sahibi olmanızı sağlar ancak aynı zamanda Navigasyon SDK'sı bildirim bilgilerinin bildirimle bağlantısını keserek bildirimde gösterilen faydalı adım adım talimatları kaldırır. Google, bu bilgileri almak ve bildirime eklemek için basit bir yöntem sunmaz.
Örnek bildirim sağlayıcı
Aşağıdaki kod örneğinde, basit bir bildirim içerik sağlayıcısı kullanılarak bildirimlerin nasıl oluşturulacağı ve döndürüleceği gösterilmektedir.
public class NotificationContentProviderImpl
extends NotificationContentProviderBase
implements NotificationContentProvider {
private String channelId;
private Context context;
private String message;
/** Constructor */
public NotificationContentProviderImpl(Application application) {
super(application);
message = "-- uninitialized --";
channelId = null;
this.context = application;
}
/**
* Sets message to display in the notification. Calls updateNotification
* to display the message immediately.
*
* @param msg The message to display in the notification.
*/
public void setMessage(String msg) {
message = msg;
updateNotification();
}
/**
* Returns the notification as it should be rendered.
*/
@Override
public Notification getNotification() {
Notification notification;
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
Spanned styledText = Html.fromHtml(message, FROM_HTML_MODE_LEGACY);
String channelId = getChannelId(context);
notification =
new Notification.Builder(context, channelId)
.setContentTitle("Notifications Demo")
.setStyle(new Notification.BigTextStyle()
.bigText(styledText))
.setSmallIcon(R.drawable.ic_navigation_white_24dp)
.setTicker("ticker text")
.build();
} else {
notification = new Notification.Builder(context)
.setContentTitle("Notification Demo")
.setContentText("testing non-O text")
.build();
}
return notification;
}
// Helper to set up a channel ID.
private String getChannelId(Context context) {
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
if (channelId == null) {
NotificationManager notificationManager =
(NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
NotificationChannel channel = new NotificationChannel(
"default", "navigation", NotificationManager.IMPORTANCE_DEFAULT);
channel.setDescription("For navigation persistent notification.");
notificationManager.createNotificationChannel(channel);
channelId = channel.getId();
}
return channelId;
} else {
return "";
}
}
}
NotificationContentProviderImpl'yi oluşturduktan sonra aşağıdaki kodu kullanarak Navigation SDK'sını bağlarsınız:
ForegroundServiceManager f = NavigationApi.getForegroundServiceManager(getApplication());
mNotification = new NotificationContentProviderImpl(getApplication());
NavigationApi.clearForegroundServiceManager();
NavigationApi.initForegroundServiceManagerProvider(getApplication(), null, mNotification);
Uyarılar ve gelecek planları
- Beklenen kullanım senaryosunun iyi tanımlanması için
initForegroundServiceManagerMessageAndIntent()veyainitForegroundServiceManagerProvider()'ü erkenden aradığınızdan emin olun. Yeni bir Navigator oluşturmadan önce bu yöntemi çağırmanız gerekir. - Kod yolunun birden fazla kez girilmesi ihtimaline karşı
initForegroundServiceManagerMessageAndIntent()veyainitForegroundServiceManagerProvider()çağrılarından gelen istisnaları yakaladığınızdan emin olun. Navigation SDK v2.0'da bu yöntemin birden çok kez çağrılması, çalışma zamanında istisna yerine kontrollü istisna oluşturur. - Google'ın, bildirimin kullanım süresi boyunca başlık stiliyle eşleşen tutarlı bir stil elde etmek için yapması gereken çalışmalar olabilir.
- Bir bildirim sağlayıcı tanımlarken öncelikle bilgi dokümanı davranışını kontrol edebilirsiniz.
- Google, bir bildirim sağlayıcının bildirime ekleyebileceği adım adım yol bilgisini almak için basit bir yöntem sağlamaz.