אוסף

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

העדכון האחרון	גרסה יציבה	גרסה מועמדת להפצה	גרסת בטא	גרסת אלפא
‫11 בפברואר 2026	1.5.0	‎1.6.0-rc01	-	-

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

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

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

Groovy

dependencies {
    def collection_version = "1.5.0"
    implementation "androidx.collection:collection:$collection_version"
}

Kotlin

dependencies {
    val collection_version = "1.5.0"
    implementation("androidx.collection:collection:$collection_version")
}

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.6

גרסה ‎1.6.0-rc01

‫11 בפברואר 2026

‫androidx.collection:collection-*:1.6.0-rc01 מופץ. גרסה ‎1.6.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.6.0-beta01

‫14 בינואר 2026

‫androidx.collection:collection-*:1.6.0-beta01 מופץ. גרסה ‎1.6.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

התוספים .toScatterSet() ו-.toScatterMap() נוספו. הפונקציות האלה מספקות חלופה לקריאה בלבד לפונקציות ההמרה שניתנות לשינוי, ומחזירות סינגלטונים ללא הקצאה כשהאוסף של המקור ריק. (I1769a, ‏ b/459867876)
מחליפים את פסאודו-הבנאים MutableScatterMap(source) ו-MutableScatterSet(source) בפונקציות הרגילות של התוסף .toMutableScatterMap() ו-.toMutableScatterSet(). ההתנהגות הזו תואמת למוסכמות של Kotlin לגבי המרות של אוספים. (Ic9ca6, b/459867876)
הוספת פונקציות של יצרן MutableScatterMap(Map) ו-MutableScatterSet(Set). אפשר להשתמש בפונקציות האלה כדי ליצור בקלות אוסף של תרשימי פיזור שמכיל את התוכן של אוסף קיים. (I51d70)

תיקוני באגים

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

גרסה ‎1.6.0-alpha01

‫27 באוגוסט 2025

‫androidx.collection:collection-*:1.6.0-alpha01 מופץ. גרסה ‎1.6.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך KGP 2.0.0 או גרסה חדשה יותר (Idb6b5)

תיקוני באגים

בעבר, הפונקציה SparseArrayCompat החזירה null עבור valueAt ו-keyAt כשמועבר אליה אינדקס שנמצא בטווח המוקצה, אבל מחוץ לטווח המוסף 0..size -1. כפי שמתואר במסמך, אף פעם לא הייתה כוונה שההתנהגות הזו תתרחש, והיא חורגת מטווח הקלט התקין. השינוי הזה מתקן את ההתנהגות הזו, כך שבמקום זאת, כשמועבר אינדקס לא תקין, המערכת תציג את השגיאה IndexOutOfBounds. (I68453)

External Contribution

תודה ל-Jake Wharton על התרומות הבאות:

כדי להתאים את ההתנהגות של joinToString לאוספים של הפלטפורמה, מוסיפים מפריד לפני אינדיקטור החיתוך וסיומת אחריו כשמגבילים את הרכיבים הכלולים. (I1b7e8)
ScatterSet.hashCode כבר לא מגן מפני רקורסיה (כלומר, הוספת הקבוצה לעצמה). השינוי הזה מיישר קו עם ההתנהגות של ScatterMap, HashSet וקבוצות פרימיטיביות שמבוססות על פיזור (למשל, LongSet). שימו לב שהשיטה equals כבר הייתה חשופה לרקורסיה, ו-toString מגן מפניה – שני סוגי ההתנהגויות האלה תואמים לאוספים האחרים. (I9c84a)
הפונקציה ScatterSet.retainAll מוטמעת עכשיו כדי למנוע יצירה של מופע lambda. (Ifa4b7)
ScatterSet.hashCode כבר לא משתמשת בקיבולת שלה בחישוב הגיבוב, וכך מוודאת שתוכן זהה אבל קיבולות שונות עדיין יניבו את אותו ערך. (Ic863b)
‫IllegalStateException מוצג עכשיו אם קוראים ל-remove() לפני next() באיטרטור של האוספים keys, values או entries של ScatterMap.asMap() או ScatterSet.asSet(). כך ההתנהגות שלו תהיה זהה להתנהגות של המפה הרגילה ושל ערכת ההגדרות. (I71694)

גירסה 1.5

גרסה 1.5.0

‫12 במרץ 2025

‫androidx.collection:collection-*:1.5.0 מופץ. גרסה 1.5.0 מכילה את השמירות האלה.

גרסה ‎1.5.0-rc01

‫26 בפברואר 2025

‫androidx.collection:collection-*:1.5.0-rc01 מופץ. גרסה ‎1.5.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.5.0-beta03

‫29 בינואר 2025

‫androidx.collection:collection-*:1.5.0-beta03 מופץ. גרסה ‎1.5.0-beta03 מכילה את השמירות האלה.

גרסה ‎1.5.0-beta02

‫15 בינואר 2025

‫androidx.collection:collection-*:1.5.0-beta02 מופץ. גרסה ‎1.5.0-beta02 מכילה את השמירות האלה.

גרסה ‎1.5.0-beta01

‫11 בדצמבר 2024

‫androidx.collection:collection-*:1.5.0-beta01 מופץ. גרסה ‎1.5.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

נוספה תמיכה ביעד KMP וביעד kotlin 1.9 (Icf15d, ‏ b/364652024)watchosDeviceArm64

גרסה ‎1.5.0-alpha06

‫13 בנובמבר 2024

‫androidx.collection:collection-*:1.5.0-alpha06 מופץ. גרסה ‎1.5.0-alpha06 מכילה את השמירות האלה.

תיקוני באגים

תוקן קראש שיכול היה להתרחש ב-SieveCache וב-OrderedScatterSet כשמוסיפים פריטים רבים שגורמים להתנגשויות חוזרות של מפתחות. ‫(Iaaf3d, ‏ b/375607736)
הוספת יעד wasm לספריית האוסף. ‫(I66fe3, ‏ b/352722444)

גרסה ‎1.5.0-alpha05

‫30 באוקטובר 2024

‫androidx.collection:collection-*:1.5.0-alpha05 מופץ. גרסה ‎1.5.0-alpha05 מכילה את השמירות האלה.

גרסה ‎1.5.0-alpha04

‫16 באוקטובר 2024

‫androidx.collection:collection-*:1.5.0-alpha04 מופץ. גרסה ‎1.5.0-alpha04 מכילה את השמירות האלה.

גרסה ‎1.5.0-alpha03

‫2 באוקטובר 2024

‫androidx.collection:collection-*:1.5.0-alpha03 מופץ. גרסה ‎1.5.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

עדכון גרסת Kotlin ל-1.9 (I1a14c)

External Contribution

העברה אל contains עד containsKey. תודה, Jake Wharton! (I9362b)
הוספת בנאי מאגרים לאוספים סקלריים מיוחדים. תודה, Jake Wharton! (I13179)

גרסה ‎1.5.0-alpha02

‫18 בספטמבר 2024

‫androidx.collection:collection-*:1.5.0-alpha02 מופץ. גרסה ‎1.5.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

הוספנו תמיכה ביעד הפלטפורמה watchosDeviceArm64. (I1cc04, b/364652024)

גרסה ‎1.5.0-alpha01

‫4 בספטמבר 2024

‫androidx.collection:collection-*:1.5.0-alpha01 מופץ. גרסה ‎1.5.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

‫OrderedScatterSet הוא אוסף חדש ללא הקצאה, עם סדר (Ic4178)
‫SieveCache הוא תחליף חדש ל-LruCache שלא דורש הקצאה ומציע מאפיינים טובים יותר של יחס פגיעה. (I50a17)
הצגנו את הייצוג הפנימי של packedValue עבור IntIntPair ו-FloatFloatPair. (Ifeb75, ‏ b/331853566)
הוספת גישה למערך התוכן באוספים של רשימות. (I899d5, b/333903173)
מוסיפים את DoubleList, מבנה נתונים דמוי רשימה שעבר אופטימיזציה לערכי Double. ‫(Ia10d1, ‏ b/315127635)

תיקוני באגים

ספריית האוספים עוברת ל-Kotlin 1.9 (I0782f)
אפשר לבצע אופטימיזציה של הרבה מהאוספים כדי לשפר את היעילות שלהם. (Ic0566)

גרסה 1.4

גרסה 1.4.5

‫30 באוקטובר 2024

‫androidx.collection:collection-*:1.4.5 מופץ. גרסה 1.4.5 מכילה את השמירות האלה.

גרסה 1.4.4

‫18 בספטמבר 2024

‫androidx.collection:collection-*:1.4.4 מופץ. גרסה 1.4.4 מכילה את השמירות האלה.

תיקוני באגים

פתרון עקיף ArrayIndexOutOfBounds כשממיינים אוסף ריק. (I65245)

גרסה 1.4.3

‫7 באוגוסט 2024

‫androidx.collection:collection-*:1.4.3 מופץ. גרסה 1.4.3 מכילה את השמירות האלה.

תיקוני באגים

תוקנה בעיה שגרמה להשחתה ב-ScatterMap, ב-ScatterSet ובגרסאות הפרימיטיביות שלהם. ‫(I38a4a, ‏ b/352560465)
אופטימיזציה של הביצועים. במיוחד:
- מחליפים את הקריאות ל-check() ול-required() בגרסאות שלא כוללות זריקת חריגים בשורה. כך מקטינים את הגודל הסופי של הקובץ הבינארי, וחשוב מכך, מקלים קצת על העומס במטמון ההוראות.
- שיפרנו את removeDeletedMarkers() באוספים מסוג 'פיזור'. בגרסה החדשה, סמני המחיקה נמחקים בקבוצות של 8, והתהליך מדלג על פעולות כתיבה יקרות יותר. (Ic0566)

גרסה 1.4.2

‫24 ביולי 2024

‫androidx.collection:collection-*:1.4.2 מופץ. גרסה 1.4.2 מכילה את השמירות האלה.

תכונות חדשות

כולל יעדים נוספים של Kotlin Multiplatform: ‏ watchos, ‏ tvos, ‏ linuxArm64. (b/352543988)

גרסה 1.4.1

‫10 ביולי 2024

‫androidx.collection:collection-*:1.4.1 מופץ. גרסה 1.4.1 מכילה את השמירות האלה.

תיקוני באגים

הסרה של מצבות שנמחקו מהמפה או מהקבוצה כשמשנים את הגודל. (7a996c5, ‏ b/345960092)

גרסה 1.4.0

‫24 בינואר 2024

‫androidx.collection:collection-*:1.4.0 מופץ. גרסה 1.4.0 מכילה את השמירות האלה.

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

נוספו אוספים חדשים ויעילים לאחסון פרימיטיבים בלי boxing:

‫MutableScatterMap ו-ScatterMap – כיתות עם MutableMap וממשק API שדומה למפה
‫MutableScatterSet & ScatterSet – כיתות עם MutableSet וממשק API דמוי Set
‫MutableObjectList & ObjectList – כיתות עם MutableList וממשק API שדומה לרשימה

לדוגמה, מפה עם מפתח של מספר שלם וערך של סוג הפניה היא IntObjectMap<T>. מפה עם מפתח ארוך וערך מסוג float היא LongFloatMap. אין גרסה בשם ObjectObjectMap כי היא כלולה ב-ScatterMap/MutableScatterMap.

גרסה ‎1.4.0-rc01

‫10 בינואר 2024

הגרסה androidx.collection:collection-*:1.4.0-rc01 יוצאת ללא שינויים. גרסה ‎1.4.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.4.0-beta02

‫29 בנובמבר 2023

‫androidx.collection:collection-*:1.4.0-beta02 מופץ. גרסה ‎1.4.0-beta02 מכילה את השמירות האלה.

תכונות חדשות

שיפור הביצועים של FloatFloatPair. (If5537)

תיקוני באגים

‫ScatterMap.asMap() iterator מחזיר עכשיו מופעים חדשים (I28932, ‏ b/310365754)

גרסה ‎1.4.0-beta01

‫15 בנובמבר 2023

‫androidx.collection:collection-*:1.4.0-beta01 מופץ. גרסה ‎1.4.0-beta01 מכילה את השמירות האלה.

תיקוני באגים

תיקנו את הבעיה שגרמה לListIterator להגדיר ערכים בצורה שגויה ב-ObjectList, מה שיכול היה לגרום לקריסה בגלל IndexOutOfBoundsException. ‫(I3bd8a, ‏ b/307049391)

גרסה ‎1.4.0-alpha02

‫18 באוקטובר 2023

‫androidx.collection:collection-*:1.4.0-alpha02 מופץ. גרסה ‎1.4.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

נוספה פונקציית עומס יתר ל-put שמחזירה את הערך הקודם כשהוא מוחלף בכל האוספים הפרימיטיביים, כמו FloatFloatMap.
המרת שיטות removeIf באוספים פרימיטיביים, כמו removeIf, לשורת קוד.MutableFloatFloatMap כך מוודאים שלא מוקצה lambda ל-removeIf.

גרסה ‎1.4.0-alpha01

‫4 באוקטובר 2023

‫androidx.collection:collection-*:1.4.0-alpha01 מופץ. גרסה ‎1.4.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

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

‫MutableScatterMap ו-ScatterMap – כיתות עם MutableMap וממשק API שדומה למפה
‫MutableScatterSet & ScatterSet – כיתות עם MutableSet וממשק API דמוי Set
‫MutableObjectList & ObjectList – כיתות עם MutableList וממשק API שדומה לרשימה

נוספו אוספים חדשים ויעילים לאחסון פרימיטיבים בלי boxing:

‫Mutable[Int|Float|Long]List – מחלקות עם API שדומה ל-MutableList<Int|Float|Long>. קיים גם [Int|Float|Long]List לקריאה בלבד. לדוגמה, אפשר להשתמש ב-IntList כדי לאחסן מספרים שלמים.
‫Mutable[Int|Float|Long]Set – מחלקות עם API שדומה ל-MutableSet<Int|Float|Long>. קיים גם [Int|Float|Long]Set לקריאה בלבד. לדוגמה, אפשר להשתמש ב-IntSet כדי להחזיק מספרים שלמים.
‫Mutable[Int|Float|Long|Object][Int|Float|Long|Object]Map – מחלקות עם API שדומה ל-Mutable<Int|Float|Long,T, Int|Float|Long|T>. קיים גם [Int|Float|Long|Object][Int|Float|Long|Object]Map לקריאה בלבד. לדוגמה, מפה עם מפתח של מספר שלם וערך של סוג הפניה היא IntObjectMap<T>. מפה עם מפתח ארוך וערך מסוג float היא LongFloatMap. אין גרסה בשם ObjectObjectMap כי היא כלולה ב-ScatterMap/MutableScatterMap.

גרסה 1.3.0

‫4 באוקטובר 2023

‫androidx.collection:collection-*:1.3.0 מופץ. גרסה 1.3.0 מכילה את השמירות האלה.

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

מעכשיו אפשר להשתמש ב-Collections בפרויקטים של Kotlin Multiplatform. שימו לב: יעדים שאינם Android של אוספים עדיין נמצאים בשלב הניסוי, אבל החלטנו למזג גרסאות כדי להקל על מפתחים לנסות אותם.
כל הקוד המקורי הועבר ל-Kotlin. כחלק מהשינוי הזה, הרבה ממשקי API מוקלדים עכשיו בצורה נכונה לגבי ערכי null, וכמה חברים פרטיים בחבילה הפכו ל-internal. רשימה של השינויים המדויקים זמינה בהמשך בנתוני הגרסה המשנית 1.3.x.
בנוסף להעברה ל-Kotlin, ‏collection-ktx מוזג עם ארטיפקט האוסף הראשי. אפשר להסיר בבטחה את כל התלות ב-collection:collection-ktx לטובת collection:collection כי collection-ktx ריק עכשיו.

גרסה ‎1.3.0-rc01

‫6 בספטמבר 2023

הגרסה androidx.collection:collection-*:1.3.0-rc01 יוצאת ללא שינויים. גרסה ‎1.3.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.3.0-beta01

‫9 באוגוסט 2023

‫androidx.collection:collection-*:1.3.0-beta01 מופץ. גרסה ‎1.3.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.3.0-alpha04

‫24 במרץ 2023

‫androidx.collection:collection-*:1.3.0-alpha04 מופץ.

תיקוני באגים

הוסרו אילוצי תלות מפריטי Maven כדי לעקוף בעיה ב-build ביעדי Kotlin Native ‏ (b/274786186, ‏ KT-57531).

גרסה ‎1.3.0-alpha03

‫22 במרץ 2023

‫androidx.collection:collection-*:1.3.0-alpha03 מופץ. גרסה ‎1.3.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

‫ArraySet מטמיע עכשיו את MutableCollections במקום AbstractMutableCollection כדי לאפשר הטמעה יעילה יותר של toArray (I1ac32)

תיקוני באגים

‫ArraySet.toArray זמין עכשיו רק ב-JVM, כי הוא תמיד נכלל רק לצורך תאימות ל-Java. משתמשי Kotlin צריכים בדרך כלל להשתמש במקום זאת בעוזרים של stdlib‏ .toTypedArray, שמספקים את אותה פונקציונליות בדיוק עם בטיחות נוספת של סוגים. (I2c59b)

גרסה ‎1.3.0-alpha02

‫27 ביולי 2022

‫androidx.collection:collection:1.3.0-alpha02 וגם androidx.collection:collection-ktx:1.3.0-alpha02 מופצים. גרסה ‎1.3.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

‫SparseArrayCompat זמין עכשיו בפלטפורמות שאינן JVM מתוך הארטיפקט המשותף (Ic9bd0, ‏ b/219589118, ‏ b/228347315)
‫CircularIntArray זמין עכשיו בפלטפורמות שאינן JVM מתוך הארטיפקט המשותף (I3d8ef, b/228344943)
‫LongSparseArray זמין עכשיו בפלטפורמות שאינן JVM מתוך הארטיפקט המשותף (I73149, ‏ b/228347315)

גרסה ‎1.3.0-alpha01

29 ביוני 2022

‫androidx.collection:collection:1.3.0-alpha01 וגם androidx.collection:collection-ktx:1.3.0-alpha01 מופצים. גרסה ‎1.3.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

collection-ktx תוספים הועברו אל ארטיפקט האוספים הראשי, androidx.collection:collection. השינוי הזה מאפשר למשתמשי Kotlin לגשת לתוספים הקיימים מראש מסוג ‎-ktx בלי לדרוש את התלות ב-‎-ktx, ועדיין לשמור על תאימות למשתמשים קיימים. אין יותר יתרון בשמירה של התוספים האלה בארטיפקט נפרד מסוג ‎-ktx, כי הארטיפקט הראשי עבר ל-Kotlin. (I6eef2)

שינויים ב-API

‫ArraySet מרחיב עכשיו את AbstractMutableCollection ולא מיישם יותר ישירות את הממשק Collection. ‫(If6da0, b/230860589)
המרת ArraySet ל-Kotlin. בגלל הקלדה מחמירה יותר, יכול להיות שחלק מהקריאות ל-Kotlin לא יקומפלו יותר. (Id68c1, b/230860589)
- הקריאות הבאות כוללות את סוג הארגומנט T ולא T?:
  - ArraySet<T>.contains(null)
  - ArraySet<T>.add(null)
  - ArraySet<T>.remove(null)
- השיחות הבאות הן מסוג ההחזרה T? ולא T!:
  - ArraySet<T?>.valueAt(n)
  - ArraySet<T?>.removeAt(n)
  - ArraySet<T?>().iterator().next()
- אי אפשר יותר לבצע את הקריאות הבאות מ-Kotlin:
  - set.toArray() – שימוש set.toTypedArray()
  - set.toArray(array) – שימוש set.forEachIndexed(array::set)
שילוב של בנאי עם עומס יתר עבור SparseArrayCompat כארגומנט אופציונלי למשתמשי Kotlin. ‫(If8407, ‏ b/227474719)
הסרת תחביר של אופרטורים עבור SparseArrayCompat.get(key, defaultValue). שימו לב שעדיין אפשר להשתמש בתחביר של אופרטורים עבור .get(key), אבל השינוי הזה משפר את ההתאמה של API surface של SparseArrayCompat למחלקות האחרות בספרייה הזו. (I9a38d)
העברנו LongSparseArray תוספים לארטיפקט הראשי, androidx.collection:collection. השינוי הזה מאפשר למשתמשי Kotlin לגשת לתוספים הקיימים מראש מסוג ‎-ktx בלי לדרוש את התלות ב-‎-ktx, ועדיין לשמור על תאימות למשתמשים קיימים. אין יותר יתרון בשמירה של התוספים האלה בארטיפקט נפרד מסוג ‎-ktx, כי הארטיפקט הראשי עבר ל-Kotlin. (I8659a)
המרת LongSparseArray ל-Kotlin. השינוי הזה מוסיף אפשרות מפורשת לערך null לסוגים שלו, וזה שינוי שמתאים לבינארי, אבל עלול לגרום לחוסר תאימות למקור. במיוחד: * אי אפשר יותר לגשת אל .isEmpty כאל מאפיין, צריך לגשת אליו כאל קריאה לפונקציה ב-Kotlin –‏ .isEmpty() (Idfd0f)
המרת SimpleArrayMap ל-Kotlin. השינוי הזה כולל כמה שינויים לא תואמים, כתוצאה מפעולת הדדית בין Java ל-Kotlin ומהיכולת להגדיר נכון את האפשרות שסוגים מסוימים יהיו ריקים במקור.
- ממשקי ה-API הפרטיים של החבילה, .mSize,‏ .mArray,‏ .mHashes,‏ .indexOf(),‏ .indexOfNull() ו-.indexOfValue(), הפכו לפרטיים – מבחינה טכנית זהו שינוי שגורם לאי-תאימות בינארית, אבל הוא משקף את הנראות המיועדת של השדות האלה, וזה הכי קרוב שאפשר להגיע ב-Kotlin, כי אין בה דרך לציין נראות פרטית של חבילה.
- הגדרנו עכשיו בצורה נכונה את האפשרות להגדיר ערך null בחלק מהסוגים. השינוי הזה משפיע על השיטות הבאות: .getOrDefault,‏ .keyAt,‏ .valueAt,‏ .setValueAt,‏ .put,‏ .putIfAbsent,‏ .removeAt,‏ .replace.
- משתמשי Kotlin יכולים להשתמש ב-.isEmpty() רק כפונקציה, ולא גם דרך גישה למאפיין. (I271b7, b/182813986)
המרת CircularArray ל-Kotlin. שינויים בולטים:
- הפונקציה מתקנת את הערך null של הגנריקה שלה כך שלא יהיה null. בעבר לא הייתה אפשרות להצהיר על כך, אבל זה נאכף בכל ממשקי ה-API הציבוריים שלה.
- בגלל יכולת הפעולה ההדדית של Kotlin עם Java, בעבר הייתה אפשרות לגשת לשיטות מסוימות גם כמאפיינים וגם כפונקציות. עם זאת, כדי לצמצם כפילויות ולשמור על תאימות בינארית, היה צורך להסיר אותן, וזהו שינוי שגורם לאי-תאימות בקוד המקור. השיחות המושפעות הן: .isEmpty, ‏ .getLast() ו-.getFirst(). (Ifffac)
המרת CircularIntArray ל-Kotlin. בגלל יכולת הפעולה ההדדית של Kotlin עם Java, בעבר הייתה אפשרות לגשת לשיטות מסוימות גם כמאפיינים וגם כפונקציות. עם זאת, כדי לצמצם כפילויות ולשמור על תאימות בינארית, היה צורך להסיר אותן, וזה שינוי שגורם לאי-תאימות למקור. השיחות המושפעות הן: .isEmpty, ‏ .getLast() ו-.getFirst(). (Ie36ce)
המרת LruCache ל-Kotlin‏ (Ia2f19)
המרת SparseArrayCompat ל-Kotlin. ‫(If6fe8)

נוסף שינוי קטן בהתנהגות של SparseArrayCompat.valueAt(), כך שהפונקציה לא מחזירה יותר את הערך null באופן שגוי לקריאות שלא אותחלו מחוץ לגבולות של size() אבל בתוך הקיבולת הראשונית שסופקה.

השינוי הזה כולל גם את הערך הנכון של null עבור חלק מהסוגים, שלא היה קיים קודם.
- ‫.get(): E? -> ‏.get(): E
- ‫.replace(Int, Int?): Int? -> ‏.replace(Int, Int): Int?
- ‫.replace(Int, Int?, Int?): Boolean -> ‏.replace(Int, Int, Int): Boolean
- ‫.put(Int, Int?) -> ‏.put(Int, Int)
- ‫.putIfAbsent(Int, Int?): Int? -> ‏.putIfAbsent(Int, Int): Int?
- ‫.setValueAt(index: Int, value: Int?) -> ‏.setValueAt(index: Int, value: Int)
- ‫.indexOfValue(value: Int?): Int -> ‏.indexOfValue(value: Int): Int
- ‫.containsValue(value: Int?): Boolean -> ‏.containsValue(value: Int): Boolean
- ‫.append(key: Int, value: Int?) -> ‏.append(key: Int, value: Int)

גרסה 1.2.0

1 בדצמבר 2021

‫androidx.collection:collection:1.2.0 וגם androidx.collection:collection-ktx:1.2.0 מופצים. גרסה 1.2.0 מכילה את השמירות האלה.

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

מוסיפים בנאי של מערך ל-ArraySet. (Id7f19)
כדי שהאפליקציה תעמוד בדרישות של entrySet() API, צריך להטמיע את entrySet().toArray(), ‏ remove(), ‏ removeAll() ו-retainAll(), ולהסיר את ההטמעה של entrySet().addAll() (I5d505)

גרסה ‎1.2.0-rc01

‫17 בנובמבר 2021

‫androidx.collection:collection:1.2.0-rc01 וגם androidx.collection:collection-ktx:1.2.0-rc01 מופצים. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

שינויים ב-API

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

גרסה ‎1.2.0-beta01

‫13 באוקטובר 2021

‫androidx.collection:collection:1.2.0-beta01 וגם androidx.collection:collection-ktx:1.2.0-beta01 מופצים. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

תיקוני באגים

כדי שהאפליקציה תעמוד בדרישות של entrySet() API, צריך להטמיע את entrySet().toArray(), ‏ remove(), ‏ removeAll() ו-retainAll(), ולהסיר את ההטמעה של entrySet().addAll() (I5d505)

גרסה ‎1.2.0-alpha01

‫16 בדצמבר 2020

‫androidx.collection:collection:1.2.0-alpha01 וגם androidx.collection:collection-ktx:1.2.0-alpha01 מופצים. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

מוסיפים בנאי של מערך ל-ArraySet. (Id7f19)

גרסה 1.1.0

‫5 ביוני 2019

‫androidx.collection:collection:1.1.0 וגם androidx.collection:collection-ktx:1.1.0 מופצים. כאן אפשר לראות את השמירות שכלולות בגרסה 1.1.0.

סיכום השינויים מגרסה 1.0.0 לגרסה 1.1.0:

תכונות חדשות

שימוש בהטמעה יעילה יותר של הפונקציות contains ו-isNotEmpty בארטיפקט collection-ktx. (aosp/866529)

שינויים ב-API

הוספת putIfAbsent אל LongSparseArray, אל SimpleArrayMap ואל SparseArrayCompat (aosp/772608)
הוספה של getOrDefault אל SimpleArrayMap (aosp/772607)
הוספת הפונקציה remove עם שני ארגומנטים אל LongSparseArray,‏ SimpleArrayMap ו-SparseArrayCompat. הוצאה משימוש של תוספי KTX תואמים לפונקציונליות הזו. (aosp/772482)
הוספת replace עם שני ארגומנטים אל LongSparseArray, SimpleArrayMap ו-SparseArrayCompat (aosp/772483)
הוספת replace עם שלושה ארגומנטים ל-LongSparseArray, ל-SimpleArrayMap ול-SparseArrayCompat (aosp/772484)
הוצאה משימוש של שיטות delete מיותרות. השיטה remove מציעה את אותו API ואותה פונקציונליות, והיא תואמת ל-API שבו נעשה שימוש במפות לא ייעודיות. (aosp/866053)

תיקוני באגים

משנים את SimpleArrayMap כדי לסנכרן את המטמון הגלובלי הפנימי של מערכי נתונים ב-SimpleArrayMap.class במקום ב-ArrayMap.class. כך, אם משתמשים רק ב-SimpleArrayMap, אפשר להסיר את ArrayMap באמצעות כלים לצמצום קוד. (aosp/934557)

גרסה ‎1.1.0-rc01

‫7 במאי 2019

‫androidx.collection:collection:1.1.0-rc01 וגם androidx.collection:collection-ktx:1.1.0-rc01 מופצים. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תכונות חדשות

שימוש בהטמעה יעילה יותר של הפונקציות contains ו-isNotEmpty בארטיפקט collection-ktx. (aosp/866529)

גרסה ‎1.1.0-beta01

‫3 באפריל 2019

‫androidx.collection:collection:1.1.0-beta01 וגם androidx.collection:collection-ktx:1.1.0-beta01 מופצים. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

שינויים ב-API

השיטה שצוין בהערות הגרסה של אלפא03 שהערך שלה @RestrictTo השתנה הוסרה. הוא לא היה בשימוש באף ספריית AndroidX (עכשיו או בעבר) והוא לא הציע פונקציונליות שלא הייתה קיימת ב-API הציבורי.

תיקוני באגים

משנים את SimpleArrayMap כדי לסנכרן את המטמון הגלובלי הפנימי של מערכי נתונים ב-SimpleArrayMap.class במקום ב-ArrayMap.class. כך, אם משתמשים רק ב-SimpleArrayMap, אפשר להסיר את ArrayMap באמצעות כלים לצמצום קוד. (aosp/934557)

גרסה ‎1.1.0-alpha03

‫13 במרץ 2019

‫androidx.collection:collection:1.0.0-alpha03 וגם androidx.collection:collection-ktx:1.0.0-alpha03 מופצים. כאן אפשר לראות את הרשימה המלאה של פעולות ה-commit שכלולות בגרסה הזו.

שינויים ב-API

שיטה ב-ArraySet שסומנה בעבר כ-@RestrictTo(LIBRARY_GROUP) שונתה ל-@RestrictTo(LIBRARY_GROUP_PREFIX). הסיבה לכך היא תמיכה בשימוש היסטורי בספריות אחרות של AndroidX, שנמצאות עכשיו במזהי קבוצות שונים של Maven. השיטה הזו תהפוך לציבורית או תוסר בגרסה 1.1.0-alpha04 כי לספריות אחרות של AndroidX לא צריכות להיות ממשקי API מיוחדים שאינם זמינים למפתחים אחרים.

גרסה ‎1.1.0-alpha02

‫30 בינואר 2019

‫androidx.collection:collection 1.1.0-alpha02 וגם androidx.collection:collection-ktx 1.1.0-alpha02 מופצים.

שינויים ב-API

הוצאה משימוש של שיטות delete מיותרות. השיטות remove מציעות את אותו API ואת אותה פונקציונליות, והן תואמות ל-API שמשמש במפות לא ייעודיות. (aosp/866053)

גרסה ‎1.1.0-alpha01

‫3 בדצמבר 2018

שינויים ב-API

הוספת putIfAbsent אל LongSparseArray, אל SimpleArrayMap ואל SparseArrayCompat (aosp/772608)
הוספה של getOrDefault אל SimpleArrayMap (aosp/772607)
הוספת הפונקציה remove עם שני ארגומנטים אל LongSparseArray,‏ SimpleArrayMap ו-SparseArrayCompat. הוצאה משימוש של תוספי KTX תואמים לפונקציונליות הזו. (aosp/772482)
הוספת replace עם שני ארגומנטים אל LongSparseArray, SimpleArrayMap ו-SparseArrayCompat (aosp/772483)
הוספת replace עם שלושה ארגומנטים ל-LongSparseArray, ל-SimpleArrayMap ול-SparseArrayCompat (aosp/772484)