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

הערה: עם השקת Support Library 28.0.0, הספריות באריזת android.support הוצאו משימוש והוחלפו בספריות Jetpack עם גרסאות נפרדות, באריזת androidx. הגרסה הראשונית של ספריות 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

ספריית ליבה v4

קיימים כמה סוגי שירותים, כמו 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

נוספה תמיכה בקיפול של ממשק המשתמש והפונקציונליות באמצעות קטעים, שמאפשרת לאפליקציות לספק פריסות שתואמות למכשירים עם מסכים קטנים וגדולים. המודול הזה תלוי בתאימות, תוכנות ליבה (core-utils), core-ui ותאימות מדיה.

הערה: ספריית התמיכה v13 כוללת מחלקה FragmentCompat. המחלקה v4 של Fragment היא מחלקה עצמאית שמספקת תיקוני באגים שנוספו בגרסאות מאוחרות יותר של הפלטפורמה, ואילו המחלקה v13 FragmentCompat מספקת ספריות shim לתאימות להטמעה של ה-framework של המחלקה 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.

ספריית לוח צבעים v7

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

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

com.android.support:palette-v7:28.0.0

ספריית recyclerview גרסה 7

ספריית 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 עם ספריית התמיכה ב-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 בגרסה 17 Preference Support Library API, ראו את חבילת 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 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

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

בחבילה המלצות לאפליקציות יש ממשקי 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