Collection
最近更新时间 | 稳定版 | 候选版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2021 年 12 月 1 日 | 1.2.0 | - | - | - |
声明依赖项
如需添加 Collection 的依赖项,您必须将 Google Maven 代码库添加到项目中。如需了解详情,请参阅 Google 的 Maven 代码库。
在应用或模块的 build.gradle
文件中添加所需工件的依赖项:
Groovy
dependencies { def collection_version = "1.2.0" // Java language implementation implementation "androidx.collection:collection:$collection_version" // Kotlin implementation "androidx.collection:collection-ktx:$collection_version" }
Kotlin
dependencies { val collection_version = "1.2.0" // Java language implementation implementation("androidx.collection:collection:$collection_version") // Kotlin implementation("androidx.collection:collection-ktx:$collection_version") }
如需详细了解依赖项,请参阅添加 build 依赖项。
反馈
您的反馈将帮助我们改进 Jetpack。如果您发现了新问题,或对此库的改进有自己的见解,请告诉我们。创建新问题前,请先查看此库中的现有问题。您可以点击星标按钮,为现有问题投票。
如需了解详情,请参阅问题跟踪器文档。
版本 1.2.0
版本 1.2.0
2021 年 12 月 1 日
发布了 androidx.collection:collection:1.2.0
和 androidx.collection:collection-ktx:1.2.0
。版本 1.2.0 中包含这些提交内容。
自 1.1.0 以来的重要变更
- 向
ArraySet
添加了数组构造函数。(Id7f19) - 通过实现
entrySet().toArray()
、remove()
、removeAll()
和retainAll()
,并移除entrySet().addAll()
的实现,使entrySet()
API 符合要求 (I5d505)
版本 1.2.0-rc01
2021 年 11 月 17 日
发布了 androidx.collection:collection:1.2.0-rc01
和 androidx.collection:collection-ktx:1.2.0-rc01
。版本 1.2.0-rc01 中包含这些提交内容。
API 变更
- 与之前的 Beta 版相比没有任何变化。
版本 1.2.0-beta01
2021 年 10 月 13 日
发布了 androidx.collection:collection:1.2.0-beta01
和 androidx.collection:collection-ktx:1.2.0-beta01
。版本 1.2.0-beta01 中包含这些提交内容。
bug 修复
- 通过实现
entrySet().toArray()
、remove()
、removeAll()
和retainAll()
,并移除entrySet().addAll()
的实现,使entrySet()
API 符合要求 (I5d505)
版本 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
版本 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)
bug 修复
- 更改了
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 中缺少的任何功能。
bug 修复
- 更改了
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)