איחוד התראות בנייד

החל מרמת API‏ 26 של Android, נדרש שימוש בהתראות קבועות לשירותים שפועלים בחזית. הדרישה הזו נועדה למנוע מכם להסתיר שירותים שעשויים להפעיל לחץ יתר על משאבי המערכת, כולל הסוללה בפרט. הדרישה הזו יוצרת בעיה פוטנציאלית: אם אפליקציה עם כמה שירותים בחזית לא מנהלת בקפידה את ההתראה כך שתשותף בין כל השירותים, יכולות להיות כמה התראות עיקשות שלא ניתן לסגור, וכתוצאה מכך רשימת ההתראות הפעילה תהיה עמוסה.

הבעיה הזו נעשית קשה יותר כשמשתמשים ב-SDKs כמו Navigation SDK, שמפעילים שירותים שפועלים בחזית ללא קשר לאפליקציה, שיש להם התראות קבועות משלהם, ולכן קשה לאחד אותם. כדי לטפל בבעיות האלה, הוספנו ל-Navigation SDK v1.11 ממשק API פשוט שעוזר לנהל התראות קבועות באפליקציה, כולל ב-SDK.

רכיבים

מנהל השירותים שפועלים בחזית מספק מעטפת סביב הכיתה של השירותים שפועלים בחזית ב-Android והכיתה של ההתראות הקבועות. הפונקציה העיקרית של המעטפת הזו היא לאכוף שימוש חוזר במזהה ההתראה, כדי שההתראה תשותף בין כל שירותי החזית באמצעות המנהל.

‏Navigation SDK מכיל שיטות סטטיות להפעלה ולקבלה של ה-singleton‏ ForegroundServiceManager. אפשר לאתחל את ה-Singleton הזה רק פעם אחת במהלך החיים של Navigation SDK. לכן, אם משתמשים באחת מהקריאות לטעינה (initForegroundServiceManagerMessageAndIntent() או initForegroundServiceManagerProvider()), צריך להקיף אותה בבלוק try-catch למקרה שהנתיב הזה ייכנס שוב. אם תפעילו כל אחת מהשיטות יותר מפעם אחת, מערכת Navigation SDK תשליך חריגת זמן ריצה, אלא אם תמחקו קודם את כל ההפניות ל-ForegroundServiceManager ותפעילו את clearForegroundServiceManager() לפני כל קריאה נוספת.

ארבעת הפרמטרים של initForegroundServiceManagerMessageAndIntent() הם application,‏ notificationId,‏ defaultMessage ו-resumeIntent. אם שלושת הפרמטרים האחרונים הם null, ההתראה תהיה ההתראה הרגילה של Navigation SDK. עדיין אפשר להסתיר שירותים אחרים בחזית האפליקציה מאחורי ההתראה הזו. הפרמטר notificationId מציין את מזהה ההתראה שצריך להשתמש בו בהתראה. אם הוא 'null', המערכת תשתמש בערך שרירותי. אפשר להגדיר אותו באופן מפורש כדי לעקוף התנגשויות עם התראות אחרות, כמו התראות מ-SDK אחר. הערך defaultMessage הוא מחרוזת שמוצגת כשהמערכת לא מנווטת. resumeIntent הוא כוונה שמופיעה כשלוחצים על ההתראה. אם הערך של resumeIntent הוא null, המערכת תתעלם מהקליקים על ההתראה.

שלושת הפרמטרים של initForegroundServiceManagerProvider() הם application,‏ notificationId ו-notificationProvider. אם שני הפרמטרים האחרונים הם null, ההתראה היא ההתראה הרגילה של Navigation SDK. הפרמטר notificationId מציין את מזהה ההתראה שצריך להשתמש בו בהתראה. אם הוא null, המערכת משתמשת בערך שרירותי. אפשר להגדיר אותו באופן מפורש כדי לעקוף התנגשויות עם התראות אחרות, כמו התראות מ-SDK אחר. אם הערך של notificationProvider מוגדר, הספק תמיד אחראי ליצירת ההתראה שצריך להציג.

השיטה getForegroundServiceManager() של Navigation SDK מחזירה את ה-singleton של מנהל השירותים בחזית. אם עדיין לא יצרתם קוד, זה שווה ערך לקריאה ל-initForegroundServiceManagerMessageAndIntent() עם פרמטרים null עבור notificationId,‏ defaultMessage ו-resumeIntent.

ל-ForegroundServiceManager יש שלוש שיטות פשוטות. שתי השיטות הראשונות משמשות להעברת שירות לחזית וליציאה ממנה, והן נקראות בדרך כלל מתוך השירות שנוצר. השימוש בשיטות האלה מבטיח שהשירותים משויכים להתראה המתמדת המשותפת. השיטה האחרונה, updateNotification(), מסמנת למנהל שהתראה השתנתה וצריכה להיגרם לה עיבוד מחדש.

אם אתם צריכים שליטה מלאה בהתראה הקבועה המשותפת, ה-API מספק ממשק NotificationContentProvider להגדרת ספק התראות, שמכיל שיטה אחת לקבלת התראה עם התוכן הנוכחי. הוא מספק גם סיווג בסיס, שאפשר להשתמש בו כדי לעזור בהגדרת הספק. אחד מהמטרות העיקריות של הכיתה הבסיסית היא לספק דרך לקרוא ל-updateNotification() בלי צורך לגשת ל-ForegroundServiceManager. אם אתם משתמשים במופע של ספק ההתראות כדי לקבל הודעות התראה חדשות, תוכלו להפעיל את השיטה הפנימית הזו ישירות כדי להציג את ההודעה בהתראה.

תרחישי שימוש

בקטע הזה מפורטים תרחישים לדוגמה לשימוש בהתראות קבועות משותפות.

הסתרת התראות קבועות של שירותים אחרים בחזית האפליקציה

התרחיש הפשוט ביותר הוא לשמור על ההתנהגות הנוכחית ולהשתמש בהתראה הקבועה רק להצגת המידע של Navigation SDK. שירותים אחרים יכולים להסתתר מאחורי ההתראה הזו באמצעות השיטות startForeground() ו-stopForeground() של מנהל השירותים שפועלים בחזית.

להסתיר התראות קבועות של שירותים אחרים שפועלים בחזית של אפליקציות, אבל להגדיר טקסט ברירת מחדל שיוצג כשלא מנווטים

התרחיש השני הכי קל הוא לשמור על ההתנהגות הנוכחית, ולהשתמש בהתראה הקבועה רק כדי להציג מידע מ-Navigation SDK, מלבד במקרים שבהם המערכת לא מנווטת. כשהמערכת לא מנווטת, מופיעה המחרוזת שצוינה ב-initForegroundServiceManagerMessageAndIntent() במקום המחרוזת שמוגדרת כברירת מחדל ב-Navigation SDK ומזכירה את 'מפות Google'. אפשר גם להשתמש בקריאה הזו כדי להגדיר את הכוונה להמשך, שתופעל כשלוחצים על ההתראה.

שליטה מלאה על העיבוד של ההתראה הקבועה

בתרחיש הסופי צריך להגדיר וליצור ספק התראות ולהעביר אותו ל-ForegroundServiceManager באמצעות initForegroundServiceManagerProvider(). האפשרות הזו מעניקה לכם שליטה מלאה על מה שמוצג בהתראה, אבל היא גם מנתקת את פרטי ההתראה של Navigation SDK מהתראה, וכך מסירה את ההנחיות המועילות של הניווט ממסלול ל-מסלול שמוצגות בהתראה. Google לא מספקת דרך פשוטה לאחזר את המידע הזה ולהוסיף אותו להתראה.

דוגמה לספק התראות

בדוגמת הקוד הבאה מוסבר איך ליצור התראות ולהחזיר אותן באמצעות ספק תוכן פשוט של התראות.

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, מחברים אליו את Navigation SDK באמצעות הקוד הבא:

ForegroundServiceManager f = NavigationApi.getForegroundServiceManager(getApplication());
mNotification = new NotificationContentProviderImpl(getApplication());
NavigationApi.clearForegroundServiceManager();
NavigationApi.initForegroundServiceManagerProvider(getApplication(), null, mNotification);

אזהרות ותוכניות עתידיות

• חשוב להפעיל את initForegroundServiceManagerMessageAndIntent() או initForegroundServiceManagerProvider() בשלב מוקדם כדי שהתרחיש הצפוי לשימוש יהיה מוגדר היטב. צריך להפעיל את השיטה הזו לפני שיוצרים Navigator חדש.
• חשוב לתפוס חריגות מהקריאות ל-initForegroundServiceManagerMessageAndIntent() או ל-initForegroundServiceManagerProvider() למקרה שנתיב הקוד מזין יותר מפעם אחת. ב-Navigation SDK v2.0, קריאה לשיטה הזו כמה פעמים מפעילה חריג מאומת במקום חריג בסביבת זמן הריצה.
• יכול להיות ש-Google עדיין צריכה לעבוד על סגנון עקבי לכל משך החיים של ההתראה, שיהיה תואם לסגנון הכותרת.
• כשמגדירים ספק התראות, אפשר לקבוע את העדיפות כדי לשלוט בהתנהגות של ההתראות.
• Google לא מספקת דרך פשוטה לאחזור מידע על מסלול מפורט שספק ההתראות עשוי להוסיף להתרעה.