בו-זמנית

  
העברת משימות מהשרשור הראשי באמצעות פונקציות רפיטיביות (coroutines) וניצול היתרונות של ListenableFuture.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסה אלפא
‫12 ביוני 2024 1.2.0 - - -

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

כדי להוסיף יחסי תלות ל-Futures, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאגר Maven של Google.

מוסיפים את יחסי התלות של פריטי המידע הנדרשים בקובץ build.gradle של האפליקציה או המודול:

Groovy

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

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

Kotlin

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

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

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

משוב

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

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

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

גרסה 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

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

גרסה 1.0.0-rc01

7 באוגוסט 2019

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

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

שינויים ב-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.