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

הערה: עם השקת 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

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

הטמעה של מגוון רכיבים שקשורים לממשק המשתמש, כמו 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, ראו פיתוח אפליקציות עם יותר מ-64,000 שיטות.

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

com.android.support:multidex:1.0.0

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

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

ספריית v7 appcompat   חלק מ-Android Jetpack.

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

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

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

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

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

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

com.android.support:appcompat-v7:28.0.0

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

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

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

com.android.support:cardview-v7:28.0.0

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

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

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

com.android.support:gridlayout-v7:28.0.0

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

הספרייה הזו מספקת את המחלקות 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

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

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

ספריית v8 renderscript

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

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

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

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

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

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

הערה: ספריית הקטעים של גרסה 4 מספקת את המחלקה 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 בגרסה 14, אפשר לעיין בחבילה 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

ספריית Vector Drawable

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

מזהה התלות של סקריפט ה-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 לתמיכה בהוספת רכיבים ודפוסים של עיצוב חומר לאפליקציות.

ספריית התמיכה בעיצוב מוסיפה תמיכה במגוון רכיבים ודפוסים של עיצוב חומר, שעליהם מפתחי האפליקציות יכולים לבסס את העבודה שלהם, כמו תיבות ניווט, לחצני פעולה צפים (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 מוסיפה תמיכה בממשק PercentLayoutHelper.PercentLayoutParams ובמחלקות שונות, כמו PercentFrameLayout ו- PercentRelativeLayout.

מזהה התלות של סקריפט ה-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

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

בחבילה המלצות לאפליקציות יש ממשקי 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 התואמים בספריית התמיכה של Wearable.

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

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

com.android.support:wear:28.0.0