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

הערה: לאחר ההשקה של ספריית התמיכה בגרסה 28.0.0, המארז של android.support ספריות הוצאו משימוש והוחלפו ב-Jetpack בגרסה נפרדת ספריות שנארזות בתור androidx. הערך הראשוני של 1.0.0 של ספריות Jetpack תואם לספריית התמיכה 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, הייתה ספריית תמיכה יחידה v4. הספרייה הזו חולקה למספר מודולים כדי לשפר את היעילות. כדי לשמור על תאימות לאחור, אם תוסיפו את support-v4 לסקריפט של Gradle, האפליקציה תכלול את כל המודולים של גרסה 4. עם זאת, כדי לצמצם את גודל האפליקציה, מומלץ רק לציין את המודולים הספציפיים הנחוצים לאפליקציה.

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

מספק wrappers לתאימות למספר ממשקי API של framework, כמו 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

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

החזרת תכונות מ-Android 8.0 ל-Android 7.1, כולל MediaBrowser ו-MediaSession.

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

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

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

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

הערה: ספריית התמיכה של v13 מספק מחלקה 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

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

ספריית אפליקציות גרסה 7 חלק מ-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 של ספריית המדיה v7, ראו חבילת 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

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

ספריית Renderscript בגרסה v8

הספרייה הזו מוסיפה תמיכה חישוב 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) ותמיכה נוספת במקטעים הסוגים. מידע נוסף על קטעים זמין במדריך למפתחים בנושא קטעים. לקבלת מידע מפורט מידע על ממשקי ה-API של v13 Support Library, ראה את החבילה 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 בגרסה 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 של ספריית התמיכה להעדפות של v17, ראו את העדפה בהפניה ל-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 וגם Percentדומה לפריסה (באחוזים).

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

com.android.support:percent:28.0.0

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

תגי Exif שומרים מידע כמו הכיוון, התאריך והשעה, פרטי המצלמה והמיקום ישירות בקובץ JPEG או RAW. ExifInterface מחלקה מפצלת תמיכה לקריאת פרטי Exif מ-JPEG ובפורמט גולמי (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

ספרייה בממשק המשתמש של Wear

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

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

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

com.android.support:wear:28.0.0