RecyclerView

בטבלה הזו מפורטים כל פריטי המידע בקבוצה androidx.recyclerview.

הצהרה על יחסי תלות

כדי להוסיף תלות ב-RecyclerView, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

dependencies {
    implementation "androidx.recyclerview:recyclerview:1.4.0"
    // For control over item selection of both touch and mouse driven selection
    implementation "androidx.recyclerview:recyclerview-selection:1.2.0"
}

dependencies {
    implementation("androidx.recyclerview:recyclerview:1.4.0")
    // For control over item selection of both touch and mouse driven selection
    implementation("androidx.recyclerview:recyclerview-selection:1.2.0")
}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ב-build.

משוב

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

יצירת בעיה חדשה

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

גרסה 1.4

גרסה 1.4.0

‫15 בינואר 2025

androidx.recyclerview:recyclerview:1.4.0 משוחרר. גרסה 1.4.0 מכילה את הקומטים האלה.

שינויים חשובים מאז RecyclerView 1.3.2

• Adaptive תמיכה בקצב רענון: RecyclerView עכשיו מתבצעת קריאה ל-setFrameContentVelocity כשמתבצע גלילה באמצעות OverScroller (למשל, לאחר גלילה מהירה או גלילה חלקה). (I8f8a4)

גרסה 1.4.0-rc01

‫18 בספטמבר 2024

‫androidx.recyclerview:recyclerview:1.4.0-rc01 יוצאת לאור, ללא שינויים מאז 1.4.0-alpha02/. גרסה 1.4.0-rc01 מכילה את הקומטים האלה.

שינויים מאז גרסה 1.3.2

הערה לגבי תאימות: הגרסה הזו תעבור קומפילציה רק מול API 35 (Vanilla Ice Cream) SDK ומעלה. אם מופיעות אזהרות לגבי AGP (Android Gradle Plugin) כשמשדרגים, אפשר להסתיר אותן.

תכונות חדשות

• Adaptive תמיכה בקצב רענון: RecyclerView עכשיו מתבצעת קריאה ל-setFrameContentVelocity כשמתבצע גלילה באמצעות OverScroller (למשל, לאחר גלילה מהירה או גלילה חלקה). (I8f8a4)

שינויים ב-API

• מוסיפים את API של RecyclerView$LayoutManager#isLayoutReversed. (I4970e)

שינויים אחרים

• הסרנו את האפשרות ליצור באופן ידני תרשים של הגישה לממשקי API חדשים של הפלטפורמה, כי זה קורה אוטומטית באמצעות מידול API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל R8 גרסה 3.3), ובכל הבנייה כשמשתמשים ב-AGP 8.1 ואילך (למשל D8 גרסה 8.1). לקוחות שלא משתמשים ב-AGP מומלץ לעדכן לגרסה 8.1 ואילך של D8. למידע נוסף, מומלץ לעיין במאמר הזה. ‫(Ia60e0, ‏ b/345472586)
• הוספת סוג תצוגת הפריט אל RecyclerView bind/create trace sections, ותיוג של RV prefetches כ-'forced - needed next frame' אם צפוי שימוש בהם בפריים הבא, ולכן צריך להתחיל לעבוד איתם בהקדם האפשרי. (I8ec3e, ‏ b/309523615)
• מעדכנים את compileSdk ל-35 (פרטים נוספים מופיעים בקטע 'הערה לגבי תאימות' שלמעלה). 5dc41be

גרסה ‎1.4.0-beta01

‫21 באוגוסט 2024

‫androidx.recyclerview:recyclerview:1.4.0-beta01 יוצאת לאור, ללא שינויים מאז 1.4.0-alpha02. גרסה 1.4.0-beta01 מכילה את הקומטים האלה.

הערה לגבי תאימות: הגרסה הזו תעבור קומפילציה רק מול API 35 (Vanilla Ice Cream) SDK ומעלה. אם מופיעות אזהרות לגבי AGP (Android Gradle Plugin) כשמשדרגים, אפשר להסתיר אותן.

גרסה ‎1.4.0-alpha02

‫7 באוגוסט 2024

androidx.recyclerview:recyclerview:1.4.0-alpha02 משוחרר. גרסה ‎1.4.0-alpha02 מכילה את הקומטים האלה.

הערה לגבי תאימות: הגרסה הזו תעבור קומפילציה רק מול API 35 (Vanilla Ice Cream) SDK ומעלה. אם מופיעות אזהרות לגבי AGP (Android Gradle Plugin) כשמשדרגים, אפשר להסתיר אותן.

תכונות חדשות

• תמיכה בקצב רענון משתנה: עכשיו RecyclerView קורא ל-setFrameContentVelocity כשהוא גולל באמצעות OverScroller (למשל, כשמבצעים גלילה מהירה או גלילה חלקה). (I8f8a4)

שינויים ב-API

• ‫APIs ‏ViewCompat.LAYOUT_DIRECTION_ שיצאו משימוש (I51710, ‏ b/317055535)
• מוסיפים את API של RecyclerView$LayoutManager#isLayoutReversed. (I4970e)

שינויים אחרים

• הסרנו את האפשרות ליצור באופן ידני תרשים של הגישה לממשקי API חדשים של הפלטפורמה, כי זה קורה אוטומטית באמצעות מידול API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל R8 גרסה 3.3), ובכל הבנייה כשמשתמשים ב-AGP 8.1 ואילך (למשל D8 גרסה 8.1). לקוחות שלא משתמשים ב-AGP מומלץ לעדכן לגרסה 8.1 ואילך של D8. למידע נוסף, מומלץ לעיין במאמר הזה. ‫(Ia60e0, ‏ b/345472586)
• הוספת סוג תצוגת הפריט אל RecyclerView bind/create trace sections, ותיוג של RV prefetches כ-'forced - needed next frame' אם צפוי שימוש בהם בפריים הבא, ולכן צריך להתחיל לעבוד איתם בהקדם האפשרי. (I8ec3e, ‏ b/309523615)
• מעדכנים את compileSdk ל-35 (פרטים נוספים מופיעים בקטע 'הערה לגבי תאימות' שלמעלה). 5dc41be

חישוב צריכת הנתונים

• המאפיין GestureDetectorCompat הוצא משימוש, כי המאפיין GestureDetector זמין ב-minSdk. (Icc4cd)

גרסה ‎1.4.0-alpha01

‫18 באוקטובר 2023

androidx.recyclerview:recyclerview:1.4.0-alpha01 משוחרר. גרסה ‎1.4.0-alpha01 מכילה את הקומיטים האלה.

שינויים ב-API

• מוסיפים את API של RecyclerView$LayoutManager#isLayoutReversed. (I4970e)

תיקוני באגים

• תיקון באג שגורם לקריסות ספורדיות במהלך אנימציות (I42f22b) (כלול גם בגרסה 1.3.2)

גרסה 1.3.2

גרסה 1.3.2

‫18 באוקטובר 2023

androidx.recyclerview:recyclerview:1.3.2 משוחרר. גרסה 1.3.2 מכילה את הקומיטים האלה.

תיקוני באגים

• תיקון באג שגורם לקריסות ספורדיות במהלך אנימציות. (I42f22b)

גרסה 1.3.1

גרסה 1.3.1

‫26 ביולי 2023

הגרסה androidx.recyclerview:recyclerview:1.3.1 הושקה ללא שינויים מאז גרסה 1.3.1-rc01. גרסה 1.3.1 מכילה את הקומיטים האלה.

נתוני הגרסה של הגרסה הקודמת מופיעים בדף נתוני הגרסה

גרסה 1.3.1-rc01

‫24 במאי 2023

androidx.recyclerview:recyclerview:1.3.1-rc01 משוחרר. גרסה 1.3.1-rc01 מכילה את הקומיטים האלה.

משתמשים ב-ViewPager2 צריכים לעדכן לגרסה 1.1.0-beta02 לפחות כשמעדכנים לגרסה הזו של RecyclerView כדי למנוע קריסות.

שינויים ב-API

• נוספו ה-methods החדשות setDebugAssertionsEnabled ו-setVerboseLoggingEnabled שיכולות לעזור בניפוי באגים של בעיות שקשורות ל-RecyclerView באפליקציות. (I514b9)

תיקוני באגים

• תיקון קריסות למשתמשים ב-ViewTreeLifecycleOwner (כולל ComposeView) על ידי חיבור מחדש זמני של תצוגות שהוסרו באופן זמני כשמתבצעת קריאה ל-onBind. (I7244f2c, b/265347515, b/283288295)

גרסה 1.3.0

גרסה 1.3.0

‫8 במרץ 2023

‫androidx.recyclerview:recyclerview:1.3.0 יוצאת לאור, ללא שינויים מאז גרסה 1.3.0-rc01. גרסה 1.3.0 מכילה את הקומיטים האלה.

שינויים חשובים מאז גרסה 1.2.0

• הגרסה הזו כוללת שיפורים בביצועים (שנכללו קודם בגרסאות 1.3.0-alpha02 ו-1.3.0-beta01) כשמשתמשים בה עם Jetpack Compose. אם אתם משתמשים ב-Compose 1.2.0-beta02 או בגרסה מתקדמת יותר, והשתמשתם ב-MyComposeAdapter וב-DisposeOnViewTreeLifecycleDestroyed ViewCompositionStrategy שמתוארים בהנחיות הקודמות בנושא פעולה הדדית, עליכם להסיר אותם, כי הם כבר לא משפרים את מצב ברירת המחדל.
• נוספה שיטה חדשה ConcatAdapter.getWrappedAdapterAndPosition שמאפשרת לאחזר מידע על מתאמים עטופים במצבים שבהם אין ViewHolder, כמו SpanSizeLookup (I2bd4c, b/191543920)

גרסה ‎1.3.0-rc01

‫21 בספטמבר 2022

androidx.recyclerview:recyclerview:1.3.0-rc01 משוחרר. גרסה 1.3.0-rc01 מכילה את הקומיטים האלה.

• לא בוצעו שינויים מאז הגרסה האחרונה

גרסה ‎1.3.0-beta02

‫10 באוגוסט 2022

androidx.recyclerview:recyclerview:1.3.0-beta02 משוחרר. גרסה ‎1.3.0-beta02 מכילה את הקומיטים האלה.

שינויים ב-API

• הוסרו הערות לגבי אפשרות לערך null שנוספו בגרסה 1.3.0-beta01, כי הן ייצגו שינוי משמעותי שגרם לאי-תאימות למקור עבור משתמשי Kotlin (‏I7a258,‏I1557e6,‏I8db76)

גרסה ‎1.3.0-beta01

29 ביוני 2022

androidx.recyclerview:recyclerview:1.3.0-beta01 משוחרר. גרסה ‎1.3.0-beta01 מכילה את הקומיטים האלה.

תכונות חדשות

• גרסת הבטא הזו כוללת שיפורים בביצועים (שנכללו בעבר בגרסה 1.3.0-alpha02 כשמשתמשים בה עם Jetpack Compose). אם אתם משתמשים ב-Compose 1.2.0-beta02 או בגרסה מתקדמת יותר, והשתמשתם ב-MyComposeAdapter וב-DisposeOnViewTreeLifecycleDestroyed ViewCompositionStrategy שמתוארים בהנחיות הקודמות בנושא פעולה הדדית, עליכם להסיר אותם, כי הם כבר לא משפרים את מצב ברירת המחדל.

שינויים ב-API

• הוספנו הערות לגבי אפשרות של ערך null למספר שיטות ופרמטרים כדי לשפר את האזהרות של lint למשתמשי Java ואת יכולת הפעולה ההדדית למשתמשי Kotlin. יכול להיות שזה שינוי שובר תאימות למקור עבור חלק מהמשתמשים ב-Kotlin, ושינוי שיוביל לאזהרות או לשגיאות נוספות של lint עבור חלק מהמשתמשים ב-Java. (I61829, b/236487044; Ia0b6f; I6f119, b/236487209; Ibe1de, b/236487210)

תיקוני באגים

• כדי לוודא ששירותי הנגישות יתייחסו לרשתות כרשתות, צריך להגדיר שם מחלקה של פרטי צומת נגישות. (I12812)

גרסה ‎1.3.0-alpha02

‫6 באפריל 2022

androidx.recyclerview:recyclerview:1.3.0-alpha02 משוחרר. גרסה ‎1.3.0-alpha02 מכילה את הקומיטים האלה.

שינויים ב-API

• נוספו שיטות ניסיוניות BuildCompat לגרסאות SDK עתידיות (Iafd82, ‏ b/207528937)
• נוספה שיטה חדשה ConcatAdapter.getWrappedAdapterAndPosition כדי לאחזר מידע על מתאם עטוף במצבים שבהם אין ViewHolder, כמו SpanSizeLookup (I2bd4c, ‏ b/191543920)

תיקוני באגים

• שילוב עם ספריית PoolingContainer החדשה של AndroidX ‏ (Ib89d2)
• שינוי מרחק הגלילה לפעולת נגישות (If74ae)

גרסה ‎1.3.0-alpha01

‫15 בספטמבר 2021

androidx.recyclerview:recyclerview:1.3.0-alpha01 משוחרר. גרסה ‎1.3.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

• הוספנו תמיכה ב-RecyclerView עם גלילה מעבר לקצה. (Iab877)

RecyclerView-Selection Version 1.3.0

גרסה ‎1.3.0-alpha01

‫17 בדצמבר 2025

androidx.recyclerview:recyclerview-selection:1.3.0-alpha01 משוחרר. גרסה ‎1.3.0-alpha01 מכילה את הקומטים האלה.

שינויים ב-API

• הוספנו אפשרות לנקודת גישה בתוך הבחירה לנקות את הבחירה הקיימת (I0eae7, b/389814214). כך מפתחים יכולים לשלוט טוב יותר בבחירה של פריטים באמצעות הקשה או לחיצה על RecyclerView, ולקבוע אם פריטים שכבר נבחרו יישארו מסומנים או יבוטל הסימון שלהם.

RecyclerView-Selection Version 1.2.0

גרסה 1.2.0

‫20 במאי 2025

androidx.recyclerview:recyclerview-selection:1.2.0 משוחרר. גרסה 1.2.0 מכילה את ההתחייבויות האלה.

שינויים חשובים מאז גרסה 1.1.0

• תיקון של תנועות קטנות בעכבר שהופכות קליקים לגרירות.
• תוקנה בעיה שבה מיפוי המפתח/המיקום ב-KeyProvider אבד בזמן שהערך עדיין לא עבר מחזור.

גרסה 1.2.0-rc01

‫7 במאי 2025

androidx.recyclerview:recyclerview-selection:1.2.0-rc01 משוחרר. גרסה 1.2.0-rc01 מכילה את הקומטים האלה.

תיקוני באגים

• תיקון של תנועות קטנות בעכבר שהופכות קליקים לגרירות. (Ie9106)

גרסה 1.2.0-beta01

‫9 באפריל 2025

androidx.recyclerview:recyclerview-selection:1.2.0-beta01 משוחרר. גרסה 1.2.0-beta01 מכילה את הקומטים האלה.

שינויים ב-API

• ‫APIs ‏ViewCompat.LAYOUT_DIRECTION_ שיצאו משימוש (I51710, ‏ b/317055535)

תיקוני באגים

• הספרייה הזו משתמשת עכשיו בהערות לגבי ערכי null של JSpecify, שהן הערות לשימוש בסוגים. מפתחי Kotlin צריכים להשתמש בארגומנט המהדר הבא כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict (זו ברירת המחדל החל מגרסה 2.1.0 של מהדר Kotlin). (I03b80, ‏ b/326456246)

גרסה ‎1.2.0-alpha01

‫5 במאי 2021

androidx.recyclerview:recyclerview-selection:1.2.0-alpha01 משוחרר. גרסה 1.2.0-alpha01 מכילה את הקומיטים האלה.

תיקוני באגים

• תוקנה בעיה שבה מיפוי המפתח/המיקום ב-KeyProvider אבד בזמן שהערך עדיין לא עבר מחזור. (b/145767095)

גרסה 1.2.1

גרסה 1.2.1

‫2 ביוני 2021

androidx.recyclerview:recyclerview:1.2.1 משוחרר. גרסה 1.2.1 מכילה את הקומיטים האלה.

תיקוני באגים

• הפונקציה ViewHolders בתוך ConcatAdapter מחזירה עכשיו את המיקום הנכון של המתאם כשמבצעים שאילתה ב-callback של onViewRecycled. (b/187339376)

גרסה 1.2.0

גרסה 1.2.0

‫7 באפריל 2021

androidx.recyclerview:recyclerview:1.2.0 משוחרר. גרסה 1.2.0 מכילה את הקומיטים האלה.

שינויים משמעותיים מאז גרסה 1.1.0

‫ConcatAdapter: המתאם החדש הזה מאפשר לכם לשרשר בקלות כמה מתאמים באותו RecyclerView. מידע נוסף זמין בפוסט בבלוג.

• כחלק מהשינוי הזה, הוצאנו משימוש את ViewHolder.getAdapterPosition והחלפנו אותו בשתי שיטות חדשות:
  • ‫getBindingAdapterPosition מחזירה את המיקום ביחס לאובייקט Adapter שקשר את הפריט הזה.
  • הפונקציה getAbsoluteAdapterPosition מחזירה את המיקום ביחס ל-RecyclerView כולו.

שחזור מצב עצלני: עכשיו אפשר להשהות את שחזור המצב של RecyclerView Adapter עד שהתוכן שלו נטען. פרטים נוספים מופיעים במאמרי העזרה.

גרסה 1.2.0-rc01

‫24 במרץ 2021

androidx.recyclerview:recyclerview:1.2.0-rc01 משוחרר. גרסה 1.2.0-rc01 כוללת את הקומיטים האלה.

תיקוני באגים

• למאפיין ConcatAdapter.Config.Builder יש עכשיו ערכי ברירת מחדל שתואמים למאפיין Config.DEFAULT (b/157169835)

גרסה ‎1.2.0-beta02

24 בפברואר 2021

androidx.recyclerview:recyclerview:1.2.0-beta02 משוחרר. גרסה 1.2.0-beta02 מכילה את הקומיטים האלה.

תיקוני באגים

• תוקנה בעיה שבה הריווח העליון גרם להילה של הגלילה העודפת בצד ימין לנוע כלפי מעלה לאזור המרופד, במקום כלפי מטה כדי להתאים לריווח. (I6b61d, b/118399122)

גרסה 1.2.0-beta01

2 בדצמבר 2020

הגרסה androidx.recyclerview:recyclerview:1.2.0-beta01 הושקה ללא שינוי מאז 1.2.0-alpha06. גרסה 1.2.0-beta01 מכילה את הקומיטים האלה.

גרסה ‎1.2.0-alpha06

‫1 באוקטובר 2020

androidx.recyclerview:recyclerview:1.2.0-alpha06 משוחרר. גרסה ‎1.2.0-alpha06 מכילה את הקומיטים האלה.

תכונות חדשות

• הוספנו תמיכה בהוספה של כמה RecyclerListener. (I70ad8, ‏ b/145767095)

שינויים ב-API

• השיטה RecyclerView.setRecyclerListener(RecyclerListener) הוצאה משימוש. (I70ad8, ‏ b/145767095)

גרסה ‎1.2.0-alpha05

22 ביולי 2020

androidx.recyclerview:recyclerview:1.2.0-alpha05 משוחרר. גרסה 1.2.0-alpha05 מכילה את הקומיטים האלה.

תיקוני באגים

• נפתרה בעיה שבה אם לרכיב RecyclerView יש רק פריט אחד והוא ממוקד, העברת המיקוד קדימה או אחורה לא תזיז את המיקוד. (6f36b3)
• תוקנה בעיה ArrayIndexOutOfBoundsException ב-StaggeredGridLayoutManager (49b601, ‏ b/122303625, ‏ b/74877618, ‏ b/160193663, ‏ b/37086625)
• תוקן באג במדידה שבו בנסיבות מסוימות, RecyclerView לא הציג את רכיבי הצאצא שלו שלא בצורה מתאימה. (89040c, b/138734786)

פריטי תוכן חיצוניים שהוספת

• תודה לקולין קרווינקל מטעם פייסבוק על התרומה!

גרסה ‎1.2.0-alpha04

‫24 ביוני 2020

androidx.recyclerview:recyclerview:1.2.0-alpha04 משוחרר. גרסה 1.2.0-alpha04 מכילה את הקומיטים האלה.

שינויים ב-API

• MergeAdapter שונה ל-ConcatAdapter כדי למנוע בלבול עם התנהגויות שונות של מיזוג נתונים (c0540c, ‏ b/158019211).

תיקוני באגים

• שיפורים בגלילה האוטומטית כשכל הפריטים הגלויים מוסרים (fe8670, b/154124815)

גרסה 1.2.0-alpha03

29 באפריל 2020

androidx.recyclerview:recyclerview:1.2.0-alpha03 משוחרר. גרסה 1.2.0-alpha03 מכילה את הקומיטים האלה.

תכונות חדשות

• ל-RecyclerView יש עכשיו שיטה nestedScrollBy שמאפשרת גלילה פרוגרמטית שפועלת בשיתוף עם גלילה מקוננת: (Ibaa58)

גרסה ‎1.2.0-alpha02

‫1 באפריל 2020

androidx.recyclerview:recyclerview:1.2.0-alpha02 משוחרר. גרסה 1.2.0-alpha02 מכילה את הקומיטים האלה.

גרסה זו וגרסאות מתקדמות יותר של RecyclerView לא תואמות לגרסאות ישנות יותר של ViewPager2. אם אתם משתמשים כרגע בגרסה androidx.viewpager2:viewpager2:1.0.0 או בגרסה ישנה יותר, הקפידו לעדכן לגרסה androidx.viewpager2:viewpager2:1.1.0-alpha01.

תכונות חדשות

• MergeAdapter

  • ‫MergeAdapter: מתאם חדש של RecyclerView שיכול לשלב כמה מתאמים באופן ליניארי.

  MyAdapter adapter1 = ...;
  AnotherAdapter adapter2 = ...;
  MergeAdapter merged = new MergeAdapter(adapter1, adapter2);
  recyclerView.setAdapter(mergedAdapter);
  

  בדוגמה שלמעלה, MergeAdapter יציג פריטים מ-adapter1 ואחריהם פריטים מ-adapter2.

• RecyclerView.Adapter שחזור מצב עצלני:

  • נוסף API חדש למחלקה RecyclerView.Adapter שמאפשר למתאם לשלוט במועד שבו צריך לשחזר את מצב הפריסה.

  • לדוגמה, אפשר להתקשר אל:

  myAdapter.setStateRestorationStrategy(StateRestorationStrategy.WHEN_NOT_EMPTY);
  

  כדי לגרום ל-RecyclerView להמתין עד שהמתאם לא יהיה ריק לפני שחזור מיקום הגלילה.

• השדות CollectionInfo ו-CollectionItemInfo לא יאוכלסו יותר כברירת מחדל.

  • אם רוצים ששירותי הנגישות (לדוגמה, Talkback) ימשיכו לציין למשתמש את מספר הפריטים ואת האינדקס של הפריט, צריך לאכלס את CollectionInfo ואת CollectionItemInfo באופן ידני.

  • האובייקטים האלה לא מאוכלסים יותר במסגרת כי המסגרת לא יכולה לקבוע את מספר הפריטים כפי שהמשתמש רואה אותם (כמו מפרידים, כותרות או פריטים ב-RecyclerView שמייצגים כמה פריטים).

תיקוני באגים

• החל מעכשיו, RecyclerView לא מבצע יותר עיגון בתצוגות מחוץ לאזור התצוגה כשגודל אזור התצוגה משתנה
• תוקן באג ב-DiffUtil שבו יכול להיות שההפרש יחושב בצורה שגויה אם פריט מקורי ברשימה הראשונה משוכפל כמה פעמים ברשימה השנייה. (b/123376278)

גרסה ‎1.2.0-alpha01

18 בדצמבר 2019

androidx.recyclerview:recyclerview:1.2.0-alpha01 משוחרר. גרסה ‎1.2.0-alpha01 מכילה את הקומיטים האלה.

תיקוני באגים

• תוקנו בעיות קלות ב-FastScroller שקשורות לציור מימין לשמאל ולדיוק של מגע (b/143789932, ‏ aosp/1130438)
• תוקנה קריסה ב-ItemTouchHelper כשמסירים מ-RecyclerView בזמן שהאנימציות של ItemTouchHelper פועלות (b/140447176, ‏ aosp/1167575)

גרסה 1.1.0

גרסה 1.1.0

20 בנובמבר 2019

androidx.recyclerview:recyclerview:1.1.0 משוחרר. גרסה 1.1.0 מכילה את הקומיטים האלה.

שינויים חשובים מאז גרסה 1.0.0

• ‫PagerSnapHelper ו-LinearSnapHelper מתחשבים עכשיו בריווח הפנימי של RecyclerView, בלי קשר לערך של clipToPadding (b/139452422,‏ b/139012032,‏ aosp/1103182,‏ aosp/1106715,‏ aosp/1130728)
• המאפיין RecyclerView.setLayoutTransition(LayoutTransition) הוצא משימוש באופן רשמי, ויחזיר את השגיאה IllegalArgumentException אם הוא יופעל עם ערך שאינו null. במקום זאת, אתם צריכים להשתמש ב-RecyclerView.setItemAnimator(ItemAnimator). (aosp/839414)
• ‫aosp/723649: RecyclerView כולל עכשיו את NestedScrollingChild3, שמאפשר לו לדעת מתי כל ההורים שלו שמשתמשים בגלילה מקוננת סיימו להשתמש במרחקי הגלילה המקוננת. אם קוד המפתח מבטל כרגע את RecyclerView.onNestedScroll(View, int, int, int, int, int), סביר להניח שהוא כבר לא יופעל, ובמקומו יבוטל RecyclerView.onNestedScroll(View, int, int, int, int, int, int[]).
• ל-RecyclerView יש עכשיו מאפיין סגנון ברירת מחדל: recyclerViewStyle, שמאפשר להגדיר את סגנון ברירת המחדל בעיצוב
• ממשק ה-API של פעולות הנגישות ViewCompat לא גורם יותר לשיבוש ב-RecyclerView ItemDelegate.
• אפשר לשנות את הערך של LinearLayoutManager.calculateExtraLayoutSpace(RecyclerView.State, int[]) כדי להתאים אישית את כמות המרווח הנוסף שצריך להוסיף לכל אחד מהצדדים של RecyclerView המשויך. (aosp/931259)
• נוספה גרסה חדשה של smoothScrollBy: RecyclerView#smoothScrollBy(@Px int, @Px int, @Nullable Interpolator, int duration), שמאפשרת לציין משך זמן באלפיות השנייה לאורך האנימציה. (aosp/952807)

גרסה ‎1.1.0-rc01

‫23 באוקטובר 2019

androidx.recyclerview:recyclerview:1.1.0-rc01 משוחרר. גרסה 1.1.0-rc01 מכילה את הקומיטים האלה.

תיקוני באגים

• תוקנה בעיה שגרמה להודעה 'האפליקציה לא מגיבה' כשמבטלים את ההגדרה RecyclerViewAccessibilityDelegate.ItemDelegate (aosp/1138057, aosp/1133434)

גרסה ‎1.1.0-beta05

‫9 באוקטובר 2019

androidx.recyclerview:recyclerview:1.1.0-beta05 משוחרר. גרסה 1.1.0-beta05 מכילה את הקומיטים האלה.

שינויים ב-API

• בהמשך ל-aosp/1106715 ול-aosp/1103182, עכשיו LinearSnapHelper ו-PagerSnapHelper יחזירו את התצוגה שנמצאת במרכז הגבולות של RecyclerView, פחות הריווח הפנימי, למרות הערך של clipToPadding. (aosp/1130728)

תיקוני באגים

• תוקנה בעיה שבה RecyclerView יצר צמתי נגישות כפולים עבור צאצאים של RecyclerView. ‫(aosp/1130618)
• תוקנה בעיה שבה היררכיות וירטואליות של נגישות ב-RecyclerViews לא פעלו.
• תוקנה הבעיה שבה לא נעשה שימוש ב-ItemDelegates מותאמים אישית.

גרסה ‎1.1.0-beta04

‫5 בספטמבר 2019

androidx.recyclerview:recyclerview:1.1.0-beta04 משוחרר. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

תיקוני באגים

• הפונקציות PagerSnapHelper ו-LinearSnapHelper מתחשבות עכשיו בריווח הפנימי של RecyclerView, ללא קשר לערך של clipToPadding (b/139452422,‏ b/139012032,‏ aosp/1103182,‏ aosp/1106715)
• תוקן באג שבו RecyclerView לא ביטל את חסימת יירוט המגע כשגלילה מקדימה מוטמעת גרמה ל-NestedScrollingParent לגלול (b/138668210, ‏ aosp/1105373). הדבר מועיל לספריות כמו ViewPager2.
• הפעולה RecyclerView עוברת עכשיו באופן עקבי אל SCROLL_STATE_DRAGGING לפני שמתבצעת שליחה של גלילה מקדימה מוטמעת (aosp/1105373)
• הגלילה המקדימה המקוננת לא מתבצעת יותר לפני שהמחוות חורגות מהמרחק המינימלי לזיהוי מגע (b/139530818, ‏ aosp/1105373)
• הארגומנטים dx ו-dy שנשלחים ל-pre-scrolls מוטמעים כשה-RecyclerView לא יכול לגלול בכיוון הזה (aosp/1105373)

גרסה ‎1.1.0-beta03

‫15 באוגוסט 2019

androidx.recyclerview:recyclerview:1.1.0-beta03 משוחרר. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

שינויים ב-API

• ‫RecyclerView שולח עכשיו את מרחקי הגלילה באמצעות View.onScrollChanged(int l, int t, int oldl, int oldt) כדי ששירותי הנגישות יקבלו הודעה מדויקת על שינויים בגלילה. (aosp/1007823)

תיקוני באגים

• תוקן באג חמור של גלישת מחסנית (stack overflow) שקשור ל-RecyclerView ולנגישות. (aosp/1099577)

גרסה 1.1.0-beta02

‫7 באוגוסט 2019

androidx.recyclerview:recyclerview:1.1.0-beta02 משוחרר. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

תכונות חדשות

• ל-RecyclerView יש עכשיו מאפיין סגנון ברירת מחדל: recyclerViewStyle, שמאפשר להגדיר את סגנון ברירת המחדל בעיצוב

תיקוני באגים

• תוקן באג שבו RecyclerView לא מנע יירוט של מגע כשגלילה שלו גרמה לגלילה של NestedScrollingParent. (b/131115697, aosp/1055911)

גרסה ‎1.1.0-beta01

‫2 ביולי 2019

androidx.recyclerview:recyclerview:1.1.0-beta01 משוחרר. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

תכונות חדשות

• ‫RecyclerView משתתף עכשיו בגלילה מקוננת כשמתחילה גלילה דרך אירועי נגישות. (aosp/973584)

גרסה ‎1.1.0-alpha06

‫5 ביוני 2019

השקנו את androidx.recyclerview:recyclerview:1.1.0-alpha06 וגם את androidx.recyclerview:recyclerview-selection:1.1.0-alpha06. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

תכונות חדשות

• נוספה גרסה חדשה של smoothScrollBy: RecyclerView#smoothScrollBy(@Px int, @Px int, @Nullable Interpolator, int duration), שמאפשרת לציין משך זמן באלפיות השנייה לאורך האנימציה. (aosp/952807)

שינויים ב-API

• התגים GridLayoutManager ו-StaggeredGridLayoutManager לא מסמנים יותר באופן אוטומטי פריטים ברוחב מלא ככותרות לצורכי נגישות (aosp/969703)
• שמירה על סדר הבחירה (לפי זמן היצירה) ב-recyclerview-selection (aosp/937279)

תיקוני באגים

• תוקן באג שגרם לכך שפעולת ההעברה של RecyclerView בוצעה במהירויות לא נכונות במצב של גלילה מקוננת. (aosp/961642)
• שיפרנו את היציבות של recyclerview-selection (aosp/960213, ‏ aosp/926296)

גרסה ‎1.1.0-alpha05

‫7 במאי 2019

השקנו את androidx.recyclerview:recyclerview:1.1.0-alpha05 וגם את androidx.recyclerview:recyclerview-selection:1.1.0-alpha05. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

תכונות חדשות

• אפשר לשנות את הערך של LinearLayoutManager.calculateExtraLayoutSpace(RecyclerView.State, int[]) כדי להתאים אישית את כמות המרווח הנוסף שצריך להוסיף לכל אחד מהצדדים של RecyclerView המשויך. (aosp/931259)

שינויים ב-API

• הוספת API לאחזור של drawable ‏ (aosp/937282)DividerItemDecoration
• הוצאנו משימוש את LinearLayout.getExtraLayoutSpace(RecyclerVew.State) לטובת מנגנון חדש שמאפשר להגדיר שטח פריסה נוסף מותאם אישית משני הצדדים. השיטה החדשה היא LinearLayout.calculateExtraLayoutSpace(RecyclerView.state, int[]) (aosp/931259)

תיקוני באגים

• ניקוי הבחירה של תנועות (aosp/940781)
• שמירה על סדר הבחירה (לפי זמן היצירה) (b/128455535)

גרסה ‎1.1.0-alpha04

‫3 באפריל 2019

androidx.recyclerview:recyclerview:1.1.0-alpha04 משוחרר. כאן אפשר לראות את הקומיטים שכלולים בגרסה הזו.

תיקוני באגים

• בעבר, לא הייתה אפשרות ליירט את ACTION_UP ב-OnItemTouchListener של RV, ולכן לא הייתה אפשרות לחסום קוד אחר מלהגיב ל-ACTION_UP. הבעיה הזו נפתרה: (aosp/916137)

גרסה ‎1.1.0-alpha03

‫13 במרץ 2019

androidx.recyclerview:recyclerview:1.1.0-alpha03 משוחרר. כאן אפשר לראות את הרשימה המלאה של הקומיטים שכלולים בגרסה הזו.

תכונות חדשות

• ‫GridLayoutManager: הסכמה להערכת מידות של סרגל הגלילה ברזולוציה גבוהה יותר GridLayoutManager (aosp/838836):
  • השיטה משתמשת במידע על טווח כדי להעריך את המידות של פס הגלילה עבור GridLayoutManager.
  • כדי להפעיל, מתקשרים אל GridLayoutManager#setUsingSpansToEstimateScrollbarDimensions(boolean) עם הערך true.
  • מידע נוסף זמין במאמרי העזרה בנושא GridLayoutManager#setUsingSpansToEstimateScrollbarDimensions(boolean).

תיקוני באגים

• נגישות: הייתה באג שבו אחרי ש-ViewHolder עבר שימוש חוזר ואז שויך מחדש, ה-ItemDelegate שמשויך ל-RecyclerViewAccessibilityDelegate של RecyclerView לא שויך ל-itemView של ViewHolder, ולכן הנגישות נפגעה. הבעיה הזו תוקנה (aosp/917740).

גרסה ‎1.1.0-alpha02

‫30 בינואר 2019

androidx.recyclerview:recyclerview 1.1.0-alpha02 משוחרר.

שינויים ב-API

• המאפיינים RecyclerView.setLayoutFrozen(boolean) ו-RecyclerView.isLayoutFrozen() הוצאו משימוש והוחלפו במאפיינים RecyclerView.suppressLayout(boolean) ו-RecyclerView.isLayoutSuppressed(). (aosp/839414)
• המאפיין RecyclerView.setLayoutTransition(LayoutTransition) הוצא משימוש באופן רשמי, ויחזיר את השגיאה IllegalArgumentException אם הוא יופעל עם ערך שאינו null. (aosp/839414)

תיקוני באגים

• תיקון באג ב-RV שבו SmoothScroller אף פעם לא מופסק (aosp/843741)
• תוקן באג שבו יכול להיות שהפונקציה SCROLL_STATE_IDLE לא נקראת בסוף אנימציית גלילה. (aosp/812576)

גרסה ‎1.1.0-alpha01

‫3 בדצמבר 2018

השקנו את androidx.recyclerview 1.1.0-alpha01 וגם את androidx.recyclerview-selection 1.1.0-alpha01.

androidx.recyclerview 1.1.0-alpha01

שינויים ב-API

• ‫aosp/723649: RecyclerView כולל עכשיו את NestedScrollingChild3, שמאפשר לו לדעת מתי כל ההורים שלו שמשתמשים בגלילה מקוננת סיימו להשתמש במרחקי הגלילה המקוננת. אם קוד המפתח מבטל כרגע את RecyclerView.onNestedScroll(View, int, int, int, int, int), סביר להניח שהוא כבר לא יופעל, ובמקומו יבוטל RecyclerView.onNestedScroll(View, int, int, int, int, int, int[]).

תיקוני באגים

• תוקנה קריסה שהתרחשה כשמשתמשים ב-TransitionManager כדי לכווץ או להרחיב פריט ב-RecyclerView (b/37129527).
• תוקן באג שגרם לכך שההתנהגות של RecyclerView.OnItemTouchListener הייתה לא עקבית עם ההתנהגות של onInterceptTouchEvent ו-onTouchEvent במערכת התצוגה (aosp/721235)
• תוקנו כמה באגים במקרים קיצוניים שקשורים לגלילה חלקה (aosp/729718, ‏ aosp/747168, ‏ aosp/812576)
• תוקנה אסטרטגיית ההצמדה ב-PagerSnapHelper כדי לטפל בתצוגות לא טיפוסיות של חלונות צמודים (aosp/795752)

androidx.recyclerview-selection 1.1.0-alpha01

תיקוני באגים

• תוקן ConcurrentModificationException כשמערך הנתונים השתנה עם הסרת הבחירה.

‫RecyclerView-Selection גרסה 1.1.0

‫RecyclerView-Selection גרסה 1.1.0

‫27 בינואר 2021

androidx.recyclerview:recyclerview-selection:1.1.0 משוחרר. גרסה 1.1.0 מכילה את הקומיטים האלה.

שינויים משמעותיים מאז גרסה 1.0.0

• שיפורים רבים ביציבות.
• הוצאו משימוש השיטות withGestureTooltypes ו-withPointerTooltypes ב-SelectionTracker.Builder. השיטות האלה יוסרו בגרסה עתידית.

גרסה 1.1.0-rc03 של RecyclerView-Selection

‫1 באוקטובר 2020

androidx.recyclerview:recyclerview-selection:1.1.0-rc03 משוחרר. גרסה ‎1.1.0-rc03 מכילה את הקומיטים האלה.

תיקוני באגים

תודה לסטפן קיסלר על בדיקת התיקונים והמשוב.

• תוקנה בעיה שגרמה לכך ש-OnClickListeners של תצוגת צאצא נקראו באופן לא צפוי במהלך בחירה פעילה.
• ‫Mouse handler (band-selection) > Handle unexpected scrolls gracefully. (b/167821507)

גרסה ‎1.1.0-rc02 של RecyclerView-Selection

‫2 בספטמבר 2020

androidx.recyclerview:recyclerview-selection:1.1.0-rc02 משוחרר. גרסה 1.1.0-rc02 כוללת את הקומיטים האלה.

עיקרי השינויים

• טפלנו בכמה רגרסיות מגרסה 1.0 בטיפול בקלט.
• הספרייה עודכנה כדי להתאים ל-onRequestDisallowInterceptTouchEvent, וכך היא יכולה לפעול בצורה טובה עם ItemTouchHelper (פשוט מחליקים כדי להסיר!).

תיקוני באגים

• תוקנה הבעיה שבה ספריית הבחירה פירשה לא נכון אירועים של GestureDetector, וכתוצאה מכך נעלמו הקשות במהלך בחירה פעילה (b/165030422)
• תוקנה בעיה שגרמה לכך שהבחירה לא התעדכנה כדי לשקף פריטים שהוסרו מהמתאם. (b/138932671)
• תוקנה בעיה שבה פריטים ב-RecyclerView הפעילו אירועים מסוג onClick בזמן שהבחירה פעילה ב-SelectionTracker (b/161162268)
• עכשיו המערכת מטפלת ב-onRequestDisallowInterceptTouchEvent בצורה נכונה
• תוקנה בעיה שבה ”Cannot call this method in a scroll callback” הופיע בזמן גלילה בעזרת העכבר ב-Q
• עדכנו את המסמכים (במיוחד ב-StableIdKeyProvider) כדי לציין בבירור את הדרישות של מופע RecyclerView

‫RecyclerView-Selection גרסה 1.1.0-rc01

5 בפברואר 2020

androidx.recyclerview:recyclerview-selection:1.1.0-rc01 משוחרר. גרסה 1.1.0-rc01 מכילה את הקומיטים האלה.

תיקוני באגים

• תוקנה בעיה שבה קשה לגלול ב-RecyclerView באמצעות בחירת תנועה אם הוא באינטראקציה עם AppBarLayout שניתן לגלול בו (aosp/1193934)

RecyclerView-Selection Version 1.1.0-beta01

4 בדצמבר 2019

androidx.recyclerview:recyclerview-selection:1.1.0-beta01 משוחרר. גרסה ‎1.1.0-beta01 מכילה את הקומיטים האלה.

שיפורים כלליים ביציבות שקשורים לבדיקות הגנה ולניהול של מצב פנימי.

תיקוני באגים

• שיפור בניהול של מצב הספרייה ובפרשנות של אירועי ביטול, מה שמוביל לשיפורים ביציבות.
  • b/128054552
  • b/130707991
  • b/137460699

שינויים ב-API

• הוספנו פרמטר של סוג מפתח בחירה למחלקות ולשיטות שבהן הוא היה חסר.
• שיטות שהוצאו משימוש:
  • SelectionTracker.Builder#withPointerTooltype
  • SelectionTracker.Builder#withGestureTooltype
  • השיטות האלה נוצרו במטרה לאפשר למפתחים למפות התנהגויות של מצביעים או מחוות לסוגי כלים שונים מאלה שמוגדרים כברירת מחדל*. הכוונה הייתה טובה, אבל אחרי שימוש נוסף התברר שהציפיות של המשתמשים לגבי התנהגות הקלט הן ספציפיות מאוד לסוג הכלי. בנוסף, מערכת הקלט של Android מתייחסת לעטים אלקטרוניים 'פסיביים' כאל כלי מסוג FINGER.
  • סוגי ברירת המחדל של כלי העבודה הם FINGER לתנועה ו-MOUSE למצביע.