לעמוד בדרישה לגבי רמת ה-API לטירגוט של Google Play

מעבר מגרסה ישנה יותר מ-Android 11 (רמת API‏ 30)

בוחרים את גרסת Android שממנה יתבצע המעבר:

העברה ל-Android 5 (רמת API 21)

כדי לוודא שהאפליקציה שלכם מביאה בחשבון את השינויים שהוצגו במהדורות הבאות, כדאי לעיין בדף Behavior Changes (שינויים בהתנהגות) המתאים לכל אחת מהמהדורות הבאות:

• Android 5.0 (רמת API 21)
• Android 4.4 (רמת API 19).
• Android 4.1.x (רמת API 16).

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

מעבר ל-Android 6 (רמת API ‏23)

השיקולים הבאים רלוונטיים לאפליקציות שמטרגטות את הפלטפורמה בגרסה Android 6.0 ואילך:

• הרשאות בזמן ריצה

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

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

רשימה מקיפה של השינויים שהוצגו ב-Android 6.0 (רמת API ‏23) מפורטת בדף שינויים בהתנהגות לגרסה הזו של הפלטפורמה.

ממשיכים לפי ההוראות שבקטע הבא.

העברה ל-Android 7 (רמת API 24)

השיקולים הבאים חלים על אפליקציות שמטרגטות את Android 7.0 ואילך של הפלטפורמה:

• מצב 'נמנום' ו'אפליקציה במצב המתנה'

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

  כשהמכשיר במצב 'נמנום' ו'מצב המתנה של אפליקציה', המערכת פועלת באופן הבא:

  • הגבלת הגישה לרשת
  • דחייה של התראות, סנכרון ומשימות
  • הגבלת סריקות GPS ו-Wi-Fi
  • הגבלת הודעות Firebase Cloud Messaging ברמת עדיפות רגילה.

• שינויים בהרשאות

  • המערכת מגבילה את הגישה לספריות פרטיות של אפליקציות.
  • חשיפת URI של file:// מחוץ לאפליקציה מפעילה FileUriExposedException. אם צריך לשתף קבצים עם גורמים מחוץ לאפליקציה, צריך להטמיע את FileProvider

• המערכת אוסרת על קישור לספריות שאינן NDK.

לרשימה המלאה של השינויים שהושקו ב-Android 7.0 (רמת API 24), ראו את הדף שינויים בהתנהגות של גרסת הפלטפורמה הזו.

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

מעבר ל-Android 8 (רמת API 26)

השיקולים הבאים רלוונטיים לאפליקציות שמטרגטות את הפלטפורמה בגרסה 8.0 ואילך של Android:

• מגבלות ביצוע ברקע
  • המערכת מגבילה את השירותים של אפליקציות שלא פועלות בחזית.
    • startService() מקפיץ עכשיו הודעת שגיאה כשאפליקציה מנסה להפעיל אותו בזמן ש-startService() אסור.
    • כדי להפעיל שירותים שפועלים בחזית, האפליקציה צריכה להשתמש ב- startForeground() וב- startForegroundService().
    • חשוב לקרוא בעיון את השינויים שבוצעו ב-JobScheduler API, כפי שמתואר בדף Behavior Changes ב-Android 8.0‏ (רמת API 26).
    • כדי להשתמש ב- Firebase Cloud Messaging, צריך גרסה 10.2.1 של Google Play services SDK ואילך.
    • כשמשתמשים ב- Firebase Cloud Messaging, שליחת ההודעות כפופה למגבלות על ביצוע פעולות ברקע. כאשר נדרשת עבודת רקע בזמן קבלת ההודעה, למשל כדי לבצע סנכרון של נתוני רקע, האפליקציה צריכה לתזמן משימות באמצעות Firebase Job Dispatcher או JobIntentService. מידע נוסף זמין ב מסמכי התיעוד של Firebase Cloud Messaging.
  • שידורים מרומזים
    • קיימות הגבלות על שידור מרומז. מידע על טיפול באירועים ברקע זמין במסמכי התיעוד של ה-API JobScheduler.
  • הגבלות על מיקום ברקע
    • לאפליקציות שפועלות ברקע יש גישה מוגבלת לנתוני מיקום.
      • במכשירים עם Google Play Services, אפשר להשתמש ב ספק המיקום המשולב כדי לקבל עדכוני מיקום מדי פעם.
• ערוצי התראות
  • צריך להגדיר את מאפייני ההפרעה של ההתראות בנפרד לכל ערוץ.
  • כדי שההתראות יופיעו, צריך להקצות אותן לערוץ.
  • בגרסה הזו של הפלטפורמה יש תמיכה ב- NotificationCompat.Builder.
• פרטיות
  • ההיקף של ANDROID_ID הוא לכל מפתח לחתימת אפליקציה.

לרשימה מקיפה של השינויים שהושקו ב-Android 8.0 (רמת API 26), תוכלו לעיין בדף שינויים בהתנהגות של גרסת הפלטפורמה הזו.

מעבר מ-Android 8‏ (API 26) ל-Android 9‏ (API 28)

• ניהול צריכת חשמל
  • קטגוריות של אפליקציות במצב המתנה – הגבלות חדשות על פעילות ברקע על סמך המעורבות באפליקציה, כמו משימות מושהות, התראות ומכסות להודעות בעדיפות גבוהה
  • שיפורים במצב חיסכון בסוללה מגבירים את ההגבלות על אפליקציות במצב המתנה
• הרשאה לשימוש בשירות שפועל בחזית
  • צריך לבקש את ההרשאה הרגילה FOREGROUND_SERVICE (לא הרשאת זמן ריצה)
• שינויים בהגדרות הפרטיות
  • גישה מוגבלת לחיישני הרקע
  • הגישה ליומני השיחות הוגבלה, והיא נמצאת עכשיו בקבוצת ההרשאות CALL_LOG
  • גישה מוגבלת למספרי טלפון, שנדרשת לה הרשאה READ_CALL_LOG
  • גישה מוגבלת למידע על רשתות Wi-Fi

רשימה מקיפה של השינויים שהוצגו ב-Android 9.0 (רמת API 28) מפורטת בקטע שינויים בהתנהגות.

מעבר מ-Android 9 (רמת API 28) ל-Android 10 (רמת API 29)

• התראות עם Intent במסך מלא
  • צריך לבקש את ההרשאה הרגילה USE_FULL_SCREEN_INTENT (לא הרשאת זמן ריצה).
• תמיכה במכשירים מתקפלים ובמכשירים עם מסך גדול
  • במצב 'המשך' בו-זמנית, ניתן להגדיר כמה פעילויות בו-זמנית, אבל רק באחת מהן להתמקד בפועל.
    • השינוי הזה משפיע על ההתנהגות של onResume() ושל onPause().
    • מושג חדש של מחזור חיים של 'הפעלה מחדש של הפעילות העליונה', שאפשר לזהות אותו על ידי הרשמה ל-onTopResumedActivityChanged().
      • ניתן 'להפעיל מחדש' רק פעילות אחת.
  • כשהערך של resizeableActivity מוגדר לערך false, אפליקציות יכולות לציין גם את התג minAspectRatio שמכניס את האפליקציה לפורמט letterbox באופן אוטומטי ביחס גובה-רוחב צר יותר.
• שינויים בנושא פרטיות
  • אחסון ברמת ההיקף
    • הגישה לאחסון החיצוני מוגבלת רק לספרייה ספציפית לאפליקציה ולסוגי מדיה ספציפיים שנוצרו על ידי האפליקציה.
  • הגישה למיקום מוגבלת בזמן שהאפליקציה פועלת ברקע, נדרשת ההרשאה ACCESS_BACKGROUND_LOCATION.
  • גישה מוגבלת למזהים שלא ניתן לאפס, כמו מספר IMEI ומספר סדרתי.
  • גישה מוגבלת למידע על פעילות פיזית, כמו מספר הצעדים של המשתמש. נדרשת הרשאה ACTIVITY_RECOGNITION.
  • גישה מוגבלת לחלק מממשקי ה-API של הטלפון, ה-Bluetooth וה-Wi-Fi, שנדרשת לה הרשאה ACCESS_FINE_LOCATION.
  • גישה מוגבלת להגדרות ה-Wi-Fi
    • אפליקציות לא יכולות יותר להפעיל או להשבית את ה-Wi-Fi ישירות, וצריך לעשות זאת באמצעות לוחות ההגדרות.
    • הגבלות על התחלת חיבור לרשת Wi-Fi, שמחייבות להשתמש ב-WifiNetworkSpecifier או ב-WifiNetworkSuggestion.

מעבר מ-Android 10 (רמת API 29) ל-Android 11 (רמת API 30)

• פרטיות
  • אכיפת אחסון ברמת ההיקף : אפליקציות צריכות להשתמש במודל אחסון ברמת ההיקף, שבו קבצים ספציפיים לאפליקציה, קבצי מדיה וסוגים אחרים של קבצים נשמרים ומנוהלים במיקומים ייעודיים.
  • איפוס אוטומטי של הרשאות: אם המשתמשים לא ניהלו אינטראקציה עם אפליקציה במשך כמה חודשים, המערכת מאפסת באופן אוטומטי את ההרשאות הרגישות של האפליקציה. רוב האפליקציות לא יושפעו מכך. אם האפליקציה פועלת בעיקר ברקע בלי אינטראקציות של משתמשים, כדאי לבקש מהמשתמשים להשבית את האיפוס האוטומטי.
  • גישה למיקום ברקע: אפליקציות צריכות לבקש הרשאת מיקום בחזית וברקע בנפרד. ניתן להעניק גישה להרשאת מיקום ברקע רק בהגדרות האפליקציה, במקום בתיבת דו-שיח של הרשאה בזמן ריצה.
  • הרשאות גישה לחבילה: כשאפליקציה שולחת שאילתה לקבלת רשימת האפליקציות והשירותים המותקנות במכשיר, הרשימה המוחזרת מסוננת.
    • אם אתם משתמשים בשירותי המרת טקסט לדיבור או בשירותי זיהוי דיבור, תצטרכו להוסיף רכיבי שאילתות לשירותים לקובץ המניפסט.
• אבטחה
  • קבצים דחוסים מסוג resource.arsc כבר לא נתמכים
  • צריך עכשיו להשתמש בגרסה 2 של חתימת APK. מטעמי תאימות לאחור, המפתחים צריכים להמשיך לחתום גם באמצעות APK Signature Scheme v1.
  • הגבלה על ממשק שאינו ב-SDK. לא מומלץ להשתמש בממשקים שאינם ב-SDK באפליקציות שמטרגטות רמת API 30, כי חלק מהממשקים האלה שאינם ב-SDK חסומים עכשיו. בקישור ממשקים שאינם ב-SDK שחוסמים עכשיו ב-Android 11 מופיעה רשימה מקיפה של ממשקים שאינם ב-SDK שחוסמים עכשיו.

רשימה מקיפה של השינויים שהוצגו ב-Android 11 (רמת API ‏30) מופיעה בדף שינויים בהתנהגות.

כדי להמשיך לעדכן ל-API 31, פועלים לפי ההוראות שמפורטות בקטע הקודם.