חבילות של ספריית התמיכה

הערה: בגרסת Support Library 28.0.0, ספריות ה-android.support הארוזות הוצאו משימוש והוחלפו בספריות Jetpack בכל גרסה בנפרד, שנארזו כ-androidx. הגרסה הראשונית 1.0.0 של ספריות Jetpack מספקת תאימות ל-Support Library 28.0.0, ומהווה נקודת התחלה למעבר לחבילת androidx החדשה.

הספריות הקיימות בחבילות android.support ימשיכו לפעול, אבל הן לא יקבלו עדכונים מעבר לגרסה 28.0.0 ולא יהיו תואמות לספריות החדשות של Jetpack. ארטיפקטים היסטוריים (גרסה 27 וגרסאות קודמות, ארוזים בתור android.support) ימשיכו להיות זמינים ב-Google Maven. כל הארטיפקטים החדשים יאוחסנו בקונטיינרים מסוג androidx ויהיה צורך להעביר אותם מ-android.support ל-androidx.

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

ספריית התמיכה של Android מכילה כמה חבילות ספריות שאפשר לכלול באפליקציה. כל אחת מהספריות האלה תומכת בטווח ספציפי של גרסאות של פלטפורמת Android וקבוצת תכונות.

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

הערה: גרסת ה-SDK המינימלית לכל חבילות של ספריית התמיכה היא ברמת API 14 לפחות. לחלק מהחבילות נדרשת רמה גבוהה יותר של API, כפי שמפורט בהמשך.

ספריות תמיכה בגרסה 4

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

למידע מפורט ומלא על הכיתות והשיטות שספריות התמיכה של גרסה 4 מספקות, אפשר לעיין בחבילה android.support.v4 במסמך העזרה של ה-API.

הערה: לפני גרסה 24.2.0 של ספריית התמיכה, הייתה ספריית תמיכה יחידה בגרסה 4. הספרייה הזו חולקה למספר מודולים כדי לשפר את היעילות. כדי לשמור על תאימות לאחור, אם תוסיפו את support-v4 לסקריפט של Gradle, האפליקציה תכלול את כל המודולים של גרסה 4. עם זאת, כדי לצמצם את גודל האפליקציה, מומלץ רק לציין את המודולים הספציפיים הנחוצים לאפליקציה.

ספריית תאימות לגרסה 4

מספק חבילות תאימות למספר ממשקי API של מסגרות, כמו Context.obtainDrawable() ו-View.performAccessibilityAction().

מזהה התלות של סקריפט build של Gradle לספרייה הזו:

com.android.support:support-compat:28.0.0

ספריית core-utils בגרסה 4

מכיל מספר שיעורי שירות, כמו AsyncTaskLoader ו-PermissionChecker.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא: 

com.android.support:support-core-utils:28.0.0

ספריית ליבה-ui v4

הטמעה של מגוון רכיבים שקשורים לממשק המשתמש, כמו ViewPager,‏ NestedScrollView ו-ExploreByTouchHelper.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא: 

com.android.support:support-core-ui:28.0.0

ספריית media-compat מגרסה 4

המערכת מעבירה לאחור חלקים מהמסגרת של media, כולל MediaBrowser ו-MediaSession.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא: 

com.android.support:support-media-compat:28.0.0

ספריית קטעי קוד (fragments) בגרסה 4

הוספת תמיכה בכיווץ של ממשק משתמש ופונקציונליות עם מקטעים, וכך לאפשר לאפליקציות לספק פריסות שמתאימות בין מכשירים עם מסך קטן למכשירים עם מסך גדול. למודול הזה יש יחסי תלות ב-compat, ב-core-utils, ב-core-ui וב-media-compat.

הערה: ספריית התמיכה בגרסה 13 כוללת את המחלקה FragmentCompat. הכיתה Fragment בגרסה 4 היא כיתה עצמאית שמספקת תיקוני באגים שנוספו בגרסאות פלטפורמה מאוחרות יותר, ואילו הכיתה FragmentCompat בגרסה 13 מספקת תאימות ל-shims להטמעת המסגרת של הכיתה Fragment.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא: 

com.android.support:support-fragment:28.0.0

ספריית התמיכה Multidex

הספרייה הזו מספקת תמיכה בפיתוח אפליקציות עם כמה קובצי Dalvik Executable‏ (DEX). אפליקציות שמפנות ליותר מ-65,536 שיטות נדרשות להשתמש בהגדרות multidex. מידע נוסף על השימוש ב-multidex זמין במאמר יצירת אפליקציות עם יותר מ-64K Methods.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא: 

com.android.support:multidex:1.0.0

ספריות תמיכה גרסה 7

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

ספריית אפליקציות v7 חלק מ-Android Jetpack.

הערה: ספריית appcompat הועברה לספרייה AndroidX, שהיא רכיב של Android Jetpack. אפשר לראות את השימוש בו באפליקציית הדגמה Sunflower.

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

הערה: הספרייה הזו תלויה בספריית התמיכה בגרסה 4.

ריכזנו כאן כמה מהכיתות העיקריות שכלולות בספריית v7 של appcompat:

  • ActionBar – הקצאה של תבנית ממשק המשתמש לסרגל הפעולות. מידע נוסף על השימוש בסרגל הפעולות זמין במדריך למפתחים בנושא סרגל הפעולות.
  • AppCompatActivity – הוספת מחלקה של פעילות אפליקציה שאפשר להשתמש בה כמחלקה בסיסית לפעילויות שמשתמשות בהטמעה של סרגל הפעולות של Support Library.
  • AppCompatDialog – הוספת מחלקת תיבת דו-שיח שאפשר להשתמש בה כמחלקת בסיס לתיבות דו-שיח בנושא AppCompat.
  • ShareActionProvider – הוספת תמיכה בפעולה סטנדרטית של שיתוף (כמו שליחת אימייל או פרסום באפליקציות חברתיות) שאפשר לכלול בסרגל הפעולות.

מזהה התלות של סקריפט build של Gradle לספרייה הזו:

com.android.support:appcompat-v7:28.0.0

ספריית cardview בגרסה 7

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

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:cardview-v7:28.0.0

ספריית gridlayout בגרסה 7

אחרי שתורידו את ספריות התמיכה של Android, הספרייה הזו תוסיף תמיכה לכיתה GridLayout, שמאפשרת לסדר רכיבים של ממשק המשתמש באמצעות רשת של תאים מלבניים. למידע מפורט על ממשקי ה-API של ספריית הרשת בגרסה 7, ראו חבילת android.support.v7.widget במאמרי העזרה של ה-API.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:gridlayout-v7:28.0.0

ספריית mediarouter v7

הספרייה הזו מספקת את המחלקות MediaRouter ו-MediaRouteProvider ומחלקות מדיה קשורות שתומכות ב-Google Cast.

באופן כללי, ממשקי ה-API בספריית mediarouter בגרסה 7 מספקים אמצעים לשליטה בניתוב של ערוצי מדיה וסטרימינג מהמכשיר הנוכחי אל מסכים חיצוניים, רמקולים ומכשירי יעד אחרים. הספרייה כוללת ממשקי API לפרסום ספקי מסלולי מדיה ספציפיים לאפליקציה, לזיהוי ולבחירה של מכשירי יעד, לבדיקת סטטוס המדיה ועוד. לקבלת מידע מפורט על ממשקי ה-API של ספריית mediarouter בגרסה 7, ראו חבילת android.support.v7.media בהפניה ל-API.

מזהה התלות של סקריפט build של Gradle לספרייה הזו:

com.android.support:mediarouter-v7:28.0.0

ממשקי ה-API של ספריית mediarouter בגרסה 7, שהוצגו בגרסה 18 של Support Library, עשויים להשתנות בגרסאות מאוחרות יותר של Support Library. בשלב זה, מומלץ להשתמש בספרייה רק בהקשר של Google Cast.

ספריית פלטה בגרסה 7

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

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:palette-v7:28.0.0

ספריית v7 recyclerview

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

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:recyclerview-v7:28.0.0

ספריית התמיכה ב-Preference בגרסה 7

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

ספריית העדפה לגרסה 7 כוללת תמיכה בממשקים כמו Preference.OnPreferenceChangeListener ו-Preference.OnPreferenceClickListener, ובמחלקות כמו CheckBoxPreference ו-ListPreference.

מזהה התלות של סקריפט build של Gradle לספרייה הזו:

com.android.support:preference-v7:28.0.0

ספריית התמיכה של גרסה 8

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

ספריית v8 renderscript

הספרייה הזו מוסיפה תמיכה במסגרת החישוב RenderScript. ממשקי ה-API האלה כלולים בחבילה android.support.v8.renderscript. חשוב לדעת שהשלבים להכללת ממשקי ה-API האלה באפליקציה שונים מאוד מממשקי API אחרים של ספריות תמיכה. למידע נוסף על השימוש ב-API האלה באפליקציה, תוכלו לעיין במדריך למפתחים של RenderScript.

הערה: השימוש ב-RenderScript עם ספריית התמיכה נתמך בגרסאות build של Android Studio ו-Gradle. ספריית ה-renderscript נמצאת בתיקייה build-tools/$VERSION/renderscript/.

בדוגמה הבאה מוצגים המאפיינים של סקריפט ה-build של Gradle לספרייה הזו:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

ספריית תמיכה בגרסה 13

הספרייה הזו מוסיפה תמיכה בתבנית של ממשק המשתמש Fragment באמצעות המחלקה (FragmentCompat) ומחלקות תמיכה נוספות ב-Fragment. מידע נוסף על קטעים זמין במדריך למפתחים בנושא קטעים. למידע מפורט על ממשקי ה-API של ספריית התמיכה בגרסה 13, ראו את חבילת android.support.v13 במאמרי העזרה של ה-API.

הערה: ספריית המקטעים v4 מספקת מחלקה Fragment. הכיתה Fragment בגרסה 4 היא כיתה עצמאית שמספקת תיקוני באגים שנוספו בגרסאות פלטפורמה מאוחרות יותר, ואילו הכיתה FragmentCompat בגרסה 13 מספקת תאימות ל-shims להטמעת המסגרת של הכיתה Fragment.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:support-v13:28.0.0

ספריית התמיכה של ההעדפות בגרסה 14

החבילה android.support.v14.preference מספקת ממשקי API להוספת תמיכה בממשקי העדפות כמו PreferenceFragment.OnPreferenceStartFragmentCallback ו-PreferenceFragment.OnPreferenceStartScreenCallback, וגם מחלקות כמו MultiSelectListPreference ו-PreferenceFragment. למידע מפורט על ממשקי ה-API של ספריית Preference Support בגרסה v14, ראו את חבילת ה-preference בחומר העזר של ה-API.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:preference-v14:28.0.0

ספריית תמיכה בעדיפות v17 לטלוויזיה

החבילה android.support.v17.preference מספקת ממשקי API ליצירת ממשקי העדפות במכשירי טלוויזיה, כולל תמיכה בממשק LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener ובמחלקות כמו BaseLeanbackPreferenceFragment ו-LeanbackPreferenceFragment. למידע מפורט על ממשקי ה-API של ספריית התמיכה ב-Preference בגרסה 17, אפשר לעיין בחבילה preference במסמך העזרה של ה-API.

החבילה הזו דורשת רמת API 17 ומעלה. מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

 com.android.support:preference-leanback-v17:28.0.0

ספריית Leanback בגרסה 17

החבילה android.support.v17.leanback מספקת ממשקי API לתמיכה בפיתוח ממשקי משתמש במכשירי טלוויזיה. הוא מספק כמה ווידג'טים חשובים לאפליקציות לטלוויזיה. חלק מהשיעורים הבולטים הם:

החבילה הזו דורשת רמת API 17 ומעלה. מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:leanback-v17:28.0.0

ספרייה עם גרפיקה וקטורית

תמיכה בגרפיקה וקטורית סטטית.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:support-vector-drawable:28.0.0

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

תמיכה בגרפיקה וקטורית מונפשת.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:animated-vector-drawable:28.0.0

ספריית התמיכה בהערות

החבילה Annotation מספקת ממשקי API שתומכים בהוספת מטא-נתונים של הערות לאפליקציות.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:support-annotations:28.0.0

ספריית התמיכה בעיצוב

החבילה Design מספקת ממשקי API לתמיכה בהוספת רכיבים ודפוסים של Material Design לאפליקציות.

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

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:design:28.0.0

ספריית התמיכה של כרטיסיות בהתאמה אישית

בחבילה כרטיסיות מותאמות יש ממשקי API שתומכים בהוספה ובניהול של כרטיסיות מותאמות אישית באפליקציות.

ספריית התמיכה של כרטיסיות בהתאמה אישית מוסיפה תמיכה בכיתות שונות, כמו Custom Tabs Service ו-Custom Tabs Callback.

החבילה הזו דורשת רמת API 15 ומעלה. מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:customtabs:28.0.0

ספריית התמיכה של Percent

בחבילה Percent יש ממשקי API לתמיכה בהוספה ובניהול של מאפיינים שמבוססים על אחוזים באפליקציה.

הערה: החל מגרסה 26.0.0, ספריית Percent Support הוצאה משימוש. הלקוחות של המודול הזה צריכים לעבור לווידג'ט ConstraintLayout החדש, שמסופק כארטיפקט נפרד ב-SDK Manager.

ספריית Percent Support מוסיפה תמיכה בממשק PercentLayoutHelper.PercentLayoutParams ובמחלקות שונות, כמו PercentFrameLayout ו- PercentPolicyLayout.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:percent:28.0.0

ספריית התמיכה של ExifInterface

תגי Exif שומרים מידע כמו הכיוון, התאריך והשעה, פרטי המצלמה והמיקום ישירות בקובץ JPEG או RAW. בכיתה ExifInterface מפורטים תמיכה בקריאת פרטי Exif מקובצי JPEG וקובצי RAW (DNG, ‏ CR2, ‏ NEF, ‏ NRW, ‏ ARW, ‏ RW2, ‏ ORF, ‏ PEF, ‏ SRW ו-RAF), והגדרת פרטי Exif בקובצי תמונה בפורמט JPEG.

מזהה התלות של סקריפט build של Gradle לספרייה הזו: 

com.android.support:exifinterface:28.0.0

ספריית תמיכה להמלצות על אפליקציות לטלוויזיה

החבילה App Recommendation מספקת ממשקי API שתומכים בהוספת המלצות לתוכן באפליקציה שלכם שפועלת במכשירי טלוויזיה.

בספריית האפליקציות יש תמיכה בהערות כמו ContentRecommendation.ContentMaturity ובסיווגים שונים, כמו ContentRecommendation ו- RecommendationExtender.

החבילה הזו דורשת רמת API של 21 ומעלה. מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא:

com.android.support:recommendation:28.0.0

ספרייה ב-UI של Wear OS

בספרייה הזו יש ממשקי API ליצירת ממשקי משתמש לאפליקציות ל-Wear. ממשקי ה-API, שזמינים בחבילה android.support.wear.widget, מחליפים את ממשקי ה-API המקבילים בספריית התמיכה לבישה.

מידע נוסף זמין במאמר שימוש בספריית ממשק המשתמש של Wear.

מזהה התלות של סקריפט ה-build ב-Gradle בספרייה הזו הוא: 

com.android.support:wear:28.0.0