همزمان

وظایف را با استفاده از کوروتین‌ها از نخ اصلی خارج کنید و از ListenableFuture بهره ببرید.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۲۹ ژوئیه ۲۰۲۶ ۱.۳.۰ - - ۱.۴.۰-آلفا۰۱

اعلام وابستگی‌ها

برای افزودن وابستگی به Futures، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's Maven را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

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

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

کاتلین 

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

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

برای اطلاعات بیشتر در مورد وابستگی‌ها، به بخش «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۴

نسخه ۱.۴.۰-آلفا۰۱

۲۹ ژوئیه ۲۰۲۶

androidx.concurrent:concurrent:1.4.0-alpha01 ، androidx.concurrent:concurrent-futures:1.4.0-alpha01 و androidx.concurrent:concurrent-futures-ktx:1.4.0-alpha01 منتشر شدند. نسخه 1.4.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • یک متد کاربردی برای دریافت اجراکننده‌های سریال اضافه کنید. ( I19fd6 , b/532183522 )

مشارکت خارجی

  • concurrent-ktx را در کتابخانه concurrent ادغام کنید. همه افزونه‌های کاتلین اکنون بخشی از مصنوع اصلی concurrent هستند. concurrent-ktx اکنون یک مصنوع خالی برای سازگاری است. ( Ibaed2 )

نسخه ۱.۳

نسخه ۱.۳.۰

۱۶ ژوئیه ۲۰۲۵

androidx.concurrent:concurrent-futures:1.3.0 و androidx.concurrent:concurrent-futures-ktx:1.3.0 منتشر شدند. نسخه ۱.۳.۰ شامل این کامیت‌ها است.

نسخه ۱.۳.۰-rc01

۲ ژوئیه ۲۰۲۵

androidx.concurrent:concurrent-futures:1.3.0-rc01 و androidx.concurrent:concurrent-futures-ktx:1.3.0-rc01 منتشر شدند. نسخه 1.3.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۳.۰-بتا۰۱

۲۰ مه ۲۰۲۵

androidx.concurrent:concurrent-futures:1.3.0-beta01 و androidx.concurrent:concurrent-futures-ktx:1.3.0-beta01 منتشر شدند. نسخه 1.3.0-beta01 شامل این کامیت‌ها است.

نسخه ۱.۳.۰-آلفا۰۱

۱۱ دسامبر ۲۰۲۴

androidx.concurrent:concurrent-futures:1.3.0-alpha01 و androidx.concurrent:concurrent-futures-ktx:1.3.0-alpha01 منتشر شدند. نسخه 1.3.0-alpha01 شامل این کامیت‌ها است.

رفع اشکالات

  • این کتابخانه اکنون از حاشیه‌نویسی‌های nullness از نوع JSpecify استفاده می‌کند که از نوع type-use هستند. توسعه‌دهندگان کاتلین باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این پیش‌فرض است که از نسخه 2.1.0 کامپایلر کاتلین شروع می‌شود). ( I0faf4 ، b/326456246 )

نسخه ۱.۲

نسخه ۱.۲.۰

۱۲ ژوئن ۲۰۲۴

androidx.concurrent:concurrent-futures:1.2.0 و androidx.concurrent:concurrent-futures-ktx:1.2.0 منتشر شدند. نسخه ۱.۲.۰ شامل این کامیت‌ها است.

تغییرات مهم از زمان ۱.۱.۰

  • SuspendToFutureAdapter برای ترجمه فراخوانی یک API در حال تعلیق به ListenableFuture اضافه شد.

نسخه ۱.۲.۰-rc01

۲۹ مه ۲۰۲۴

androidx.concurrent:concurrent-futures:1.2.0-rc01 و androidx.concurrent:concurrent-futures-ktx:1.2.0-rc01 منتشر شدند. نسخه 1.2.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۲.۰-بتا۰۱

۱۴ مه ۲۰۲۴

androidx.concurrent:concurrent-futures:1.2.0-beta01 و androidx.concurrent:concurrent-futures-ktx:1.2.0-beta01 منتشر شدند. نسخه 1.2.0-beta01 شامل این کامیت‌ها است.

نسخه ۱.۲.۰-آلفا۰۳

۲۰ مارس ۲۰۲۴

androidx.concurrent:concurrent-futures:1.2.0-alpha03 و androidx.concurrent:concurrent-futures-ktx:1.2.0-alpha03 منتشر شدند. نسخه 1.2.0-alpha03 شامل این کامیت‌ها است.

رفع اشکالات

  • اشکالی در مدیریت خطا هنگامی که یک وظیفه SuspendToFutureAdapter یک استثنا ایجاد می‌کند، برطرف شد. ( b/327629504 )

نسخه ۱.۲.۰-آلفا۰۲

۹ آگوست ۲۰۲۳

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 ) اضافه شد.

نسخه ۱.۲.۰-آلفا۰۱

۲۲ فوریه ۲۰۲۳

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 )

نسخه ۱.۱.۰

نسخه ۱.۱.۰

۱۹ آگوست ۲۰۲۰

androidx.concurrent:concurrent-futures:1.1.0 و androidx.concurrent:concurrent-futures-ktx:1.1.0 بدون هیچ تغییری از 1.1.0-rc01 منتشر شده‌اند. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

تغییرات عمده از زمان ۱.۰.۰

  • 1.1.0 افزونه‌های کاتلین را برای کمک به تبدیل بین 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 استفاده کنند.

نسخه ۱.۱.۰-rc01

۲۲ ژوئیه ۲۰۲۰

androidx.concurrent:concurrent-futures:1.1.0-rc01 و androidx.concurrent:concurrent-futures-ktx:1.1.0-rc01 بدون هیچ تغییری از زمان 1.1.0-beta01 منتشر شده‌اند. نسخه ۱.۱.۰-rc01 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-بتا۰۱

۲۴ ژوئن ۲۰۲۰

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 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-آلفا۰۱

۱۸ دسامبر ۲۰۱۹

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 است.

ویژگی‌های جدید

  • افزونه‌های کاتلین برای کمک به تبدیل بین ListenableFuture و Kotlin Coroutines اکنون در concurrent-futures-ktx در دسترس هستند. این مصنوع قرار است با com.google.guava:listenablefuture استفاده شود، نه با کتابخانه کامل Guava، که جایگزین سبکی برای Guava است و فقط شامل ListenableFuture می‌شود. کاربران کتابخانه کامل Guava، باید به جای آن از افزونه‌های رسمی ListenableFuture از kotlinx.coroutines.kotlinx-coroutines-guava استفاده کنند.

تغییرات API

  • یک افزونه‌ی ListenableFuture.await() در حال تعلیق اضافه می‌کند که ListenableFuture را به یک کوروتین کاتلین تبدیل می‌کند.

نسخه ۱.۰.۰

نسخه ۱.۰.۰

۹ اکتبر ۲۰۱۹

androidx.concurrent:concurrent-futures:1.0.0 منتشر شد. نسخه ۱.۰.۰ شامل این کامیت‌ها است .

ویژگی‌های مهم نسخه ۱.۰.۰

androidx.concurrent:concurrent-futures:1.0.0 کلاس CallbackToFutureAdapter را ارائه می‌دهد، یک ابزار مینیمالیستی که امکان پوشش دادن کد مبتنی بر callback و بازگرداندن نمونه‌های ListenableFuture را فراهم می‌کند. این کلاس برای کتابخانه‌هایی مفید است که می‌خواهند عملیات ناهمزمان را در APIهای جاوای خود به روشی زیباتر از callbackهای سفارشی ارائه دهند، اما به دلیل نگرانی در مورد اندازه کتابخانه، به اندازه کافی کارهای سنگین چندنخی انجام نمی‌دهند تا به guava کامل یا rx java وابستگی داشته باشند.

نسخه ۱.۰.۰-rc01

۷ آگوست ۲۰۱۹

androidx.concurrent:concurrent-futures:1.0.0-rc01 بدون هیچ تغییری نسبت به 1.0.0-beta01 منتشر شده است. کامیت‌های موجود در این نسخه را می‌توانید اینجا بیابید.

نسخه ۱.۰.۰-بتا۰۱ از Concurrent-ListenableFuture

۳۰ مه ۲۰۱۹

androidx.concurrent:concurrent-listenablefuture:1.0.0-beta01 و androidx.concurrent:concurrent-listenablefuture-callback:1.0.0-beta01 منتشر شدند. کامیت‌های موجود در این نسخه را می‌توانید اینجا بیابید.

این کتابخانه‌ها معادل مستقلی برای رابط ListenableFuture در Guava و یک آداپتور برای تبدیل callbackها ارائه می‌دهند.

artifact مربوط به androidx.concurrent:concurrent-futures که قبلاً منتشر شده بود، و آداپتور مشابهی را ارائه می‌داد و شامل artifact مربوط به com.google.guava:listenablefuture بود، ممکن است برای توسعه‌دهندگانی که از زنجیره‌های ابزار - مانند Android Gradle Plugin 3.4.0 - با تطبیق دقیق تفکیک وابستگی استفاده می‌کنند، مشکل‌ساز باشد. به توسعه‌دهندگانی که به کتابخانه کامل Guava متکی نیستند، توصیه می‌شود به androidx.concurrent:concurrent-listenablefuture-callback تغییر دهند.

نسخه ۱.۰.۰-بتا۰۱

۷ مه ۲۰۱۹

androidx.concurrent:concurrent-futures:1.0.0-beta01 منتشر شد. کامیت‌های موجود در این نسخه را می‌توانید اینجا پیدا کنید.

تغییرات API

  • ResolvableFuture و AbstractResolvableFuture به نفع CallbackToFutureAdapter که API امن‌تری ارائه می‌دهد، از API عمومی پنهان شدند.

نسخه ۱.۰.۰-آلفا۰۳

۱۷ دسامبر ۲۰۱۸

androidx.concurrent:concurrent-futures 1.0.0-alpha03 منتشر شد.

ویژگی‌های جدید

  • CallbackToFutureAdapter معرفی شد. این یک API جدید و امن‌تر برای قرار دادن یک API مبتنی بر callback در ListenableFuture است. آن را به استفاده از ResolvableFuture ترجیح دهید.