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

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

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

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

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

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

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

חלקים חוזרים ב-framework של media, כולל MediaBrowser ו-MediaSession.

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

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

ספריית קטעים בגרסה 4

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

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

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

com.android.support:support-fragment:28.0.0

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

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

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

com.android.support:multidex:1.0.0

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

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

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

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

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

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

אלה כמה מסוגי המפתחות שכלולים בספריית האפליקציות התאימות של v7:

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

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

com.android.support:appcompat-v7:28.0.0

ספריית כרטיס v7

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

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

com.android.support:cardview-v7:28.0.0

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

אחרי ההורדה של ספריות התמיכה של Android, בספרייה הזו תתווסף תמיכה כיתה אחת (GridLayout), שבה מאפשרת לארגן את הרכיבים בממשק המשתמש באמצעות רשת של תאים מלבניים. למידע מפורט על ממשקי ה-API של ספריות רשת v7, אפשר לעיין ב חבילת 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 של ספריית המדיה v7, ראו חבילת android.support.v7.media ב-API הפניה.

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

com.android.support:mediarouter-v7:28.0.0

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

ספריית התמיכה בנושא העדפות גרסה 7

העדפה חבילה מספקת ממשקי 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 גרסאות build שמבוססות על Studio ו-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. גרסה 4 כיתה אחת (Fragment) היא כיתה עצמאית תיקוני באגים שנוספו בגרסאות מאוחרות יותר של הפלטפורמה, ואילו הכיתה v13 FragmentCompat מספקת תאימות ל-framework של יישום ה-framework, כיתה אחת (Fragment).

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

com.android.support:support-v13:28.0.0

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

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

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

com.android.support:preference-v14:28.0.0

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

חבילת 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

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

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

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

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

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

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

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

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

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

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

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

com.android.support:support-annotations:28.0.0

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

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

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

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

com.android.support:design:28.0.0

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

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

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

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

com.android.support:customtabs:28.0.0

ספריית התמיכה של 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 וסוגי תוכן שונים, כמו המלצה לגבי תוכן וגם 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