Android API düzeyi 26'dan itibaren ön plan hizmetleri için kalıcı bildirimler gereklidir. Bu gereksinimin amacı, özellikle pil dahil olmak üzere sistem kaynakları üzerinde aşırı talep oluşturabilecek hizmetleri gizlemenizi önlemektir. Bu gereklilik potansiyel bir sorun yaratır: Birden fazla ön plan hizmeti olan bir uygulama, bildirimi tüm hizmetlerde paylaşılacak şekilde dikkatlice yönetmezse bu durumda birden fazla kalıcı ve kapatılamayan bildirim olacaktır. Bu durum da etkin bildirim listesinde istenmeyen karışıklıklara yol açar.
Uygulamadan bağımsız ön plan hizmetlerini çalıştıran, kendi bağımsız kalıcı bildirimleri olabilen ve birleştirmeyi zorlaştıran {7}SDK gibi SDK'lar kullandığınızda bu sorun daha zor hale gelir.
Bu sorunları çözmek için Navigation SDK v1.11, SDK içindekiler de dahil olmak üzere uygulama genelinde kalıcı bildirimlerin yönetilmesine yardımcı olacak basit bir API'yi kullanıma sundu.
Bileşenler
Ön plan hizmet yöneticisi, Android ön plan hizmet sınıfı ve kalıcı bildirim sınıfı için bir sarmalayıcı sağlar. Bu sarmalayıcının ana işlevi, bildirim kimliğinin yönetici kullanılarak tüm ön plan hizmetlerinde paylaşılabilmesi için Bildirim Kimliğinin yeniden kullanılmasını zorunlu kılmaktır.
Gezinme API'si, ForegroundServiceManager
tekilleştirmesini başlatmak ve almak için statik yöntemler içerir. Bu tekil değişken, Navigasyon SDK'sının kullanım süresi içinde yalnızca bir kez başlatılabilir. Sonuç olarak, başlatma çağrılarından (initForegroundServiceManagerMessageAndIntent()
veya initForegroundServiceManagerProvider()
) birini kullanırsanız bu yolun yeniden girilmesi olasılığına karşı bir dene-yakala bloku ile çevrelemeniz gerekir. Tüm ForegroundServiceManager
başvurularını temizlemediğiniz ve sonraki her çağrıdan önce clearForegroundServiceManager()
çağrısı yapmadığınız sürece, uyumsuzluk sorunlarını önlemek için iki yöntemden herhangi birini birden fazla kez çağırırsanız gezinme SDK'sı bir çalışma zamanı istisnası atar. Gezinme SDK'sının 2.0 sürümünde, bu amaç için API'ye işaretli bir istisna eklenir.
initForegroundServiceManagerMessageAndIntent()
öğesinin dört parametresi application
, notificationId
, defaultMessage
ve resumeIntent
'dir. Son üç parametre boşsa bildirim, standart Gezinme SDK'sı bildirimidir. Bu bildirimin arkasında, uygulamadaki diğer ön plan hizmetlerini gizlemeye devam edebilirsiniz. notificationId
parametresi, bildirim için kullanılması gereken bildirim kimliğini belirtir. Boş ise rastgele bir değer kullanılır. Başka bir SDK'dan gelen bildirimler gibi diğer bildirimlerle çakışmalara çözüm olarak bu ayarı açıkça belirtebilirsiniz. defaultMessage
, sistem gezinmediğinde görüntülenen bir dizedir. resumeIntent
, bildirim tıklandığında tetiklenen bir amaçtır. resumeIntent
null ise bildirimin tıklanması yoksayılır.
initForegroundServiceManagerProvider()
öğesinin üç parametresi application
, notificationId
ve notificationProvider
şeklindedir. Son iki parametre boşsa bildirim, standart Gezinme SDK'sı bildirimi olur. notificationId
parametresi, bildirim için kullanılması gereken bildirim kimliğini belirtir. Boş ise rastgele bir değer kullanılır. Başka bir SDK'dan gelen bildirimler gibi diğer bildirimlerle çakışmalara çözüm olarak bu ayarı açıkça belirtebilirsiniz. notificationProvider
ayarlanırsa oluşturulacak bildirimin oluşturulmasından, her zaman sağlayıcı sorumludur.
Gezinme SDK'sının getForegroundServiceManager()
yöntemi, ön plan hizmet yöneticisi tekilini döndürür. Henüz bir parametre oluşturmadıysanız bu işlem, notificationId
, defaultMessage
ve resumeIntent
için boş parametrelerle initForegroundServiceManagerMessageAndIntent()
çağırmaya eş değerdir.
ForegroundServiceManager
, üç basit yönteme sahiptir. İlk ikisi bir hizmeti ön plana taşımak ve ön plandan taşımak içindir ve genellikle oluşturulan hizmet içinden çağrılır. Bu yöntemlerin kullanılması, hizmetlerin paylaşılan kalıcı bildirimle ilişkilendirilmesini sağlar. Son yöntem olan updateNotification()
, bildirimin değiştiğini ve yeniden oluşturulması gerektiğini bildirerek yöneticiyi işaretler.
Paylaşılan kalıcı bildirimin içeriği üzerinde tam kontrol sahibi olmak istiyorsanız yeni API, bildirim sağlayıcı tanımlamak için geçerli içerikle ilgili bildirim almak için tek bir yöntem içeren NotificationContentProvider
arayüzü sunar. Ayrıca, sağlayıcıyı tanımlamanıza yardımcı olması 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
erişimine gerek kalmadan updateNotification()
kolayca çağrılabilmesidir. Yeni bildirim mesajlarını almak için bildirim sağlayıcının bir örneğini kullanıyorsanız bu yardımcı yöntem kullanışlı olabilir. Bu durumda, bildirimdeki mesajı 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ıyla ilgili kullanım senaryoları açıklanmaktadır.
- Diğer uygulama ön plan hizmetlerinin kalıcı bildirimlerini gizle
- En kolay senaryo, mevcut davranışı korumak ve Navigation SDK bilgilerini oluşturmak için yalnızca 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 gizle, ancak gezinme sırasında gösterilen varsayılan metni ayarla
- İkinci en kolay senaryo, mevcut davranışı korumak ve sistemin gezinmediği durumlar haricinde, yalnızca Gezinme SDK'si bilgilerini oluşturmak için kalıcı bildirimi kullanmaktır. Sistem gezinmediğinde, "Google Haritalar" ifadesini içeren varsayılan Navigasyon SDK'sı dizesi yerine
initForegroundServiceManagerMessageAndIntent()
için sağlanan dize görüntülenir. Bu çağrı, bildirim tıklandığında etkinleşecek bir devam ettirme niyetini ayarlamak için de kullanılabilir. - Kalıcı bildirimin oluşturulması üzerinde tam kontrol sahibi olun
- Son senaryo, bir bildirim sağlayıcı tanımlayıp oluşturmayı ve
initForegroundServiceManagerProvider()
aracılığıyla ForegroundServiceManager'a iletmeyi gerektirir. Bu seçenek size bildirimde ne oluşturulacağına ilişkin tam kontrol sağlar, ancak aynı zamanda Navigation SDK bildirim bilgilerinin bildirimle olan bağlantısını da keserek bildirimde gösterilen yararlı adım adım istemleri kaldırır. Google, henüz bu bilgilerin alınması ve bildirime eklenmesi için basit bir yöntem sağlamamaktadır.
Örnek bildirim sağlayıcı
Aşağıdaki kod örneğinde, basit bir bildirim içeriği sağlayıcısı kullanarak 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 "";
}
}
}
Uyarılar ve gelecek planları
- Beklenen kullanım senaryosunun iyi tanımlanması için
initForegroundServiceManagerMessageAndIntent()
veyainitForegroundServiceManagerProvider()
yöntemini erkenden çağırdığınızdan emin olun. Yeni bir Gezgin oluşturmadan önce bu yöntemi çağırmalısınız. - Kod yolu birden fazla kez girilirse
initForegroundServiceManagerMessageAndIntent()
veyainitForegroundServiceManagerProvider()
çağrılarına yönelik istisnaları yakaladığınızdan emin olun. Gezinme SDK'sı 2.0 sürümünde, bu yöntemin birden çok kez çağrılması, çalışma zamanı istisnası yerine işaretli istisna döndürür. - Bildirimin kullanım süresi boyunca, başlık stiliyle eşleşen stilin tutarlı olması için Google'ın üzerinde çalışmalar olabilir.
- Bir bildirim sağlayıcı tanımladığınızda, uyarı davranışını öncelik sırasına göre kontrol edebilirsiniz.
- Google, bir bildirim sağlayıcısının bildirime ekleyebileceği adım adım bilgileri almak için henüz basit bir yöntem sağlamamaktadır.