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

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

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

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

הוא מספק עטיפות תאימות למספר ממשקי API של מסגרות, כמו ‫Context.obtainDrawable() ו- View.performAccessibilityAction().

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

com.android.support:support-compat:28.0.0

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

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

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

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

ספריית הליבה של ממשק המשתמש (גרסה 4)

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

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

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

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

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

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

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

ספריית מקטעים (fragment) גרסה 4

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

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

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

com.android.support:support-fragment:28.0.0

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

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

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

com.android.support:multidex:1.0.0

ספריות תמיכה v7

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

‫v7 appcompat library   חלק מ-Android Jetpack.

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

הספרייה הזו מוסיפה תמיכה בסרגל הפעולות של ממשק המשתמש בתבנית העיצוב. הספרייה הזו כוללת תמיכה בהטמעות של ממשקי משתמש של Material Design.

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

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

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

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

com.android.support:appcompat-v7:28.0.0

ספריית v7 cardview

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

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

com.android.support:cardview-v7:28.0.0

ספריית v7 gridlayout

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

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

com.android.support:gridlayout-v7:28.0.0

ספריית MediaRouter v7

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

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

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

com.android.support:mediarouter-v7:28.0.0

ממשקי ה-API של ספריית mediarouter v7 שהוצגו בספריית התמיכה r18 כפופים לשינויים בגרסאות מאוחרות יותר של ספריית התמיכה. בשלב הזה, אנחנו ממליצים להשתמש בספרייה רק בשילוב עם Google Cast.

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

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

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

com.android.support:palette-v7:28.0.0

ספריית v7 recyclerview

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

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

com.android.support:recyclerview-v7:28.0.0

ספריית התמיכה v7 Preference

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

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

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

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
}

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

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

הערה: ספריית v4 fragment מספקת מחלקה Fragment. המחלקות v4 Fragment הן מחלקות עצמאיות שמספקות תיקוני באגים שנוספו בגרסאות מאוחרות יותר של הפלטפורמה, ואילו המחלקות v13 FragmentCompat מספקות שכבות תאימות (shims) להטמעה של המסגרת של המחלקות Fragment.

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

com.android.support:support-v13:28.0.0

ספריית התמיכה של העדפות v14

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

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

com.android.support:preference-v14:28.0.0

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

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

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

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

‫v17 Leanback Library

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

• ‫BrowseFragment – רכיב ליצירת פריסת ברירת מחדל לדפדוף בקטגוריות ובשורות של פריטי מדיה.
• ‫DetailsFragment – רכיב wrapper למסכי פרטים של Leanback.
• ‫PlaybackOverlayFragment – מחלקת משנה של DetailsFragment להצגת אמצעי בקרה להפעלה ותוכן שקשור אליה.
• ‫SearchFragment – קטע קוד לטיפול בחיפושים. הקטע מקבל את בקשת החיפוש של המשתמש ומעביר אותה אל SearchResultProvider שסופק על ידי האפליקציה. הפונקציה SearchResultProvider מחזירה את תוצאות החיפוש אל SearchFragment, שמעבד אותן ל-RowsFragment.

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

com.android.support:leanback-v17:28.0.0

ספרייה של פריטים גרפיים וקטוריים שניתנים לשרטוט

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

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

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

ספרייה של פריטים גרפיים וקטוריים מונפשים שניתן לשרטוט

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

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

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

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

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

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

com.android.support:support-annotations:28.0.0

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

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

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

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

com.android.support:design:28.0.0

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

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

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

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

com.android.support:customtabs:28.0.0

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

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

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

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

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

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.

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

com.android.support:exifinterface:28.0.0

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

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

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

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

com.android.support:recommendation:28.0.0

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

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

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

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

com.android.support:wear:28.0.0