בו-זמנית

הצהרת יחסי תלות

כדי להוסיף יחסי תלות ל-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")
}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ל-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. אם נתקלתם בבעיות חדשות או שיש לכם רעיונות לשיפור הספרייה הזו, נשמח לשמוע מכם. לפני שיוצרים בעיה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להצביע על בעיה קיימת, לוחצים על לחצן הכוכב.

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גרסה 1.3

גרסה 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 לגבי ערכים null, שהן שימוש בסוגים. מפתחי Kotlin צריכים להשתמש בארגומנטים הבאים של המהדר כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (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 כדי לתרגם קריאה ל-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-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 מכילה את ההוספות האלה.

שינויים ב-API

• נוספה 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 כוללת את ההוספות האלה.

שינויים ב-API

• עכשיו יש ב-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 לבין שגרות המשך (coroutines) ב-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-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 לבין שגרות המשך (coroutines) ב-Kotlin זמינים עכשיו ב-concurrent-futures-ktx. הארטיפקט הזה מיועד לשימוש עם com.google.guava:listenablefuture, בניגוד לספריית Guava המלאה, שהיא תחליף קל ל-Guava שמכיל רק את ListenableFuture. משתמשים בספריית Guava המלאה צריכים להשתמש במקום זאת בתוספים הרשמיים של ListenableFuture מ-kotlinx.coroutines.kotlinx-coroutines-guava.

שינויים ב-API

• הוספת הרחבה 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, כלי מינימליסטי שמאפשר לעטוף קוד מבוסס-החזרה (callback) ולהחזיר מופעים של ListenableFuture. הספרייה שימושית לספריות שרוצות לחשוף פעולות אסינכררוניות בממשקי ה-API שלהן ל-Java בצורה אלגנטית יותר מאשר באמצעות פונקציות קריאה חוזרת בהתאמה אישית, אבל לא מבצעות מספיק משימות כבדות במספר רב של שרשורים כדי להסתמך על guava או rx java מלאים בגלל בעיות שקשורות לגודל הספרייה.

גרסה 1.0.0-rc01

7 באוגוסט 2019

androidx.concurrent:concurrent-futures:1.0.0-rc01 משוחרר ללא שינויים מ-1.0.0-beta01. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

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 משוחררים. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

הספריות האלה מספקות מקבילה עצמאית לממשק ListenableFuture של Guava, וכן מתאם להמרת פונקציות חזרה (callbacks).

הארטיפקט androidx.concurrent:concurrent-futures שפורסם בעבר, שסיפק מתאם דומה וכלל את הארטיפקט com.google.guava:listenablefuture, עלול ליצור בעיות למפתחים שמשתמשים בסביבות פיתוח – כמו Android Gradle Plugin 3.4.0 – עם התאמה קפדנית של פתרון יחסי התלות. מפתחים שלא מסתמכים על ספריית Guava המלאה מומלצים לעבור ל-androidx.concurrent:concurrent-listenablefuture-callback.

גרסה 1.0.0-beta01

7 במאי 2019

androidx.concurrent:concurrent-futures:1.0.0-beta01 משוחרר. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

שינויים ב-API

• ResolvableFuture ו-AbstractResolvableFuture הוסתרו מממשק ה-API הציבורי לטובת CallbackToFutureAdapter שמספק ממשק API בטוח יותר.

גרסה 1.0.0-alpha03

17 בדצמבר 2018

androidx.concurrent:concurrent-futures 1.0.0-alpha03 משוחרר.

תכונות חדשות

• CallbackToFutureAdapter הוצג. זהו ממשק API חדש ובטוח יותר שמאפשר לעטוף ממשק API מבוסס-החזרה (callback) ב-ListenableFuture. עדיף להשתמש בו במקום ב-ResolvableFuture.