متزامن

تعريف التبعيات

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

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.3

الإصدار 1.3.0-rc01

‫2 يوليو 2025

تم طرح androidx.concurrent:concurrent-futures:1.3.0-rc01 وandroidx.concurrent:concurrent-futures-ktx:1.3.0-rc01. يحتوي الإصدار 1.3.0-rc01 على عمليات الإيداع هذه.

الإصدار 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 لكتابة جسور suspend-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.

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

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

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

• تضيف هذه السمة دالة تعليق ListenableFuture.await() إضافية تحوّل ListenableFuture إلى روتين فرعي في 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.