並行
最近更新時間 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2024 年 6 月 12 日 | 1.2.0 | - | - | - |
宣告依附元件
如果要為 Futures 新增依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。
在應用程式或模組的 build.gradle
檔案中,新增您需要的構件依附元件:
Groovy
dependencies { implementation "androidx.concurrent:concurrent-futures:1.2.0" // Kotlin implementation "androidx.concurrent:concurrent-futures-ktx:1.2.0" }
Kotlin
dependencies { implementation("androidx.concurrent:concurrent-futures:1.2.0") // Kotlin implementation("androidx.concurrent:concurrent-futures-ktx:1.2.0") }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋:
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
詳情請參閱 Issue Tracker 說明文件。
1.2 版本
1.2.0 版
2024 年 6 月 12 日
發布 androidx.concurrent:concurrent-futures:1.2.0
和 androidx.concurrent:concurrent-futures-ktx:1.2.0
。1.2.0 版包含這些修訂版本。
自 1.1.0 版以來的重要變更
- 新增
SuspendToFutureAdapter
,將對暫停 API 的呼叫轉譯為ListenableFuture
。
1.2.0-rc01 版
2024 年 5 月 29 日
發布 androidx.concurrent:concurrent-futures:1.2.0-rc01
和 androidx.concurrent:concurrent-futures-ktx:1.2.0-rc01
。1.2.0-rc01 版包含這些修訂版本。
1.2.0-beta01 版
2024 年 5 月 14 日
發布 androidx.concurrent:concurrent-futures:1.2.0-beta01
和 androidx.concurrent:concurrent-futures-ktx:1.2.0-beta01
。1.2.0-beta01 版包含這些修訂版本。
1.2.0-alpha03 版
2024 年 3 月 20 日
發布 androidx.concurrent:concurrent-futures:1.2.0-alpha03
和 androidx.concurrent:concurrent-futures-ktx:1.2.0-alpha03
。1.2.0-alpha03 版包含這些修訂版本。
修正錯誤
- 修正了
SuspendToFutureAdapter
工作擲回例外狀況時發生的錯誤處理錯誤。(b/327629504)。
1.2.0-alpha02 版
2023 年 8 月 9 日
發布 androidx.concurrent:concurrent-futures:1.2.0-alpha02
和 androidx.concurrent:concurrent-futures-ktx:1.2.0-alpha02
。1.2.0-alpha02 版本包含以下修訂項目。
API 變更
- 新增了
SuspendToFutureAdapter
來寫入暫停ListenableFuture
橋接器 (Ia8a66)
1.2.0-alpha01 版
2023 年 2 月 22 日
發布 androidx.concurrent:concurrent-futures:1.2.0-alpha01
和 androidx.concurrent:concurrent-futures-ktx:1.2.0-alpha01
。1.2.0-alpha01 版本包含以下修訂項目。
API 變更
ResolvableFuture
的方法現可加上是否可為空值註解 (I2339f、b/236474470)。
1.1.0 版本
1.1.0 版本
2020 年 8 月 19 日
發布 androidx.concurrent:concurrent-futures:1.1.0
和 androidx.concurrent:concurrent-futures-ktx:1.1.0
,且自 1.1.0-rc01
版以來皆無異動。1.1.0 版本包含這些修訂內容。
自 1.0.0 版起的重大異動
1.1.0
推出 Kotlin 擴充功能,可協助您在 ListenableFuture 和 Kotlin 協同程式之間轉換,現在於androidx.concurrent:concurrent-futures-ktx:1.1.0
提供。此構件不是設計用來搭配完整的 Guava 程式庫,而是與com.google.guava:listenablefuture
搭配使用,這是僅包含 ListenableFuture 的替代用精簡版 Guava。如果使用完整的 Guava 程式庫,請改用kotlinx.coroutines.kotlinx-coroutines-guava
的正式版 ListenableFuture 擴充功能。
1.1.0-rc01 版本
2020 年 7 月 22 日
發布 androidx.concurrent:concurrent-futures:1.1.0-rc01
和 androidx.concurrent:concurrent-futures-ktx:1.1.0-rc01
,且自 1.1.0-beta01
版以來皆無異動。1.1.0-rc01 版本包含這些修訂版本。
1.1.0-beta01 版本
2020 年 6 月 24 日
androidx.concurrent:concurrent-futures:1.1.0-beta01
和 androidx.concurrent:concurrent-futures-ktx:1.1.0-beta01
發布,且自 1.1.0-alpha01
版以來皆無異動。1.1.0-beta01 版本包含這些修訂版本。
1.1.0-alpha01 版
2019 年 12 月 18 日
發布 androidx.concurrent:concurrent-futures:1.1.0-alpha01
和 androidx.concurrent:concurrent-futures-ktx:1.1.0-alpha01
。1.1.0-alpha01 版本包含這些修訂版本。此為 androidx.concurrent:concurrent-futures-ktx
的第一版本。
新功能
- 您現在可使用
concurrent-futures-ktx
中提供的 Kotlin 擴充功能,在 ListenableFuture 與 Kotlin 協同程式之間轉換。此構件不是設計用來搭配完整的 Guava 程式庫,而是與com.google.guava:listenablefuture
搭配使用,這是僅包含ListenableFuture
的替代用精簡版 Guava。如果使用完整的 Guava 程式庫,請改用kotlinx.coroutines.kotlinx-coroutines-guava
的正式版 ListenableFuture 擴充功能。
API 相關異動
- 加入暫停性質的
ListenableFuture.await()
擴充功能,將 ListenableFuture 轉換為 Kotlin 協同程式
1.0.0 版本
1.0.0 版本
2019 年 10 月 9 日
androidx.concurrent:concurrent-futures:1.0.0
發布。1.0.0 版本包含這些修訂版本。
1.0.0 的重要功能
androidx.concurrent:concurrent-futures:1.0.0
提供 CallbackToFutureAdapter
class,這是一種精簡的公用程式,可根據程式碼納入回呼,並回傳 ListenableFuture
的執行個體。如果程式庫要透過 Java API 以更流暢的方式 (相較於自訂回呼) 公開非同步作業,但又因程式庫大小的考量,導致多執行緒的繁複作業規模不需要使用完整 Guava 或 Rx Java 的依附元件,那麼這個功能會有很幫助。
1.0.0-rc01 版本
2019 年 8 月 7 日
androidx.concurrent:concurrent-futures:1.0.0-rc01
發布,且自 1.0.0-beta01
版以來皆無異動。您可以前往這裡查看這個版本包含的修訂版本。
Concurrent-ListenableFuture 1.0.0-beta01 版本
2019 年 5 月 30 日
發布 androidx.concurrent:concurrent-listenablefuture:1.0.0-beta01
和 androidx.concurrent:concurrent-listenablefuture-callback:1.0.0-beta01
。您可以前往這裡查看這個版本包含的修訂版本。
這些程式庫提供了與 Guava 的 ListenableFuture 介面相對應的獨立版本,以及轉換回呼的轉接程式。
先前發布的 androidx.concurrent:concurrent-futures
構件提供類似的轉接程式且包含 com.google.guava:listenablefuture
構件。如果開發人員使用具有嚴格依附元件解析比對的工具鏈 (例如 Android Gradle 外掛程式 3.4.0) 時,前者的構件可能會造成問題。開發人員如果不仰賴完整 Guava 程式庫,建議改用 androidx.concurrent:concurrent-listenablefuture-callback
。
1.0.0-beta01 版本
2019 年 5 月 7 日
發布了 androidx.concurrent:concurrent-futures:1.0.0-beta01
。您可以前往這裡查看這個版本包含的修訂項目。
API 相關異動
- 由於
CallbackToFutureAdapter
提供的 API 更安全,ResolvableFuture
和AbstractResolvableFuture
已在公用 API 中隱藏。
1.0.0-alpha03 版本
2018 年 12 月 17 日
發布了 androidx.concurrent:concurrent-futures 1.0.0-alpha03
。
新功能
- 已推出
CallbackToFutureAdapter
。此新版 API 更安全,可在ListenableFuture
中納入以回呼為基礎的 API。建議您使用此 API 取代ResolvableFuture
。