متزامن

إعلان التبعيات

لإضافة تبعية على 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.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 بدلاً من مكتبة Java الكاملة، وهي بديل خفيف عن Java الذي يحتوي فقط على 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 فقط. بالنسبة إلى مستخدمي مكتبة Java الكاملة، يجب استخدام إضافات 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 من Juva ومحوّلاً لتحويل استدعاءات معاودة الاتصال.

قد يتسبب العنصر 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.