תצוגת מיחזור
בטבלה הזו מפורטים כל פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) בקבוצה androidx.recyclerview
.
פריט מידע שנוצר בתהליך פיתוח (Artifact) | גרסה יציבה | מועמד לפרסום | גרסת בטא | גרסת אלפא |
---|---|---|---|---|
recyclerview | 1.3.2 | - | - | 1.4.0-alpha02 |
בחירת-recyclerview | 1.1.0 | - | - | 1.2.0-alpha01 |
הצהרה על יחסי תלות
כדי להוסיף תלות ב-RecyclerView, צריך להוסיף את המאגר של Google Maven פרויקט. למאגר Maven של Google אפשר לקבל מידע נוסף.
מוסיפים את יחסי התלות של פריטי המידע הנדרשים בקובץ build.gradle
בשביל
האפליקציה או המודול שלך:
מגניב
dependencies { implementation "androidx.recyclerview:recyclerview:1.3.2" // For control over item selection of both touch and mouse driven selection implementation "androidx.recyclerview:recyclerview-selection:1.1.0" }
Kotlin
dependencies { implementation("androidx.recyclerview:recyclerview:1.3.2") // For control over item selection of both touch and mouse driven selection implementation("androidx.recyclerview:recyclerview-selection:1.1.0") }
למידע נוסף על יחסי תלות, אפשר לעיין במאמר הוספת יחסי תלות של build.
משוב
המשוב שלך עוזר לנו לשפר את Jetpack. נשמח לשמוע אם גילית בעיות חדשות או אם יש לך רעיונות לשיפור הספרייה הזו. מומלץ לעיין בעיות קיימות בספרייה הזו לפני שיוצרים ספר חדש. אפשר להוסיף את ההצבעה שלך לבעיה קיימת על ידי לחיצה על לחצן הכוכב.
מקורות מידע בנושא מעקב אחר בעיות אפשר לקבל מידע נוסף.
גרסה 1.4
גרסה 1.4.0-alpha02
7 באוגוסט 2024
androidx.recyclerview:recyclerview:1.4.0-alpha02
משוחרר. גרסה 1.4.0-alpha02 מכילה את התחייבויות אלה.
הערה לגבי תאימות: הגרסה הזו תעבור הידור (compile) ל-API מגרסה 35 (Vanilla Ice Cup) ואילך. אם מופיעות אזהרות לגבי AGP (Android Gradle Plugin) בזמן השדרוג, אפשר להשבית אותן.
שינויים ב-API
- ממשקי API של
ViewCompat.LAYOUT_DIRECTION_
שהוצאו משימוש (I51710, b/317055535)
תכונות חדשות
- תמיכה בקצב רענון משתנה: RecyclerView קורא עכשיו ל-
setFrameContentVelocity
כשגוללים באמצעות OverScroller (למשל, מתנתקים מגלילה חלקה או כשמתבצעת גלילה חלקה). (I8f8a4)
שינויים אחרים
- הוסרה חלוקה ידנית של הגישה לממשקי API של פלטפורמות חדשות, כי זה קורה באופן אוטומטי באמצעות בניית מודלים של API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל R8 גרסה 3.3) ובכל גרסאות ה-build כשמשתמשים ב-AGP 8.1 ואילך (למשל D8 גרסה 8.1). ללקוחות שלא משתמשים ב-AGP מומלץ לעדכן לגרסה D8 ואילך. למידע נוסף, מומלץ לעיין במאמר הזה. (Ia60e0, b/345472586)
- צריך להוסיף את סוג תצוגת הפריט ל-
RecyclerView
קטעי קישור/יצירה של קטעי מעקב, ולהוסיף תוויות לשליפה מראש של RV כ'מאולץ – נדרש המסגרת הבאה' אם הם צפויים להיות בשימוש במסגרת הבאה, ולכן הם אמורים להתחיל לעבוד בהקדם האפשרי. (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
- אפשר להוסיף שיטות חדשות
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 פיתוח נייטיב'. אם השתמשת בתכונות 'כתיבה' בגרסה
1.2.0-beta02
ומעלה והשתמשת בViewCompositionStrategy
ובMyComposeAdapter
DisposeOnViewTreeLifecycleDestroyed
שמתוארות בהנחיות הקודמות ליכולת פעולה הדדית, עליך להסיר אותן כי כבר אין שיפור במצב ברירת המחדל. - נוספה שיטת
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 פיתוח נייטיב'. אם השתמשת בתכונות 'כתיבה' בגרסה
1.2.0-beta02
ומעלה והשתמשת בViewCompositionStrategy
ובMyComposeAdapter
DisposeOnViewTreeLifecycleDestroyed
שמתוארות בהנחיות הקודמות ליכולת פעולה הדדית, עליך להסיר אותן כי כבר אין שיפור במצב ברירת המחדל.
שינויים ב-API
- הוספנו הערות null עבור מספר שיטות ופרמטרים כדי לשפר אזהרות איתור שגיאות עבור משתמשי Java ויכולת פעולה הדדית למשתמשי Kotlin. אצל חלק ממשתמשי Kotlin, שינוי זה עלול לגרום לכשלים מקור חדש, ולגרום לאזהרות/שגיאות נוספות של איתור שגיאות בקוד עבור חלק ממשתמשי Java. (I61829, b/236487044; Ia0b6f; I6f119, b/236487209; Ibe1de, b/236487210)
תיקוני באגים
- כדי לוודא ששירותי a11y יתייחסו לרשתות כרשתות, צריך להגדיר שם של מחלקה של פרטי צומת a11y. (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)
תיקוני באגים
- שילוב עם הספרייה החדשה של AndroidX PoolingContainer (Ib89d2)
- שינוי מרחק הגלילה לפעולת הנגישות (If74ae)
גרסה 1.3.0-alpha01
15 בספטמבר 2021
androidx.recyclerview:recyclerview:1.3.0-alpha01
משוחרר. גרסה 1.3.0-alpha01 מכילה את התחייבויות אלה.
תכונות חדשות
- נוספה תמיכה ב-RecyclerView למתיחות של גלילת יתר. (Iab877)
RecyclerView-Selection גרסה 1.2.0
גרסה 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 כוללת את ההתחייבויות האלה.
תיקוני באגים
- כשמזינים
ViewHolder
בתוך מכשיר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 מחזיר את המיקום ביחס למתאם שקושר את הפריט הזה.
- getAbsoluteAdapterPosition מחזיר את המיקום ביחס לכל ה-RecyclerView.
שחזור מצב לא פעיל: עכשיו מתאם RecyclerView יכול לעכב את שחזור המצב עד שהתוכן שלו נטען. פרטים נוספים זמינים במאמרי העזרה.
גרסה 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 מכילה את התחייבויות אלה.
תכונות חדשות
- נוספה תמיכה בהוספת מספר פריטי RecyclerListeners. (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)
תרומות חיצוניות
- תודה לקולין קרווינקל בשם Facebook על התרומה!
גרסה 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.
האובייקטים האלה לא מאוכלסים יותר ב-framework כי ה-framework לא יכול לקבוע את מספר הפריטים כפי שנתפסים על ידי המשתמש (כמו מפרידים, כותרות או פריטי RecyclerView שמייצגים כמה פריטים נתפסים).
תיקוני באגים
- מעכשיו, RecyclerView נמנע מעוגן בתצוגות מחוץ לאזור התצוגה כשהגודל של אזור התצוגה השתנה
- תוקן באג ב-DiffUtil שגרם לחישוב ההפרש בצורה שגויה כאשר פריט מקורי ברשימה הראשונה שוכפל מספר פעמים ברשימה השנייה. (b/123376278)
גרסה 1.2.0-alpha01
18 בדצמבר 2019
androidx.recyclerview:recyclerview:1.2.0-alpha01
משוחרר. גרסה 1.2.0-alpha01 מכילה את התחייבויות אלה.
תיקוני באגים
- תוקנו בעיות קלות ב-FastScroller הקשורות לשרטוט RTL ולדיוק מגע (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
, שמאפשר להגדיר את סגנון ברירת המחדל של העיצוב. - ViewCompat Accessibility actions API לא מפר יותר את 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, ללא המרווח הפנימי, למרות הערך שלClipToPגנים. (aosp/1130728)
תיקוני באגים
- תוקנה בעיה שגרמה ל-RecyclerView ליצור צומתי נגישות כפולים עבור הצאצאים של RecyclerView. (aosp/1130618)
- תוקנה בעיה שבה היררכיות נגישות וירטואליות ב-RecyclerViews לא פעלו.
- תוקנה בעיה שבה לא נעשה שימוש בתכונה 'הענקת פריטים בהתאמה אישית'.
גרסה 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
שנשלחים לשקפים לפני גלילה בתוך גלילה מתאפסים כש-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)
תיקוני באגים
- תוקן באג גדול של גלישת קריסות באגים שקשורה ל-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 כדי לאחזר את הרכיב
DividerItemDecoration
שניתן להזזה (aosp/937282) - להוציא משימוש את
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
משוחרר. אפשר למצוא כאן את ההתחייבות שכלולה בגרסה הזו.
תיקוני באגים
- בעבר של RV OnItemTouchListener לא הייתה אפשרות ליירט ב-ACTION_UP, ולכן ה-OnItemTouchListener לא מונע מקוד אחר להגיב ל-ACTION_UP. השגיאה תוקנה: (aosp/916137)
גרסה 1.1.0-alpha03
13 במרץ 2019
androidx.recyclerview:recyclerview:1.1.0-alpha03
משוחרר. הרשימה המלאה של ההתחייבויות שכלולות בגרסה הזו זמינה כאן.
תכונות חדשות
GridLayoutManager
: הבעת הסכמה, רזולוציה גבוהה יותרGridLayoutManager
הערכת מאפיין סרגל גלילה (aosp/838836):- נעשה שימוש בפרטי טווח כדי להעריך את המידות של סרגל הגלילה עבור
GridLayoutManager
. - כדי להפעיל אותו, צריך להעביר את הערך True ל-
GridLayoutManager#setUsingSpansToEstimateScrollbarDimensions(boolean)
. - מידע נוסף זמין במסמכי התיעוד בנושא
GridLayoutManager#setUsingSpansToEstimateScrollbarDimensions(boolean)
.
- נעשה שימוש בפרטי טווח כדי להעריך את המידות של סרגל הגלילה עבור
תיקוני באגים
- נגישות: היה באג שבו לאחר מיחזור של ViewHolder והחזירו את המכשיר, ה-ItemDelegateer המשויך ל-
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)
תיקוני באגים
- תיקון באג בקרוואן שבו
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
. השיטות האלה יוסרו בגרסה עתידית.
RecyclerView-Selection גרסה 1.1.0-rc03
1 באוקטובר 2020
androidx.recyclerview:recyclerview-selection:1.1.0-rc03
משוחרר. גרסה 1.1.0-rc03 מכילה את ההתחייבויות האלה.
תיקוני באגים
תודה לסטפן קיסלר (Stefan Kiesler) ששלח תיקונים לבדיקות ומשוב.
- תוקנה בעיה שבה בוצעה קריאה לא צפויה ב-OnClickListeners בתצוגת צאצא במהלך בחירה פעילה.
- גורם handler של עכבר (בחירת רצועה) > טיפול בגלילות בלתי צפויות. (b/167821507)
RecyclerView-Selection גרסה 1.1.0-rc02
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 כשב-SelectTracker יש בחירה פעילה (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 גרסה 1.1.0-beta01
4 בדצמבר 2019
androidx.recyclerview:recyclerview-selection:1.1.0-beta01
משוחרר. גרסה 1.1.0-beta01 מכילה את התחייבויות אלה.
שיפורים כלליים ביציבות שקשורים לבדיקות הגנה ולניהול של המצב הפנימי.
תיקוני באגים
- ניהול משופר של מצב הספרייה ופירוש האירועים 'ביטול' כתוצאה משיפורים ביציבות.
שינויים ב-API
- הפרמטר של סוג מפתח הבחירה נוסף למחלקות ולשיטות שבהן הוא חסר.
- שיטות שהוצאו משימוש:
- SelectionTracker.Builder#withPointerTooltype
- SelectionTracker.Builder#withGestureTooltype
- המטרה של ה-methods האלה היא שמפתחים יוכלו למפות התנהגויות של סמנים או תנועות לסוגי כלים שונים מברירות המחדל*. הכוונה הייתה טובה, אבל לאחר מכן התברר שהציפיות של המשתמשים בנוגע להתנהגות של קלט הן מאוד ספציפיות לסוג כלים. כמו כן, "פסיבי" בכל הנוגע למערכת הקלט של Android, זה סוג הכלי FINGER.
- סוגי הכלים שמוגדרים כברירת מחדל הם FINGER לתנועה ו-MOUSE למצביע.