Эта страница переведена с помощью Cloud Translation API.

Параллельно

Справочник по API
androidx.concurrent

Перемещайте задачи из основного потока с помощью сопрограмм и воспользуйтесь преимуществами ListenableFuture.

Последнее обновление	Стабильный выпуск	Кандидат на выпуск	Бета-версия	Альфа-релиз
11 декабря 2024 г.	1.2.0	-	-	1.3.0-альфа01

Объявление зависимостей

Чтобы добавить зависимость от Futures, вы должны добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .

Добавьте зависимости для нужных вам артефактов в файл build.gradle для вашего приложения или модуля:

классный

dependencies {
    implementation "androidx.concurrent:concurrent-futures:1.2.0"

    // Kotlin
    implementation "androidx.concurrent:concurrent-futures-ktx:1.2.0"
}

Котлин

dependencies {
    implementation("androidx.concurrent:concurrent-futures:1.2.0")

    // Kotlin
    implementation("androidx.concurrent:concurrent-futures-ktx:1.2.0")
}

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.

Создать новую задачу

Дополнительную информацию см. в документации по системе отслеживания проблем .

Версия 1.3

Версия 1.3.0-альфа01

11 декабря 2024 г.

Выпущены androidx.concurrent:concurrent-futures:1.3.0-alpha01 и androidx.concurrent:concurrent-futures-ktx:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит эти коммиты .

Исправления ошибок

Эта библиотека теперь использует аннотации NULL NULL JSpecify , которые являются типизированными. Разработчики Kotlin должны использовать следующий аргумент компилятора для обеспечения правильного использования: -Xjspecify-annotations=strict (это значение по умолчанию, начиная с версии 2.1.0 компилятора Kotlin). ( I0faf4 , б/326456246 )

Версия 1.2

Версия 1.2.0

12 июня 2024 г.

Выпущены 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

29 мая 2024 г.

Выпущены androidx.concurrent:concurrent-futures:1.2.0-rc01 и androidx.concurrent:concurrent-futures-ktx:1.2.0-rc01 . Версия 1.2.0-rc01 содержит эти коммиты .

Версия 1.2.0-бета01

14 мая 2024 г.

Выпущены androidx.concurrent:concurrent-futures:1.2.0-beta01 и androidx.concurrent:concurrent-futures-ktx:1.2.0-beta01 . Версия 1.2.0-beta01 содержит эти коммиты .

Версия 1.2.0-альфа03

20 марта 2024 г.

Выпущены androidx.concurrent:concurrent-futures:1.2.0-alpha03 и androidx.concurrent:concurrent-futures-ktx:1.2.0-alpha03 . Версия 1.2.0-alpha03 содержит эти коммиты .

Исправления ошибок

Исправлена ошибка обработки ошибок, когда задача SuspendToFutureAdapter выдает исключение. ( б/327629504 )

Версия 1.2.0-альфа02

9 августа 2023 г.

Выпущены androidx.concurrent:concurrent-futures:1.2.0-alpha02 и androidx.concurrent:concurrent-futures-ktx:1.2.0-alpha02 . Версия 1.2.0-alpha02 содержит эти коммиты.

Изменения API

Добавлен SuspendToFutureAdapter для написания мостов suspend- ListenableFuture ( Ia8a66 ).

Версия 1.2.0-альфа01

22 февраля 2023 г.

Выпущены androidx.concurrent:concurrent-futures:1.2.0-alpha01 и androidx.concurrent:concurrent-futures-ktx:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит эти коммиты.

Изменения API

ResolvableFuture теперь имеет правильные аннотации об отсутствии значений в своих методах. ( I2339f , б / 236474470 )

Версия 1.1.0

19 августа 2020 г.

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 . Этот артефакт предназначен для использования с com.google.guava:listenablefuture а не с полной библиотекой Guava, которая представляет собой облегченную замену Guava, содержащую только ListenableFuture. Пользователям полной библиотеки Guava вместо этого следует использовать официальные расширения ListenableFuture из kotlinx.coroutines.kotlinx-coroutines-guava .

Версия 1.1.0-rc01

22 июля 2020 г.

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-бета01

24 июня 2020 г.

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-альфа01

18 декабря 2019 г.

Выпущены 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 .

Новые возможности

Расширения Kotlin, помогающие конвертировать ListenableFuture и Kotlin Coroutines, теперь доступны в concurrent-futures-ktx . Этот артефакт предназначен для использования с com.google.guava:listenablefuture а не с полной библиотекой Guava, которая представляет собой облегченную замену Guava, содержащую только ListenableFuture . Пользователям полной библиотеки Guava вместо этого следует использовать официальные расширения ListenableFuture из kotlinx.coroutines.kotlinx-coroutines-guava .

Изменения API

Добавляет приостанавливающее расширение ListenableFuture.await() , которое преобразует ListenableFuture в сопрограмму Kotlin.

Версия 1.0.0

9 октября 2019 г.

Выпущен androidx.concurrent:concurrent-futures:1.0.0 . Версия 1.0.0 содержит эти коммиты .

Важные особенности версии 1.0.0

androidx.concurrent:concurrent-futures:1.0.0 предоставляет класс CallbackToFutureAdapter , минималистическую утилиту, которая позволяет обертывать код на основе обратного вызова и возвращать экземпляры ListenableFuture . Это полезно для библиотек, которые хотели бы предоставлять асинхронные операции в своих Java API более элегантным способом, чем пользовательские обратные вызовы, но не выполняют достаточную тяжелую многопоточность, чтобы зависеть от полной гуавы или rx Java из-за проблем с размером библиотеки.

Версия 1.0.0-rc01

7 августа 2019 г.

androidx.concurrent:concurrent-futures:1.0.0-rc01 выпущен без изменений по сравнению с 1.0.0-beta01 . Коммиты, включенные в эту версию, можно найти здесь .

Concurrent-ListenableFuture Версия 1.0.0-beta01

30 мая 2019 г.

Выпущены androidx.concurrent:concurrent-listenablefuture:1.0.0-beta01 и androidx.concurrent:concurrent-listenablefuture-callback:1.0.0-beta01 . Коммиты, включенные в эту версию, можно найти здесь .

Эти библиотеки предоставляют автономный эквивалент интерфейса ListenableFuture Guava и адаптер для преобразования обратных вызовов.

Ранее выпущенный артефакт androidx.concurrent:concurrent-futures , который предоставлял аналогичный адаптер и включал артефакт com.google.guava:listenablefuture , может быть проблематичным для разработчиков, использующих цепочки инструментов, такие как Android Gradle Plugin 3.4.0, со строгим соответствием разрешения зависимостей. Разработчикам, которые не полагаются на полную библиотеку Guava, рекомендуется переключиться на androidx.concurrent:concurrent-listenablefuture-callback .

Версия 1.0.0-бета01

7 мая 2019 г.

Выпущен androidx.concurrent:concurrent-futures:1.0.0-beta01 . Коммиты, включенные в эту версию, можно найти здесь .

Изменения API

ResolvableFuture и AbstractResolvableFuture были скрыты от общедоступного API в пользу CallbackToFutureAdapter , который обеспечивает более безопасный API.

Версия 1.0.0-альфа03

17 декабря 2018 г.

androidx.concurrent:concurrent-futures 1.0.0-alpha03 выпущен.

Новые возможности

Был представлен CallbackToFutureAdapter . Это новый, более безопасный API для переноса API, управляемого обратным вызовом, в ListenableFuture . Предпочитайте его использованию ResolvableFuture .