פתרון בעיות בשירותים שפועלים בחזית

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

במסמך הזה מפורטות הבעיות הבאות:

לפני שמתחילים לפתור את הבעיה

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

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

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

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

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

שגיאות מסוג "האפליקציה לא מגיבה" (ANR)

בנסיבות מסוימות, האפליקציה אמורה לסגור את השירות שפועל בחזית. אם האפליקציה לא עוצרת את השירות, המערכת עוצרת אותו ומפעילה שגיאת האפליקציה לא מגיבה (ANR).

שירות קצר פועל יותר מדי זמן וגורם ל-ANR

שירותים שפועלים בחזית מסוג שירות קצר צריכים להסתיים במהירות, תוך כשלוש דקות. כשהזמן נגמר, המערכת קוראת ל-method‏ Service.onTimeout(int,int) של השירות. לשירות יש כמה שניות לקרוא ל-stopSelf(). אם השירות לא מפסיק את עצמו, המערכת מפעילה שגיאת "האפליקציה לא מגיבה".

אבחון:

אם שגיאת ה-ANR נגרמה בגלל שירות שפועל בחזית ולא הצליח לעצור את עצמו, המערכת תציג חריגה פנימית. כדי לוודא שזו הבעיה, אפשר לבדוק את דוחות ה-ANR. אם זו הבעיה, הדוח יכלול את ההודעה הבאה:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type FOREGROUND_SERVICE_TYPE_SHORT_SERVICE did not stop within its timeout:
[component name]"

הפתרון:

חשוב לוודא שכל השירותים שפועלים בחזית ומוגבלים בזמן מסיימים את העבודה שלהם וקוראים ל-stopForeground(int) במסגרת מגבלת הזמן של המערכת.

השירותים שפועלים בחזית צריכים להטמיע את Service.onTimeout(int,int). חשוב לוודא שההטמעה של ה-method הזו מפעילה את stopSelf() באופן מיידי.

חריגים לשירותים שפועלים בחזית

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

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

חריגה פנימית: חריגה מהזמן הקצוב

המערכת מגבילה את משך הזמן שבו שירותים שפועלים בחזית לסנכרון נתונים ולעיבוד מדיה יכולים לפעול כשהאפליקציה ברקע. אם השירות חורג מהמגבלה הזו, המערכת קוראת ל-method‏ Service.onTimeout(int,int) של השירות. לשירות יש כמה שניות להפעיל את stopSelf(). אם השירות לא מפסיק את עצמו, המערכת יוצרת RemoteServiceException פנימי שגורם לאפליקציה לקרוס.

אבחון:

כדי לגלות מה היה החריג, אפשר לעיין בדוח הקריסות. אפשר גם לבדוק ב-Logcat כדי לקבל מידע מפורט יותר על השגיאה. במקרה כזה, הודעת השגיאה הבאה מופיעה ב-Logcat:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type [service type] did not stop within its timeout: [component name]"

הפתרון:

חשוב לוודא שכל השירותים שפועלים בחזית ומוגבלים בזמן מסיימים את העבודה שלהם וקוראים ל-stopForeground(int) במסגרת מגבלת הזמן של המערכת.

השירותים שפועלים בחזית צריכים להטמיע את Service.onTimeout(int,int). חשוב לוודא שההטמעה של ה-method הזו מפעילה את stopSelf() באופן מיידי.

חריגה פנימית: ForegroundServiceDidNotStartInTimeException

כשמפעילים שירות באמצעות קריאה ל-context.startForegroundService(), לשירות הזה יש כמה שניות לקדם את עצמו לשירות שפועל בחזית באמצעות קריאה ל-ServiceCompat.startForeground(). אם השירות לא עושה זאת, הוא מחזיר שגיאה פנימית מסוג ForegroundServiceDidNotStartInTimeException.

אבחון:

כדי לגלות מה היה החריג, אפשר לעיין בדוח הקריסות. אפשר גם לבדוק ב-Logcat כדי לקבל מידע מפורט יותר על השגיאה. במקרה כזה, הודעת השגיאה הבאה מופיעה ב-Logcat:

android.app.RemoteServiceException$ForegroundServiceDidNotStartInTimeException:
Context.startForegroundService() did not then call Service.startForeground()

הפתרון:

חשוב לוודא שכל השירותים החדשים שפועלים בחזית קוראים ל-ServiceCompat.startForeground() תוך כמה שניות.

WorkManager:

יכול להיות שתראו את החריגה הזו גם עם קורוטינות WorkManager שמפעילות שירות בחזית (קוראות ל-setForegound או ל-setForegroundAsync). כשמחזור החיים של שתי קורוטינות בחזית חופף, כי קורוטינה אחת מנסה להפעיל שירות בחזית בזמן ששירות בחזית שהופעל קודם מנסה להיסגר, הקריסה הזו תלווה ביומן הבא:

Re-initializing SystemForegroundService after a request to shut-down

תיקון לקריסה הזו נוסף ב-WorkManager גרסה 2.10.5.

אם האפליקציה נתקלת בחריגה הזו, צריך לעדכן לגרסה העדכנית ביותר של WorkManager ולדווח על בעיות מתמשכות בIssue Tracker של WorkManager.

ForegroundServiceStartNotAllowedException

שגיאה:

המערכת מחזירה את השגיאה ForegroundServiceStartNotAllowedException.

הסיבה:

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

החל מ-Android 12 (רמת API‏ 31), אפליקציות לא יכולות להפעיל שירותים בחזית כשהן פועלות ברקע, למעט כמה מקרים חריגים ספציפיים. אם תנסו להפעיל מהרקע שירות שפועל בחזית, ולא תעמדו בדרישות של אחד מהפטורים, המערכת תציג את השגיאה ForegroundServiceStartNotAllowedException. המערכת תעשה את זה גם אם אתם לא עומדים בדרישות לקבלת הפטור.

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

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

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

הפתרון:

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

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

SecurityException

שגיאה:

המערכת מציגה את השגיאה SecurityException.

הסיבה:

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

  • אם האפליקציה מטרגטת ל-Android 9 (רמת API 28) ומעלה, צריכה להיות לה ההרשאה FOREGROUND_SERVICE כדי להפעיל שירות שפועל בחזית.
  • אם האפליקציה מטרגטת את Android 14 (רמת API ‏34) ומעלה, היא צריכה לעמוד בכל הדרישות המוקדמות של סוג השירות שפועל בחזית. הדרישות המוקדמות האלה מפורטות במסמכי התיעוד של סוגי השירותים שפועלים בחזית. חשוב לשים לב במיוחד לדרישות הבאות:
    • כמה סוגים של שירותים שפועלים בחזית דורשים הרשאות ספציפיות בתחילת ההפעלה. לדוגמה, שירות שפועל בחזית להעברת הודעות מרחוק חייב לכלול את ההרשאה FOREGROUND_SERVICE_REMOTE_MESSAGING.
  • במקרים מסוימים, יש הגבלות נוספות על הרשאות שנדרשות לסוגים מסוימים של שירותים שפועלים בחזית בזמן השימוש. ההרשאות האלה ניתנות לאפליקציה רק כשהיא פועלת בחזית (עם כמה חריגים ספציפיים). כלומר, גם אם האפליקציה ביקשה וקיבלה את אחת מההרשאות האלה, אם היא תנסה להפעיל את השירות שפועל בחזית בזמן שהיא פועלת ברקע, המערכת תציג את השגיאה SecurityException, גם אם לאפליקציה יש פטור שמאפשר לה להפעיל שירות שפועל בחזית מהרקע. מידע נוסף זמין במאמר הגבלות על הפעלת שירותים שפועלים בחזית ודורשים הרשאות בזמן השימוש.
    • יכול להיות שתקבלו SecurityException אם ביקשתם את ההרשאות הנדרשות, אבל הפעלתם את השירות שפועל בחזית לפני שווידאתם שההרשאות הנדרשות ניתנו.

הפתרון:

לפני שמפעילים את השירות שפועל בחזית, צריך לבקש את כל ההרשאות המתאימות לשירות שפועל בחזית, ולוודא שעומדים בכל שאר הדרישות המוקדמות של זמן הריצה.