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

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

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

רכיבים

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

‫Navigation SDK מכיל שיטות סטטיות לאתחול ולקבלת 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 מוגדר, הספק תמיד אחראי ליצירת ההתראה שתוצג.

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

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

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

תרחישי שימוש

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

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

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

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

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

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

בתרחיש האחרון צריך להגדיר וליצור ספק התראות ולהעביר אותו אל 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() בשלב מוקדם כדי להגדיר היטב את תרחיש השימוש הצפוי. צריך להפעיל את ה-method הזו לפני שיוצרים Navigator חדש.
• חשוב לטפל בחריגים מקריאות ל-initForegroundServiceManagerMessageAndIntent() או ל-initForegroundServiceManagerProvider() למקרה שנתיב הקוד מוזן יותר מפעם אחת. ב-Navigation SDK גרסה 2.0, קריאה לשיטה הזו מספר פעמים מציגה חריגה מסומנת ולא חריגה בזמן ריצה.
• יכול להיות ש-Google עדיין צריכה לבצע פעולות כדי להשיג סגנון עקבי לאורך כל משך החיים של ההתראה, שיתאים לסגנון הכותרת.
• כשמגדירים ספק התראות, אפשר לשלוט בהתנהגות של ההתראות הקופצות באמצעות העדיפות.
• ‫Google לא מספקת אמצעי פשוט לאחזור מידע מפורט על הנחיות הגעה, שספק התראות יכול להוסיף להתראה.