Kolekcja

  
Zmniejsz wpływ na pamięć w przypadku małych kolekcji (zarówno nowych, jak i istniejących).
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja Beta Wersja alfa
27 sierpnia 2025 roku 1.5.0 - - 1.6.0-alpha01

Deklarowanie zależności

Aby dodać zależność od Collection, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

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")
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.6

Wersja 1.6.0-alpha01

27 sierpnia 2025 roku

Publikacja androidx.collection:collection-*:1.6.0-alpha01 Wersja 1.6.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Projekty wydane w Kotlinie 2.0 wymagają do użycia KGP w wersji 2.0.0 lub nowszej (Idb6b5).

Poprawki błędów

  • Wcześniej funkcja SparseArrayCompat zwracała wartość null dla parametru valueAt i keyAt, gdy przekazywano indeks, który mieścił się w przydzielonym zakresie, ale poza wstawionym zakresem 0..size -1. Jak udokumentowano, takie zachowanie nigdy nie było oczekiwane i wykraczało poza prawidłowy zakres danych wejściowych. Ta zmiana naprawia to zachowanie, tak aby w przypadku przekazania nieprawidłowego indeksu zgłaszać wyjątek IndexOutOfBounds. (I68453)

Wkład zewnętrzny

Dziękujemy Jake’owi Whartonowi za te publikacje:

  • Dostosuj działanie joinToString do kolekcji platformy, dodając separator przed wskaźnikiem obcięcia i przyrostek po nim podczas ograniczania uwzględnionych elementów. (I1b7e8)
  • ScatterSet.hashCode nie chroni już przed rekurencją (czyli dodawaniem zbioru do samego siebie). Dzięki temu zachowuje się tak samo jak ScatterMap, HashSet i zbiory oparte na rozproszeniu pierwotnym (np. LongSet). Pamiętaj, że metoda equals była już podatna na rekurencję, a toString chroni przed nią – oba te zachowania są zgodne z innymi kolekcjami. (I9c84a)
  • Funkcja ScatterSet.retainAll jest teraz wstawiana w kodzie, aby uniknąć tworzenia instancji lambda. (Ifa4b7)
  • ScatterSet.hashCode nie używa już swojej pojemności w obliczeniach skrótu, co zapewnia, że równe treści, ale o różnej pojemności, nadal dają tę samą wartość. (Ic863b)
  • Wyjątek IllegalStateException jest teraz zgłaszany, jeśli wywołasz funkcję remove() przed next() na iteratorze kolekcji keys, values lub entries typu ScatterMap.asMap() lub ScatterSet.asSet(). Dzięki temu będzie działać tak samo jak zwykła mapa i zbiór. (I71694)

Wersja 1.5

Wersja 1.5.0

12 marca 2025 r.

Publikacja androidx.collection:collection-*:1.5.0 Wersja 1.5.0 zawiera te zmiany.

Wersja 1.5.0-rc01

26 lutego 2025 r.

Publikacja androidx.collection:collection-*:1.5.0-rc01 Wersja 1.5.0-rc01 zawiera te zmiany.

Wersja 1.5.0-beta03

29 stycznia 2025 r.

Publikacja androidx.collection:collection-*:1.5.0-beta03 Wersja 1.5.0-beta03 zawiera te zmiany.

Wersja 1.5.0-beta02

15 stycznia 2025 r.

Publikacja androidx.collection:collection-*:1.5.0-beta02 Wersja 1.5.0-beta02 zawiera te zmiany.

Wersja 1.5.0-beta01

11 grudnia 2024 r.

Publikacja androidx.collection:collection-*:1.5.0-beta01 Wersja 1.5.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano obsługę watchosDeviceArm64 KMP i wersji 1.9 języka Kotlin (Icf15d, b/364652024)

Wersja 1.5.0-alpha06

13 listopada 2024 r.

Publikacja androidx.collection:collection-*:1.5.0-alpha06 Wersja 1.5.0-alpha06 zawiera te zmiany.

Poprawki błędów

  • Naprawiliśmy awarię, która mogła wystąpić w SieveCacheOrderedScatterSet podczas dodawania wielu elementów powodujących powtarzające się kolizje kluczy. (Iaaf3d, b/375607736)
  • Dodaj element docelowy wasm do biblioteki kolekcji. (I66fe3, b/352722444)

Wersja 1.5.0-alpha05

30 października 2024 r.

Publikacja androidx.collection:collection-*:1.5.0-alpha05 Wersja 1.5.0-alpha05 zawiera te zmiany.

Wersja 1.5.0-alpha04

16 października 2024 r.

Publikacja androidx.collection:collection-*:1.5.0-alpha04 Wersja 1.5.0-alpha04 zawiera te zmiany.

Wersja 1.5.0-alpha03

2 października 2024 r.

Publikacja androidx.collection:collection-*:1.5.0-alpha03 Wersja 1.5.0-alpha03 zawiera te zmiany.

Zmiany w interfejsie API

  • Aktualizacja wersji Kotlina do 1.9 (I1a14c)

Wkład zewnętrzny

  • Jedź dalej na contains do: containsKey. Dzięki, Jake Wharton! (I9362b)
  • Dodaj konstruktory kontenerów dla kolekcji wyspecjalizowanych w skalarach. Dzięki, Jake Wharton! (I13179)

Wersja 1.5.0-alpha02

18 września 2024 r.

Publikacja androidx.collection:collection-*:1.5.0-alpha02 Wersja 1.5.0-alpha02 zawiera te zmiany.

Zmiany w interfejsie API

Wersja 1.5.0-alpha01

4 września 2024 r.

Publikacja androidx.collection:collection-*:1.5.0-alpha01 Wersja 1.5.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • OrderedScatterSet to nowa kolekcja bez przydziału (Ic4178)
  • SieveCache to nowy zamiennik LruCache, który nie wymaga przydzielania pamięci i ma lepsze charakterystyki współczynnika trafień. (I50a17)
  • Udostępniliśmy wewnętrzną reprezentację packedValue dla IntIntPairFloatFloatPair. (Ifeb75, b/331853566)
  • Dodawanie dostępu do tablicy treści w kolekcjach list. (I899d5, b/333903173)
  • Dodaliśmy DoubleList, strukturę danych podobną do listy zoptymalizowaną pod kątem wartości typu Double. (Ia10d1, b/315127635)

Poprawki błędów

  • Biblioteka kolekcji zostanie przeniesiona na Kotlin 1.9 (I0782f)
  • Zoptymalizuj wiele kolekcji, aby zwiększyć ich wydajność. (Ic0566)

Wersja 1.4

Wersja 1.4.5

30 października 2024 r.

Publikacja androidx.collection:collection-*:1.4.5 Wersja 1.4.5 zawiera te zmiany.

Wersja 1.4.4

18 września 2024 r.

Publikacja androidx.collection:collection-*:1.4.4 Wersja 1.4.4 zawiera te zmiany.

Poprawki błędów

  • Obejście ArrayIndexOutOfBounds podczas sortowania pustej kolekcji. (I65245)

Wersja 1.4.3

7 sierpnia 2024 r.

Publikacja androidx.collection:collection-*:1.4.3 Wersja 1.4.3 zawiera te zmiany.

Poprawki błędów

  • Usunięto błąd, który mógł powodować uszkodzenie danych w przypadku typów ScatterMap, ScatterSet i ich wariantów pierwotnych. (I38a4a, b/352560465)
  • Optymalizacje wydajności. W szczególności:
    • Zastąp wywołania funkcji check()required() wariantami, które nie wstawiają wyjątków w kodzie. Zmniejsza to rozmiar końcowego pliku binarnego, a co ważniejsze, nieco zmniejsza obciążenie pamięci podręcznej instrukcji.
    • Ulepszone removeDeletedMarkers() w kolekcjach z rodziny „scatter”. Nowa wersja usuwa po 8 znaczników usunięcia naraz i pomija droższe operacje zapisu. (Ic0566)

Wersja 1.4.2

24 lipca 2024 r.

Publikacja androidx.collection:collection-*:1.4.2 Wersja 1.4.2 zawiera te zmiany.

Nowe funkcje

  • Obejmuje dodatkowe platformy Kotlin Multiplatform: watchos, tvos, linuxArm64. (b/352543988)

Wersja 1.4.1

10 lipca 2024 r.

Publikacja androidx.collection:collection-*:1.4.1 Wersja 1.4.1 zawiera te zmiany.

Poprawki błędów

  • Usuwanie usuniętych znaczników z mapy lub zbioru podczas zmiany rozmiaru. (7a996c5, b/345960092)

Wersja 1.4.0

24 stycznia 2024 r.

Publikacja androidx.collection:collection-*:1.4.0 Wersja 1.4.0 zawiera te zmiany.

Ważne zmiany od wersji 1.3.0

Dodaliśmy nowe kolekcje o wysokiej wydajności do przechowywania typów prostych bez opakowywania:

  • MutableScatterMap & ScatterMap - Classes with MutableMap & Map-like API
  • MutableScatterSet i ScatterSet – klasy z MutableSet i interfejsem API podobnym do zbioru
  • MutableObjectList & ObjectList - Classes with MutableList & List-like API

Na przykład mapa z kluczem całkowitym i wartością typu odniesienia to IntObjectMap<T>. Mapa z długim kluczem i wartością zmiennoprzecinkową to LongFloatMap. Nie ma wersji o nazwie ObjectObjectMap, ponieważ jest ona objęta wersją ScatterMap/MutableScatterMap.

Wersja 1.4.0-rc01

10 stycznia 2024 r.

androidx.collection:collection-*:1.4.0-rc01 zostaje opublikowany bez zmian. Wersja 1.4.0-rc01 zawiera te zmiany.

Wersja 1.4.0-beta02

29 listopada 2023 r.

Publikacja androidx.collection:collection-*:1.4.0-beta02 Wersja 1.4.0-beta02 zawiera te zmiany.

Nowe funkcje

  • Poprawiona wydajność FloatFloatPair. (If5537)

Poprawki błędów

Wersja 1.4.0-beta01

15 listopada 2023 r.

Publikacja androidx.collection:collection-*:1.4.0-beta01 Wersja 1.4.0-beta01 zawiera te zmiany.

Poprawki błędów

  • Poprawka dotycząca ListIterator, która nieprawidłowo ustawiała wartości w ObjectList, co mogło powodować awarię z powodu IndexOutOfBoundsException. (I3bd8a, b/307049391)

Wersja 1.4.0-alpha02

18 października 2023 r.

Publikacja androidx.collection:collection-*:1.4.0-alpha02 Wersja 1.4.0-alpha02 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano przeciążenie dla put, które zwraca poprzednią wartość, gdy jest ona zastępowana we wszystkich kolekcjach typów prostych, takich jak FloatFloatMap.
  • Konwertuj metody removeIf w kolekcjach typów prostych, np. MutableFloatFloatMap, na wbudowane. Dzięki temu lambda dla removeIf nie zostanie przydzielona.

Wersja 1.4.0-alpha01

4 października 2023 roku

Publikacja androidx.collection:collection-*:1.4.0-alpha01 Wersja 1.4.0-alpha01 zawiera te zmiany.

Nowe funkcje

Dodano nowe kolekcje o wysokiej wydajności, które mają niski narzut alokacji i wysoką wydajność:

  • MutableScatterMap & ScatterMap - Classes with MutableMap & Map-like API
  • MutableScatterSet i ScatterSet – klasy z MutableSet i interfejsem API podobnym do zbioru
  • MutableObjectList & ObjectList - Classes with MutableList & List-like API

Dodaliśmy nowe kolekcje o wysokiej wydajności do przechowywania typów prostych bez opakowywania:

  • Mutable[Int|Float|Long]List – klasy z interfejsem API podobnym do MutableList<Int|Float|Long>. Istnieje też wersja [Int|Float|Long]List tylko do odczytu. Na przykład liczby całkowite mogą być przechowywane w obiekcie IntList.
  • Mutable[Int|Float|Long]Set – klasy z interfejsem API podobnym do MutableSet<Int|Float|Long>. Istnieje też wersja [Int|Float|Long]Set tylko do odczytu. Na przykład liczby całkowite można przechowywać w obiekcie IntSet.
  • Mutable[Int|Float|Long|Object][Int|Float|Long|Object]Map – klasy z interfejsem API podobnym do Mutable<Int|Float|Long,T, Int|Float|Long|T>. Istnieje też wersja [Int|Float|Long|Object][Int|Float|Long|Object]Map tylko do odczytu. Na przykład mapa z kluczem całkowitym i wartością typu odniesienia to IntObjectMap<T>. Mapa z długim kluczem i wartością zmiennoprzecinkową to LongFloatMap. Nie ma wersji o nazwie ObjectObjectMap, ponieważ jest ona objęta wersją ScatterMap/MutableScatterMap.

Wersja 1.3.0

Wersja 1.3.0

4 października 2023 roku

Publikacja androidx.collection:collection-*:1.3.0 Wersja 1.3.0 zawiera te zmiany.

Ważne zmiany od wersji 1.2.0

  • Teraz możesz używać kolekcji w projektach Kotlin Multiplatform. Pamiętaj, że platformy inne niż Android w przypadku kolekcji są nadal w fazie eksperymentalnej, ale postanowiliśmy połączyć wersje, aby ułatwić deweloperom ich wypróbowanie.
  • Cały kod źródłowy został przeniesiony do języka Kotlin. W ramach tej zmiany wiele interfejsów API ma teraz prawidłowe typy wartości null, a kilka elementów prywatnych pakietu stało się internal. Listę dokładnych zmian znajdziesz poniżej w informacjach o wersji 1.3.x.
  • Wraz z migracją do języka Kotlin collection-ktx został scalony z głównym artefaktem kolekcji. Możesz bezpiecznie usunąć wszystkie zależności od collection:collection-ktx na rzecz collection:collection, ponieważ collection-ktx jest teraz puste.

Wersja 1.3.0-rc01

6 września 2023 r.

androidx.collection:collection-*:1.3.0-rc01 zostaje opublikowany bez zmian. Wersja 1.3.0-rc01 zawiera te zmiany.

Wersja 1.3.0-beta01

9 sierpnia 2023 r.

Publikacja androidx.collection:collection-*:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zmiany.

Wersja 1.3.0-alpha04

24 marca 2023 r.

Publikacja androidx.collection:collection-*:1.3.0-alpha04

Poprawki błędów

  • Usunięto ograniczenia zależności z artefaktów Maven, aby obejść problem z kompilacją w przypadku natywnych elementów docelowych Kotlin (b/274786186, KT-57531).

Wersja 1.3.0-alpha03

22 marca 2023 r.

Publikacja androidx.collection:collection-*:1.3.0-alpha03 Wersja 1.3.0-alpha03 zawiera te zmiany.

Nowe funkcje

  • Możesz teraz używać kolekcji w projektach KMM. Pamiętaj, że platformy inne niż Android w przypadku kolekcji są nadal w fazie eksperymentalnej, ale postanowiliśmy połączyć wersje, aby deweloperzy mogli je łatwiej wypróbować.

Zmiany w interfejsie API

  • ArraySet używa teraz MutableCollections zamiast AbstractMutableCollection, aby umożliwić bardziej wydajne pod względem pamięci wdrożenie toArray (I1ac32).

Poprawki błędów

  • ArraySet.toArray jest teraz dostępny tylko w JVM, ponieważ zawsze był uwzględniany tylko ze względu na zgodność z Java. Użytkownicy języka Kotlin powinni raczej korzystać z funkcji pomocniczych .toTypedArray biblioteki standardowej, które zapewniają dokładnie taką samą funkcjonalność, ale z dodatkowym bezpieczeństwem typów. (I2c59b)

Wersja 1.3.0-alpha02

27 lipca 2022 roku

androidx.collection:collection:1.3.0-alpha02androidx.collection:collection-ktx:1.3.0-alpha02 zostają opublikowane. Wersja 1.3.0-alpha02 zawiera te zmiany.

Zmiany w interfejsie API

  • SparseArrayCompat jest teraz dostępny na platformach innych niż JVM w ramach wspólnego artefaktu (Ic9bd0, b/219589118, b/228347315).
  • CircularIntArray jest teraz dostępny na platformach innych niż JVM w ramach wspólnego artefaktu (I3d8ef, b/228344943).
  • LongSparseArray jest teraz dostępny na platformach innych niż JVM w ramach wspólnego artefaktu (I73149, b/228347315).

Wersja 1.3.0-alpha01

29 czerwca 2022 r.

androidx.collection:collection:1.3.0-alpha01androidx.collection:collection-ktx:1.3.0-alpha01 zostają opublikowane. Wersja 1.3.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • collection-ktx rozszerzeń zostało przeniesionych do głównego artefaktu kolekcji, androidx.collection:collection. Dzięki tej zmianie użytkownicy języka Kotlin będą mogli korzystać z wcześniej dostępnych rozszerzeń -ktx bez konieczności dodawania zależności -ktx, a dotychczasowi użytkownicy zachowają kompatybilność. Utrzymywanie tych rozszerzeń w osobnym artefakcie -ktx nie jest już korzystne, ponieważ główny artefakt został przeniesiony do języka Kotlin. (I6eef2)

Zmiany w interfejsie API

  • ArraySet rozszerza teraz AbstractMutableCollection i nie implementuje już bezpośrednio interfejsu Collection. (If6da0, b/230860589)
  • Przekonwertowano ArraySet na Kotlin. Ze względu na bardziej rygorystyczne typowanie niektóre wywołania w Kotlinie mogą już nie być kompilowane. (Id68c1, b/230860589)
    • Te wywołania mają argument typu T, a nie T?:
      • ArraySet<T>.contains(null)
      • ArraySet<T>.add(null)
      • ArraySet<T>.remove(null)
    • Te wywołania mają typ zwracany T?, a nie T!:
      • ArraySet<T?>.valueAt(n)
      • ArraySet<T?>.removeAt(n)
      • ArraySet<T?>().iterator().next()
    • Z Kotlin nie można już wykonywać tych wywołań:
      • set.toArray() – użyj set.toTypedArray()
      • set.toArray(array) – użyj set.forEachIndexed(array::set)
  • Połącz przeciążony konstruktor dla SparseArrayCompat jako argument opcjonalny dla użytkowników Kotlin. (If8407, b/227474719)
  • Usuń składnię operatora dla SparseArrayCompat.get(key, defaultValue).. Pamiętaj, że nadal zezwala to na składnię operatora dla .get(key), ale lepiej dopasowuje powierzchnię interfejsu API SparseArrayCompat do innych klas w tej bibliotece. (I9a38d)
  • Przenieś rozszerzenia LongSparseArray do głównego artefaktu androidx.collection:collection. Dzięki tej zmianie użytkownicy języka Kotlin będą mogli korzystać z wcześniej dostępnych rozszerzeń -ktx bez konieczności dodawania zależności -ktx, a dotychczasowi użytkownicy zachowają kompatybilność. Utrzymywanie tych rozszerzeń w osobnym artefakcie -ktx nie jest już korzystne, ponieważ główny artefakt został przeniesiony do języka Kotlin. (I8659a)
  • Przekonwertuj LongSparseArray na Kotlin. Ta zmiana dodaje do typów jawne wartości null, co jest zmianą zgodną binarnie, ale może powodować niezgodności w kodzie źródłowym. W szczególności: * .isEmpty nie jest już dostępny jako właściwość, musi być dostępny jako wywołanie funkcji w języku Kotlin – .isEmpty() (Idfd0f)
  • Przekonwertuj SimpleArrayMap na Kotlin. Ta zmiana wprowadza kilka niezgodnych zmian wynikających z współdziałania języków Java i Kotlin oraz możliwości prawidłowego określania wartości null typów w kodzie źródłowym.
    • Interfejsy API pakietu prywatnego .mSize, .mArray, .mHashes, .indexOf(), .indexOfNull().indexOfValue() zostały ustawione jako prywatne. Jest to technicznie zmiana powodująca niezgodność binarną, ale odzwierciedla zamierzoną widoczność tych pól i jest najbliższym rozwiązaniem, jakie możemy osiągnąć w Kotlinie, ponieważ nie ma w nim możliwości określenia widoczności pakietu prywatnego.
    • Wartość null niektórych typów jest teraz prawidłowo zdefiniowana. Dotyczy to tych metod: .getOrDefault, .keyAt, .valueAt, .setValueAt, .put, .putIfAbsent, .removeAt, .replace.
    • W przypadku użytkowników języka Kotlin funkcja .isEmpty() jest teraz dostępna tylko jako funkcja, a nie jako dostęp do właściwości. (I271b7, b/182813986)
  • Przekonwertuj CircularArray na Kotlin. Najważniejsze zmiany:

    • Koryguje wartość nullability typów ogólnych na wartość inną niż null, co wcześniej było niemożliwe do zadeklarowania, ale było wymuszane we wszystkich publicznych interfejsach API.
    • Ze względu na interoperacyjność Kotlina z Javą można było wcześniej uzyskiwać dostęp do niektórych metod jako właściwości lub funkcji. Aby jednak zmniejszyć duplikowanie przy zachowaniu zgodności binarnej, konieczne było usunięcie tych elementów, co jest zmianą niezgodną ze źródłem. Dotknięte wywołania to: .isEmpty, .getLast().getFirst(). (Ifffac)
  • Przekonwertuj CircularIntArray na Kotlin. Ze względu na interoperacyjność języka Kotlin z językiem Java można było wcześniej uzyskiwać dostęp do niektórych metod jako właściwości lub funkcji. Aby jednak zmniejszyć duplikowanie przy zachowaniu zgodności binarnej, konieczne było usunięcie tych elementów, co jest zmianą niezgodną ze źródłem. Połączenia, których dotyczy problem: .isEmpty, .getLast().getFirst(). (Ie36ce)

  • Konwertowanie LruCache na Kotlin (Ia2f19)

  • Przekonwertuj SparseArrayCompat na Kotlin. (If6fe8)

    Do funkcji SparseArrayCompat.valueAt() dodano niewielką zmianę w sposobie działania, która sprawia, że nie zwraca ona już nieprawidłowo wartości null w przypadku niezainicjowanych wywołań poza zakresem size(), ale w ramach podanej początkowej pojemności.

    Wprowadzamy też prawidłową wartość null dla niektórych typów, której wcześniej brakowało.

    • .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)

Wersja 1.2.0

Wersja 1.2.0

1 grudnia 2021 r.

androidx.collection:collection:1.2.0androidx.collection:collection-ktx:1.2.0 zostają opublikowane. Wersja 1.2.0 zawiera te zmiany.

Ważne zmiany od wersji 1.1.0

  • Dodaj konstruktor tablicy do ArraySet. (Id7f19)
  • Zapewnij zgodność z interfejsem entrySet() API, wdrażając entrySet().toArray(), remove(), removeAll()retainAll() oraz usuwając implementację entrySet().addAll() (I5d505).

Wersja 1.2.0-rc01

17 listopada 2021 r.

androidx.collection:collection:1.2.0-rc01androidx.collection:collection-ktx:1.2.0-rc01 zostają opublikowane. Wersja 1.2.0-rc01 zawiera te zmiany.

Zmiany w interfejsie API

  • Brak zmian w porównaniu z poprzednią wersją beta.

Wersja 1.2.0-beta01

13 października 2021 r.

androidx.collection:collection:1.2.0-beta01androidx.collection:collection-ktx:1.2.0-beta01 zostają opublikowane. Wersja 1.2.0-beta01 zawiera te zmiany.

Poprawki błędów

  • Zapewnij zgodność z interfejsem entrySet() API, wdrażając entrySet().toArray(), remove(), removeAll()retainAll() oraz usuwając implementację entrySet().addAll() (I5d505).

Wersja 1.2.0-alpha01

16 grudnia 2020 roku

androidx.collection:collection:1.2.0-alpha01androidx.collection:collection-ktx:1.2.0-alpha01 zostają opublikowane. Wersja 1.2.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaj konstruktor tablicy do ArraySet. (Id7f19)

Wersja 1.1.0

Wersja 1.1.0

5 czerwca 2019 r.

androidx.collection:collection:1.1.0androidx.collection:collection-ktx:1.1.0 zostają opublikowane. Zmiany wprowadzone w wersji 1.1.0 znajdziesz tutaj.

Poniżej znajdziesz podsumowanie zmian wprowadzonych w wersji 1.1.0 w porównaniu z wersją 1.0.0:

Nowe funkcje

  • Używaj bardziej wydajnej implementacji funkcji containsisNotEmpty w artefakcie „collection-ktx”. (aosp/866529)

Zmiany w interfejsie API

  • Dodaj putIfAbsent do LongSparseArray, SimpleArrayMap i SparseArrayCompat (aosp/772608)
  • Dodaj getOrDefault do SimpleArrayMap (aosp/772607)
  • Dodaj funkcję dwuargumentową remove do funkcji LongSparseArray, SimpleArrayMapSparseArrayCompat. Wycofaj odpowiednie rozszerzenia KTX dla tej funkcji. (aosp/772482)
  • Dodanie funkcji replace z 2 argumentami do LongSparseArray, SimpleArrayMapSparseArrayCompat (aosp/772483)
  • Dodaj 3-argumentową funkcję replace do LongSparseArray, SimpleArrayMapSparseArrayCompat (aosp/772484)
  • Wycofaj zbędne metody delete. Metoda remove oferuje ten sam interfejs API i funkcje oraz jest zgodna z interfejsem API używanym przez niespecjalistyczne Mapy. (aosp/866053)

Poprawki błędów

  • Zmień SimpleArrayMap, aby zsynchronizować wewnętrzną globalną pamięć podręczną tablic na SimpleArrayMap.class zamiast na ArrayMap.class. Dzięki temu, jeśli używasz tylko SimpleArrayMap, narzędzia do zmniejszania kodu mogą usunąć ArrayMap. (aosp/934557)

Wersja 1.1.0-rc01

7 maja 2019 r.

androidx.collection:collection:1.1.0-rc01androidx.collection:collection-ktx:1.1.0-rc01 zostają opublikowane. Zmiany zawarte w tej wersji znajdziesz tutaj.

Nowe funkcje

  • Używaj bardziej wydajnej implementacji funkcji containsisNotEmpty w artefakcie „collection-ktx”. (aosp/866529)

Wersja 1.1.0-beta01

3 kwietnia 2019 r.

androidx.collection:collection:1.1.0-beta01androidx.collection:collection-ktx:1.1.0-beta01 zostają opublikowane. Zmiany zawarte w tej wersji znajdziesz tutaj.

Zmiany w interfejsie API

  • Metoda, o której wspomnieliśmy w informacjach o wersji alpha03 jako tej, której wartość @RestrictTo została zmieniona, została usunięta. Nie była używana przez żadną bibliotekę AndroidX (obecnie ani w przeszłości) i nie oferowała żadnych funkcji, których nie było w publicznym interfejsie API.

Poprawki błędów

  • Zmień SimpleArrayMap, aby zsynchronizować wewnętrzną globalną pamięć podręczną tablic na SimpleArrayMap.class zamiast na ArrayMap.class. Dzięki temu, jeśli używasz tylko SimpleArrayMap, narzędzia do zmniejszania kodu mogą usunąć ArrayMap. (aosp/934557)

Wersja 1.1.0-alpha03

13 marca 2019 r.

androidx.collection:collection:1.0.0-alpha03androidx.collection:collection-ktx:1.0.0-alpha03 zostały opublikowane. Pełną listę zmian w tej wersji znajdziesz tutaj.

Zmiany w interfejsie API

  • Metoda w ArraySet, która wcześniej była oznaczona jako @RestrictTo(LIBRARY_GROUP), została zmieniona na @RestrictTo(LIBRARY_GROUP_PREFIX). Ma to na celu obsługę starszych wersji innych bibliotek AndroidX, które znajdują się teraz w innych identyfikatorach grup Maven. Ta metoda zostanie upubliczniona lub usunięta w wersji 1.1.0-alpha04, ponieważ inne biblioteki AndroidX nie powinny mieć specjalnych interfejsów API, które nie są dostępne dla innych deweloperów.

Wersja 1.1.0-alpha02

30 stycznia 2019 r.

androidx.collection:collection 1.1.0-alpha02androidx.collection:collection-ktx 1.1.0-alpha02 zostały opublikowane.

Zmiany w interfejsie API

  • Wycofaj zbędne metody delete. Metody remove oferują ten sam interfejs API i funkcje oraz są zgodne z interfejsem API używanym przez niespecjalistyczne Mapy. (aosp/866053)

Wersja 1.1.0-alpha01

3 grudnia 2018 r.

Zmiany w interfejsie API

  • Dodaj putIfAbsent do LongSparseArray, SimpleArrayMap i SparseArrayCompat (aosp/772608)
  • Dodaj getOrDefault do SimpleArrayMap (aosp/772607)
  • Dodaj funkcję dwuargumentową remove do funkcji LongSparseArray, SimpleArrayMapSparseArrayCompat. Wycofaj odpowiednie rozszerzenia KTX dla tej funkcji. (aosp/772482)
  • Dodanie funkcji replace z 2 argumentami do LongSparseArray, SimpleArrayMapSparseArrayCompat (aosp/772483)
  • Dodaj 3-argumentową funkcję replace do LongSparseArray, SimpleArrayMapSparseArrayCompat (aosp/772484)