Collection

降低现有和新的小型集合对内存的影响。

最近更新时间	当前稳定版	下一候选版本	Beta 版	Alpha 版
2020 年 12 月 16 日	1.1.0	-	-	1.2.0-alpha01

声明依赖项

如需添加 Collection 的依赖项，您必须将 Google Maven 代码库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

    dependencies {
        def collection_version = "1.1.0"

        // Java language implementation
        implementation "androidx.collection:collection:$collection_version"
        // Kotlin
        implementation "androidx.collection:collection-ktx:$collection_version"
    }

如需详细了解依赖项，请参阅添加构建依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对库的改进有某些建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 1.2.0

版本 1.2.0-alpha01

2020 年 12 月 16 日

发布了 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

2019 年 6 月 5 日

发布了 androidx.collection:collection:1.1.0 和 androidx.collection:collection-ktx:1.1.0。点击此处可查看版本 1.1.0 中包含的提交内容。

下面是从 1.0.0 到 1.1.0 的变更摘要：

新功能

对“collection-ktx”工件中的 contains 和 isNotEmpty 函数使用了更高效的实现。(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 和功能，并与非专用 Map 类使用的 API 相匹配。(aosp/866053)

问题修复

更改了 SimpleArrayMap，以在 SimpleArrayMap.class（而非 ArrayMap.class）上同步其数组的内部全局缓存。这可以确保在您只使用 SimpleArrayMap 时通过代码缩减工具移除 ArrayMap。(aosp/934557)

版本 1.1.0-rc01

2019 年 5 月 7 日

发布了 androidx.collection:collection:1.1.0-rc01 和 androidx.collection:collection-ktx:1.1.0-rc01。点击此处可查看此版本中包含的提交内容。

新功能

对“collection-ktx”工件中的 contains 和 isNotEmpty 函数使用了更高效的实现。(aosp/866529)

版本 1.1.0-beta01

2019 年 4 月 3 日

发布了 androidx.collection:collection:1.1.0-beta01 和 androidx.collection:collection-ktx:1.1.0-beta01。点击此处可查看此版本中包含的提交内容。

API 变更

移除了 alpha03 版本说明中提到的更改了其 @RestrictTo 值的方法。所有 AndroidX 库（现在或过去）都未使用该方法，并且它不提供公共 API 中缺少的任何功能。

问题修复

更改了 SimpleArrayMap，以在 SimpleArrayMap.class（而非 ArrayMap.class）上同步其数组的内部全局缓存。这可以确保在您只使用 SimpleArrayMap 时通过代码缩减工具移除 ArrayMap。(aosp/934557)

版本 1.1.0-alpha03

2019 年 3 月 13 日

发布了 androidx.collection:collection:1.0.0-alpha03 和 androidx.collection:collection-ktx:1.0.0-alpha03。点击此处可查看此版本中包含的完整提交内容列表。

API 变更

ArraySet 上先前标记为 @RestrictTo(LIBRARY_GROUP) 的方法已更改为 @RestrictTo(LIBRARY_GROUP_PREFIX)。这是为了让其他现在具有不同 Maven 组 ID 的 AndroidX 库能像过去一样使用它。此方法将在 1.1.0-alpha04 中公开或移除，这是因为其他 AndroidX 库不应获得其他开发者没有的特殊 API。

版本 1.1.0-alpha02

2019 年 1 月 30 日

发布了 androidx.collection:collection 1.1.0-alpha02 和 androidx.collection:collection-ktx 1.1.0-alpha02。

API 变更

弃用了冗余 delete 方法。remove 方法提供相同的 API 和功能，并与非专用 Map 类使用的 API 相匹配。(aosp/866053)

版本 1.1.0-alpha01

2018 年 12 月 3 日

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)