متزامنة

تحديد التبعيات

لإضافة تبعية على Futures، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف التبعيات للعناصر التي تحتاج إليها في ملف 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-beta01

20 أيار (مايو) 2025

تمّ إصدار androidx.concurrent:concurrent-futures:1.3.0-beta01 وandroidx.concurrent:concurrent-futures-ktx:1.3.0-beta01. يتضمّن الإصدار 1.3.0-beta01 عمليات الربط هذه.

الإصدار 1.3.0-alpha01

11 كانون الأول (ديسمبر) 2024

تمّ إصدار androidx.concurrent:concurrent-futures:1.3.0-alpha01 وandroidx.concurrent:concurrent-futures-ktx:1.3.0-alpha01. يتضمّن الإصدار 1.3.0-alpha01 عمليات الربط هذه.

إصلاح الأخطاء

• تستخدم هذه المكتبة الآن تعليقات JSpecify التوضيحية حول القيمة الخالية، وهي عبارة عن استخدام للنوع. على مطوّري لغة Kotlin استخدام وسيطة المُجمِّع التالية لفرض الاستخدام الصحيح: -Xjspecify-annotations=strict (هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من مُجمِّع Kotlin). (I0faf4، b/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 لترجمة طلب بيانات من واجهة برمجة تطبيقات معلّقة إلى 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-beta01

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-alpha03

20 مارس 2024

تمّ إصدار 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

9 آب (أغسطس) 2023

تمّ إصدار androidx.concurrent:concurrent-futures:1.2.0-alpha02 وandroidx.concurrent:concurrent-futures-ktx:1.2.0-alpha02. يحتوي الإصدار 1.2.0-alpha02 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

• تمت إضافة SuspendToFutureAdapter لكتابة جسور تعليق-ListenableFuture (Ia8a66)

الإصدار 1.2.0-alpha01

22 شباط (فبراير) 2023

تمّ إصدار androidx.concurrent:concurrent-futures:1.2.0-alpha01 وandroidx.concurrent:concurrent-futures-ktx:1.2.0-alpha01. يحتوي الإصدار 1.2.0-alpha01 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

• يحتوي ResolvableFuture الآن على تعليقات توضيحية سليمة حول إمكانية القيمة الخالية في طرقه. (I2339f، b/236474470)

الإصدار 1.1.0

الإصدار 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 Coroutines، وهي متوفرة الآن مع 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-beta01

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-alpha01

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.

الميزات الجديدة

• تتوفّر الآن في concurrent-futures-ktx إضافات Kotlin للمساعدة في التحويل بين ListenableFuture وKotlin Coroutines. يُقصد استخدام هذا العنصر مع com.google.guava:listenablefuture بدلاً من مكتبة Guava الكاملة، وهي بديل خفيف الوزن لمجموعة Guava التي تحتوي على ListenableFuture فقط. بالنسبة إلى مستخدمي مكتبة Guava الكاملة، يجب استخدام إضافات ListenableFuture الرسمية من kotlinx.coroutines.kotlinx-coroutines-guava بدلاً من ذلك.

تغييرات واجهة برمجة التطبيقات

• تضيف إضافة ListenableFuture.await() معلّقة تحوّل ListenableFuture إلى دالة Coroutine في Kotlin

الإصدار 1.0.0

الإصدار 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 بطريقة أكثر رقة من عمليات الاستدعاء المخصّصة، ولكنّها لا تُجري ما يكفي من الأعمال الشاقة باستخدام خيوط متعدّدة لتصبح معتمدة على guava أو rx java بالكامل بسبب المخاوف المتعلقة بحجم المكتبة.

الإصدار 1.0.0-rc01

7 آب (أغسطس) 2019

تم طرح الإصدار androidx.concurrent:concurrent-futures:1.0.0-rc01 بدون أي تغييرات من الإصدار 1.0.0-beta01. يمكن العثور على عمليات الربط المضمّنة في هذا الإصدار هنا.

الإصدار 1.0.0-beta01 من Concurrent-ListenableFuture

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، في مشاكل للمطوّرين الذين يستخدمون سلاسل الأدوات، مثل الإصدار 3.4.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"، مع مطابقة صارمة لحلّ الملحقات. ننصح المطوّرين الذين لا يعتمدون على مكتبة Guava الكاملة بالتبديل إلى androidx.concurrent:concurrent-listenablefuture-callback.

الإصدار 1.0.0-beta01

7 أيار (مايو) 2019

تم إصدار androidx.concurrent:concurrent-futures:1.0.0-beta01. يمكن العثور على عمليات الربط المضمّنة في هذا الإصدار هنا.

تغييرات واجهة برمجة التطبيقات

• تم إخفاء ResolvableFuture وAbstractResolvableFuture من واجهة برمجة التطبيقات العامة لصالح CallbackToFutureAdapter التي توفّر واجهة برمجة تطبيقات أكثر أمانًا.

الإصدار 1.0.0-alpha03

17 كانون الأول (ديسمبر) 2018

تم إصدار androidx.concurrent:concurrent-futures 1.0.0-alpha03.

الميزات الجديدة

• تم طرح CallbackToFutureAdapter. وهي واجهة برمجة تطبيقات جديدة وأكثر أمانًا لتغليف واجهة برمجة تطبيقات مستندة إلى طلب إعادة الاتصال في ListenableFuture. ويُفضّل استخدام هذا الإجراء بدلاً من استخدام ResolvableFuture.