مدیر کار
آخرین به روز رسانی | انتشار پایدار | کاندید را آزاد کنید | نسخه بتا | انتشار آلفا |
---|---|---|---|---|
18 سپتامبر 2024 | 2.9.1 | - | - | 2.10.0-alpha04 |
اعلام وابستگی ها
برای افزودن وابستگی به WorkManager، باید مخزن Google Maven را به پروژه خود اضافه کنید:
وابستگیهای مصنوعات مورد نیاز خود را در فایل build.gradle
برای برنامه یا ماژول خود اضافه کنید:
شیار
dependencies { def work_version = "2.9.1" // (Java only) implementation "androidx.work:work-runtime:$work_version" // Kotlin + coroutines implementation "androidx.work:work-runtime-ktx:$work_version" // optional - RxJava2 support implementation "androidx.work:work-rxjava2:$work_version" // optional - GCMNetworkManager support implementation "androidx.work:work-gcm:$work_version" // optional - Test helpers androidTestImplementation "androidx.work:work-testing:$work_version" // optional - Multiprocess support implementation "androidx.work:work-multiprocess:$work_version" }
کاتلین
dependencies { val work_version = "2.9.1" // (Java only) implementation("androidx.work:work-runtime:$work_version") // Kotlin + coroutines implementation("androidx.work:work-runtime-ktx:$work_version") // optional - RxJava2 support implementation("androidx.work:work-rxjava2:$work_version") // optional - GCMNetworkManager support implementation("androidx.work:work-gcm:$work_version") // optional - Test helpers androidTestImplementation("androidx.work:work-testing:$work_version") // optional - Multiprocess support implementation("androidx.work:work-multiprocess:$work_version") }
برای اطلاعات در مورد استفاده از پسوندهای Kotlin، به مستندات ktx مراجعه کنید.
برای اطلاعات بیشتر درباره وابستگیها، به افزودن وابستگیهای ساخت مراجعه کنید.
بازخورد
بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.
برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.
نسخه 2.10
نسخه 2.10.0-alpha04
18 سپتامبر 2024
androidx.work:work-*:2.10.0-alpha04
منتشر شد. نسخه 2.10.0-alpha04 حاوی این commit ها است.
تغییرات API
- دلیل توقف
STOP_REASON_FOREGROUND_SERVICE_TIMEOUT
را برای زمانی که یک کارگر پیشزمینه به دلیل وقفه زمانی اجرا متوقف میشود، بر اساس نوع سرویس پیشزمینه اضافه کنید. ( Ibd0af )
نسخه 2.10.0-alpha03
4 سپتامبر 2024
androidx.work:work-*:2.10.0-alpha03
منتشر شد. نسخه 2.10.0-alpha03 حاوی این commit ها است.
ویژگی های جدید
- برچسبهای ردیابی از
WorkManager
به Jobs اضافه شده است که درک «adb shell dumpsys jobscheduler» را بسیار سادهتر میکند، زیرا حاوی نام Worker در حال اجرا است. بخشهای Trace نیز در اطراف بخشهای کلیدیWorkManager
اضافه میشوند.
تغییرات API
- WorkManager 2.10.0 اکنون با SDK 35 کامپایل شده است.
- زمانی که
WorkManager
stopSelf()
را فراخوانی نمیکند، کارگران پیشزمینه از نوع «سرویس کوتاه» و «همگامسازی داده» به پایان میرسند و باعث ایجاد ANR میشوند. این اصلاح فقط برای دستگاههای دارای API 34 و 35 اعمال میشود که در آنها انواع خدمات پیشزمینه معرفی شدهاند. ( ca06b2 , b/364508145 ) - API های
WorkerParameters
جدید که امکان تغییر فرآیند راه دوری را کهWorker
هنگام استفاده ازWorkerFactory
به آن متصل می شود، می دهد. ( Ibdc8a ، Ie8a90 ، I7373f )
رفع اشکال
- خرابی ناشی از تلاش
WorkManager
برای راهاندازی مجدد یک کارگر طولانیمدت (یعنی کارگر پیشزمینه) را برطرف کنید، زمانی که نوع پیشزمینه کار دارای مجوزهای پیشنیاز Android 14 بود که لغو شده بودند. ( b/333957914 ) - طرح دستی دسترسی به APIهای پلتفرم جدید حذف شد زیرا این به طور خودکار از طریق مدلسازی API هنگام استفاده از R8 با AGP 7.3 یا جدیدتر (مثلا R8 نسخه 3.3) و برای همه ساختها هنگام استفاده از AGP 8.1 یا بالاتر (به عنوان مثال D8 نسخه 8.1) اتفاق میافتد. به مشتریانی که از AGP استفاده نمیکنند، توصیه میشود به نسخه 8.1 یا بالاتر D8 بهروزرسانی کنند. برای جزئیات بیشتر به این مقاله مراجعه کنید. ( Ia60e0 , b/345472586 )
نسخه 2.10.0-alpha02
17 آوریل 2024
androidx.work:work-*:2.10.0-alpha02
منتشر شد. نسخه 2.10.0-alpha02 حاوی این commit ها است.
تغییرات API
- قابلیت انتشار بازه های ردیابی از طریق یک
@RestrictTo
Tracer
قابل تنظیم درWorkManager
اضافه شده است. ( I17d7f , b/260214125 ) -
Configuration.workerCoroutineContext
برای کنترل توزیع کننده که در آنCoroutineWorker
اجرا می شود به آن اضافه شد. این کمک می کند تا به طور کامل از استفاده ازDispatchers.Default
درWorkManager
اجتناب شود. ( Icd1b7 ) - اضافه کردن کنترلکنندههای استثنای سفارشی برای Workers ( Ib1b74 , b/261190695 )
-
OneTimeWorkRequest.Builder
وPeriodicWorkRequest.Builder
اکنون می توانند باKClass
به جایClass
ساخته شوند:val request = OneTimeWorkRequest.Builder(Worker::class).setConstraints(...).build()
( Ib55f6 ) - کلاس
WorkManager
به کاتلین منتقل شد. اکنون روشهایی کهLiveData
،ListenableFuture
یاFlow
را برمیگردانند، اطلاعات پوچپذیری صحیحی را ارائه میکنند. اگر مفروضات پوچ بودن در آن کد نادرست بود، ممکن است نیاز به تغییر در کد منبع مشتری داشته باشد. ( If6757 )
نسخه 2.10.0-alpha01
24 ژانویه 2024
androidx.work:work-*:2.10.0-alpha01
منتشر شد. نسخه 2.10.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
- توسعه دهندگان می توانند
NetworkRequest
به عنوان یک محدودیت برای یک کارگر از طریق روشConstraints.setRequiredNetworkRequest
تعیین کنند. این امکان کنترل دقیق تری بر روی شبکه ای که این کارگر باید اجرا کند را فراهم می کند.
تغییرات API
- افزودن قابلیتی برای تعیین
NetworkRequest
به عنوان محدودیت. ( Id98a1 , b/280634452 )
نسخه 2.9
نسخه 2.9.1
7 آگوست 2024
androidx.work:work-*:2.9.1
منتشر شد. نسخه 2.9.1 شامل این commit ها است.
رفع اشکال
- خرابی ناشی از تلاش
WorkManager
برای راهاندازی مجدد یک کارگر طولانیمدت (یعنی کارگر پیشزمینه) را برطرف کنید، زمانی که نوع پیشزمینه کار دارای مجوزهای پیشنیاز Android 14 بود که لغو شده بودند. ( b/333957914 )
نسخه 2.9.0
29 نوامبر 2023
androidx.work:work-*:2.9.0
منتشر شد. نسخه 2.9.0 حاوی این commit ها است.
تغییرات مهم از 2.8.0
- قابلیت مشاهده از طریق
Flow
-s. به جایLiveData
، پیشرفت Worker اکنون از طریق Flow از طریقWorkManager.getWorkInfosFlow
و روشهای مشابه قابل مشاهده است. - اکنون
WorkManager
راهنمایی می کند که چرا یک کارگر قبلا متوقف شده است. از طریق متدgetStopReason()
یا ازWorkInfo
از طریقgetStopReason()
می توان آن را از خود کارگر جویا شد. - زمانبندی دقیق کارگران دورهای از طریق
setNextScheduleTimeOverride
. این امکان محاسبه پویا برنامه کاری دورهای بعدی را فراهم میکند، که میتواند برای پیادهسازی ویژگیهای پیشرفته مانند زمانهای تازهسازی تطبیقی، رفتار امتحان مجدد سفارشی، یا ایجاد یک کارمند اخبار فید قبل از بیدار شدن کاربر هر روز صبح بدون جابجایی مورد استفاده قرار گیرد.ExistingPeriodicWorkPolicy.UPDATE
باید با این تکنیکها استفاده شود تا از لغو یک کارگر فعلی در حین برنامهریزی بعدی جلوگیری شود. - تست WorkManager با تولید تطبیق رشته.
ExecutorsMode.PRESERVE_EXECUTORS
می توان درinitializeTestWorkManager
برای حفظ مجری های تنظیم شده درConfiguration
و استفاده از رشته اصلی واقعی استفاده کرد. - API های Coroutines مانند
CoroutineWorker
از artifact اضافی work-runtime-ktx به artifact work-runtime اصلی منتقل شده اند. work-runtime-ktx اکنون خالی است.
تغییرات API
-
stopReason
بهWorkInfo
اضافه شد. پس از اجرا شدن کارگر،stopReason
در دسترس قرار می دهد. این می تواند در گزارشstopReason
به روشی قابل استفاده مفید باشد، زیرا هنگامی که یک کارگر متوقف شود، خود یک برنامه می تواند خیلی سریع از بین برود. ( I21386 ) - اجازه دهید
Clock
از طریق پیکربندی تنظیم شود و برای اجرای توالی اجرای تستهای Worker استفاده شود. ( IC586e ) - متد
getStopReason()
بهListenableWorker
اضافه شد که به دلیل توقف کارگر اشاره می کند. ( I07060 ) - اضافه شد
WorkManagerTestInitHelper#closeWorkDatabase()
برای جلوگیری از هشدار Closeguard در مورد منابع لو رفته. ( Ia8d49 ) - سازنده
WorkInfo
اکنون عمومی است، که می تواند در آزمایش مفید باشد. ( Ia00b6 , b/209145335 ) -
work-runtime-ktx
اکنون خالی است،CoroutineWorker
و سایر ابزارهای خاص Kotlin اکنون در آرتیفکت اصلی کار در زمان اجرا در دسترس هستند. ( I71a9a ) - روش
setNextScheduleTimeOverride
اضافه شد که امکان تنظیم دقیق برنامه های کاری دوره ای را فراهم می کند ( I3b4da ) -
getNextScheduleTimeMillis
برای دریافت اطلاعات زمان اجرای برنامهریزیشده بهWorkInfo
اضافه شد. ( I797e4 ) - تاخیر اولیه و اطلاعات دوره ای به
WorkInfo
اضافه می شود. ( I52f2f ) - روش اضافه شده مشاهده کارگران از طریق جریان از طریق متدهای
getWorkInfosByTagFlow
،getWorkInfoByIdFlow
،getWorkInfosForUniqueWorkFlow
،getWorkInfosFlow
( If122a ) - توضیحات گم شده
@RequiresApi(...)
به سازنده ها و ویژگی هایConstraints
اضافه شد. آنها اکنون با حاشیهنویسیهای مربوطه در تنظیمکنندهها درConstraints.Builder
که از نسخههای اولیهWorkManager
وجود داشت، تراز شدهاند. ( I6d7d2 ) -
WorkManager
اکنون محدودیت جداگانهای برای کارگران محتوای uri دارد تا به آنها اسلات تضمینی درJobScheduler
بدهد تا از بهروزرسانیهای محتوای مفقود تحت بار زیاد جلوگیری کند. محدودیت را می توان از طریقConfiguration.Builder.setContentUriTriggerWorkersLimit
پیکربندی کرد. ( IC128f ) - محدودیت ها به
WorkInfo
اضافه می شوند. ( I162c0 )
نسخه 2.9.0-rc01
18 اکتبر 2023
androidx.work:work-*:2.9.0-rc01
منتشر شد. نسخه 2.9.0-rc01 حاوی این commit ها است.
- هیچ تغییری از آخرین نسخه بتا وجود ندارد
نسخه 2.9.0-beta01
6 سپتامبر 2023
androidx.work:work-*:2.9.0-beta01
منتشر شد. نسخه 2.9.0-beta01 حاوی این تعهدات است.
تغییرات API
- ثابت اضافه شده به دلایل توقف که توسط
WorkInfo.stopReason
وListenableWorker.stopReason
( I0cc00 ) برگردانده شده است
نسخه 2.9.0-alpha02
26 جولای 2023
androidx.work:work-*:2.9.0-alpha02
منتشر شد. نسخه 2.9.0-alpha02 حاوی این commit ها است.
ویژگی های جدید
- اکنون
WorkManager
راهنمایی می کند که چرا یک کارگر قبلا متوقف شده است. از طریق متدgetStopReason()
یا ازWorkInfo
از طریقgetStopReason()
می توان آن را از خود کارگر جویا شد.
تغییرات API
-
stopReason
بهWorkInfo
اضافه شد. پس از اجرای کارگر،stopReason
در دسترس قرار می دهد. این می تواند در گزارشstopReason
به روشی قابل استفاده مفید باشد، زیرا هنگامی که یک کارگر متوقف شود، خود یک برنامه می تواند خیلی سریع از بین برود. ( I21386 ) - اجازه دهید ساعت از طریق پیکربندی تنظیم شود و برای اجرای توالی اجرای تستهای Worker استفاده شود. ( IC586e )
- متد
getStopReason()
بهListenableWorker
اضافه شد که به دلیل توقف کارگر اشاره می کند. ( I07060 ) - اضافه شد
WorkManagerTestInitHelper#closeWorkDatabase()
برای جلوگیری از هشدار Closeguard در مورد منابع لو رفته. ( Ia8d49 )
رفع اشکال
- اضافه شدن قابلیت دور زدن
overrideNextScheduleTime
با استفاده ازTestDriver
و رفع مشکلات تستپذیری. ( IC2905 )
نسخه 2.9.0-alpha01
7 ژوئن 2023
androidx.work:work-*:2.9.0-alpha01
منتشر شد. نسخه 2.9.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
- قابلیت مشاهده از طریق
Flow
-s. به جایLiveData
، پیشرفت Worker اکنون از طریق Flow از طریقWorkManager.getWorkInfosFlow
و روشهای مشابه قابل مشاهده است. - زمانبندی دقیق کارگران دورهای از طریق
setNextScheduleTimeOverride
. این امکان محاسبه پویا برنامه کاری دورهای بعدی را فراهم میکند، که میتواند برای پیادهسازی ویژگیهای پیشرفته مانند زمانهای تازهسازی تطبیقی، رفتار امتحان مجدد سفارشی، یا ایجاد یک کارمند اخبار فید قبل از بیدار شدن کاربر هر روز صبح بدون جابجایی مورد استفاده قرار گیرد.ExistingPeriodicWorkPolicy.UPDATE
باید با این تکنیکها استفاده شود تا از لغو یک کارگر فعلی در حین برنامهریزی بعدی جلوگیری شود. - تست
WorkManager
با تولید تطبیق رشته.ExecutorsMode.PRESERVE_EXECUTORS
می توان برای حفظ مجری های تنظیم شده درConfiguration
و استفاده از رشته اصلی واقعی استفاده کرد. - API های Coroutines مانند
CoroutineWorker
از artifact اضافیwork-runtime-ktx
به artifactwork-runtime
اصلی منتقل شده اند.work-runtime-ktx
اکنون خالی است.
تغییرات API
- سازنده
WorkInfo
اکنون عمومی است، که می تواند در آزمایش مفید باشد. ( Ia00b6 , b/209145335 ) -
work-runtime-ktx
اکنون خالی است،CoroutineWorker
و سایر ابزارهای خاص kotlin اکنون در آرتیفکت اصلیwork-runtime
در دسترس هستند. ( I71a9a ) - روش
setNextScheduleTimeOverride
اضافه شد که امکان تنظیم دقیق برنامه های کاری دوره ای را فراهم می کند ( I3b4da ) - نام
getEarliestRunTimeMillis
بهgetNextScheduleTimeMillis
تغییر یافت. ( I2bd7a ) - اطلاعات زمان اجرای برنامه ریزی شده بعدی به
WorkInfo
اضافه می شود. ( I797e4 ) - تاخیر اولیه و اطلاعات دوره ای به
WorkInfo
اضافه می شود. ( I52f2f ) - روش اضافه شده مشاهده کارگران از طریق جریان از طریق متدهای
getWorkInfosByTagFlow
،getWorkInfoByIdFlow
،getWorkInfosForUniqueWorkFlow
،getWorkInfosFlow
( If122a ) - حاشیه نویسی
@RequiresApi(...)
گم شده به سازنده ها و ویژگی های Constraints اضافه شد. آنها اکنون با حاشیهنویسیهای مربوطه در تنظیمکنندهها درConstraints.Builder
که از نسخههای اولیهWorkManager
وجود داشت، تراز شدهاند. ( I6d7d2 ) -
WorkManager
اکنون محدودیت جداگانهای برای کارگران محتوای uri دارد تا به آنها اسلات تضمینی درJobScheduler
بدهد تا از بهروزرسانیهای محتوای مفقود تحت بار زیاد جلوگیری کند. Limit را می توان از طریقConfiguration.Builder.setContentUriTriggerWorkersLimit
پیکربندی کرد. ( IC128f ) - محدودیت ها به
WorkInfo
اضافه می شوند. ( I162c0 )
نسخه 2.8
نسخه 2.8.1
22 مارس 2023
androidx.work:work-*:2.8.1
منتشر شد. نسخه 2.8.1 حاوی این commit ها است.
رفع اشکال
- ANR در
RescheduleReceiver
که قبلاً دو پخش همزمان را به درستی مدیریت نمی کرد، رفع شد. ( b/236906724 )
نسخه 2.8.0
8 فوریه 2023
androidx.work:work-*:2.8.0
منتشر شد. نسخه 2.8.0 حاوی این commit ها است.
تغییرات مهم از 2.7.0
ویژگی های جدید
- توانایی به روز رسانی
WorkRequests
به روشی غیر مزاحم اضافه شد، با حفظ زمان صف اولیه، زنجیره زدن و غیره. برای جزئیات بیشتر به پست وبلاگ مفصل در مورد این ویژگی و همچنین جاوادوکس برایWorkManager.updateWork
وExistingPeriodicWorkPolicy.UPDATE
مراجعه کنید.
تغییرات API
-
WorkManager.updateWork
برای بهروزرسانی کار با حفظ زمان صف اولیه و زنجیرهبندی آن اضافه شد. ( I9a248 , b/219446409 ) -
ExistingPeriodicWorkPolicy.UPDATE
اضافه شد. این خطمشی بهروزرسانی یک اثر دورهای را با نام اجازه میدهد. شبیهREPLACE
موجود است، اما کمتر مزاحم است: اگر در حال حاضر در حال اجرا باشد، کارگری را لغو نمیکند و زمان صف را حفظ میکند - تاخیر و دوره اولیه به جای زمان بهروزرسانی، از زمان صف اولیه محاسبه میشود.REPLACE
منسوخ شد تا سردرگمی بین نام بسیار مشابهREPLACE
وUPDATE
کاهش یابد. اگر همچنان میخواهید معنای قبلیREPLACE
را حفظ کنید، میتوانید ازCANCEL_AND_REENQUEUE
که به تازگی اضافه شده است، که مشابهREPLACE
است، استفاده کنید. ( I985ed , b/219446409 ) - اضافه شدن قابلیت رهگیری استثناهای زمانبندی ارائه
Consumer<Throwable>
از طریق setSchedulingExceptionHandler ) - قابلیت ارائه
Consumer<Throwable>
از طریق setInitializationExceptionHandler اضافه کرد تا مشخص شود آیا هنگام تلاش برای مقداردهی اولیه WorkManager مشکلی وجود دارد یا خیر. - راهنماهای درون خطی برای
OneTimeWorkRequest
وPeriodicWorkRequest
ازandroidx.work:work-runtime-ktx
بهandroidx.work:work-runtime
منتقل شدند ( I0010f ، b/209145335 ) - روشهای کمکی
WorkQuery.fromIds
،WorkQuery.fromStates
،WorkQuery.fromUniqueWorkNames
،WorkQuery.fromTags
برای ایجاد مستقیمWorkQuery
اضافه شدند. ( b/199919736 ) ( If48f2 , b/199919736 ) -
getForegroundInfo
بهWorker
اضافه شد. ( IC1ead ) -
RxWorker
برای RxJava 2 و RxJava 3 اکنون دارایsetForeground
بازگشتیCompletable
است که می تواند به جایsetForegroundInfoAsync
استفاده شود کهListenableFuture
برمی گرداند. -
RxWorker
هر دو برای RxJava 2 و RxJava 3 دارایgetForegroundInfo
بازگشتیSingle
است که می تواند به جایgetForegroundInfoAsync
استفاده شود کهListenableFuture
برمی گرداند. ( b/203851459 ) - اکنون می توان محدودیت ها را مستقیماً به جای استفاده از
Constraints.Builder
ایجاد کرد که برای کاربران Kotlin راحت است. ( IDc390 , b/137568653 ) - قابلیت بررسی اینکه آیا
WorkManager
مقداردهی اولیه شده است یا خیر اضافه شده است. همچنین، یک APIgetConfiguration()
برای توسعه دهندگان کتابخانه اضافه کرد تا پیکربندی را کهWorkManager
با آن مقداردهی اولیه شده بود، دریافت کند. ( I6eff3 , b/212300336 )
رفع اشکال
- مشکلی در زمانبندی حریص که مانع از دویدن کارگران در هنگام بارگیری میشد، برطرف شد. ( I9686b , b/248111307 )
-
@RequiresPermission
به APIهایی که نیاز به اعطای مجوزPOST_NOTIFICATIONS
در SDK 33 و بالاتر دارند اضافه شد. ( Ie542e , b/238790278 ) - هنگام استفاده از
suspendCancellableCoroutine
لغوها را درCoroutineScope
بهListenableFuture
منتشر کنید.
نسخه 2.8.0-rc01
7 دسامبر 2022
androidx.work:work-*:2.8.0-rc01
منتشر شد. نسخه 2.8.0-rc01 حاوی این commit ها است.
ویژگی های جدید
- هیچ ویژگی جدیدی در این نسخه وجود ندارد. این عمدتا یک دست انداز نسخه است
نسخه 2.8.0-beta02
9 نوامبر 2022
androidx.work:work-*:2.8.0-beta02
منتشر شد. نسخه 2.8.0-beta02 حاوی این تعهدات است.
رفع اشکال
- روش
equals
ثابت درWorkInfo
، که قبلاً اطلاعات نسل جدید را در نظر نمی گرفت. ( 4977cc )
نسخه 2.8.0-beta01
5 اکتبر 2022
androidx.work:work-*:2.8.0-beta01
منتشر شد. نسخه 2.8.0-beta01 حاوی این تعهدات است.
رفع اشکال
- مشکلی در زمانبندی حریص که مانع از دویدن کارگران در هنگام بارگیری میشد، برطرف شد. ( I9686b , b/248111307 )
نسخه 2.8.0-alpha04
7 سپتامبر 2022
androidx.work:work-*:2.8.0-alpha04
منتشر شد. نسخه 2.8.0-alpha04 حاوی این commit ها است.
تغییرات API
-
WorkerInfo.getGeneration()
وWorkerParameters.getGeneration()
اضافه شدند که نسل یک worker را برمی گرداند. یک کارگر دارای چندین نسل است، اگر از طریقWorkManager.updateWork
یاWorkManager.enqueueUniquePeriodicWork
با استفاده ازExistingPeriodicWorkPolicy.UPDATE
به روز شده باشد. توجه داشته باشید که اگر کارگر در حال حاضر در حال اجرا است، این روش ممکن است نسل جدیدتری را از کارگر فعلی در حال اجرا برگرداند، اگر به روز رسانی در حین اجرای کارگر رخ داده باشد. ( I665c5 , b/219446409 ) ( I128a9 , b/219446409 ) -
InitializationExceptionHandler
اضافه شد، یک Exception Handler که می تواند برای تعیین اینکه آیا هنگام تلاش برای مقداردهی اولیهWorkManager
مشکلی وجود دارد یا خیر استفاده شود. ( I061de )
نسخه 2.8.0-alpha03
10 آگوست 2022
androidx.work:work-*:2.8.0-alpha03
منتشر شد. نسخه 2.8.0-alpha03 حاوی این commit ها است.
ویژگی های جدید
- توانایی بهروزرسانی
WorkRequests
به روشی غیر سرزده اضافه شد، با حفظ زمان صف اولیه، زنجیرهبندی و غیره. برای جزئیات بیشتر بهWorkManager.updateWork
وExistingPeriodicWorkPolicy.UPDATE
مراجعه کنید.
تغییرات API
-
WorkManager.updateWork
برای بهروزرسانی کار با حفظ زمان صف اولیه و زنجیرهبندی آن اضافه شد. ( I9a248 , b/219446409 ) -
ExistingPeriodicWorkPolicy.UPDATE
اضافه شد. این خط مشی اجازه می دهد تا یک اثر دوره ای را با نام به روز کنید. شبیهREPLACE
موجود است، اما کمتر مزاحم است: اگر در حال حاضر در حال اجرا باشد، کارگری را لغو نمیکند و زمان صف را حفظ میکند - تاخیر و دوره اولیه به جای زمان بهروزرسانی، از زمان صف اولیه محاسبه میشود.REPLACE
منسوخ شد تا سردرگمی بینREPLACE
وUPDATE
با نام بسیار مشابه کاهش یابد. اگر همچنان میخواهید معنای قبلیREPLACE
را حفظ کنید، میتوانید ازCANCEL_AND_REENQUEUE
که به تازگی اضافه شده است، که مشابهREPLACE
است، استفاده کنید. ( I985ed , b/219446409 ) - با تعریف
SchedulingExceptionHandler
، امکان رهگیری استثناهای زمانبندی را اضافه کنید. ( I033eb ) - راهنماهای درون خطی برای
OneTimeWorkRequest
وPeriodicWorkRequest
ازandroidx.work:work-runtime-ktx
بهandroidx.work:work-runtime
منتقل شدند ( I0010f ، b/209145335 )
رفع اشکال
-
@RequiresPermission
به APIهایی که نیاز به اعطای مجوز POST_NOTIFICATIONS در SDK 33 و بالاتر دارند اضافه شد. ( Ie542e , b/238790278 )
نسخه 2.8.0-alpha02
6 آوریل 2022
androidx.work:work-*:2.8.0-alpha02
منتشر شد. نسخه 2.8.0-alpha02 حاوی این commit ها است.
تغییرات API
- اکنون می توان به جای استفاده از Builder که برای کاربران Kotlin راحت است، محدودیت ها را مستقیماً ایجاد کرد. ( IDc390 , b/137568653 )
- قابلیت بررسی اینکه آیا
WorkManager
مقداردهی اولیه شده است یا خیر اضافه شده است. همچنین، یک APIgetConfiguration()
برای توسعه دهندگان کتابخانه اضافه کرد تا پیکربندی را کهWorkManager
با آن مقداردهی اولیه شده بود، دریافت کند. ( I6eff3 , b/212300336 )
نسخه 2.8.0-alpha01
12 ژانویه 2022
androidx.work:work-*:2.8.0-alpha01
منتشر شد. نسخه 2.8.0-alpha01 حاوی این commit ها است.
تغییرات API
- متدهای کمکی
WorkQuery.fromStates
،WorkQuery.fromUniqueWorkNames
،WorkQuery.fromTags
برای ایجاد مستقیم WorkQuery اضافه شدند. ( If48f2 , b/199919736 ) - روش های آزمایشی BuildCompat را برای SDK های آینده اضافه می کند ( Iafd82 , b/207528937 )
-
getForegroundInfo
بهWorker
اضافه کنید. ( IC1ead ) - روشهای کمکی
WorkQuery.fromIds
برای ایجاد WorkQuery مستقیماً از ID اضافه شد. ( Ie5bdf , b/199919736 ) - RxWorker اکنون
setForeground
بازگشتیCompletable
دارد که می تواند به جایsetForegroundInfoAsync
کهListenableFuture
برمی گرداند استفاده شود. ( I85156 ) - RxWorker برای RxJava 2 اکنون
getForegroundInfo
Single
دارد که می تواند به جایgetForegroundInfoAsync
استفاده شود کهListenableFuture
برمی گرداند. ( I21c91 , b/203851459 ) - RxWorker برای RxJava 3 اکنون
getForegroundInfo
Single
دارد که می تواند به جایgetForegroundInfoAsync
کهListenableFuture
برمی گرداند استفاده شود. ( I1ca8a ) - RxWorker اکنون
setForeground
بازگشتیCompletable
دارد که می تواند به جایsetForegroundInfoAsync
کهListenableFuture
برمی گرداند استفاده شود. ( I992a3 , b/203851459 )
رفع اشکال
- هنگام استفاده از
suspendCancellableCoroutine
لغوها را درCoroutineScope
بهListenableFuture
منتشر کنید. ( I77e63 )
نسخه 2.7
نسخه 2.7.1
17 نوامبر 2021
androidx.work:work-*:2.7.1
منتشر شد. نسخه 2.7.1 حاوی این commit ها است.
رفع اشکال
- هنگام استفاده از
suspendCancellableCoroutine
لغوها درCoroutineScope
بهListenableFuture
منتشر می شوند. ( I77e63 ) - زمانی که درخواستهای کاری با تأخیر بهعنوان تسریعشده علامتگذاری میشوند، فوراً استثنا ایجاد میشود. bef1762
نسخه 2.7.0
13 اکتبر 2021
androidx.work:work-*:2.7.0
منتشر شد. نسخه 2.7.0 حاوی این commit ها است.
تغییرات مهم از 2.6.0
WorkManager یک API
WorkRequest.Builder.setExpedited(...)
جدید را برای کمک به محدودیت های خدمات پیش زمینه در اندروید 12 معرفی می کند.هنگام استفاده از
setExpedited(...)
، WorkManager به کارهای تسریع شده در JobScheduler با شروع Android 12 واگذار می کند، در حالی که با واگذاری به یک سرویس پیش زمینه، سازگاری با نسخه های قبلی اندروید را فراهم می کند.
نسخه 2.7.0-rc01
29 سپتامبر 2021
androidx.work:work-*:2.7.0-rc01
منتشر شد. نسخه 2.7.0-rc01 حاوی این commit ها است.
این نسخه مشابه androidx.work:work-*:2.7.0-beta01
است.
نسخه 2.7.0-beta01
1 سپتامبر 2021
androidx.work:work-*:2.7.0-beta01
منتشر شد. نسخه 2.7.0-beta01 حاوی این تعهدات است.
ویژگی های جدید
- هنگام راه اندازی WorkManager، اختلاف چند فرآیندی SQLite را کاهش دهید.
تغییرات API
- APIهای
@ExperimentalExpeditedWork
را حذف کنید، با توجه به اینکه APIهای پلتفرم زیرین برای Android 12 (S) پایدار هستند. ( aosp/1792806 )
رفع اشکال
- برای کارگران تسریع شده که
getForegroundInfoAsync()
پیاده سازی نمی کنند، پیام خطای بهتری ارائه دهید. ( aosp/1809376 )
نسخه 2.7.0-alpha05
21 جولای 2021
androidx.work:work-*:2.7.0-alpha05
منتشر شد. نسخه 2.7.0-alpha05 حاوی این commit ها است.
این نسخه همچنین حاوی رفع اشکال از نسخه WorkManager 2.6.0-beta02
است.
نسخه 2.7.0-alpha04
2 ژوئن 2021
androidx.work:work-*:2.7.0-alpha04
منتشر شد.
این نسخه همچنین شامل تغییرات نسخه 2.6.0-beta01 است.
تغییرات API
-
ListenableWorker.setForegroundAsync()
دیگر منسوخ نشده است. - توصیه می کنیم در صورت امکان از
WorkRequest.Builder.setExpedited(...)
API استفاده کنید. برای پشتیبانی بهتر از موقعیتهایی که برنامه تحت محدودیتهای سرویس پیشزمینه نیست ، توسعهدهندگان میتوانند از APIListenableWorker.setForegroundAsync()
استفاده کنند. - اگر
ListenableWorker.setForegroundAsync()
فراخوانی شود، زمانی که برنامه در معرض محدودیتهای سرویس پیشزمینه باشد، ForegroundServiceStartNotAllowedException را پرتاب میکند.
رفع اشکال
- وقتی کارهای تسریع شده دوباره برنامه ریزی می شوند، دیگر تسریع نمی شوند. تبدیل به مشاغل معمولی می شوند.
نسخه 2.7.0-alpha03
21 آوریل 2021
androidx.work:work-*:2.7.0-alpha03
منتشر شد. نسخه 2.7.0-alpha03 حاوی این commit ها است.
ویژگی های جدید
From WorkManager
2.6.0-alpha02
: پشتیبانی از Workers را اضافه می کند که می توانند در هر فرآیندی اجرا شوند. ( Iaf200 )از WorkManager
2.6.0-alpha02
: یکRemoteCoroutineWorker
اضافه شد که پیاده سازیRemoteListenableWorker
است که می تواند به یک فرآیند راه دور متصل شود. ( I30578 )
تغییرات API
- از WorkManager
2.6.0-alpha02
: پشتیبانی از محدودیت شبکهTEMPORARILY_UNMETERED
اضافه شد. ( I08d5e ) - از WorkManager
2.6.0-alpha02
:پشتیبانی کارگر چند فرآیندی برایsetProgressAsync()
. ( Ib6d08 ) - از WorkManager
2.6.0-alpha02
:WorkManagerInitializer
عمومی کنید تا دیگرandroidx.startup.Initializer
بتوانند از این موارد به عنوان وابستگی استفاده کنند. ( I5ab11 )
نسخه 2.7.0-alpha02
10 مارس 2021
androidx.work:work-*:2.7.0-alpha02
منتشر شد. نسخه 2.7.0-alpha02 حاوی این commit ها است.
رفع اشکال
- تغییرپذیری
PendingIntent
آشکار کنید تا هنگام هدف قرار دادن Android 12 خرابی را برطرف کنید. ( b/180884673 )
نسخه 2.7.0-alpha01
18 فوریه 2021
androidx.work:work-*:2.7.0-alpha01
منتشر شد. نسخه 2.7.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
WorkManager یک API
WorkRequest.Builder.setExpedited(...)
جدید را برای در نظر گرفتن محدودیت های خدمات پیش زمینه در اندروید 12 معرفی می کند.وقتی برنامهها در پسزمینه هستند، دیگر نمیتوانند سرویس پیشزمینه را راهاندازی کنند. بنابراین، برای پشتیبانی بهتر از کارهای طولانی مدتی که قبلاً به چرخه عمر یک سرویس پیشزمینه وابسته بود، برنامهها میتوانند
WorkRequest
را بهعنوان تسریع شده علامتگذاری کنند.این API جایگزینی برای APIهای
setForegroundAsync(...)
/setForeground(...)
است که اکنون منسوخ شده اند.هنگام استفاده از
setExpedited(...)
، WorkManager به کارهای تسریع شده درJobScheduler
با شروع Android 12 واگذار میکند، در حالی که با واگذاری به خدمات پیشزمینه، سازگاری با نسخههای قبلی اندروید را فراهم میکند.
تغییرات API
- اضافه کردن پشتیبانی برای
WorkRequest
های سریع.
نسخه 2.6.0
نسخه 2.6.0
1 سپتامبر 2021
androidx.work:work-*:2.6.0
منتشر شد. نسخه 2.6.0 حاوی این commit ها است.
تغییرات مهم از 2.5.0
WorkManager اکنون از
androidx.startup
برای مقداردهی اولیه WorkManager استفاده می کند. اگر در گذشته ازtools:node="remove"
ContentProvider
که برای مقداردهی اولیه WorkManager استفاده میشد استفاده میکردید، در عوض باید کارهای زیر را انجام دهید.<provider android:name="androidx.startup.InitializationProvider" android:authorities=\"${applicationId}.androidx-startup" android:exported="false" tools:node=\"merge"> <!-- If you are using androidx.startup to initialize other components --> <meta-data android:name="androidx.work.WorkManagerInitializer" android:value="androidx.startup" tools:node="remove" /> </provider>
<!-- If you want to disable android.startup completely. --> <provider android:name="androidx.startup.InitializationProvider" android:authorities="${applicationId}.androidx-startup" tools:node="remove" />
پشتیبانی اضافه شده برای Workers که می تواند در هر فرآیندی اجرا شود. ( Iaf200 )
یک
RemoteCoroutineWorker
اضافه شد که اجرای RemoteListenableWorker است که می تواند به یک فرآیند راه دور متصل شود. ( I30578 )
نسخه 2.6.0-rc01
4 آگوست 2021
androidx.work:work-*:2.6.0-rc01
منتشر شد. نسخه 2.6.0-rc01 حاوی این commit ها است.
این نسخه مشابه androidx.work:work-*:2.6.0-beta02
است.
نسخه 2.6.0-beta02
21 جولای 2021
androidx.work:work-*:2.6.0-beta02
منتشر شد. نسخه 2.6.0-beta02 حاوی این تعهدات است.
رفع اشکال
-
RemoteWorkManager
اکنون به درستی ازRemoteWorkManagerService
جدا می شود که بهRemoteWorkManagerService
اجازه می دهد تا به درستی پاکسازی کند. aosp/1730694 -
RemoteListenableWorker
اکنون به درستی ازRemoteWorkerService
جدا می شود که بهRemoteWorkerService
اجازه می دهد تا به درستی پاکسازی کند. aosp/1743817 -
ForceStopRunnable
اکنون فقط در فرآیند برنامه اولیه اجرا می شود. این یک بهینه سازی است و از مناقشات منابع برای برنامه هایی که از چندین فرآیند استفاده می کنند جلوگیری می کند. aosp/1749180 ، aosp/1761729
نسخه 2.6.0-beta01
2 ژوئن 2021
androidx.work:work-*:2.6.0-beta01
منتشر شد. نسخه 2.6.0-beta01 حاوی این تعهدات است.
این نسخه حاوی برخی بهبودهای جزئی در اسناد است. نسخه تا حد زیادی مشابه 2.6.0-alpha02 است.
نسخه 2.6.0-alpha02
21 آوریل 2021
androidx.work:work-*:2.6.0-alpha02
منتشر شد. نسخه 2.6.0-alpha02 حاوی این commit ها است.
ویژگی های جدید
پشتیبانی برای Workers اضافه می کند که می تواند در هر فرآیندی اجرا شود. ( Iaf200 )
یک
RemoteCoroutineWorker
اضافه شد که اجرایRemoteListenableWorker
است که می تواند به یک فرآیند راه دور متصل شود. ( I30578 )
تغییرات API
- پشتیبانی از محدودیت شبکه
TEMPORARILY_UNMETERED
اضافه شد. ( I08d5e ) - پشتیبانی کارگر چند فرآیندی برای
setProgressAsync()
. ( Ib6d08 ) -
WorkManagerInitializer
عمومی کنید تا سایرandroidx.startup.Initializer
بتوانند از اینها به عنوان وابستگی استفاده کنند. ( I5ab11 )
نسخه 2.6.0-alpha01
24 مارس 2021
androidx.work:work-*:2.6.0-alpha01
منتشر شد. نسخه 2.6.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
WorkManager
اکنون ازandroidx.startup
برای مقداردهی اولیه WorkManager استفاده می کند. قبلاً این کار توسطandroidx.work.impl.WorkManagerInitializer
انجام می شد. ( aosp/1608813 )اگر در گذشته از
tools:node="remove"
ContentProvider
استفاده میکردید که برای مقداردهی اولیه چرخه حیات فرآیند استفاده میشد، در عوض باید کارهای زیر را انجام دهید.<provider android:name="androidx.startup.InitializationProvider" android:authorities=\"${applicationId}.androidx-startup" android:exported="false" tools:node=\"merge"> <!-- If you are using androidx.startup to initialize other components --> <meta-data android:name="androidx.work.impl.WorkManagerInitializer" android:value="androidx.startup" tools:node="remove" /> </provider>
(یا)
<!-- If you want to disable android.startup completely. --> <provider android:name="androidx.startup.InitializationProvider" android:authorities="${applicationId}.androidx-startup" tools:node="remove"> </provider>
تغییرات API
- یک API
Result.getOutputData()
اضافه کنید کهoutputData
ListenableWorker را برمیگرداند. ( Ie51e3 )
رفع اشکال
- یک راه حل برای یک اشکال OEM اضافه کنید که باعث می شود هنگام استفاده از
AlarmManager
API یکSecurityException
ایجاد شود. ( aosp/1587518 )
نسخه 2.5.0
نسخه 2.5.0
27 ژانویه 2021
androidx.work:work-*:2.5.0
منتشر شد. نسخه 2.5.0 شامل این commit ها است.
تغییرات عمده از 2.4.0
- یک مصنوع جدید
:work:work-multiprocess
برای برنامه هایی که از چندین فرآیند استفاده می کنند. این کار با یکسان کردن زمانبندی درخواست کار در یک فرآیند واحد، دستاوردهای عملکردی را معرفی میکند.- برای استفاده از
work-multiprocess
، یک وابستگی به:implementation "androidx.work:work-multiprocess:2.5.0"
تعریف کنید. - یک فرآیند اولیه را با استفاده از Configuration.Builder.setDefaultProcessName(String) تعیین کنید.
- هنگام استفاده از
work-multiprocess
شما همچنین می خواهید از RemoteWorkManager برای مدیریتWorkRequest
خود استفاده کنید. RemoteWorkManager همیشه به فرآیند تعیین شده دسترسی پیدا می کند. زمانبندی در فرآیند نیز در فرآیند تعیین شده اجرا می شود.
- برای استفاده از
- گاهی اوقات،
ActivityManager
نمی تواند نمونهJobService
را برای شروع یک کار نمونه سازی کند. این باعث می شود که کار اصلی به دلیل یک اشکال پلتفرم بی سر و صدا حذف شود.WorkManager
اکنون تضمین می کند که برای هرWorkRequest
زمانی که یکApplication
با تطبیق کارها مقداردهی اولیه می شود، کارهای پشتیبان وجود دارد. این امر قابلیت اطمینان اجرای کار را تا حد زیادی بهبود می بخشد. ( b/172475041 , aosp/1489577 ) -
WorkManager
رشد پایگاه داده را با کاهش مدت زمان بافری کهWorkRequest
ها پس از تکمیلWorkRequest
ردیابی می کنند، محدود می کند. مدت زمان قبل7
روز بود. به1
روز کاهش یافته است + مدت نگهداری نتایج برای حداقل . ( aosp/1419708 ) -
TestListenableWorkerBuilder
اکنون از کلاس reified پشتیبانی می کند کهListenableWorker
برای آسان تر کردن آزمایش گسترش می دهد. ( aosp/1443299 , b/169787349 ) - بازرس WorkManager اکنون هنگام استفاده از Android Studio Arctic Fox در دسترس است.
نسخه 2.5.0-rc01
13 ژانویه 2021
androidx.work:work-*:2.5.0-rc01
منتشر شد. نسخه 2.5.0-rc01 حاوی این commit ها است.
رفع اشکال
- اشکالی که در آن
getWorkInfosLiveData
پس از بهروزرسانی موجودیتها هنگام استفاده از API مبتنی برWorkQuery
به درستی باطل نمیشد، برطرف شد. ( aosp/1540566 , b/173769028 ) - رفع اشکالی که در آن تراکنش های پایگاه داده در برخی موارد نادر به عنوان موفقیت آمیز علامت گذاری نمی شدند. این باعث بروز مشکلاتی در برخی از دستگاه های موتورولا می شود. ( aosp/1535368 , b/175944460 )
- رفع یک اشکال برای نادیده گرفتن
NoSuchElementException
در هنگام تلاش برای جداسازی از یک فرآیند مرده. ( aosp/1530589 ) -
ConstraintTrackingWorker
بهبود دهید تا فقط در صورتی کهListenableWorker
متوقف نشده باشد، متوقف شود. ( aosp/1496844 , b/172946965 ) - کتابخانه های androidx.work را برای هدف قرار دادن جاوا 8 ( Ibd2f2 ) به روز کنید
نسخه 2.5.0-beta02
2 دسامبر 2020
androidx.work:work-*:2.5.0-beta02
منتشر شد. نسخه 2.5.0-beta02 حاوی این تعهدات است.
رفع اشکال
- یک اشکال در
androidx.work:work-multiprocess
که در آن WorkManager هنگام تلاش برای اتصال به فرآیند تعیینشده، بهطور ناخواسته رشته تماس را مسدود کرد، رفع شد. ( aosp/1475538 ) - رفع اشکالی که در آن
PeriodicWorkRequest
به درستی تطبیق نمی شد. ( b/172475041 , aosp/1489577 ) - در هنگام توقف سرویس پیشزمینه هنگام استفاده از
setForeground*
، راهحلی برای اشکال پلتفرم اضافه شد. ( b/170924044 , aosp/1489901 )
نسخه 2.5.0-beta01
28 اکتبر 2020
androidx.work:work-*:2.5.0-beta01
منتشر شد. نسخه 2.5.0-beta01 حاوی این تعهدات است.
ویژگی های جدید
-
WorkManager
بهطور خودکار تعدادWorkRequest
هایی را که میتوانند توسط زمانبندی در فرآیند دریافت شوند، کاهش میدهد. درخواست ها همچنان به ترتیب FIFO اجرا می شوند. ( aosp/1455228 ) -
WorkManager
زمانی که دیتا استور برنامه در وضعیت بدی قرار دارد، تلاش میکند تا بازیابی کند. ( aosp/1463103 )
رفع اشکال
- وقتی
ListenableWorker
ها قطع می شوند، فوراً آنها راENQUEUED
علامت گذاری کنید تا متعاقباً برنامه ریزی مجدد شوند. ( aosp/1455618 , b/170273988 )
نسخه 2.5.0-alpha03
14 اکتبر 2020
androidx.work:work-*:2.5.0-alpha03
منتشر شد. نسخه 2.5.0-alpha03 حاوی این commit ها است.
تغییرات API
-
TestListenableWorkerBuilder
وTestWorkerBuilder
از انواع خام استفاده نمی کنند. ( I883ad , b/169787349 )
رفع اشکال
- از
ApplicationInfo
برای تعیین نام فرآیند پیش فرض برنامه استفاده کنید. ( b/168716641 , aosp/1429950 ) - قوانین نمایان بودن
RemoteWorkManager
وRemoteWorkContinuation
را اصلاح کنید. این APIها دیگر بهعنوان@Restricted
علامتگذاری نمیشوند. ( aosp/1432091 ) - قوانین proguard را برای
:work:work-multiprocess
اصلاح کنید. ( aosp/1432091 ) - چرخههای عمر اعلانها را برای کارهای طولانیمدت مرتبط با سرویس پیشزمینه بهبود دهید. ( b/168502234 , aosp/1431331 )
نسخه 2.5.0-alpha02
16 سپتامبر 2020
androidx.work:work-*:2.5.0-alpha02
منتشر شد. نسخه 2.5.0-alpha02 حاوی این commit ها است.
ویژگی های جدید
- یک API به WorkQuery اضافه کنید تا بتوانید
id
برای پرس و جو ازWorkInfo
استفاده کنید. ( aosp/1412372 , b/157335295 ) - WorkManager از برنامههایی که از چندین فرآیند با یک مصنوع جدید استفاده میکنند (
androidx.work:work-multiprocess:*
) بهتر پشتیبانی میکند. این مصنوع جدید به حل چند مشکلی که اپلیکیشنهای بزرگ با آنها مواجه میشوند کمک میکند، از جمله:- WorkManager معمولاً در هر فرآیند برنامه باید مقداردهی اولیه شود. این عالی نیست زیرا اختلاف SQLite افزایش یافته است که به نوبه خود باعث مشکلات دیگری می شود. WorkManager اکنون API های جدیدی دارد که می تواند برای تعیین یک فرآیند برنامه اولیه با استفاده از
Configuration#setDefaultProcessName(processName)
استفاده شود.processName
یک نام فرآیند کاملاً واجد شرایط است که شبیهpackageName:processName
است (مثلاًcom.example:remote
). - مجموعه ای از API های جدید:
RemoteWorkManager
وRemoteWorkContinuation
برایenqueue
،cancel
وquery
درخواست های کاری. این APIها شامل انواعLiveData
برای جلوگیری از مشاجره SQLite در چندین فرآیند نیستند . همه تماسها برایenqueue
،cancel
وquery
با استفاده از AIDL به یک فرآیند برنامهprimary
هدایت میشوند و یکListenableFuture
روان برمیگردانند. ( AOSP/1392657 ، AOSP/1411210 ، AOSP/1412215 ، AOSP/1417713 )
- WorkManager معمولاً در هر فرآیند برنامه باید مقداردهی اولیه شود. این عالی نیست زیرا اختلاف SQLite افزایش یافته است که به نوبه خود باعث مشکلات دیگری می شود. WorkManager اکنون API های جدیدی دارد که می تواند برای تعیین یک فرآیند برنامه اولیه با استفاده از
تغییرات API
- WorkManager اکنون
WorkRequest
به اتمام رسانده است که هیچ وابستگی ناقص تری ندارند. مدت زمان بافر از7
روز به1
روز تغییر یافت. ( AOSP/1419708 )
رفع اشکال
- WorkManager اکنون مشاغل را به صورت پیشگیرانه آشتی می دهد ، بنابراین مشاغل
WorkRequest
S وJobScheduler
در هنگام شروع کارWorkManager
در همگام سازی هستند. ( AOSP/1412794 ، b/166292069 )
نسخه 2.5.0-alpha01
19 آگوست 2020
androidx.work:work-*:2.5.0-alpha01
*:2.5.0-alpha01 منتشر شده است. نسخه 2.5.0-alpha01 شامل این تعهدات است.
ویژگی های جدید
- تغییراتی در API های داخلی که به ما امکان می دهد ابزار بهتری را برای پیشبرد
WorkManager
فراهم کنیم. برای به روزرسانی های اضافی با ما در ارتباط باشید.
رفع اشکال
-
SecurityException
را هنگام ردیابی حالت شبکه در برخی از دستگاه ها انجام دهید. ( AOSP/1396969 )
مشارکت خارجی
- مستندات را برای
ArrayCreatingInputMerger
توسط Zac Sweers ( Github/43 ) اصلاح کنید.
نسخه 2.4.0
نسخه 2.4.0
22 جولای 2020
androidx.work:work-*:2.4.0
:2.4.0 منتشر شده است. نسخه 2.4.0 شامل این تعهدات است.
تغییرات اساسی از 2.3.0
- برنامه ریزی در فرآیند
WorkManager
اکنون توانایی بیشتری دارد. پیش از این ،Scheduler
فرآیند فقط در نظر می گرفت که کارهایی را که به تأخیر افتاده است و محدودیت های آنها برآورده شده است ، در نظر می گرفت. در حال حاضر ، برنامه ریز در حال پردازشWorkRequest
را دنبال می کند که ممکن است در آینده اجرا شود ، از جمله دوره های دوره ای.Scheduler
فرآیند همچنین محدودیت های برنامه ریزی را رعایت نمی کند (اما هنوز هم به اندازهExecutor
که توسط کارگر استفاده می شود محدود است). این بدان معناست که برنامه اکنون می تواند کارهای بیشتری را انجام دهد که برنامه در پیش زمینه باشد. برای مدیریت اجرای کار تأخیر در پیش زمینه ،WorkManager
همچنین یکRunnableScheduler
قابل تنظیم جدید را معرفی می کند. ( AOSP/1185778 ) - WorkManager اکنون از Rxjava 3 پشتیبانی می کند. برای استفاده از Rxjava 3 ، باید وابستگی زیر را درج کنید:
implementation "androidx.work:work-rxjava3:2.4.0"
. ( AOSP/1277904 ) - با استفاده از یک
WorkQuery
توانایی پرس و جو برایWorkInfo
را اضافه کرد. این زمانی مفید است که توسعه دهندگان می خواهند با ترکیبی از ویژگی های مختلف ،WorkInfo
پرس و جو کنند. برای کسب اطلاعات بیشتر بهWorkQuery.Builder.fromStates(...)
،WorkQuery.Builder. fromTags(...)
یاWorkQuery.Builder.fromUniqueWorkNames(...)
. ( AOSP/1253230 ، B/143847546 ) امکان درخواست اطلاعات تشخیصی از
WorkManager
را با استفاده از:adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "<your_app_package_name>"
این اطلاعات مفید زیادی از جمله:
- کارهای کاری که در 24 ساعت گذشته به پایان رسید.
- کارهای کاری که در حال حاضر در حال اجرا هستند.
- برنامه ریزی شده کار. ( AOSP/1235501 )
اضافه کردن
ExistingWorkPolicy.APPEND_OR_REPLACE
که شبیه بهAPPEND
است ، اما زنجیره ای را که پیش نیازهای لغو یا شکست خورده است جایگزین می کند. ( b/134613984 ، AOSP/1199640 )امکان اضافه کردن یک
RunnableScheduler
سفارشی را برای ردیابی کارهای کاری که باید در آینده اجرا شوند ، فراهم کنید. این توسط برنامه ریز در فرآیند استفاده می شود. ( AOSP/1203944 )هنگام استفاده از یک
DelegatingWorkerFactory
، پشتیبانی از کارخانه های پویا را برای تفسیر اضافه کنید. ( b/156289105 ، AOSP/1309745 )ردیابی را برای محدودیت های
BATTERY_NOT_LOW
از نزدیک با سیستم عامل تراز کنید. ( AOSP/1312583 )برنامه ریز در حال فرآیند اکنون از API های بهتری برای تعیین نام فرآیند استفاده می کند. این برای پشتیبانی بهتر برنامه هایی که از چندین فرآیند استفاده می کنند مفید است. ( AOSP/1324732 )
قوانین جدید خط که اجرا می شود:
- استفاده از
foregroundServiceType
مناسب برای استفاده از API هایsetForegroundAsync()
. ( b/147873061 ، AOSP/1215915 ) - مشخص کردن شناسه های JobScheduler که WorkManager باید هنگام استفاده مستقیم از API های JobService از آن استفاده کند. AOSP/1223567
- یک قانون جدید را اضافه کرد که تضمین می کند که پیاده سازی های
ListenableWorker
هنگام استفاده ازWorkerFactory
پیش فرض اکنونpublic
هستند. ( AOSP/1291262 )
- استفاده از
فراخوانی به
setForegroundAsync()
که قبل از اتمام یکListenableWorker
تکمیل نمی شود ، اکنون از طریق یکIllegalStateException
در موردListenableFuture
بازگردانده شده ، از طریق غیرقانونی نشان داده می شود. ( AOSP/1262743 )پس از قطع یک
Worker
پیش زمینه ، اشکال را برطرف کنید که در آنForegroundService
متوقف نشود. ( b/155579898 ، AOSP/1302153 )رفع اشکال در جایی که
WorkManager
تلاش می کند چندین نمونه از یکWorker
را که به یک سرویس پیش زمینه متصل است ، اجرا کند ( B/156310133 ، AOSP/1309853 )
نسخه 2.4.0-RC01
24 ژوئن 2020
androidx.work:work-*:2.4.0-rc01
:2.4.0-RC01 منتشر شده است. نسخه 2.4.0-RC01 شامل این تعهدات است.
رفع اشکال
- برنامه ریز در حال فرآیند اکنون از API های بهتری برای تعیین نام فرآیند استفاده می کند. این برای پشتیبانی بهتر برنامه هایی که از چندین فرآیند استفاده می کنند مفید است. ( AOSP/1324732 )
نسخه 2.4.0-beta01
20 مه 2020
androidx.work:work-gcm:2.4.0-beta01
، androidx.work:work-runtime:2.4.0-beta01
، androidx.work:work-runtime-ktx:2.4.0-beta01
، androidx.work:work-rxjava2:2.4.0-beta01
، و androidx.work:work-testing:2.4.0-beta01
work-testing:2.4.0-beta01 منتشر می شوند. نسخه 2.4.0-beta01 شامل این تعهدات است.
رفع اشکال
- پس از قطع یک
Worker
پیش زمینه ، اشکال را برطرف کنید که در آنForegroundService
متوقف نشود. ( b/155579898 ، AOSP/1302153 ) - رفع اشکال در جایی که
WorkManager
تلاش می کند چندین نمونه از یکWorker
را که به یک سرویس پیش زمینه متصل است ، اجرا کند ( B/156310133 ، AOSP/1309853 ) - هنگام استفاده از یک
DelegatingWorkerFactory
، پشتیبانی از کارخانه های پویا را برای تفسیر اضافه کنید. ( b/156289105 ، AOSP/1309745 ) - ردیابی را برای محدودیت های
BATTERY_NOT_LOW
از نزدیک با سیستم عامل تراز کنید. ( AOSP/1312583 )
نسخه 2.4.0-alpha03
29 آوریل 2020
androidx.work:work-*:2.4.0-alpha03
:2.4.0-alpha03 منتشر می شود. نسخه 2.4.0-alpha03 شامل این تعهدات است.
ویژگی های جدید
- WorkManager اکنون از Rxjava 3 پشتیبانی می کند. برای استفاده از Rxjava 3 ، باید وابستگی زیر را درج کنید:
implementation "androidx.work:work-rxjava3:2.4.0-alpha03"
. ( AOSP/1277904 ) - یک قانون جدید را اضافه کرد که تضمین می کند که پیاده سازی های
ListenableWorker
هنگام استفاده ازWorkerFactory
پیش فرض اکنونpublic
هستند. ( AOSP/1291262 )
تغییرات API
- فراخوانی
setProgressAsync()
پس از پایانListenableWorker
اعدام را تمام کرده است ، اکنون یکException
از طریقListenableFuture
نشان می دهد. ( AOSP/1285494 ) -
WorkQuery.Builder
اکنونfinal
است. ( AOSP/1275037 ) - روشهای کارخانه
WorkQuery.Builder
withStates
،withTags
withUniqueWorkNames
به ترتیب ، به ترتیب ، ازfromStates
،fromTags
وfromUniqueWorkNames
تغییر نام داده اند. ( AOSP/1280287 )
رفع اشکال
-
SecurityException
را هنگام ردیابی وضعیت شبکه یک دستگاه نادیده بگیرید. ( b/153246136 ، AOSP/1280813 )
نسخه 2.4.0-alpha02
1 آوریل 2020
androidx.work:work-*:2.4.0-alpha02
:2.4.0-alpha02 منتشر می شود. نسخه 2.4.0-alpha02 شامل این تعهدات است.
ویژگی های جدید
- یک قانون جدید را اضافه کرد که هشدار می دهد که در هنگام
WorkRequest
، به هر دوConstraints.setRequiresCharging(...)
نیاز داردConstraints.setRequiresDeviceIdle(...)
برخی از دستگاه ها هرگز به طور همزمان شارژ و بیکار نیستند. بنابراین چنین درخواست هایی کمتر از آنچه انتظار می رفت اجرا می شود. ( AOSP/1253840 )
تغییرات API
با استفاده از یک
WorkQuery
توانایی پرس و جو برایWorkInfo
را اضافه کرد. این زمانی مفید است که توسعه دهندگان می خواهند با ترکیبی از ویژگی های مختلف ،WorkInfo
پرس و جو کنند. برای کسب اطلاعات بیشتر بهWorkQuery.Builder withStates(...)
،WorkQuery.Builder withTags(...)
یاWorkQuery.Builder withUniqueWorkNames(...)
نگاه کنید. ( AOSP/1253230 ، B/143847546 )فراخوانی به
setForegroundAsync()
که قبل از اتمام یکListenableWorker
تکمیل نمی شود ، اکنون از طریق یکIllegalStateException
در موردListenableFuture
بازگردانده شده ، از طریق غیرقانونی نشان داده می شود. ( AOSP/1262743 )
رفع اشکال
- قانون خط را که بررسی می کند مدت زمان نامعتبر برای
PeriodicWorkRequest
را بررسی می کند. ( AOSP/1254846 ، B/152606442 )
نسخه 2.4.0-alpha01
4 مارس 2020
androidx.work:work-*:2.4.0-alpha01
*:2.4.0-alpha01 منتشر شده است. نسخه 2.4.0-alpha01 شامل این تعهدات است.
ویژگی های جدید
برنامه ریزی در فرآیند
WorkManager
اکنون توانایی بیشتری دارد. پیش از این ، برنامه ریز فرآیند فقط در نظر می گرفت که کارهایی را که به تأخیر افتاده است و محدودیت های آنها برآورده شده است ، در نظر می گرفت. اکنون ، برنامه ریز در حال پردازشWorkRequest
دنبال می کند که ممکن است در آینده اجرا شود ، از جمله دوره هایPeriodicWorkRequest
. برنامه ریز فرآیند همچنین محدودیت های برنامه ریزی را رعایت نمی کند (اما هنوز هم به اندازهExecutor
که توسط کارگر استفاده می شود محدود است). این بدان معنی است که برنامه اکنون می تواندWorkRequest
بیشتری را انجام دهد که برنامه در پیش زمینه باشد. ( AOSP/1185778 )اضافه کردن امکان درخواست اطلاعات تشخیصی از WorkManager با استفاده از
adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "<your_app_package_name>"
. این اطلاعات مفید زیادی از جمله:- کارهای کاری که در 24 ساعت گذشته به پایان رسید.
- کارهای کاری که در حال حاضر در حال اجرا هستند.
- برنامه ریزی شده کار. ( AOSP/1235501 )
قوانین جدید خط که اجرا می شود:
- استفاده از
foregroundServiceType
مناسب برای استفاده از API هایsetForegroundAsync()
. ( b/147873061 ، AOSP/1215915 ) - مشخص کردن شناسه های
JobScheduler
کهWorkManager
باید هنگام استفاده مستقیم از API هایJobService
از آن استفاده کند. ( AOSP/1223567 )
- استفاده از
تغییرات API
اضافه کردن
ExistingWorkPolicy.APPEND_OR_REPLACE
که شبیه بهAPPEND
است ، اما زنجیره ای را که پیش نیازهای لغو یا شکست خورده است جایگزین می کند . ( b/134613984 ، AOSP/1199640 )امکان اضافه کردن یک
RunnableScheduler
سفارشی را برای ردیابیWorkRequest
که باید در آینده اجرا شود ، فراهم کنید. این توسط برنامه ریز در فرآیند استفاده می شود. ( AOSP/1203944 )
رفع اشکال
-
setProgress()
درRxWorker
زیرا قبلاً یکSingle<Void>
را بازگردانده بود که یک نوع غیرممکن است. یک API جدیدsetCompletableProgress()
اضافه کرد که به جای آن یکCompletable
بازگرداند. و قوانین جدید LINT را اضافه کرد که به مهاجرت به API های جدید کمک می کند. ( b/150080946 ، AOSP/1242665 )
نسخه 2.3.4
نسخه 2.3.4
18 مارس 2020
androidx.work:work-*:2.3.4
:2.3.4 منتشر شده است. نسخه 2.3.4 شامل این تعهدات است.
رفع اشکال
- رفع اشکالی که باعث می شود چندین مورد از یک
Worker
طولانی مدت اجرا شود ، پس از بیش از پنجره 10 دقیقه اجرای. ( AOSP/1247484 ، B/150553353 ) - رفع
IssueRegistry
LINT WorkManager. با تشکر از شما zacsweers از Slack ، برای سهم. ( AOSP/1217923 )
نسخه 2.3.3
نسخه 2.3.3
4 مارس 2020
androidx.work:work-*:2.3.3
منتشر شده است. نسخه 2.3.3 شامل این تعهدات است.
رفع اشکال
- رفع اشکال در صورت قطع شدن یک
Worker
، به درستی دوباره برنامه ریزی نمی شود. ( B/150325687 ، AOSP/1246571 )
نسخه 2.3.2
نسخه 2.3.2
19 فوریه 2020
androidx.work:work-*:2.3.2
منتشر می شود. نسخه 2.3.2 شامل این تعهدات است.
رفع اشکال
- مسئله ای را برطرف می کند که در مواردی نادر از 100 محدودیت شغلی در Jobcheduler فراتر رود. ( AOSP/1226859 ، B/149092520 )
- برای یک شرایط مسابقه در ConstraintControllers رفع کنید. ( AOSP/1220100 )
- چرخه چرخه خدمات پیش زمینه مدیریت را برای کارگران طولانی مدت بهبود بخشید. ( AOSP/1226295 )
- بهبود مدیریت لغو اعلان ها برای کارگران طولانی مدت در مورد لغو کارگران. ( AOSP/1228346 )
نسخه 2.3.1
نسخه 2.3.1
5 فوریه 2020
androidx.work:work-*:2.3.1
:2.3.1 منتشر شده است. نسخه 2.3.1 شامل این تعهدات است .
رفع اشکال
- بهتر مدیریت چرخه عمر
Notification
ها را برایWorker
طولانی مدت که در هنگام فعال بودنService
پیش زمینه اجرا می شود ، مدیریت کنید. ( AOSP/1218539 ، B/147249312 ) -
WorkManager
اکنون بهandroidx.sqlite:sqlite-framework:2.1.0
پایدار. ( AOSP/1217729 ) - قوانین LINT اضافه شده تا اطمینان حاصل شود که یک
foregroundServiceType
درAndroidManifest.xml
هنگام استفاده ازforegroundServiceType
S درForegroundInfo
مشخص شده است. ( AOSP/1214207 ، b/147873061 )
نسخه 2.3.0
نسخه 2.3.0
22 ژانویه 2020
androidx.work:work-*:2.3.0
از 2.3.0-rc01
بدون تغییر منتشر می شود. نسخه 2.3.0 شامل این تعهدات است .
تغییرات مهم از 2.2.0
- پشتیبانی از کار طولانی یا کار مهم از طریق
ListenableWorker#setForegroundAsync()
. - پشتیبانی از پیشرفت کارگران از طریق
ListenableWorker#setProgressAsync()
. - اکنون WorkManager قوانین اضافی را به عنوان بخشی از کتابخانه بسته بندی می کند که به زود گرفتن اشکالات کمک می کند.
نسخه 2.3.0-RC01
8 ژانویه 2020
androidx.work:work-*:2.3.0-rc01
:2.3.0-RC01 منتشر شده است. نسخه 2.3.0-RC01 شامل این تعهدات است .
این نسخه با 2.3.0-beta02
یکسان است
رفع اشکال
- مصنوعات
work-testing
اکنون وابستگیapi
بهwork-runtime-ktx
تعریف می کند. ( AOSP/1194410 )
نسخه 2.3.0-beta02
18 دسامبر 2019
androidx.work:work-*:2.3.0-beta02
:2.3.0-Beta02 منتشر شد. نسخه 2.3.0-beta02 شامل این تعهدات است .
ویژگی های جدید
- یک پیام خطای بهتر برای استثنائات SQLite غیر قابل بازیافت اضافه شده است. ( AOSP/1185777 )
- یک قانون خطی اضافه کرد که تضمین می کند که ارائه دهنده محتوا
androidx.work.impl.WorkManagerInitializer
ازAndroidManifest.xml
حذف می شود. ( AOSP/1167007 ) - هنگامی که
enqueue()
به جایenqueueUniquePeriodicWork()
برای یکPeriodicWorkRequest
استفاده می شود ، یک هشدار دهنده اضافه کرد. ( AOSP/1166032 )
API تغییر می کند
-
ForegroundInfo
اکنون شما را ملزم به مشخص کردنnotificationId
برای استفاده در هنگام استفاده ازListenableWorker.setForegroundAsync()
می کند. این یک تغییر شکستن است. این به شما امکان می دهد چندینWorker
طولانی مدت را به صورت موازی اجرا کنید.WorkManager
همچنین بهتر طول عمرNotification
ارائه شده را مدیریت می کند. ( b/145473554 ، AOSP/1181208 ، ASOP/1181216 ، ASOP/1183577 )
رفع اشکال
- رفع اشکال در اجرای AlarmManager که در آن هشدارها به درستی تمیز نمی شوند. ( AOSP/1156444 )
- رفع اشکال در جایی که یک لیست خالی از
WorkRequest
S باعث ایجاد یک زنجیرهWorkContinuation
نادرست شود. ( b/142835274 ، AOSP/1157051 )
تغییر وابستگی
- WorkManager اکنون از اتاق 2.2.2 استفاده می کند.
نسخه 2.3.0-beta01
20 نوامبر 2019
androidx.work:work-*:2.3.0-beta01
:2.3.0-Beta01 منتشر شد. نسخه 2.3.0-beta01 شامل این تعهدات است .
ویژگی های جدید
- یک قانون جدید را اضافه کرد که به دلیل اجرای نادرست
androidx.work.Configuration.Provider
هنگام استفاده از اولیه سازی در صورت تقاضا ، از خطاهای توسعه دهنده جلوگیری می کند. AOSP/1164559
نسخه 2.3.0-alpha03
23 اکتبر 2019
androidx.work:work-*:2.3.0-alpha03
:2.3.0-alpha03 منتشر می شود. نسخه 2.3.0-alpha03 شامل این تعهدات است .
ویژگی های جدید
- اضافه شده
WorkManager.createCancelPendingIntent()
API که باعث می شود بدون نیاز به ثبت مؤلفه دیگری درAndroidManifest.xml
لغوWorkRequest
S را آسان کنید. این API باعث می شود که لغوWorkRequest
ازNotification
ها به خصوص آسان شود. ما انتظار داریم که این مورد با API های پیش زمینه جدید در 2.3.0 جفت شود. - WorkManager اکنون به
androidx.room:*:2.2.0
بستگی دارد.
API تغییر می کند
- تغییر نام نامگذاری
ForegroundInfo.getNotificationType()
بهForegroundInfo.getForegroundServiceType()
برای سازگارتر با API های پلت فرم زیرین. ( b/142729893 ، AOSP/1143316 )
رفع اشکال
- رفع اشکالی که در اثر تماس غیر ضروری به
setTransactionSuccessful()
در خارج از معامله ایجاد می شود. این برای مهاجرت های نادر اتفاق می افتد. ( b/142580433 ، AOSP/1141737 )
نسخه 2.3.0-alpha02
9 اکتبر 2019
androidx.work:work-*:2.3.0-alpha02
:2.3.0-alpha02 منتشر شد. نسخه 2.3.0-alpha02 شامل این تعهدات است .
ویژگی های جدید
- اکنون WorkManager از دویدن طولانی یا کار مهمی که باید توسط سیستم عامل زنده نگه داشته شود ، پشتیبانی می کند. برای اطلاعات بیشتر
ListenableWorker#setForegroundAsync()
(یاCoroutineWorker#setForeground()
برای کوتلین) نگاه کنید. ( AOSP/1133636 )
API تغییر می کند
- API
containsKey
API درData
بهhasKeyWithValueOfType
تغییر نام داده می شود. روش پسوند مربوطه در کتابخانهktx
نیز تغییر نام داده است. ( b/141916545 )
رفع اشکال
- برنامه های WorkManager وقتی تعداد محدودیت برنامه ریزی رویکرد
WorkRequest
را انجام می دهد ، نسبتاً کار می کند. ( AOSP/1105766 ) - WorkManager فقط در صورتی که کار از قبل به پایان نرسد
ListenableWorker#onStopped()
را گوش می دهد. ( b/140055777 ) - اکنون WorkManager هنگام قطع شدن یک کارگر یا رسیدن به حالت ترمینال خود ، اطلاعات پیشرفت را حذف می کند. ( AOSP/1114572 )
- اکنون
Data
دارایtoString()
است. ( b/140945323 ) - اکنون
Data
از روشequals()
برابر هستند. همچنین ازdeepEquals
برای انواعArray
پشتیبانی می کند. ( b/140922528 ) - WorkManager اکنون بانک اطلاعاتی داخلی و فایلهای ترجیحی خود را در فهرست پشتیبان تهیه نمی کند. ( b/114808216 )
نسخه 2.3.0-alpha01
22 آگوست 2019
androidx.work:work-*:2.3.September 5, 20190-alpha01
منتشر شده است. تعهدات موجود در این نسخه را می توان در اینجا یافت.
ویژگی های جدید
-
ListenableWorker
اکنون می تواند از طریق APIsetProgressAsync()
پیشرفت کند. همچنین یک APIsetProgress
مربوط بهsuspend
مربوطه را درCoroutineWorker
و یکsetProgress
درRxWorker
اضافه کرد که یکSingle<Void>
را برمی گرداند. با استفاده از این کارگران جدید API می توانند اطلاعات پیشرفت را از طریقWorkInfo
که دارای APIgetProgress
مربوطه است ، منتقل کنند. ( b/79481554 ) -
Data
دارای یک APIcontainsKey()
هستند که می تواند برای تأیید اعتبار داده های ورودی بهWorker
دارای کلیدهایی با نوع مورد انتظار باشد. ( b/117136838 ) - اکنون
Data
می توانند با استفاده ازData.toByteArray()
وData.fromByteArray()
سریال شوند. توجه داشته باشید که هیچ تضمینی نسخه ای باData
وجود ندارد ، بنابراین نباید آن را ادامه دهید یا از آن برای IPC بین برنامه ها استفاده کنید. آنها فقط بی خطر هستند که بین چندین فرآیند از همان برنامه استفاده شوند. - امکان مشخص کردن یک
InputMergerFactory
را از طریقConfiguration.setInputMergerFactory
اضافه کرد. ( b/133273159 )
API تغییر می کند
- اگر یک
WorkerFactory
به عنوان نمونه ای ازListenableWorker
که قبلاً مورد استفاده قرار گرفته است ، کار Mananager نمونه ای ازIllegalStateException
. ( b/139554406 ) - به روزرسانی های مستندات پیرامون لغو
ListenableFuture
و پاسخ بهonStopped()
درListenableWorker
. ( b/138413671 )
رفع اشکال
- برنامه ریز در حال فرآیند اکنون با محدودیت
idle
WorkRequest
نادیده می گیرد. این درخواست ها اکنون فقط توسطJobScheduler
انتخاب می شوند که دستگاه در واقعidle
باشد. ( AOSP/1089779 ) -
TestScheduler
اکنون به درستی ازExecutor
مشخص شده برای مجری وظیفه داخلی خود در تست ها استفاده می کند. ( AOSP/1090749 )
نسخه 2.2.0
نسخه 2.2.0
15 آگوست 2019
androidx.work:work-*:2.2.0
:2.2.0 منتشر می شود. تعهدات موجود در این نسخه را می توان در اینجا یافت.
این نسخه با androidx.work:work-*:2.2.0-rc01
یکسان است.
تغییرات مهم در 2.2.0 از 2.1.0
androidx.work:work-gcm:2.2.0
یک مصنوع جدید Maven است که از استفاده از GCMNetworkManager به عنوان یک برنامه ریزی پشتیبانی می کند وقتی خدمات Google Play برای سطح API در دسترس است <= 22. این یک وابستگی اختیاری است که به قابل اعتماد تر و اجرا کننده کمک می کند پردازش پس زمینه در نسخه های API قدیمی. اگر برنامه شما از خدمات Google Play استفاده می کند ، این وابستگی را به پرونده Gradle خود اضافه کنید تا به طور خودکار پشتیبانی GCMNetWorkManager را دریافت کنید. اگر خدمات پخش در دسترس نباشد ، WorkManager همچنان به هشدار دهنده در دستگاه های قدیمی تر باز می گردد.
نسخه 2.2.0-RC01
30 جولای 2019
androidx.work:work-*:2.2.0-rc01
*:2.2.0-RC01 منتشر شده است. تعهدات موجود در این نسخه را می توان در اینجا یافت.
رفع اشکال
- رفع اشکال در اجرای هشدار دهنده که باعث می شود سرویس به طور زودرس خاموش شود و منجر به
RejectedExecutionException
در موارد نادر شود. ( AOSP/1092374 ) ( B/138238197 ). - هنگام استفاده از API های
JobScheduler
در برخی از دستگاه ها ، یک راه حل برایNullPointerException
اضافه کرد. ( AOSP/1091020 ) ( b/138364061 ) ، ( b/138441699 )
نسخه 2.2.0-beta02
19 جولای 2019
androidx.work:work-*:2.2.0-beta02
:2.2.0-Beta02 منتشر شد. تعهدات موجود در این نسخه را می توان در اینجا یافت.
رفع اشکال
- وابستگی غیر عمدی ژاکوکو که در
2.2.0-beta01
معرفی شده است.
نسخه 2.2.0-beta01
17 جولای 2019
androidx.work:work-*:2.2.0-beta01
*:2.2.0-Beta01 منتشر شده است. تعهدات موجود در این نسخه را می توان در اینجا یافت.
ویژگی های جدید
-
androidx.work:work-gcm:2.2.0-beta01
یک مصنوع جدید Maven است که از استفاده از GCMNetworkManager به عنوان یک برنامه ریزی پشتیبانی می کند وقتی Google Play Services برای سطح API در دسترس است <= 22. این یک وابستگی اختیاری است که به قابل اعتماد تر کمک می کند و پردازش پس زمینه در نسخه های API قدیمی. اگر برنامه شما از خدمات Google Play استفاده می کند ، این وابستگی را به پرونده Gradle خود اضافه کنید تا به طور خودکار پشتیبانی GCMNetWorkManager را دریافت کنید. اگر خدمات پخش در دسترس نباشد ، WorkManager همچنان به هشدار دهنده در دستگاه های قدیمی تر باز می گردد.
رفع اشکال
- هنگام ردیابی وضعیت شبکه در قرص Nvidia Shield K1 ، برای غیرقانونی برای
IllegalArgumentException
رفع کنید. ( AOSP/1010188 )
نسخه 2.1.0
نسخه 2.1.0
11 جولای 2019
androidx.work:work-*:2.1.0
منتشر می شود. این نسخه با androidx.work:work-*:2.1.0-rc01
یکسان است.
تغییرات مهم از 2.0.1
-
work-runtime-ktx
اکنون به جاوا 8. نیاز دارد. اگر به هر مشکلی رسیدید ، می توانید موارد زیر را بهbuild.gradle
:kotlinOptions { jvmTarget = "1.8" }
اضافه کنید. - اولیه سازی در صورت تقاضا برای WorkManager ، که فقط در صورت ارجاع ، کارگر را ایجاد می کند. B/127497100 برای تنظیم پروژه خود برای اولیه سازی در صورت تقاضا:
- ابتکار عمل خودکار را غیرفعال کنید .
-
Configuration.Provider
پیاده سازی کنید. در مورد شیءApplication
سفارشی خود. - همه منابع
WorkManager.getInstance()
را بهWorkManager.getInstance(Context)
تغییر دهید. به عنوان بخشی از این تغییر ، ماWorkManager.getInstance()
کاهش داده ایم. همیشه تماس با تعویض NewWorkManager.getInstance(Context)
امن تر است ، حتی اگر شما در حال انجام اولیه تقاضا نیستید.
- اکنون
PeriodicWorkRequest
از تأخیرهای اولیه پشتیبانی می کند. برای تعیین تأخیر اولیه می توانید از روشsetInitialDelay
درPeriodicWorkRequest.Builder
استفاده کنید. b/111404867 - امکان تفویض یک یا چند
WorkerFactory
ثبت شده با استفاده ازDelegatingWorkerFactory
را اضافه کرد. b/131435993 - امکان سفارشی سازی
Executor
استفاده شده توسط WorkManager برای کلیه کتاب های داخلی خود را از طریقConfiguration.Builder.setTaskExecutor
اضافه کرد. - با استفاده از
TestWorkerBuilder
وTestListenableWorkerBuilder
در مصنوعاتwork-testing
، امکان ایجادWorker
قابل آزمایش واحد و کلاسهایListenableWorker
را اضافه کرد.- توجه داشته باشید که
work-testing
اکنون به عنوان یک وابستگی در کوتلین قرار می گیرد و به طور پیش فرض چندین پسوند Kotlin را شامل می شود.
- توجه داشته باشید که
- تلاش برای اجرای تلاش برای
WorkInfo
. b/127290461 - انواع
Data
هم اکنون می توانند بایت و آرایه های بایت را ذخیره و بازیابی کنند. این حداکثر اندازه اشیاءData
را تغییر نمی دهد. - اکنون WorkManager به
Room 2.1.0
بستگی دارد ، که باید برخی از مشکلات پایگاه داده را برطرف کند.
نسخه 2.1.0-RC01
27 ژوئن 2019
androidx.work:work-*:2.1.0-rc01
:2.1.0-RC01 منتشر شده است. تعهدات موجود در این نسخه را می توان در اینجا یافت.
رفع اشکال
- رفع اشکالی که باعث می شود هنگام اجرای مشاغل با
JobScheduler
در حالی که یک نسخه پشتیبان تهیه شده در حال انجام بود ، در حال انجام است.
نسخه 2.1.0-beta02
20 ژوئن 2019
androidx.work:work-*:2.1.0-beta02
منتشر شد. تعهدات موجود در این نسخه را می توان در اینجا یافت.
رفع اشکال
-
TestListenableWorkerBuilder
اکنون هنگام ایجاد نمونه هایی ازListenableWorker
WorkerFactory
صحیح استفاده می کند. b/135275844 - رفع اشکالی که باعث ایجاد رانش در ویندوزهای اعدام برای
WorkRequest
به دلیل مرگ فرآیند شد. b/135272196
نسخه 2.1.0-beta01
13 ژوئن 2019
androidx.work:work-*:2.1.0-beta01
منتشر شده است. تعهدات موجود در این نسخه را می توان در اینجا یافت.
رفع اشکال
- اکنون WorkManager به
Room 2.1.0
بستگی دارد ، که باید برخی از مشکلات پایگاه داده را برطرف کند. - مقداری دیسک استارتاپ I/O را روی موضوع اصلی حذف کرد.
- یک بن بست بالقوه در ردیابی محدودیت را برطرف کرد. b/134361006
- پیش از این مشاغل نامعتبر منتسب به کارگر را لغو کرد. b/134058261
- برخی از تماس های دفاعی به API های Jobscheduler برای دستگاه های نادرست اضافه شد.
نسخه 2.1.0-alpha03
5 ژوئن 2019
androidx.work:*:2.1.0-alpha03
منتشر می شود.
رفع اشکال
- مستندات بهبود یافته برای
PeriodicWorkRequest
s. -
WorkManagerTestInitHelper
اکنون از مجری پس زمینه صحیح برای آزمایش استفاده می کند. - رفع مشکلات SQLite هنگام برخورد با معاملات بزرگ در برخی از دستگاه ها. ( b/130182503 )
- وابستگی های WorkManager اکنون دانه ای تر است. ( b/133169148 ).
- اشکالات خاص OEM در اجرای
JobScheduler
هنگام برنامه ریزی مشاغل با استفاده از WorkManager. - پیشرفت در برنامه ریزی مبتنی بر هشدار دهنده در مورد طول عمر خدمات که قبلاً باعث تصادفات نادر شده بودند. ( b/133313734 )
نسخه 2.1.0-alpha02
16 مه 2019
WorkManager 2.1.0-alpha02 منتشر شد. این نسخه شامل چندین API جدید است.
تغییرات API
اکنون
PeriodicWorkRequest
از تأخیرهای اولیه پشتیبانی می کند. برای تعیین تأخیر اولیه می توانید از روشsetInitialDelay
درPeriodicWorkRequest.Builder
استفاده کنید. b/111404867امکان تفویض یک یا چند
WorkerFactory
ثبت شده با استفاده ازDelegatingWorkerFactory
را اضافه کرد. b/131435993امکان سفارشی سازی
Executor
استفاده شده توسط WorkManager برای کلیه کتاب های داخلی خود را از طریقConfiguration.Builder.setTaskExecutor
اضافه کرد.مستندات بهبود یافته پیرامون
WorkRequest.keepResultsForAtLeast
( B/130638001 ) ، اولیه سازی در صورت تقاضا ، وPeriodicWorkRequest.Builder
( B/131711394 ).
نسخه 2.1.0-alpha01
24 آوریل 2019
WorkManager 2.1.0-alpha01 منتشر شده است. این نسخه شامل چندین API جدید است. لطفاً توجه داشته باشید که با شروع این نسخه ، ویژگی های جدیدی وجود خواهد داشت که به نسخه 1.x منتقل نمی شوند. توصیه می کنیم به 2.x تغییر دهید.
تغییرات API
- اولیه سازی در صورت تقاضا برای WorkManager ، که فقط در صورت ارجاع ، کارگر را ایجاد می کند. B/127497100 برای تنظیم پروژه خود برای اولیه سازی در صورت تقاضا:
- ابتکار عمل خودکار را غیرفعال کنید .
-
Configuration.Provider
پیاده سازی کنید. در مورد شیءApplication
سفارشی خود. - همه منابع
WorkManager.getInstance()
را بهWorkManager.getInstance(Context)
تغییر دهید. به عنوان بخشی از این تغییر ، ماWorkManager.getInstance()
کاهش داده ایم. همیشه تماس با تعویض NewWorkManager.getInstance(Context)
امن تر است ، حتی اگر شما در حال انجام اولیه تقاضا نیستید.
- با استفاده از
TestWorkerBuilder
وTestListenableWorkerBuilder
در مصنوعاتwork-testing
، امکان ایجادWorker
قابل آزمایش واحد و کلاسهایListenableWorker
را اضافه کرد.- توجه داشته باشید که
work-testing
اکنون به عنوان یک وابستگی ، کوتلین را به خود جلب می کند ، اما همچنین به طور پیش فرض چندین پسوند کوتلین را شامل می شود.
- توجه داشته باشید که
- تلاش برای اجرای تلاش برای
WorkInfo
. b/127290461 - انواع
Data
هم اکنون می توانند بایت و آرایه های بایت را ذخیره و بازیابی کنند. این حداکثر اندازه اشیاءData
را تغییر نمی دهد. -
CoroutineWorker.coroutineContext
deprecated. این زمینه به اشتباه به عنوان یکCoroutineDispatcher
تایپ شد. شما دیگر نیازی به آن ندارید زیرا می توانید خودتان در بدنه عملکرد تعلیق به CoroutInecontext مورد نظر بروید. -
RxWorker.createWork()
وRxWorker.getBackgroundScheduler()
اکنون با انواع بازگشت@NonNull
حاشیه نویسی شده اند.
نسخه 2.0.1
نسخه 2.0.1
9 آوریل 2019
WorkManager 2.0.1 منتشر می شود. این نسخه با 2.0.1-RC01 یکسان است.
نسخه 2.0.1-RC01
3 آوریل 2019
WorkManager 2.0.1-RC01 منتشر شد. این نسخه شامل برخی از رفع اشکال است. برای کاربران Legacy 1.x ، برخی از این تغییرات در 1.0.1-RC01 نیز ظاهر می شوند.
رفع اشکال
- آزمایشات Robolectric اکنون با WorkManager به درستی کار می کند. b/122553577
- سقوط یک پرونده لبه را با محدودیت های ردیابی در API های قبل از jobscheduler تمیز نمی کند. b/129226383
- رفع یک
StackOverflowError
با زنجیرهای طولانی کار. b/129091233 - مستندات به روز شده برای
PeriodicWorkRequest
S نشان می دهد که زمان فلکس در API 23 پشتیبانی نمی شود. - برخی از پیوندهای شکسته در مستندات کوتلین را برطرف کرد.
نسخه 2.0.0
نسخه 2.0.0
20 مارس 2019
WorkManager 2.0.0 منتشر می شود. این نسخه با 2.0.0-RC01 یکسان است و نسخه Androidx از 1.0.0 پایدار با وابستگی های Androidx است. توصیه می کنیم این نسخه را به جای نسخه های Legacy 1.x هدف قرار دهید. کلیه توسعه فعال 2.x و 1.x فقط برای مدت زمان محدود رفع اشکال مهم را دریافت می کنند.
نسخه 2.0.0-RC01
7 مارس 2019
WorkManager 2.0.0-RC01 منتشر می شود. این نسخه با 1.0.0 پایدار یکسان است اما وابستگی Androidx دارد. پس از رسیدن به 2.0.0 پایدار ، باید این نسخه را درج کنید و نسخه های Legacy 1.x فقط برخی از اشکالات مهم را دریافت می کنند. همه توسعه فعال 2.x را هدف قرار می دهد.
وابستگی های pre-androidx
اسناد مرجع: جاوا
شیار
dependencies { def work_version = "1.0.1" // (Java only) implementation "android.arch.work:work-runtime:$work_version" // Kotlin + coroutines implementation "android.arch.work:work-runtime-ktx:$work_version" // optional - RxJava2 support implementation "android.arch.work:work-rxjava2:$work_version" // optional - Test helpers androidTestImplementation "android.arch.work:work-testing:$work_version" }
کاتلین
dependencies { val work_version = "1.0.1" // (Java only) implementation("android.arch.work:work-runtime:$work_version") // Kotlin + coroutines implementation("android.arch.work:work-runtime-ktx:$work_version") // optional - RxJava2 support implementation("android.arch.work:work-rxjava2:$work_version") // optional - Test helpers androidTestImplementation("android.arch.work:work-testing:$work_version") }
نسخه 1.0.1
نسخه 1.0.1
9 آوریل 2019
WorkManager 1.0.1 منتشر می شود. این نسخه با 1.0.1-RC01 یکسان است.
لطفاً توجه داشته باشید که ما به شدت کاربران را ترغیب می کنیم تا در WorkManager 2.x به روز شوند ، زیرا به روزرسانی های بسیار کمی در شاخه 1.x در حال حرکت به جلو خواهد بود. API های جدید نیز برای کتابخانه 1.x منتشر نمی شوند.
نسخه 1.0.1-RC01
2 آوریل 2019
WorkManager 1.0.1-RC01 منتشر شد. این نسخه شامل برخی از رفع اشکال است.
رفع اشکال
- آزمایشات Robolectric اکنون با WorkManager به درستی کار می کند. b/122553577
- سقوط یک پرونده لبه را با محدودیت های ردیابی در API های قبل از jobscheduler تمیز نمی کند. b/129226383
- رفع یک
StackOverflowError
با زنجیرهای طولانی کار. b/129091233
نسخه 1.0.0
نسخه 1.0.0
05 مارس 2019
این نسخه پایدار 1.0.0 Workmanager است. این نسخه از WorkManager با 1.0.0-RC02 یکسان است.
نسخه 1.0.0-RC02
21 فوریه 2019
این دومین نامزد انتشار برای انتشار پایدار 1.0.0 WorkManager است. این نسخه شامل دو رفع اشکال است.
رفع اشکال
اکنون
Worker
پس از تصادف برنامه به درستی برنامه ریزی شده اند. b/124546316Worker
که یکException
بدون بررسی را پرتاب می کنند ، اکنون به درستی مشخص شده اند کهFAILED
و دیگر روند برنامه را خراب نمی کنند.
نسخه 1.0.0-RC01
14 فوریه 2019
این یک نامزد آزادی برای انتشار پایدار 1.0.0 WorkManager است. این نسخه شامل یک رفع اشکال است.
رفع اشکال
- اجرای مبتنی بر AlarmManager اکنون به درستی به ویندوزهای
flex
برای کارنامه های دوره ای احترام می گذارد. b/124274584
نسخه 1.0.0-beta05
6 فوریه 2019
این نسخه شامل برخی از رفع اشکال است.
رفع اشکال
- پرونده ای را که
JobScheduler.getPendingJob(...)
در API 23 استفاده کرد ، رفع کرد. B/123893059 - رفع
NullPointerException
در دستگاه هایی که Android 5.1 (API سطح 22) یا پایین تر دارند. b/123835104
نسخه 1.0.0-beta04
4 فوریه 2019
این نسخه شامل برخی از رفع اشکال است.
رفع اشکال
- برنامه ریزی بهبود یافته از دوره های دوره ای برای اجرای مبتنی بر AlarmManager.
- یک مورد را برطرف کرد که کارگر در هنگام استفاده از اجرای مبتنی بر AlarmManager نتوانست محدودیت ها را به درستی ردیابی کند. b/123379508
- یک مورد را برطرف کرد که کارگر نتوانست هنگام استفاده از اجرای مبتنی بر هشدار ، کار خود را برای مرگ فرآیند دوباره امتحان کند. b/123329850
- یک مورد را برطرف کرد که باعث می شود WorkManager هنگام استفاده از اجرای مبتنی بر AlarmManager ، Wakelocks را نشت کند.
نسخه 1.0.0-beta03
25 ژانویه 2019
این نسخه شامل برخی از رفع اشکال است.
رفع اشکال
- ما یک رگرسیون
1.0.0-beta02
را معرفی کردیم که باعث می شد کار در برخی شرایط به درستی اجرا نشود. b/123211993 - یک مورد را برطرف کرد که کار به درستی از زمان پس انداز خودداری نمی کرد. b/122881597
- رفع یک
ConcurrentModificationException
در دستگاه هایی که Android 5.1 (API یا) یا پایین تر دارند. این ادامه رفع در1.0.0-beta02
است. b/121345393 - اضافه شده
exported=false
برای برخی از مؤلفه های موجود در مانیفست ما که این حاشیه نویسی را از دست داده اند. - اطلاعات مربوط به نحوه تعامل WorkManager با سیستم عامل در مستندات سطح بسته را شامل می شود.
نسخه 1.0.0-beta02
15 ژانویه 2019
این نسخه شامل برخی از رفع اشکال است.
رفع اشکال
- یک مورد لبه را برطرف کرد که در آن کار دوره ای می تواند بیش از یک بار در هر بازه در دستگاه هایی که Android 6.0 را اجرا می کنند (API سطح 23) اجرا شود. b/121998363
- رفع یک
ConcurrentModificationException
در دستگاه هایی که Android 5.1 (API سطح 22) یا پایین تر دارند. b/121345393 - اجرای اشتباه کار در هنگام محدودیت ها در دستگاه هایی که Android 5.1 (API سطح 22) یا پایین تر دارند ، برآورده نمی شود. b/122578012
- انجام کار بهینه سازی بهینه سازی شده در برخی موارد لبه سریعتر. b/122358129
- تغییری برای پرداختن به شرایط بالقوه مسابقه در بین موارد متعدد
LiveData
که کارگر از آن استفاده می کند ، اضافه کرد. - به جای
1.1.1-rc01
به استفاده از وابستگیRoom
1.1.1
منتقل شد. این نسخه ها یکسان هستند. b/122578011
نسخه 1.0.0-beta01
19 دسامبر 2018
این نسخه حاوی تغییر API نیست. با حرکت به جلو ، انتظار می رود WorkManager تا نسخه بعدی API پایدار بماند ، مگر اینکه یک مشکل مهم وجود داشته باشد. این نسخه شامل برخی از رفع اشکال است.
رفع اشکال
- فرزندان پیش از این که از کار والدین با موفقیت تکمیل شده اند ، دیگر اجرا نخواهند شد. b/120811767
- کلاسهای ورود به سیستم به درستی اولیه (که در درجه اول در طول تست ها ظاهر می شوند).
نسخه 1.0.0-alpha13
12 دسامبر 2018
این نسخه حاوی یک تغییر جزئی API است که برای برخی از کاربران Kotlin مفید خواهد بود.
تغییرات API
-
androidx.work.Result
به عنوان یک کلاس درونی ازListenableWorker
منتقل شده است. این امر مانع از تغییر مجدد درگیری با کلاسResult
سطح بالای کوتلین می شود. این یک تغییر API در حال شکستن است. b/120564418
شکستن API تغییر می کند
-
androidx.work.Result
به عنوان یک کلاس درونی ازListenableWorker
منتقل شده است.
نسخه 1.0.0-alpha12
5 دسامبر 2018
این نسخه حاوی برخی از تغییرات API در حال شکستن است. لطفاً بخش Breaking API تغییرات را در زیر مشاهده کنید. این نسخه به احتمال زیاد به عنوان اولین بتا ما منتشر می شود. alpha12
همچنین حاوی به روزرسانی های گسترده مستندات است.
تغییرات API
- یک مصنوعات جدید ،
work-rxjava2
،RxWorker
معرفی می کند. این یکListenableWorker
است که انتظار دارد یکSingle<Payload>
. - پشتیبانی از Firebase JobDispatcher به دلیل استهلاک قریب الوقوع آن حذف شده است. این بدان معناست که مصنوعات
work-firebase
در حالی که به بتا می رویم دیگر به روز نمی شود. ما در آینده به دنبال اضافه کردن یک گزینه جایگزین خواهیم بود. -
Payload
ترکیبی درResult
.Result
is now a "sealed class" with three concrete implementations, which you can obtain viaResult.success()
(orResult.success(Data)
),Result.failure()
(orResult.failure(Data)
), andResult.retry()
. YourListenableFuture
s now resultResult
instead ofPayload
.Worker
s don't have getter and setter methods for outputData
. This is a breaking change. - Added
Constraints.Builder.setTriggerContentMaxDelay(long, TimeUnit)
andConstraints.Builder.setTriggerContentUpdateDelay(long, TimeUnit)
and variants to better support slow triggering content URIs. b/119919774 - Added
WorkRequest.Builder.setBackoffCriteria(BackoffPolicy, Duration)
variant. This method requires API 26. - Added
Operation.await()
andListenableFuture.await()
Kotlin extension methods. - Renamed
Operation.getException()
toOperation.getThrowable()
. This is a breaking change. - The
ContentUriTriggers
class and methods referencing it are no longer available for public usage. This is a breaking change. - Removed the rest of the varargs methods in
WorkManager
,WorkContinuation
, andOneTimeWorkRequest
to streamline the API. To fix any build problems, you can wrap your existing varargs withArrays.asList(...)
. We still include single-argument versions of each method. This is a breaking change. - Removed
WorkContinuation.combine(OneTimeWorkRequest, *)
variants. They were presenting a confusing API; the existingcombine
methods are more understandable. This is a breaking change.
رفع اشکال
- Pre-Marshmallow implementations are now more reliable in recovering from process death of an already-executing task.
-
LiveData
that is observed viaobserveForever
is tracked via WorkManager. This is a backport of a Room library fix. b/74477406 -
Data.Builder.build()
now throws an exception if the serialized object exceeds its maximum size. This previously would only happen on a background thread where you couldn't properly handle it. - Further distinguished stopped vs. cancelled work;
getWorkInfoById()
will return aWorkInfo
with theCANCELLED
State
duringListenableWorker.onStopped()
. - Treat
null
Result
s as failures inListenableWorker
. b/120362353 - Speculative fix for Shield Tablets running API 24 that sometimes threw an
IllegalArgumentException
. b/119484416
Breaking API Changes
- Support for Firebase JobDispatcher has been removed because of its impending deprecation. This means that the
work-firebase
artifact will no longer be updated as we head into beta. We will be looking into adding an alternative in the future. - Combined
Payload
intoResult
.Result
is now a "sealed class" with three concrete implementations, which you can obtain viaResult.success()
(orResult.success(Data)
),Result.failure()
(orResult.failure(Data)
), andResult.retry()
. YourListenableFuture
s now resultResult
instead ofPayload
.Worker
s don't have getter and setter methods for outputData
. - Added
Operation.await()
andListenableFuture.await()
Kotlin extension methods. - Renamed
Operation.getException()
toOperation.getThrowable()
. - The
ContentUriTriggers
class and methods referencing it are no longer available for public usage. - Removed the rest of the varargs methods in
WorkManager
,WorkContinuation
, andOneTimeWorkRequest
to streamline the API. To fix any build problems, you can wrap your existing varargs withArrays.asList(...)
. We still include single-argument versions of each method. - Removed
WorkContinuation.combine(OneTimeWorkRequest, *)
variants. They were presenting a confusing API; the existingcombine
methods are more understandable.
نسخه 1.0.0-alpha11
8 نوامبر 2018
This release contains many changes that will become stable API at beta
. There are breaking API changes in this release; please see the Breaking API Changes section below.
تغییرات API
-
work-runtime-ktx
introduces a newCoroutineWorker
. -
WorkStatus
has been renamed toWorkInfo
. All correspondinggetStatus
method variants have been renamed to the correspondinggetWorkInfo
variants. This is a breaking change. -
ListenableWorker.onStopped()
no longer accepts has a boolean argument representing if theWorkRequest
was cancelled.WorkManager
no longer makes this distinction. This is a breaking change. -
androidx.work.test
package has been renamed toandroidx.work.testing
package. This is a breaking change. - Setters on
Constraints
are no longer a part of the public API. This is a breaking change. -
WorkerParameters.getTriggeredContentUris()
andWorkerParameters.getTriggeredContentAuthorities()
previously returned arrays. Now these methods return Collections. This is a breaking change. -
ListenableWorker.onStartWork()
is renamed toListenableWorker.startWork()
. This is a breaking change. - The constructor for
WorkStatus
is no longer a part of the public API. This is a breaking change. -
Configuration.getMaxJobSchedulerID()
andConfiguration.getMinJobSchedulerID()
are renamed toConfiguration.getMinJobSchedulerId()
andConfiguration.getMaxJobSchedulerId()
respectively. This is a breaking change. - Added a lot of
@NonNull
annotations to the public API to improve ergonomics of the API. - Add
WorkManager.enqueueUniqueWork()
API to enqueue uniqueOneTimeWorkRequest
s without having to create aWorkContinuation
. - All variants of
enqueue
andcancel
methods onWorkManager
now return a newOperation
type. This is a breaking change. - All variants of
enqueue
no longer accept varargs forWorkRequest
s. This is a breaking change. Use Collections instead. You can useArrays.asList()
to modify existing code. We did this to reduce the API surface and method count. - Attempting to
initialize
WorkManager
more than once per process will now result in anIllegalStateException
. This is a breaking change.
رفع اشکال
-
WorkRequest.Builder
s in thework-runtime-ktx
artifact now useListenableWorker
s. Fixes b/117666259 - Ensure the next run time for
PeriodicWork
is in the future. Fixes b/118204399 - Remove potential disk I/O when using WorkManager on app startup. Fixes b/117796731
- Fix a race condition in
WorkConstraintsTracker
. Fixes android-workmanager/issues/56
Breaking API Changes
-
WorkStatus
has been renamed toWorkInfo
. All correspondinggetStatus
method variants have been renamed to the correspondinggetWorkInfo
variants. -
ListenableWorker.onStopped()
no longer accepts has a boolean argument representing if theWorkRequest
was cancelled.WorkManager
no longer makes this distinction. -
androidx.work.test
package has been renamed toandroidx.work.testing
package. - Setters on
Constraints
are no longer a part of the public API. -
WorkerParameters.getTriggeredContentUris()
andWorkerParameters.getTriggeredContentAuthorities()
previously returned arrays. Now these methods return Collections. -
ListenableWorker.onStartWork()
is renamed toListenableWorker.startWork()
. - The constructor for
WorkStatus
is no longer a part of the public API. -
Configuration.getMaxJobSchedulerID()
andConfiguration.getMinJobSchedulerID()
are renamed toConfiguration.getMinJobSchedulerId()
andConfiguration.getMaxJobSchedulerId()
respectively. - All variants of
enqueue
andcancel
methods onWorkManager
now return a newOperation
type. - All variants of
enqueue
no longer accept varargs forWorkRequest
s. - Attempting to
initialize
WorkManager
more than once per process will now result in anIllegalStateException
.
نسخه 1.0.0-alpha10
11 اکتبر 2018
This release supports developer-controlled asynchronous work. There are breaking API changes in this release; please see the Breaking API Changes section below.
We anticipate that WorkManager is entering the final phases of its alpha period. We expect to be API stable in beta, so please take some time to file your feedback on our issue tracker.
تغییرات API
- Removed all previously
deprecated
methods and classes, notably the defaultWorker
constructor. This is a breaking API change. - Renamed
NonBlockingWorker
toListenableWorker
, which is now an unhidden public class and ready for usage.-
ListenableWorker
provides access to one abstract method,ListenableFuture<Payload> onStartWork()
which is called on the main thread. It is up to you to start and process work asynchronously. When finished, you should update theListenableFuture
appropriately. Reference implementations ofListenableFuture
s are provided in theFutures
package inalpha02
(see below theWorkManager
section). -
Worker
extendsListenableWorker
and still operates as before, with an abstractResult doWork()
method. - Shuffled some methods and members from
Worker
toListenableWorker
. - We shall soon provide reference implementations for
ListenableWorker
s that use Kotlin coroutines (once the stable versions are released) and RxJava2.
-
- The interface
WorkerFactory
and the concrete implementationDefaultWorkerFactory
have been merged into an abstract class calledWorkerFactory
. The implementation ensures that the default reflection-based behavior is called as a last-ditch effort for any user-createdWorkerFactory
instances. This is a breaking change. - Removed
WorkManager.synchronous()
andWorkContinuation.synchronous()
and all related methods. AddedListenableFuture<Void>
as the return type of many methods in the API. This is a breaking API change.- You can now synchronously get and observe by using
ListenableFuture
s. For example,WorkManager.enqueue()
used to returnvoid
; it now returns aListenableFuture<Void>
. You can callListenableFuture.addListener(Runnable, Executor)
orListenableFuture.get()
to run code once the operation is complete. - Note that these
ListenableFuture
s do not tell you if the operation succeeded or failed; only that they finished. You will still need to chain WorkManager methods to find out this information. - We ignore
cancel()
calls on these objects, as they are confusing and hard to reason about (are you cancelling the operation or the resulting work?). This is within theFuture
s contract. - To maintain parity with the synchronous
getStatus*
methods, we have providedListenableFuture
variants, and renamed the existing ones that returnedLiveData
to explicitly have "LiveData" as part of the name (for example,getStatusesByIdLiveData(UUID)
). This is a breaking API change.
- You can now synchronously get and observe by using
رفع اشکال
- Fixed the known issue from alpha09 regarding duplicate
androidx-annotations.pro
files. You may remove the workaround from the previous release notes by deletingexclude 'META-INF/proguard/androidx-annotations.pro'
from your gradle file. - Added proguard configurations to keep new
Worker
constructor. b/116296569 - Fix potential
NullPointerException
in a race condition where work wasREPLACE
d. b/116253486 and b/116677275 -
WorkContinuation.combine()
now accepts one or moreWorkContinuation
s instead of two or more. b/117266752
Breaking API Changes
- Removed all previously
deprecated
methods and classes, notably the defaultWorker
constructor. - The interface
WorkerFactory
and the concrete implementationDefaultWorkerFactory
have been merged into an abstract class calledWorkerFactory
. - Removed
WorkManager.synchronous()
andWorkContinuation.synchronous()
. -
WorkManager.getStatus*()
methods now returnListenableFuture
s.WorkManager.getStatus*LiveData()
returnLiveData
s.
نسخه 1.0.0-alpha09
19 سپتامبر 2018
موضوع شناخته شده
If you run into the following issue: "More than one file was found with OS independent path 'META-INF/proguard/androidx-annotations.pro'", please put the following in your gradle file as a temporary workaround while we fix the issue in alpha10:
شیار
android { packagingOptions { exclude 'META-INF/proguard/androidx-annotations.pro' } }
کاتلین
android { packagingOptions { exclude("META-INF/proguard/androidx-annotations.pro") } }
رفع اشکال
- Added another fix that was needed for the "100 jobs" error. b/115560696
- Added some fixes for foreign key constraint errors due to race conditions. b/114705286
- Delegated
ConstraintTrackingWorker.onStopped(boolean)
calls to the underlyingWorker
. b/114125093 - Enforce correct minimum backoff delay for Firebase JobDispatcher. b/113304626
- Improved threading guarantees internal to the library.
- Correct potential issue with deduping of
LiveData
internally.
تغییرات API
- You can now create your own
Worker
instances at runtime by specifying aWorkerFactory
as part of theWorkManager.Configuration
. The fallback factory isDefaultWorkerFactory
, which matches behavior of previous versions of WorkManager.- The default constructors for
Worker
andNonBlockingWorker
are now marked as deprecated. Please use the new constructor (Worker(Context, WorkerParameters)
) and callsuper(Context, WorkerParameters)
; future versions of WorkManager will remove the default constructor.
- The default constructors for
- We have started using the new
ListenableFuture
artifact internally (free of Guava dependencies). We will introduce ListenableFutures to the API in upcoming releases. This change will support the eventual unhiding ofNonBlockingWorker
. - Add ability to trigger timed work in
TestDriver
viaTestDriver.setInitialDelayMet(UUID)
andTestDriver.setPeriodDelayMet(UUID)
. b/113360060
شکستن تغییرات
- The default
Worker
andNonBlockingWorker
constructors are deprecated. Please migrate to the new constructor ASAP. Future versions will remove the default constructor.
نسخه 1.0.0-alpha08
27 آگوست 2018
رفع اشکال
- Explicitly labelled WorkManager components as direct boot unaware so they don't fire up during direct boot. In the future, we will provide a version of WorkManager that is direct boot-aware. b/112665532
- Fixed an issue where retried work was not running. b/112604021
- Fixed periodic work not executing repeatedly (related to the above issue). b/112859683
- Honored backoff policies when the app process is already running.
- Corrected exception messages in
Data
to indicate the limit is 10KB. - Lowered maximum value of
Configuration.setMaxSchedulerLimit(int)
to 50 to account for some latency inJobScheduler
processing completion. b/112817355
نسخه 1.0.0-alpha07
16 آگوست 2018
رفع اشکال
- Fixed a potential SQL query with negative limits that could return an unbounded number of results.
- Work that has finished execution now correctly cancels all pending copies of that work in other Schedulers. This led to exceeding the
JobScheduler
jobs limit. b/111569265 - Fixed a
ConcurrentModificationException
inConstraintTracker
. b/112272753 - Changed return type annotations of
Data.getBooleanArray(String)
andData.getIntArray(String)
to@Nullable
instead of@NonNull
. b/112275229
تغییرات API
-
Worker
now extends a new class,NonBlockingWorker
. This does not affect any current usage. In the future,NonBlockingWorker
will become a fully supported entity for custom threading solutions. - Changed return type annotations of
Data.getBooleanArray(String)
andData.getIntArray(String)
to@Nullable
instead of@NonNull
. b/112275229 - Kotlin extensions: deprecated
Map.toWorkData()
and added a top-levelworkDataOf(vararg Pair<String, Any?>)
to be more consistent with existing APIs.
نسخه 1.0.0-alpha06
1 آگوست 2018
رفع اشکال
- Prevent a database lock when scheduling work. b/111801342
- Fix a bug which causes
PeriodicWork
to not run on schedule when in Doze mode. b/111469837 - Fix a race condition when tracking constraints which causes
WorkManager
to crash. googlecodelabs/android-workmanager/issues/56 - Create unique
WorkRequest
s when usingWorkRequest.Builder#build()
. b/111408337 - Enable the use of
RescheduleReceiver
only when there areWorkRequest
s that need it. b/111765853
نسخه 1.0.0-alpha05
24 جولای 2018
تغییرات API
-
WorkManager.getInstance()
is now annotated with@NonNull
instead of@Nullable
. Instead, if the singleton isn't properly initialized in cases of manual initialization, the method will throw anIllegalStateException
. This is a breaking API change. - Added a new API,
Configuration.Builder.setMinimumLoggingLevel(int)
, which can control WorkManager verbosity. By default, WorkManager logsLog.INFO
and above. - Changed signature of
Data.getString()
so it no longer takes a default value (it is implicitlynull
). This is a breaking API change. - Marked some methods needed only for internal usage as
@hide
. This includes theConstraints
constructor,Data.toByteArray()
, andData.fromByteArray(byte[])
. This is a breaking API change.
رفع اشکال
- WorkManager no longer executes work during known cases of auto-backup. This could have resulted in a crash. b/110564377
- Fixed double-scheduling of
PeriodicWorkRequest
s when usingJobScheduler
. b/110798652 - Fixed an issue with
PeriodicWorkRequest
s not executing correctly after device doze. b/111469837 - Fixed an issue with initial delays when using Firebase JobDispatcher. b/111141023
- Fixed some potential race conditions and timing issues.
- Correctly freed up
BroadcastReceiver
s that were no longer needed. - Optimized rescheduling performance when apps restart after being force closed.
- Allowed
TestScheduler.setAllConstraintsMet(UUID)
to be called before or after enqueuing the givenWorkRequest
. b/111238024
شکستن تغییرات
-
WorkManager.getInstance()
is now annotated with@NonNull
instead of@Nullable
. - Changed signature of
Data.getString()
so it no longer takes a default value (it is implicitlynull
). - Marked some methods needed only for internal usage as
@hide
. This includes theConstraints
constructor,Data.toByteArray()
, andData.fromByteArray(byte[])
.
نسخه 1.0.0-alpha04
26 ژوئن 2018
رفع اشکال
-
PeriodicWorkRequest
s are now correctly rescheduled when using theAlarmManager
based implementation. - Fixed a potential ANR when rescheduling all workers after a force stop or a reboot. b/110507716
- Added nullability annotations to various WorkManager APIs. b/110344065
- Log uncaught exceptions that occur during Worker execution. b/109900862
- Allowed destructive database migrations in case you decide to roll back to an older version of WorkManager. b/74633270
- Fixed a migration crash if creating duplicate implicit tags. This is a very rare issue that occurred only if you used the same implicit tag format yourself.
نسخه 1.0.0-alpha03
19 ژوئن 2018
رفع اشکال
Fixed a race condition in the
AlarmManager
based implementation. b/80346526 .Fixed duplicate jobs when using
JobScheduler
after a device reboot.Jobs with Content URI triggers now persist across reboots. b/80234744
به روز رسانی اسناد b/109827628 , b/109758949 , b/80230748
Fixed a crash when re-enqueuing a
WorkRequest
. b/109572353 .Fixed Kotlin compiler warnings when using the
work-runtime-ktx
dependency.WorkManager now uses
Room
version1.1.1-rc1
.
تغییرات API
- Added
getStatusesSync()
, the synchronous version ofWorkContinuation.getStatuses()
. -
Worker
has the ability to distinguish between user-initiated cancellation and temporary os-requested stopping.Worker.isStopped()
returnstrue
if any kind of stop has been requested.Worker.isCancelled()
returnstrue
when the work has been explicitly cancelled. b/79632247 - Add support for JobParameters#getNetwork() on API 28. This is exposed via
Worker.getNetwork()
. - Added
Configuration.Builder.setMaxSchedulerLimit(int maxSchedulerLimit)
so you can enforce how many jobs can be sent toJobScheduler
orAlarmManager
. This helps preventWorkManager
from taking all your availableJobScheduler
slots. - Added
Configuration.setJobSchedulerJobIdRange(int minJobSchedulerId, int maxJobSchedulerId)
which helps define a range ofJobScheduler
job ids safe forWorkManager
to use. b/79996760 -
Worker.getRunAttemptCount()
returns the current run count for a givenWorker
. b/79716516 -
WorkManager.enqueueUniquePeriodicWork(String uniqueWorkName, ExistingPeriodicWorkPolicy existingPeriodicWorkPolicy, PeriodicWorkRequest periodicWork)
allows you to enqueue a uniquePeriodicWorkRequest
s. b/79600647 -
WorkManager.cancelAllWork()
cancels allWorker
s. Libraries that depend onWorkManager
can query when this method was called last by usingWorkManager.getLastCancelAllTimeMillis()
for additional cleanup of internal state. - Added
WorkManager.pruneWork()
to remove completed jobs from the internal database. b/79950952 , b/109710758
Behavior Changes
- Added an implicit tag for all
WorkRequest
s, which is the fully qualified class name for theWorker
. This allows the ability to removeWorkRequest
s withouttag
s or when theid
is not available. b/109572351
شکستن تغییرات
- Renamed
Worker.WorkerResult
toWorker.Result
. -
Worker.onStopped
now has an additionalisCancelled
parameter which is set totrue
when theWorker
has explicitly been cancelled.
نسخه 1.0.0-alpha02
24 مه 2018
رفع اشکال
- Fixed a
NullPointerException
onState.isFinished()
. b/79550068 - Fixed an issue which caused
Worker
s to be rescheduled onApplication.onCreate()
. b/79660657 - Fixed an issue where you could schedule more work than is allowed by the OS. b/79497378
- Moved cleanup of wake locks associated with
Worker
s to the background thread. - The
AlarmManager
implementation now correctly cleans up when all pending work is complete. - Fixed cleanup SQL queries which affected non-English locales. b/80065360
- Added support for
float
s inData
. b/79443878 -
Data.Builder.putAll()
now returns an instance of theBuilder
. b/79699162 - More javadoc and fixes in documentation. b/79691663
تغییرات API
-
Worker
s can react to being stopped.Worker.isStopped()
can be used to check if aWorker
has been stopped.Worker.onStopped()
can be used to perform lightweight cleanup operations. -
Worker.getTags()
API returns aSet
of tags associated with theWorker
. - Added
javax.time.Duration
overloads for APIs which take a combination of duration andTimeUnit
s. This is guarded by@RequiresApi(26)
. -
WorkManager
extensions have moved from theandroidx.work.ktx
package to theandroidx.work
package. The old extensions are deprecated and will be removed in a future version. -
Configuration.withExecutor()
is deprecated. UseConfiguration.setExecutor()
instead.
نسخه 1.0.0-alpha01
8 مه 2018
WorkManager simplifies scheduling and execution of guaranteed, constraint-aware background work. This initial release is 1.0.0-alpha01
.
WorkManager
آخرین به روز رسانی | انتشار پایدار | کاندید را آزاد کنید | نسخه بتا | انتشار آلفا |
---|---|---|---|---|
18 سپتامبر 2024 | 2.9.1 | - | - | 2.10.0-alpha04 |
اعلام وابستگی ها
To add a dependency on WorkManager, you must add the Google Maven repository to your project:
وابستگیهای مصنوعات مورد نیاز خود را در فایل build.gradle
برای برنامه یا ماژول خود اضافه کنید:
شیار
dependencies { def work_version = "2.9.1" // (Java only) implementation "androidx.work:work-runtime:$work_version" // Kotlin + coroutines implementation "androidx.work:work-runtime-ktx:$work_version" // optional - RxJava2 support implementation "androidx.work:work-rxjava2:$work_version" // optional - GCMNetworkManager support implementation "androidx.work:work-gcm:$work_version" // optional - Test helpers androidTestImplementation "androidx.work:work-testing:$work_version" // optional - Multiprocess support implementation "androidx.work:work-multiprocess:$work_version" }
کاتلین
dependencies { val work_version = "2.9.1" // (Java only) implementation("androidx.work:work-runtime:$work_version") // Kotlin + coroutines implementation("androidx.work:work-runtime-ktx:$work_version") // optional - RxJava2 support implementation("androidx.work:work-rxjava2:$work_version") // optional - GCMNetworkManager support implementation("androidx.work:work-gcm:$work_version") // optional - Test helpers androidTestImplementation("androidx.work:work-testing:$work_version") // optional - Multiprocess support implementation("androidx.work:work-multiprocess:$work_version") }
For information on using Kotlin extensions, see the ktx documentation .
For more information about dependencies, see Add Build Dependencies .
بازخورد
بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.
برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.
Version 2.10
Version 2.10.0-alpha04
18 سپتامبر 2024
androidx.work:work-*:2.10.0-alpha04
is released. Version 2.10.0-alpha04 contains these commits .
تغییرات API
- Add the stop reason
STOP_REASON_FOREGROUND_SERVICE_TIMEOUT
for when a foreground worker is stopped due to execution timeout based on the foreground service type. ( Ibd0af )
Version 2.10.0-alpha03
4 سپتامبر 2024
androidx.work:work-*:2.10.0-alpha03
is released. Version 2.10.0-alpha03 contains these commits .
ویژگی های جدید
- Added trace tags to Jobs from
WorkManager
which makes 'adb shell dumpsys jobscheduler' a lot simpler to understand since it will contain the name of the Worker being executed. Trace sections are also added around key areas ofWorkManager
.
تغییرات API
- WorkManager 2.10.0 is now compiled with SDK 35.
- Fix foreground workers of type 'short service' and 'data sync' timing out and causing an ANR when
WorkManager
didn't callstopSelf()
. This fix only applies to devices with API 34 and 35 where foreground service types were introduced. ( ca06b2 , b/364508145 ) - New
WorkerParameters
APIs that make it possible to switch the remote process that theWorker
binds to when using aWorkerFactory
. ( Ibdc8a , Ie8a90 , I7373f )
رفع اشکال
- Fix a crash caused by
WorkManager
attempting to restart a long-running worker (ie a foreground worker) when the foreground type of the work had Android 14 prerequisite permissions that were revoked. ( b/333957914 ) - Removed manual outlining of access to new platform APIs since this happens automatically via API modeling when using R8 with AGP 7.3 or later (eg R8 version 3.3) and for all builds when using AGP 8.1 or later (eg D8 version 8.1). Clients who are not using AGP are advised to update to D8 version 8.1 or later. برای جزئیات بیشتر به این مقاله مراجعه کنید. ( Ia60e0 , b/345472586 )
Version 2.10.0-alpha02
17 آوریل 2024
androidx.work:work-*:2.10.0-alpha02
is released. Version 2.10.0-alpha02 contains these commits .
تغییرات API
- Added the ability to emit trace spans via a configurable
@RestrictTo
Tracer
inWorkManager
. ( I17d7f , b/260214125 ) -
Configuration.workerCoroutineContext
was added to for control of dispatcher whereCoroutineWorker
is executed. It helps to completely avoid usage ofDispatchers.Default
inWorkManager
. ( Icd1b7 ) - Add custom exception handlers for Workers ( Ib1b74 , b/261190695 )
-
OneTimeWorkRequest.Builder
andPeriodicWorkRequest.Builder
can now be constructed withKClass
instead ofClass
:val request = OneTimeWorkRequest.Builder(Worker::class).setConstraints(...).build()
( Ib55f6 ) -
WorkManager
class was migrated to Kotlin. Now methods that returnLiveData
,ListenableFuture
orFlow
provides correct nullability information. It could require changes in clients' source code, if nullability assumptions in that code were incorrect. ( If6757 )
Version 2.10.0-alpha01
24 ژانویه 2024
androidx.work:work-*:2.10.0-alpha01
is released. Version 2.10.0-alpha01 contains these commits.
ویژگی های جدید
- Developers can specify
NetworkRequest
as a constraint for a worker via theConstraints.setRequiredNetworkRequest
method. This enables more granular control over which network this worker should run.
تغییرات API
- Adding an ability to specify
NetworkRequest
as the constraint. ( Id98a1 , b/280634452 )
Version 2.9
Version 2.9.1
7 آگوست 2024
androidx.work:work-*:2.9.1
is released. Version 2.9.1 contains these commits .
رفع اشکال
- Fix a crash caused by
WorkManager
attempting to restart a long-running worker (ie a foreground worker) when the foreground type of the work had Android 14 prerequisite permissions that were revoked. ( b/333957914 )
Version 2.9.0
29 نوامبر 2023
androidx.work:work-*:2.9.0
is released. Version 2.9.0 contains these commits.
Important changes since 2.8.0
- Observability via
Flow
-s. Instead ofLiveData
, Worker's progress now can be observed via Flow's viaWorkManager.getWorkInfosFlow
and similar methods. - Now
WorkManager
provides a hint on why a worker was previously stopped. It can be queried from a worker itself viagetStopReason()
method or fromWorkInfo
viagetStopReason()
. - Precise scheduling of periodic workers via
setNextScheduleTimeOverride
. This allows dynamic calculation of the next Periodic work schedule, which can be used to implement advanced features like adaptive refresh times, custom retry behavior, or making a newsfeed worker run before the user wakes up every morning without drift.ExistingPeriodicWorkPolicy.UPDATE
should be used with these techniques to avoid canceling a currently-running worker while scheduling the next one. - WorkManager's testing with threading matching production.
ExecutorsMode.PRESERVE_EXECUTORS
can be used ininitializeTestWorkManager
to preserve executors set inConfiguration
and to use the real main thread. - Coroutines APIs such as
CoroutineWorker
have been moved from additional artifact work-runtime-ktx to the main artifact work-runtime. work-runtime-ktx is now empty.
تغییرات API
-
stopReason
was added toWorkInfo
. It makesstopReason
available after the worker has run. It could be helpful in the reportingstopReason
in a usable way, because once a worker has been stopped, an app itself could be killed very quickly. ( I21386 ) - Allow
Clock
to be set via config and used to drive execution sequencing of Worker tests. ( Ic586e ) -
getStopReason()
method was added toListenableWorker
that gives a hint why the worker was stopped. ( I07060 ) - Added
WorkManagerTestInitHelper#closeWorkDatabase()
to avoid Closeguard's warning about leaked resources. ( Ia8d49 ) -
WorkInfo
's constructor is public now, which can be useful in testing. ( Ia00b6 , b/209145335 ) -
work-runtime-ktx
is now empty,CoroutineWorker
and other Kotlin specific utilities are now available in the main work-runtime artifact. ( I71a9a ) - Added
setNextScheduleTimeOverride
method, which allows accurate setting of periodic work schedules ( I3b4da ) - Added
getNextScheduleTimeMillis
to get scheduled run time info is added toWorkInfo
. ( I797e4 ) - Initial delay and periodicity info are added to
WorkInfo
. ( I52f2f ) - Added method observe workers via Flows via methods
getWorkInfosByTagFlow
,getWorkInfoByIdFlow
,getWorkInfosForUniqueWorkFlow
,getWorkInfosFlow
( If122a ) - Added missing
@RequiresApi(...)
annotations toConstraints
' constructors and properties. They are now aligned with corresponding annotations on setters inConstraints.Builder
that existed from early versions ofWorkManager
. ( I6d7d2 ) -
WorkManager
now has a separate limit for content uri workers to give them guaranteed slots inJobScheduler
to prevent missing content updates under the high load. The limit can be configured viaConfiguration.Builder.setContentUriTriggerWorkersLimit
. ( Ic128f ) - Constraints are added to
WorkInfo
. ( I162c0 )
Version 2.9.0-rc01
18 اکتبر 2023
androidx.work:work-*:2.9.0-rc01
is released. Version 2.9.0-rc01 contains these commits.
- No changes since the last beta release
Version 2.9.0-beta01
6 سپتامبر 2023
androidx.work:work-*:2.9.0-beta01
is released. Version 2.9.0-beta01 contains these commits.
تغییرات API
- Added constants for stop reasons returned by
WorkInfo.stopReason
andListenableWorker.stopReason
( I0cc00 )
Version 2.9.0-alpha02
26 جولای 2023
androidx.work:work-*:2.9.0-alpha02
is released. Version 2.9.0-alpha02 contains these commits.
ویژگی های جدید
- Now
WorkManager
provides a hint on why a worker was previously stopped. It can be queried from a worker itself viagetStopReason()
method or fromWorkInfo
viagetStopReason()
.
تغییرات API
-
stopReason
was added toWorkInfo
. It makes availablestopReason
after the worker ran. It could be helpful in the reportingstopReason
in usable way, because once a worker has been stopped, an app itself could be very quickly killed. ( I21386 ) - Allow Clock to be set via config and used to drive execution sequencing of Worker tests. ( Ic586e )
-
getStopReason()
method was added toListenableWorker
that gives a hint why the worker was stopped. ( I07060 ) - Added
WorkManagerTestInitHelper#closeWorkDatabase()
to avoid Closeguard's warning about leaked resources. ( Ia8d49 )
رفع اشکال
- Added ability to bypass
overrideNextScheduleTime
usingTestDriver
and fixed issues with testability. ( Ic2905 )
Version 2.9.0-alpha01
7 ژوئن 2023
androidx.work:work-*:2.9.0-alpha01
is released. Version 2.9.0-alpha01 contains these commits.
ویژگی های جدید
- Observability via
Flow
-s. Instead ofLiveData
, Worker's progress now can be observed via Flow's viaWorkManager.getWorkInfosFlow
and similar methods. - Precise scheduling of periodic workers via
setNextScheduleTimeOverride
. This allows dynamic calculation of the next Periodic work schedule, which can be used to implement advanced features like adaptive refresh times, custom retry behavior, or making a newsfeed worker run before the user wakes up every morning without drift.ExistingPeriodicWorkPolicy.UPDATE
should be used with these techniques to avoid cancelling a currently-running worker while scheduling the next one. -
WorkManager
's testing with threading matching production.ExecutorsMode.PRESERVE_EXECUTORS
can be used to preserve executors set inConfiguration
and to use the real main thread. - Coroutines APIs such as
CoroutineWorker
have been moved from additional artifactwork-runtime-ktx
to the main artifactwork-runtime
.work-runtime-ktx
is now empty.
تغییرات API
-
WorkInfo
's constructor is public now, that can be useful in testing. ( Ia00b6 , b/209145335 ) -
work-runtime-ktx
is now empty,CoroutineWorker
and other kotlin specific utilities are now available in the mainwork-runtime
artifact. ( I71a9a ) - Added
setNextScheduleTimeOverride
method, which allows accurate setting of periodic work schedules ( I3b4da ) - Renamed
getEarliestRunTimeMillis
togetNextScheduleTimeMillis
. ( I2bd7a ) - Next scheduled run time info is added to
WorkInfo
. ( I797e4 ) - Initial delay and periodicity info are added to
WorkInfo
. ( I52f2f ) - Added method observe workers via Flows via methods
getWorkInfosByTagFlow
,getWorkInfoByIdFlow
,getWorkInfosForUniqueWorkFlow
,getWorkInfosFlow
( If122a ) - Added missing
@RequiresApi(...)
annotations to Constraints' constructors and properties. They are now aligned with corresponding annotations on setters inConstraints.Builder
that existed from early versions ofWorkManager
. ( I6d7d2 ) -
WorkManager
now has a separate limit for content uri workers to give them guaranteed slots inJobScheduler
to prevent missing content updates under the high load. Limit can be configured viaConfiguration.Builder.setContentUriTriggerWorkersLimit
. ( Ic128f ) - Constraints are added to
WorkInfo
. ( I162c0 )
Version 2.8
Version 2.8.1
22 مارس 2023
androidx.work:work-*:2.8.1
is released. Version 2.8.1 contains these commits.
رفع اشکال
- Fixed ANR in
RescheduleReceiver
that previously didn't correctly handle two simultaneous broadcasts. ( b/236906724 )
Version 2.8.0
8 فوریه 2023
androidx.work:work-*:2.8.0
is released. Version 2.8.0 contains these commits.
Important changes since 2.7.0
ویژگی های جدید
- An ability to update
WorkRequests
in a non-intrusive way was added, preserving original enqueue time, chaining etc. See detailed blogpost about this feature, as well as javadocs forWorkManager.updateWork
andExistingPeriodicWorkPolicy.UPDATE
for more details.
تغییرات API
-
WorkManager.updateWork
was added to update work preserving its original enqueue time and chaining.( I9a248 , b/219446409 ) -
ExistingPeriodicWorkPolicy.UPDATE
was added. This policy allows updating a periodic work by the name. It is similar to the existingREPLACE
, but it is less intrusive: it doesn't cancel a worker if it is currently running and it preserves enqueue time - initial delay and period are calculated from original enqueue time, rather than update time.REPLACE
was deprecated to decrease a confusion between the very similarly namedREPLACE
andUPDATE
. If you still want to keep the previous semantics ofREPLACE
, the newly addedCANCEL_AND_REENQUEUE
, which is identical toREPLACE
, can be used. ( I985ed , b/219446409 ) - Added the ability to intercept scheduling exceptions providing
Consumer<Throwable>
via setSchedulingExceptionHandler ) - Added the ability to provide
Consumer<Throwable>
via setInitializationExceptionHandler to determine if there were issues when trying to initialize WorkManager. - Inline helpers for
OneTimeWorkRequest
&PeriodicWorkRequest
were moved fromandroidx.work:work-runtime-ktx
toandroidx.work:work-runtime
( I0010f , b/209145335 ) - Helper methods
WorkQuery.fromIds
,WorkQuery.fromStates
,WorkQuery.fromUniqueWorkNames
,WorkQuery.fromTags
were added to createWorkQuery
directly. ( b/199919736 ) ( If48f2 , b/199919736 ) - Added
getForegroundInfo
toWorker
. ( Ic1ead ) -
RxWorker
both for RxJava 2 and RxJava 3 now hassetForeground
returningCompletable
that can be used instead ofsetForegroundInfoAsync
that returnsListenableFuture
-
RxWorker
both for RxJava 2 and RxJava 3 hasgetForegroundInfo
returningSingle
that can be used instead ofgetForegroundInfoAsync
that returnsListenableFuture
. ( b/203851459 ) - Constraints can now be directly constructed rather than using
Constraints.Builder
, which is convenient for Kotlin users. ( Idc390 , b/137568653 ) - Added the ability to check if
WorkManager
has been initialized. Also, added a newgetConfiguration()
API for library developers to get the configuration thatWorkManager
was initialized with. ( I6eff3 , b/212300336 )
رفع اشکال
- Fixed an issue with the greedy scheduler that would prevent workers from running immediately when under load. ( I9686b , b/248111307 )
- Added
@RequiresPermission
to APIs that require granting thePOST_NOTIFICATIONS
permission on SDK 33 and above. ( Ie542e , b/238790278 ) - Propagate cancellations in the
CoroutineScope
to theListenableFuture
when usingsuspendCancellableCoroutine
.
Version 2.8.0-rc01
7 دسامبر 2022
androidx.work:work-*:2.8.0-rc01
is released. Version 2.8.0-rc01 contains these commits.
ویژگی های جدید
- No new features on this release. This is mainly a version bump
Version 2.8.0-beta02
9 نوامبر 2022
androidx.work:work-*:2.8.0-beta02
is released. Version 2.8.0-beta02 contains these commits.
رفع اشکال
- Fixed
equals
method inWorkInfo
, that previously didn't take into account new generation information. ( 4977cc )
Version 2.8.0-beta01
5 اکتبر 2022
androidx.work:work-*:2.8.0-beta01
is released. Version 2.8.0-beta01 contains these commits.
رفع اشکال
- Fixed an issue with the greedy scheduler that would prevent workers from running immediately when under load. ( I9686b , b/248111307 )
Version 2.8.0-alpha04
7 سپتامبر 2022
androidx.work:work-*:2.8.0-alpha04
is released. Version 2.8.0-alpha04 contains these commits.
تغییرات API
-
WorkerInfo.getGeneration()
andWorkerParameters.getGeneration()
were added that return the generation of a worker. A worker has multiple generations, if it was updated viaWorkManager.updateWork
orWorkManager.enqueueUniquePeriodicWork
usingExistingPeriodicWorkPolicy.UPDATE
. Note that If the worker is currently running, it is possible for this method to return a newer generation from that of the currently running worker if an update has happened during an execution of the worker. ( I665c5 , b/219446409 ) ( I128a9 , b/219446409 ) - Added
InitializationExceptionHandler
, an Exception Handler that can be used to determine if there were issues when trying to initializeWorkManager
. ( I061de )
Version 2.8.0-alpha03
10 آگوست 2022
androidx.work:work-*:2.8.0-alpha03
is released. Version 2.8.0-alpha03 contains these commits.
ویژگی های جدید
- An ability to update
WorkRequests
in a non-intrusive way was added, preserving original enqueue time, chaining etc. SeeWorkManager.updateWork
andExistingPeriodicWorkPolicy.UPDATE
for more details.
تغییرات API
-
WorkManager.updateWork
was added to update work preserving its original enqueue time and chaining.( I9a248 , b/219446409 ) -
ExistingPeriodicWorkPolicy.UPDATE
was added. This policy allows to update a periodic work by the name. It is similar to the existingREPLACE
, but it is less intrusive: it doesn't cancel a worker if it is currently running and it preserves enqueue time - initial delay and period are calculated from original enqueue time, rather than update time.REPLACE
was deprecated to decrease a confusion between very similarly namedREPLACE
andUPDATE
. If you still want to keep the previous semantics ofREPLACE
, the newly addedCANCEL_AND_REENQUEUE
, which is identical toREPLACE
, can be used. ( I985ed , b/219446409 ) - Add the ability to intercept scheduling exceptions by defining a
SchedulingExceptionHandler
. ( I033eb ) - Inline helpers for
OneTimeWorkRequest
&PeriodicWorkRequest
were moved fromandroidx.work:work-runtime-ktx
toandroidx.work:work-runtime
( I0010f , b/209145335 )
رفع اشکال
- Added
@RequiresPermission
to APIs that require granting the POST_NOTIFICATIONS permission on SDK 33 and above. ( Ie542e , b/238790278 )
Version 2.8.0-alpha02
6 آوریل 2022
androidx.work:work-*:2.8.0-alpha02
is released. Version 2.8.0-alpha02 contains these commits.
تغییرات API
- Constraints can now be directly constructed rather than using Builder, which is convenient for Kotlin users. ( Idc390 , b/137568653 )
- Added the ability to check if
WorkManager
has been initialized. Also, added a newgetConfiguration()
API for library developers to get the configuration thatWorkManager
was initialized with. ( I6eff3 , b/212300336 )
Version 2.8.0-alpha01
12 ژانویه 2022
androidx.work:work-*:2.8.0-alpha01
is released. Version 2.8.0-alpha01 contains these commits.
تغییرات API
- Helper methods
WorkQuery.fromStates
,WorkQuery.fromUniqueWorkNames
,WorkQuery.fromTags
were added to create WorkQuery directly. ( If48f2 , b/199919736 ) - Adds experimental BuildCompat methods for future SDKs ( Iafd82 , b/207528937 )
- Add
getForegroundInfo
toWorker
. ( Ic1ead ) - Helper methods
WorkQuery.fromIds
to create WorkQuery directly from ids were added. ( Ie5bdf , b/199919736 ) - RxWorker now has
setForeground
returningCompletable
that can be used instead ofsetForegroundInfoAsync
that returnsListenableFuture
. ( I85156 ) - RxWorker for RxJava 2 now has
getForegroundInfo
returningSingle
that can be used instead ofgetForegroundInfoAsync
that returnsListenableFuture
. ( I21c91 , b/203851459 ) - RxWorker for RxJava 3 now has
getForegroundInfo
returningSingle
that can be used instead ofgetForegroundInfoAsync
that returnsListenableFuture
. ( I1ca8a ) - RxWorker now has
setForeground
returningCompletable
that can be used instead ofsetForegroundInfoAsync
that returnsListenableFuture
. ( I992a3 , b/203851459 )
رفع اشکال
- Propagate cancellations in the
CoroutineScope
to theListenableFuture
when usingsuspendCancellableCoroutine
. ( I77e63 )
نسخه 2.7
Version 2.7.1
17 نوامبر 2021
androidx.work:work-*:2.7.1
is released. Version 2.7.1 contains these commits.
رفع اشکال
- Cancellations in the
CoroutineScope
are propagated to theListenableFuture
when usingsuspendCancellableCoroutine
. ( I77e63 ) - An exception is thrown immediately when delayed work requests are marked as expedited. bef1762
Version 2.7.0
13 اکتبر 2021
androidx.work:work-*:2.7.0
is released. Version 2.7.0 contains these commits.
Important changes since 2.6.0
WorkManager introduces a new
WorkRequest.Builder.setExpedited(...)
API to help with Foreground Service restrictions in Android 12.When using
setExpedited(...)
, WorkManager delegates to expedited jobs in JobScheduler starting Android 12, while providing backwards compatibility on prior versions of Android by delegating to a Foreground Service.
Version 2.7.0-rc01
29 سپتامبر 2021
androidx.work:work-*:2.7.0-rc01
is released. Version 2.7.0-rc01 contains these commits.
This version is identical to androidx.work:work-*:2.7.0-beta01
.
Version 2.7.0-beta01
1 سپتامبر 2021
androidx.work:work-*:2.7.0-beta01
is released. Version 2.7.0-beta01 contains these commits.
ویژگی های جدید
- Reduce multi-process SQLite contention when initializing WorkManager.
تغییرات API
- Remove
@ExperimentalExpeditedWork
APIs given the underlying platform APIs for Android 12 (S) are stable. ( aosp/1792806 )
رفع اشکال
- Provide a better error message for expedited workers that do not implement
getForegroundInfoAsync()
. ( aosp/1809376 )
Version 2.7.0-alpha05
21 جولای 2021
androidx.work:work-*:2.7.0-alpha05
is released. Version 2.7.0-alpha05 contains these commits.
This release also contains bug fixes from the WorkManager 2.6.0-beta02
release.
Version 2.7.0-alpha04
2 ژوئن 2021
androidx.work:work-*:2.7.0-alpha04
is released.
This release also contains the changes from the 2.6.0-beta01 release.
تغییرات API
-
ListenableWorker.setForegroundAsync()
is no longer deprecated. - We recommend using
WorkRequest.Builder.setExpedited(...)
API when possible. To better support situations when the app is not subject to foreground service restrictions , developers can use theListenableWorker.setForegroundAsync()
API. - If
ListenableWorker.setForegroundAsync()
is called, when the app is subject to foreground service restrictions, this will throw the ForegroundServiceStartNotAllowedException .
رفع اشکال
- When expedited jobs are rescheduled, they are no longer expedited. They become regular jobs.
Version 2.7.0-alpha03
21 آوریل 2021
androidx.work:work-*:2.7.0-alpha03
is released. Version 2.7.0-alpha03 contains these commits.
ویژگی های جدید
From WorkManager
2.6.0-alpha02
: Adds support for Workers that can run in any process. ( Iaf200 )From WorkManager
2.6.0-alpha02
: Added aRemoteCoroutineWorker
which is an implementation ofRemoteListenableWorker
that can bind to a remote process. ( I30578 )
تغییرات API
- From WorkManager
2.6.0-alpha02
:Added support forTEMPORARILY_UNMETERED
network constraint. ( I08d5e ) - From WorkManager
2.6.0-alpha02
:Multi-process worker support forsetProgressAsync()
. ( Ib6d08 ) - From WorkManager
2.6.0-alpha02
:MakeWorkManagerInitializer
public so otherandroidx.startup.Initializer
s can use these as dependencies. ( I5ab11 )
Version 2.7.0-alpha02
10 مارس 2021
androidx.work:work-*:2.7.0-alpha02
is released. Version 2.7.0-alpha02 contains these commits.
رفع اشکال
- Make
PendingIntent
mutability explicit, to fix a crash when targeting Android 12. ( b/180884673 )
Version 2.7.0-alpha01
18 فوریه 2021
androidx.work:work-*:2.7.0-alpha01
is released. Version 2.7.0-alpha01 contains these commits.
ویژگی های جدید
WorkManager introduces a new
WorkRequest.Builder.setExpedited(...)
API to take into account the foreground Service restrictions in Android 12.Applications can no longer launch a foreground service when they are in the background. Therefore, to better support long running work which was previously bound to the lifecycle of a foreground service, applications can mark
WorkRequest
s as expedited .This API is a replacement for the
setForegroundAsync(...)
/setForeground(...)
APIs which are now deprecated .When using
setExpedited(...)
, WorkManager delegates to expedited jobs inJobScheduler
starting Android 12, while providing backwards compatibility on prior versions of Android by delegating to foreground services,
تغییرات API
- Add support for expedited
WorkRequest
s.
نسخه 2.6.0
نسخه 2.6.0
1 سپتامبر 2021
androidx.work:work-*:2.6.0
is released. Version 2.6.0 contains these commits.
Important changes since 2.5.0
WorkManager now uses
androidx.startup
to initialize WorkManager. If you usedtools:node="remove"
theContentProvider
being used to initialize WorkManager in the past, then you need to do the following instead.<provider android:name="androidx.startup.InitializationProvider" android:authorities=\"${applicationId}.androidx-startup" android:exported="false" tools:node=\"merge"> <!-- If you are using androidx.startup to initialize other components --> <meta-data android:name="androidx.work.WorkManagerInitializer" android:value="androidx.startup" tools:node="remove" /> </provider>
<!-- If you want to disable android.startup completely. --> <provider android:name="androidx.startup.InitializationProvider" android:authorities="${applicationId}.androidx-startup" tools:node="remove" />
Added support for Workers that can run in any process. ( Iaf200 )
Added a
RemoteCoroutineWorker
which is an implementation of RemoteListenableWorker that can bind to a remote process. ( I30578 )
Version 2.6.0-rc01
4 آگوست 2021
androidx.work:work-*:2.6.0-rc01
is released. Version 2.6.0-rc01 contains these commits.
This version is identical to androidx.work:work-*:2.6.0-beta02
.
Version 2.6.0-beta02
21 جولای 2021
androidx.work:work-*:2.6.0-beta02
is released. Version 2.6.0-beta02 contains these commits.
رفع اشکال
-
RemoteWorkManager
now correctly unbinds fromRemoteWorkManagerService
which allowsRemoteWorkManagerService
to clean up correctly. aosp/1730694 -
RemoteListenableWorker
now correctly unbinds fromRemoteWorkerService
which allowsRemoteWorkerService
to clean up correctly. aosp/1743817 -
ForceStopRunnable
now only runs in the primary app process. This is an optimization, and avoids resource contention for apps that use multiple processes. aosp/1749180 , aosp/1761729
Version 2.6.0-beta01
2 ژوئن 2021
androidx.work:work-*:2.6.0-beta01
is released. Version 2.6.0-beta01 contains these commits.
This release contains some minor documentation improvements. The release is largely identical to 2.6.0-alpha02 .
Version 2.6.0-alpha02
21 آوریل 2021
androidx.work:work-*:2.6.0-alpha02
is released. Version 2.6.0-alpha02 contains these commits.
ویژگی های جدید
Adds support for Workers that can run in any process. ( Iaf200 )
Added a
RemoteCoroutineWorker
which is an implementation ofRemoteListenableWorker
that can bind to a remote process. ( I30578 )
تغییرات API
- Added support for
TEMPORARILY_UNMETERED
network constraint. ( I08d5e ) - Multi-process worker support for
setProgressAsync()
. ( Ib6d08 ) - Make
WorkManagerInitializer
public so otherandroidx.startup.Initializer
s can use these as dependencies. ( I5ab11 )
Version 2.6.0-alpha01
24 مارس 2021
androidx.work:work-*:2.6.0-alpha01
is released. Version 2.6.0-alpha01 contains these commits.
ویژگی های جدید
WorkManager
now usesandroidx.startup
to initialize WorkManager. Previously, this was being done byandroidx.work.impl.WorkManagerInitializer
. ( aosp/1608813 )If you used
tools:node="remove"
theContentProvider
being used to initialize process lifecycle in the past, then you need to do the following instead.<provider android:name="androidx.startup.InitializationProvider" android:authorities=\"${applicationId}.androidx-startup" android:exported="false" tools:node=\"merge"> <!-- If you are using androidx.startup to initialize other components --> <meta-data android:name="androidx.work.impl.WorkManagerInitializer" android:value="androidx.startup" tools:node="remove" /> </provider>
(یا)
<!-- If you want to disable android.startup completely. --> <provider android:name="androidx.startup.InitializationProvider" android:authorities="${applicationId}.androidx-startup" tools:node="remove"> </provider>
تغییرات API
- Add a
Result.getOutputData()
API which returns the ListenableWorker'soutputData
. ( Ie51e3 )
رفع اشکال
- Add a workaround for an OEM bug which causes a
SecurityException
to be thrown when usingAlarmManager
APIs. ( aosp/1587518 )
Version 2.5.0
Version 2.5.0
27 ژانویه 2021
androidx.work:work-*:2.5.0
is released. Version 2.5.0 contains these commits.
Major changes since 2.4.0
- A new
:work:work-multiprocess
artifact for apps that use multiple processes. This introduces performance gains by unifying work request scheduling to a single process.- To use
work-multiprocess
, define a dependency on:implementation "androidx.work:work-multiprocess:2.5.0"
- Designate a primary process using Configuration.Builder.setDefaultProcessName(String) .
- When using
work-multiprocess
you also want to use RemoteWorkManager to manage yourWorkRequest
s. RemoteWorkManager always reaches out to the designated process. The in-process scheduler also runs in the designated process.
- To use
- Sometimes,
ActivityManager
cannot instantiate theJobService
instance, to start a job. This causes the underlying job to get silently dropped because of a platform bug.WorkManager
now ensures that there are backing jobs for every singleWorkRequest
when anApplication
is being initialized by reconciling jobs. This greatly improves job execution reliability. ( b/172475041 , aosp/1489577 ) -
WorkManager
limits database growth by reducing the buffer duration thatWorkRequest
s are tracked after aWorkRequest
is complete. The duration was7
days previously. It has been reduced to1
day + the keepResultsForAtLeast duration. ( aosp/1419708 ) - The
TestListenableWorkerBuilder
now supports the reified class extendingListenableWorker
to make testing easier. ( aosp/1443299 , b/169787349 ) - WorkManager inspector is now available when using Android Studio Arctic Fox.
Version 2.5.0-rc01
13 ژانویه 2021
androidx.work:work-*:2.5.0-rc01
is released. Version 2.5.0-rc01 contains these commits.
رفع اشکال
- Fixed a bug where
getWorkInfosLiveData
was not correctly getting invalidated after entities were updated when using theWorkQuery
based API. ( aosp/1540566 , b/173769028 ) - Fixed a bug where database transactions were not being marked as successful in some rare cases. This causes issues on some Motorola devices. ( aosp/1535368 , b/175944460 )
- Fixed a bug to ignore
NoSuchElementException
s when trying to unbind from a dead process. ( aosp/1530589 ) - Improve
ConstraintTrackingWorker
to only stop aListenableWorker
if it's not already been stopped. ( aosp/1496844 , b/172946965 ) - Update androidx.work libraries to target Java 8 ( Ibd2f2 )
Version 2.5.0-beta02
2 دسامبر 2020
androidx.work:work-*:2.5.0-beta02
is released. Version 2.5.0-beta02 contains these commits.
رفع اشکال
- Fixed a bug in
androidx.work:work-multiprocess
where WorkManager inadvertently blocked the calling thread when trying to bind to the designated process. ( aosp/1475538 ) - Fixed a bug where
PeriodicWorkRequest
s were not being reconciled correctly. ( b/172475041 , aosp/1489577 ) - Added a workaround for a platform bug when stopping the foreground service when using the
setForeground*
APIs. ( b/170924044 , aosp/1489901 )
Version 2.5.0-beta01
28 اکتبر 2020
androidx.work:work-*:2.5.0-beta01
is released. Version 2.5.0-beta01 contains these commits.
ویژگی های جدید
-
WorkManager
automatically throttles the number ofWorkRequest
s that can be picked up by the in-process scheduler. The requests are still executed in FIFO order. ( aosp/1455228 ) -
WorkManager
attempts to recover when the application's datastore is in a bad state. ( aosp/1463103 )
رفع اشکال
- When
ListenableWorker
s are interrupted, mark themENQUEUED
immediately so they can be subsequently rescheduled. ( aosp/1455618 , b/170273988 )
Version 2.5.0-alpha03
14 اکتبر 2020
androidx.work:work-*:2.5.0-alpha03
is released. Version 2.5.0-alpha03 contains these commits.
تغییرات API
-
TestListenableWorkerBuilder
andTestWorkerBuilder
do not use raw types. ( I883ad , b/169787349 )
رفع اشکال
- Use
ApplicationInfo
to determine the name of the default app process. ( b/168716641 , aosp/1429950 ) - Fix the visibility rules for
RemoteWorkManager
andRemoteWorkContinuation
. These APIs are no-longer marked as@Restricted
. ( aosp/1432091 ) - Fix proguard rules for
:work:work-multiprocess
. ( aosp/1432091 ) - Improve notification lifecycles for long running work bound to a foreground service. ( b/168502234 , aosp/1431331 )
Version 2.5.0-alpha02
16 سپتامبر 2020
androidx.work:work-*:2.5.0-alpha02
is released. Version 2.5.0-alpha02 contains these commits.
ویژگی های جدید
- Add an API to WorkQuery to be able to use
id
s to queryWorkInfo
s. ( aosp/1412372 , b/157335295 ) - WorkManager better supports apps that use multiple processes with a new artifact (
androidx.work:work-multiprocess:*
). This new artifact helps solve a few problems that large apps encounter including:- WorkManager typically needs to be initialized in every app process. This is not great because there is increased SQLite contention which in turn causes other problems. WorkManager now has new APIs which can be used to designate a primary app process using
Configuration#setDefaultProcessName(processName)
. TheprocessName
is a fully qualified process name which looks likepackageName:processName
(egcom.example:remote
). - A set of new APIs:
RemoteWorkManager
andRemoteWorkContinuation
toenqueue
,cancel
andquery
work requests. These APIs do not includeLiveData
variants to avoid SQLite contention across multiple-processes. All calls toenqueue
,cancel
andquery
are forwarded to aprimary
app process using AIDL and return a fluentListenableFuture
. ( aosp/1392657 , aosp/1411210 , aosp/1412215 , aosp/1417713 )
- WorkManager typically needs to be initialized in every app process. This is not great because there is increased SQLite contention which in turn causes other problems. WorkManager now has new APIs which can be used to designate a primary app process using
تغییرات API
- WorkManager now prunes completed
WorkRequest
s that have no incomplete dependencies more aggressively. The buffer duration changed from7
days to1
day. ( aosp/1419708 )
رفع اشکال
- WorkManager now reconciles jobs proactively so
WorkRequest
s andJobScheduler
jobs are in sync whenWorkManager
is initialized. ( aosp/1412794 , b/166292069 )
Version 2.5.0-alpha01
19 آگوست 2020
androidx.work:work-*:2.5.0-alpha01
is released. Version 2.5.0-alpha01 contains these commits.
ویژگی های جدید
- Changes to internal APIs that allow us to provide better tooling with
WorkManager
going forward. Stay tuned for additional updates.
رفع اشکال
- Handle
SecurityException
s when tracking network state on some devices. ( aosp/1396969 )
مشارکت خارجی
- Fix documentation for
ArrayCreatingInputMerger
by Zac Sweers ( github/43 ).
نسخه 2.4.0
نسخه 2.4.0
22 جولای 2020
androidx.work:work-*:2.4.0
is released. Version 2.4.0 contains these commits.
Major changes since 2.3.0
-
WorkManager
s in-process scheduler is now more capable. Previously, the in-processScheduler
would only consider executing work that was not delayed and whose constraints were met. Now, the in-process scheduler tracksWorkRequest
s which might be executed in the future, including PeriodicWorkRequests. The in-processScheduler
also does not observe scheduling limits (but is still restricted to the size of theExecutor
being used by WorkManager). This means that the application can now execute a lot more WorkRequests when the app is in the foreground. To manage execution of delayed work in the foreground,WorkManager
also introduces a new configurableRunnableScheduler
. ( aosp/1185778 ) - WorkManager now supports RxJava 3. To use RxJava 3, you should include the following dependency:
implementation "androidx.work:work-rxjava3:2.4.0"
. ( aosp/1277904 ) - Added the ability to query for
WorkInfo
s by using aWorkQuery
. This is useful when developers want to queryWorkInfo
s by a combination of multiple attributes. For more information look atWorkQuery.Builder.fromStates(...)
,WorkQuery.Builder. fromTags(...)
orWorkQuery.Builder.fromUniqueWorkNames(...)
. ( aosp/1253230 , b/143847546 ) Add the ability to request diagnostic information from
WorkManager
using:adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "<your_app_package_name>"
This provides a lot of useful information including:
- WorkRequests that were completed in the last 24 hours.
- WorkRequests that are currently RUNNING.
- Scheduled WorkRequests. ( aosp/1235501 )
Add
ExistingWorkPolicy.APPEND_OR_REPLACE
which is similar toAPPEND
, but replaces a chain that has cancelled or failed prerequisites. ( b/134613984 , aosp/1199640 )Provide the ability to add a custom
RunnableScheduler
to track WorkRequests that need to be executed in the future. This is used by the in-process Scheduler. ( aosp/1203944 )Add support for dynamically adding factories to delegate to, when using a
DelegatingWorkerFactory
. ( b/156289105 , aosp/1309745 )Align tracking for
BATTERY_NOT_LOW
constraints more closely with the platform. ( aosp/1312583 )The in-process scheduler now uses better APIs to determine the name of the process. This is useful to better support apps that use multiple-processes. ( aosp/1324732 )
New Lint rules which enforce:
- Use of the right
foregroundServiceType
when usingsetForegroundAsync()
APIs. ( b/147873061 , aosp/1215915 ) - Specifying JobScheduler ids that WorkManager should use when using JobService APIs directly. aosp/1223567
- Added a new lint rule that ensures that
ListenableWorker
implementations are nowpublic
when using the defaultWorkerFactory
. ( aosp/1291262 )
- Use of the right
Calls to
setForegroundAsync()
that do not complete before completion of aListenableWorker
will now be signalled via anIllegalStateException
on the returnedListenableFuture
. ( aosp/1262743 )Fix a bug where the
ForegroundService
is not stopped after a foregroundWorker
is interrupted. ( b/155579898 , aosp/1302153 )Fix a bug where
WorkManager
attempts to execute multiple instances of aWorker
bound to a Foreground Service ( b/156310133 , aosp/1309853 )
Version 2.4.0-rc01
24 ژوئن 2020
androidx.work:work-*:2.4.0-rc01
is released. Version 2.4.0-rc01 contains these commits.
رفع اشکال
- The in-process scheduler now uses better APIs to determine the name of the process. This is useful to better support apps that use multiple-processes. ( aosp/1324732 )
Version 2.4.0-beta01
20 مه 2020
androidx.work:work-gcm:2.4.0-beta01
, androidx.work:work-runtime:2.4.0-beta01
, androidx.work:work-runtime-ktx:2.4.0-beta01
, androidx.work:work-rxjava2:2.4.0-beta01
, and androidx.work:work-testing:2.4.0-beta01
are released. Version 2.4.0-beta01 contains these commits.
رفع اشکال
- Fix a bug where the
ForegroundService
is not stopped after a foregroundWorker
is interrupted. ( b/155579898 , aosp/1302153 ) - Fix a bug where
WorkManager
attempts to execute multiple instances of aWorker
bound to a Foreground Service ( b/156310133 , aosp/1309853 ) - Add support for dynamically adding factories to delegate to, when using a
DelegatingWorkerFactory
. ( b/156289105 , aosp/1309745 ) - Align tracking for
BATTERY_NOT_LOW
constraints more closely with the platform. ( aosp/1312583 )
Version 2.4.0-alpha03
29 آوریل 2020
androidx.work:work-*:2.4.0-alpha03
is released. Version 2.4.0-alpha03 contains these commits.
ویژگی های جدید
- WorkManager now supports RxJava 3. To use RxJava 3, you should include the following dependency:
implementation "androidx.work:work-rxjava3:2.4.0-alpha03"
. ( aosp/1277904 ) - Added a new lint rule that ensures that
ListenableWorker
implementations are nowpublic
when using the defaultWorkerFactory
. ( aosp/1291262 )
تغییرات API
- Calling
setProgressAsync()
after aListenableWorker
has finished execution will now signal anException
via theListenableFuture
. ( aosp/1285494 ) -
WorkQuery.Builder
is now markedfinal
. ( aosp/1275037 ) -
WorkQuery.Builder
factory methodswithStates
,withTags
andwithUniqueWorkNames
have been renamed tofromStates
,fromTags
andfromUniqueWorkNames
respectively. ( aosp/1280287 )
رفع اشکال
- Ignore
SecurityException
s when tracking network state of a device. ( b/153246136 , aosp/1280813 )
Version 2.4.0-alpha02
1 آوریل 2020
androidx.work:work-*:2.4.0-alpha02
is released. Version 2.4.0-alpha02 contains these commits.
ویژگی های جدید
- Added a new Lint rule that warns when
WorkRequest
s requires bothConstraints.setRequiresCharging(...)
andConstraints.setRequiresDeviceIdle(...)
. Some devices are never charging and idle at the same time. So such requests would run less frequently than expected. ( aosp/1253840 )
تغییرات API
Added the ability to query for
WorkInfo
s by using aWorkQuery
. This is useful when developers want to queryWorkInfo
s by a combination of multiple attributes. For more information look atWorkQuery.Builder withStates(...)
,WorkQuery.Builder withTags(...)
orWorkQuery.Builder withUniqueWorkNames(...)
. ( aosp/1253230 , b/143847546 )Calls to
setForegroundAsync()
that do not complete before completion of aListenableWorker
will now be signalled via anIllegalStateException
on the returnedListenableFuture
. ( aosp/1262743 )
رفع اشکال
- Fixed the lint rule that checks for invalid interval durations for
PeriodicWorkRequest
s. ( aosp/1254846 , b/152606442 )
Version 2.4.0-alpha01
March 4, 2020
androidx.work:work-*:2.4.0-alpha01
is released. Version 2.4.0-alpha01 contains these commits.
ویژگی های جدید
WorkManager
s in-process scheduler is now more capable. Previously, the in-process Scheduler would only consider executing work that was not delayed and whose constraints were met. Now, the in-process scheduler tracksWorkRequest
s which might be executed in the future, includingPeriodicWorkRequest
s. The in-process Scheduler also does not observe scheduling limits (but is still restricted to the size of theExecutor
being used by WorkManager). This means that the application can now execute a lot moreWorkRequest
s when the app is in the foreground. ( aosp/1185778 )Added the ability to request diagnostic information from WorkManager using
adb shell am broadcast -a "androidx.work.diagnostics.REQUEST_DIAGNOSTICS" -p "<your_app_package_name>"
. This provides a lot of useful information including:- WorkRequests that were completed in the last 24 hours.
- WorkRequests that are currently RUNNING.
- Scheduled WorkRequests. ( aosp/1235501 )
New Lint rules which enforce:
- Use of the right
foregroundServiceType
when usingsetForegroundAsync()
APIs. ( b/147873061 , aosp/1215915 ) - Specifying
JobScheduler
ids thatWorkManager
should use when usingJobService
APIs directly. ( aosp/1223567 )
- Use of the right
تغییرات API
Add
ExistingWorkPolicy.APPEND_OR_REPLACE
which is similar toAPPEND
, but replaces a chain that has cancelled or failed prerequisites. ( b/134613984 , aosp/1199640 )Provide the ability to add a custom
RunnableScheduler
to trackWorkRequest
s that need to be executed in the future. This is used by the in-process Scheduler. ( aosp/1203944 )
رفع اشکال
- Deprecated
setProgress()
inRxWorker
because it previously returned aSingle<Void>
which is an impossible type. Added a new APIsetCompletableProgress()
which returns aCompletable
instead; and added new Lint rules which help migrate to the new APIs. ( b/150080946 , aosp/1242665 )
Version 2.3.4
Version 2.3.4
18 مارس 2020
androidx.work:work-*:2.3.4
is released. Version 2.3.4 contains these commits.
رفع اشکال
- Fixed a bug which would cause multiple instances of a long running
Worker
s to run, after exceeding the 10 minute execution window. ( aosp/1247484 , b/150553353 ) - Fix for WorkManager's lint
IssueRegistry
. Thank you @ZacSweers from Slack, for the contribution. ( aosp/1217923 )
نسخه 2.3.3
نسخه 2.3.3
March 4, 2020
androidx.work:work-*:2.3.3
is released. Version 2.3.3 contains these commits.
رفع اشکال
- Fixed a bug where if a
Worker
was interrupted, it would not get rescheduled correctly. ( b/150325687 , aosp/1246571 )
Version 2.3.2
Version 2.3.2
19 فوریه 2020
androidx.work:work-*:2.3.2
are released. Version 2.3.2 contains these commits.
رفع اشکال
- Fixes an issue where WorkManager exceeds the 100 job limit in JobScheduler in rare cases. ( aosp/1226859 , b/149092520 )
- Fix for a race condition in ConstraintControllers. ( aosp/1220100 )
- Improved the management foreground Service lifecycle for long running Workers. ( aosp/1226295 )
- Improved the management of cancellation of Notifications for long running Workers upon Worker cancellation. ( aosp/1228346 )
Version 2.3.1
Version 2.3.1
5 فوریه 2020
androidx.work:work-*:2.3.1
is released. Version 2.3.1 contains these commits .
رفع اشکال
- Better manage the lifecycle of
Notification
s for long runningWorker
s that run when a foregroundService
is active. ( aosp/1218539 , b/147249312 ) -
WorkManager
now depends onandroidx.sqlite:sqlite-framework:2.1.0
stable. ( aosp/1217729 ) - Added lint rules to ensure that a
foregroundServiceType
is specified in theAndroidManifest.xml
when usingforegroundServiceType
s inForegroundInfo
. ( aosp/1214207 , b/147873061 )
Version 2.3.0
Version 2.3.0
22 ژانویه 2020
androidx.work:work-*:2.3.0
is released with no changes since 2.3.0-rc01
. Version 2.3.0 contains these commits .
Important changes since 2.2.0
- Support for long running or important work via
ListenableWorker#setForegroundAsync()
. - Support for Worker Progress via
ListenableWorker#setProgressAsync()
. - WorkManager now packages additional lint rules as part of the library which helps catch bugs early.
Version 2.3.0-rc01
8 ژانویه 2020
androidx.work:work-*:2.3.0-rc01
is released. Version 2.3.0-rc01 contains these commits .
This release is identical to 2.3.0-beta02
رفع اشکال
- The
work-testing
artifact now defines anapi
dependency onwork-runtime-ktx
. ( aosp/1194410 )
Version 2.3.0-beta02
18 دسامبر 2019
androidx.work:work-*:2.3.0-beta02
is released. Version 2.3.0-beta02 contains these commits .
ویژگی های جدید
- Added a better error message for non-recoverable SQLite exceptions. ( aosp/1185777 )
- Added a lint rule which ensures that the content provider
androidx.work.impl.WorkManagerInitializer
is removed from theAndroidManifest.xml
when using on demand initialization. ( aosp/1167007 ) - Added a lint warning when
enqueue()
is used for aPeriodicWorkRequest
instead ofenqueueUniquePeriodicWork()
. ( aosp/1166032 )
API changes
-
ForegroundInfo
now requires you to specify thenotificationId
to be used when usingListenableWorker.setForegroundAsync()
. This is a breaking change. This allows you to run multiple long runningWorker
s in parallel.WorkManager
also better manages lifetimes of the providedNotification
s. ( b/145473554 , aosp/1181208 , asop/1181216 , asop/1183577 )
رفع اشکال
- Fixed a bug in the AlarmManager implementation where alarms were not being cleaned up correctly. ( aosp/1156444 )
- Fixed a bug where an empty list of
WorkRequest
s would cause an incorrectWorkContinuation
chain to be built. ( b/142835274 , aosp/1157051 )
Dependency changes
- WorkManager now uses Room 2.2.2.
Version 2.3.0-beta01
20 نوامبر 2019
androidx.work:work-*:2.3.0-beta01
is released. Version 2.3.0-beta01 contains these commits .
ویژگی های جدید
- Added a new lint rule which prevents developer errors due to incorrect implementation of
androidx.work.Configuration.Provider
when using on-demand initialization. aosp/1164559
Version 2.3.0-alpha03
23 اکتبر 2019
androidx.work:work-*:2.3.0-alpha03
is released. Version 2.3.0-alpha03 contains these commits .
ویژگی های جدید
- Added
WorkManager.createCancelPendingIntent()
API which makes it easy to cancelWorkRequest
s without having to register another component in theAndroidManifest.xml
. This API makes it especially easy to cancelWorkRequest
s fromNotification
s. We expect this to be paired with the new foreground APIs in 2.3.0. - WorkManager now depends on
androidx.room:*:2.2.0
stable.
API changes
- Renamed
ForegroundInfo.getNotificationType()
toForegroundInfo.getForegroundServiceType()
to be more consistent with the underlying platform APIs. ( b/142729893 , aosp/1143316 )
رفع اشکال
- Fixed a bug which is caused by an unnecessary call to
setTransactionSuccessful()
outside of a transaction. This happens for rare migrations. ( b/142580433 , aosp/1141737 )
Version 2.3.0-alpha02
9 اکتبر 2019
androidx.work:work-*:2.3.0-alpha02
is released. Version 2.3.0-alpha02 contains these commits .
ویژگی های جدید
- WorkManager now supports running long running or important work that should be kept alive by the OS. For more information look at
ListenableWorker#setForegroundAsync()
(orCoroutineWorker#setForeground()
for Kotlin). ( aosp/1133636 )
API changes
- The
containsKey
API inData
is renamed tohasKeyWithValueOfType
. The corresponding extension method in thektx
library has also been renamed. ( b/141916545 )
رفع اشکال
- WorkManager schedules work fairly when the number of
WorkRequest
s enqueued approach scheduling limits . ( aosp/1105766 ) - WorkManager calls
ListenableWorker#onStopped()
only if the work is not already completed. ( b/140055777 ) - WorkManager now removes progress information when a worker gets interrupted or reaches its terminal state. ( aosp/1114572 )
-
Data
now has a much more usefultoString()
representation. ( b/140945323 ) -
Data
now has a betterequals()
method. It also supportsdeepEquals
forArray
types. ( b/140922528 ) - WorkManager now stores its internal database and preference files in a no backup directory. ( b/114808216 )
Version 2.3.0-alpha01
22 آگوست 2019
androidx.work:work-*:2.3.September 5, 20190-alpha01
is released. The commits included in this version can be found here .
ویژگی های جدید
-
ListenableWorker
s can now set progress via thesetProgressAsync()
API. Also added a correspondingsuspend
-ingsetProgress
API inCoroutineWorker
and asetProgress
inRxWorker
which returns aSingle<Void>
. With these new APIs Workers can convey progress information viaWorkInfo
which has a correspondinggetProgress
API. ( b/79481554 ) -
Data
has acontainsKey()
API which can be used to validate that input data toWorker
s has keys with the expected type. ( b/117136838 ) -
Data
can now be serialized usingData.toByteArray()
andData.fromByteArray()
. Note that there are no versioning guarantees withData
so you should not persist it or use it for IPC between applications. They are only safe to be used between multiple processes of the same application. - Added the ability to specify an
InputMergerFactory
viaConfiguration.setInputMergerFactory
. ( b/133273159 )
API changes
- WorkManager will throw an instance of
IllegalStateException
if aWorkerFactory
returns an instance ofListenableWorker
which has been previously invoked. ( b/139554406 ) - Documentation updates around
ListenableFuture
cancellation and theonStopped()
callback inListenableWorker
. ( b/138413671 )
رفع اشکال
- The in-process Scheduler now ignores
WorkRequest
s with theidle
constraint. These requests are now only picked up byJobScheduler
when the device is actuallyidle
. ( aosp/1089779 ) -
TestScheduler
now correctly uses the specifiedExecutor
for its internal task executor in tests. ( aosp/1090749 )
Version 2.2.0
Version 2.2.0
15 آگوست 2019
androidx.work:work-*:2.2.0
is released. The commits included in this version can be found here .
This release is identical to androidx.work:work-*:2.2.0-rc01
.
Important Changes in 2.2.0 from 2.1.0
androidx.work:work-gcm:2.2.0
is a new Maven artifact which supports the use of GCMNetworkManager as a scheduler when Google Play Services is available for API levels <= 22. This is an optional dependency that helps with more reliable and performant background processing on older API versions. If your app uses Google Play Services, add this dependency to your gradle file to automatically get GCMNetworkManager support. If Play Services is not available, WorkManager will continue to fall back to AlarmManager on older devices.
Version 2.2.0-rc01
30 جولای 2019
androidx.work:work-*:2.2.0-rc01
is released. The commits included in this version can be found here .
رفع اشکال
- Fixed a bug in the AlarmManager implementation that causes the Service to shutdown prematurely and resulting in a
RejectedExecutionException
in rare cases. ( aosp/1092374 ) ( b/138238197 ). - Added a workaround for a
NullPointerException
when usingJobScheduler
APIs on some devices. ( aosp/1091020 ) ( b/138364061 ), ( b/138441699 )
Version 2.2.0-beta02
19 جولای 2019
androidx.work:work-*:2.2.0-beta02
is released. The commits included in this version can be found here .
رفع اشکال
- Removed unintentional jacoco dependency that was introduced in
2.2.0-beta01
.
Version 2.2.0-beta01
17 جولای 2019
androidx.work:work-*:2.2.0-beta01
is released. The commits included in this version can be found here .
ویژگی های جدید
-
androidx.work:work-gcm:2.2.0-beta01
is a new Maven artifact which supports the use of GCMNetworkManager as a scheduler when Google Play Services is available for API levels <= 22. This is an optional dependency that helps with more reliable and performant background processing on older API versions. If your app uses Google Play Services, add this dependency to your gradle file to automatically get GCMNetworkManager support. If Play Services is not available, WorkManager will continue to fall back to AlarmManager on older devices.
رفع اشکال
- Fix for
IllegalArgumentException
when tracking network state on Nvidia Shield K1 tablets. ( aosp/1010188 )
نسخه 2.1.0
نسخه 2.1.0
11 جولای 2019
androidx.work:work-*:2.1.0
is released. This release is identical to androidx.work:work-*:2.1.0-rc01
.
Important changes since 2.0.1
-
work-runtime-ktx
now requires Java 8. If you run into any issues, you can add the following to yourbuild.gradle
:kotlinOptions { jvmTarget = "1.8" }
- Added on-demand initialization for WorkManager, which will create WorkManager only when referenced. b/127497100 To set up your project for on-demand initialization:
- Disable the automatic initializer .
- Implement
Configuration.Provider
on your customApplication
object. - Change all references of
WorkManager.getInstance()
toWorkManager.getInstance(Context)
. As part of this change, we have deprecatedWorkManager.getInstance()
. It is always safer to call the newWorkManager.getInstance(Context)
replacement, even if you're not doing on-demand initialization.
-
PeriodicWorkRequest
s now support initial delays. You can use thesetInitialDelay
method onPeriodicWorkRequest.Builder
to set an initial delay. b/111404867 - Added the ability to delegate to one or more registered
WorkerFactory
s usingDelegatingWorkerFactory
. b/131435993 - Added the ability to customize the
Executor
used by WorkManager for all its internal book-keeping viaConfiguration.Builder.setTaskExecutor
. - Added the ability to create unit testable
Worker
andListenableWorker
classes by usingTestWorkerBuilder
andTestListenableWorkerBuilder
in thework-testing
artifact.- Note that
work-testing
now pulls in Kotlin as a dependency and includes several Kotlin extensions by default.
- Note that
- Added run attempt count to
WorkInfo
. b/127290461 -
Data
types can now store and retrieve bytes and byte arrays. This does NOT change the maximum size ofData
objects. - WorkManager now depends on
Room 2.1.0
, which should fix some database issues.
Version 2.1.0-rc01
27 ژوئن 2019
androidx.work:work-*:2.1.0-rc01
is released. The commits included in this version can be found here .
رفع اشکال
- Fixed a bug which would cause an application to crash when executing jobs with
JobScheduler
while a backup was in progress b/135858602 .
Version 2.1.0-beta02
20 ژوئن 2019
androidx.work:work-*:2.1.0-beta02
is released. The commits included in this version can be found here .
رفع اشکال
-
TestListenableWorkerBuilder
now uses the correctWorkerFactory
when creating instances ofListenableWorker
. b/135275844 - Fixed a bug which caused drifts in the execution windows for
WorkRequest
s due to process death. b/135272196
Version 2.1.0-beta01
13 ژوئن 2019
androidx.work:work-*:2.1.0-beta01
is released. The commits included in this version can be found here .
رفع اشکال
- WorkManager now depends on
Room 2.1.0
, which should fix some database issues. - Removed some startup disk I/O on the main thread.
- Fixed a potential deadlock in constraint tracking. b/134361006
- Preemptively cancelled invalid jobs attributed to WorkManager. b/134058261
- Added some defensive calls to JobScheduler APIs for misbehaving devices.
Version 2.1.0-alpha03
5 ژوئن 2019
androidx.work:*:2.1.0-alpha03
is released.
رفع اشکال
- Improved documentation for
PeriodicWorkRequest
s. -
WorkManagerTestInitHelper
now uses the correct background executor for tests. - Fixes for SQLite issues when dealing with large transactions on some devices. ( b/130182503 )
- WorkManager's dependencies are now more granular. ( b/133169148 ).
- Workaround OEM specific bugs in the implementation of
JobScheduler
when scheduling jobs using WorkManager. - Improvements in the AlarmManager based scheduler around service lifetimes that previously caused rare crashes. ( b/133313734 )
Version 2.1.0-alpha02
16 مه 2019
WorkManager 2.1.0-alpha02 is released. This version contains several new APIs.
تغییرات API
PeriodicWorkRequest
s now support initial delays. You can use thesetInitialDelay
method onPeriodicWorkRequest.Builder
to set an initial delay. b/111404867Added the ability to delegate to one or more registered
WorkerFactory
s usingDelegatingWorkerFactory
. b/131435993Added the ability to customize the
Executor
used by WorkManager for all its internal book-keeping viaConfiguration.Builder.setTaskExecutor
.Improved documentation around
WorkRequest.keepResultsForAtLeast
( b/130638001 ), on-demand initialization, andPeriodicWorkRequest.Builder
( b/131711394 ).
Version 2.1.0-alpha01
24 آوریل 2019
WorkManager 2.1.0-alpha01 is released. This version contains several new APIs. Please note that starting with this version, there will be new features that won't get backported to the 1.x release. We recommend switching to 2.x.
تغییرات API
- Added on-demand initialization for WorkManager, which will create WorkManager only when referenced. b/127497100 To set up your project for on-demand initialization:
- Disable the automatic initializer .
- Implement
Configuration.Provider
on your customApplication
object. - Change all references of
WorkManager.getInstance()
toWorkManager.getInstance(Context)
. As part of this change, we have deprecatedWorkManager.getInstance()
. It is always safer to call the newWorkManager.getInstance(Context)
replacement, even if you're not doing on-demand initialization.
- Added the ability to create unit testable
Worker
andListenableWorker
classes by usingTestWorkerBuilder
andTestListenableWorkerBuilder
in thework-testing
artifact.- Note that
work-testing
now pulls in Kotlin as a dependency, but also includes several Kotlin extensions by default.
- Note that
- Added run attempt count to
WorkInfo
. b/127290461 -
Data
types can now store and retrieve bytes and byte arrays. This does NOT change the maximum size ofData
objects. - Deprecated
CoroutineWorker.coroutineContext
. This field was incorrectly typed as aCoroutineDispatcher
; you should no longer need it as you can go to the desired coroutineContext yourself in the body of the suspending function. -
RxWorker.createWork()
andRxWorker.getBackgroundScheduler()
are now annotated with@NonNull
return types.
نسخه 2.0.1
نسخه 2.0.1
9 آوریل 2019
WorkManager 2.0.1 is released. This release is identical to 2.0.1-rc01 .
Version 2.0.1-rc01
3 آوریل 2019
WorkManager 2.0.1-rc01 is released. This version contains some bug fixes. For legacy 1.x users, some of these changes also appear in 1.0.1-rc01 .
رفع اشکال
- Robolectric tests now operate properly with WorkManager. b/122553577
- Fixed an edge case crash with constraints tracking not being cleaned up on pre-JobScheduler APIs. b/129226383
- Fixed a
StackOverflowError
dealing with long chains of work. b/129091233 - Updated documentation for
PeriodicWorkRequest
s to indicate that flex time is not supported on API 23. - Fixed some broken links in the Kotlin documentation.
نسخه 2.0.0
نسخه 2.0.0
20 مارس 2019
WorkManager 2.0.0 is released. This version is identical to 2.0.0-rc01 and is the AndroidX version of 1.0.0 stable with AndroidX dependencies. We recommend targeting this version instead of the legacy 1.x versions. All active development will target 2.x and 1.x will only receive critical bug fixes for a limited time.
Version 2.0.0-rc01
7 مارس 2019
WorkManager 2.0.0-rc01 is released. This version is identical to 1.0.0 stable but has AndroidX dependencies. Once this reaches 2.0.0 stable, you should include this version and the legacy 1.x versions will only receive some critical bug fixes. All active development will target 2.x.
Pre-AndroidX Dependencies
Reference docs: Java
شیار
dependencies { def work_version = "1.0.1" // (Java only) implementation "android.arch.work:work-runtime:$work_version" // Kotlin + coroutines implementation "android.arch.work:work-runtime-ktx:$work_version" // optional - RxJava2 support implementation "android.arch.work:work-rxjava2:$work_version" // optional - Test helpers androidTestImplementation "android.arch.work:work-testing:$work_version" }
کاتلین
dependencies { val work_version = "1.0.1" // (Java only) implementation("android.arch.work:work-runtime:$work_version") // Kotlin + coroutines implementation("android.arch.work:work-runtime-ktx:$work_version") // optional - RxJava2 support implementation("android.arch.work:work-rxjava2:$work_version") // optional - Test helpers androidTestImplementation("android.arch.work:work-testing:$work_version") }
نسخه 1.0.1
نسخه 1.0.1
9 آوریل 2019
WorkManager 1.0.1 is released. This release is identical to 1.0.1-rc01 .
Please note that we strongly encourage users to update to WorkManager 2.x, as there will be very few updates to the 1.x branch moving forward. New APIs will also not be released for the 1.x library.
Version 1.0.1-rc01
2 آوریل 2019
WorkManager 1.0.1-rc01 is released. This version contains some bug fixes.
رفع اشکال
- Robolectric tests now operate properly with WorkManager. b/122553577
- Fixed an edge case crash with constraints tracking not being cleaned up on pre-JobScheduler APIs. b/129226383
- Fixed a
StackOverflowError
dealing with long chains of work. b/129091233
نسخه 1.0.0
نسخه 1.0.0
March 05, 2019
This is WorkManager's 1.0.0 stable release. This version of WorkManager is identical to 1.0.0-rc02.
Version 1.0.0-rc02
21 فوریه 2019
This is the second release candidate for WorkManager's 1.0.0 stable release. This release contains two bug fixes.
رفع اشکال
Worker
s are now correctly scheduled after an application crash. b/124546316Worker
s that throw an uncheckedException
are now correctly marked asFAILED
and no longer crash the app process.
نسخه 1.0.0-RC01
14 فوریه 2019
This is a release candidate for WorkManager's 1.0.0 stable release. This release contains one bug fix.
رفع اشکال
- The AlarmManager based implementation now correctly respects
flex
windows for PeriodicWorkRequests. b/124274584
Version 1.0.0-beta05
6 فوریه 2019
This release contains some bug fixes.
رفع اشکال
- Fixed a case where
JobScheduler.getPendingJob(...)
was used on API 23. b/123893059 - Fixed a
NullPointerException
on devices running Android 5.1 (API level 22) or lower. b/123835104
Version 1.0.0-beta04
4 فوریه 2019
This release contains some bug fixes.
رفع اشکال
- Improved scheduling of PeriodicWork for the AlarmManager based implementation.
- Fixed a case where WorkManager failed to correctly track constraints when using the AlarmManager based implementation. b/123379508
- Fixed a case when WorkManager failed to retry work on process death when using the AlarmManager based implementation. b/123329850
- Fixed a case which would cause WorkManager to leak Wakelocks when using the AlarmManager based implementation.
نسخه 1.0.0-beta03
25 ژانویه 2019
This release contains some bug fixes.
رفع اشکال
- We introduced a regression
1.0.0-beta02
that was causing work to not execute properly in some situations. b/123211993 - Fixed a case where work wasn't properly honoring backoff timing. b/122881597
- Fixed a
ConcurrentModificationException
on devices running Android 5.1 (API or) or lower. This is a continuation of the fix in1.0.0-beta02
. b/121345393 - Added
exported=false
for some components in our manifest that were missing this annotation. - Included information about how WorkManager interacts with the OS in the package-level documentation.
نسخه 1.0.0-beta02
15 ژانویه 2019
This release contains some bug fixes.
رفع اشکال
- Fixed an edge case where periodic work could run more than once per interval on devices running Android 6.0 (API level 23). b/121998363
- Fixed a
ConcurrentModificationException
on devices running Android 5.1 (API level 22) or lower. b/121345393 - Fixed erroneous execution of work when Constraints aren't met on devices running Android 5.1 (API level 22) or lower. b/122578012
- Optimized work completion handling to be faster in some edge cases. b/122358129
- Added a change to address potential race conditions among multiple instances of
LiveData
that WorkManager uses. - Moved to use
Room
dependency1.1.1
instead of1.1.1-rc01
; these versions are identical. b/122578011
نسخه 1.0.0-beta01
19 دسامبر 2018
This release contains no API changes; moving forward, WorkManager is expected to stay API stable until the next version unless there is a critical problem. This release contains some bug fixes.
رفع اشکال
- Previously-cancelled children of successfully completed parent work will no longer run. b/120811767
- Properly initialized logging classes (primarily surfaced during tests).
نسخه 1.0.0-alpha13
12 دسامبر 2018
This release contains a minor API change that will be helpful for some Kotlin users.
تغییرات API
-
androidx.work.Result
has been moved to be an inner class ofListenableWorker
. This prevents refactoring conflicts with Kotlin's top-levelResult
class. This is a breaking API change. b/120564418
Breaking API Changes
-
androidx.work.Result
has been moved to be an inner class ofListenableWorker
.
نسخه 1.0.0-alpha12
5 دسامبر 2018
This release contains some breaking API changes; please see the Breaking API Changes section below. This version is likely to be released as our first beta. alpha12
also contains extensive documentation updates.
تغییرات API
- A new artifact,
work-rxjava2
, introducesRxWorker
. This is aListenableWorker
that expects aSingle<Payload>
. - Support for Firebase JobDispatcher has been removed because of its impending deprecation. This means that the
work-firebase
artifact will no longer be updated as we head into beta. We will be looking into adding an alternative in the future. - Combined
Payload
intoResult
.Result
is now a "sealed class" with three concrete implementations, which you can obtain viaResult.success()
(orResult.success(Data)
),Result.failure()
(orResult.failure(Data)
), andResult.retry()
. YourListenableFuture
s now resultResult
instead ofPayload
.Worker
s don't have getter and setter methods for outputData
. This is a breaking change. - Added
Constraints.Builder.setTriggerContentMaxDelay(long, TimeUnit)
andConstraints.Builder.setTriggerContentUpdateDelay(long, TimeUnit)
and variants to better support slow triggering content URIs. b/119919774 - Added
WorkRequest.Builder.setBackoffCriteria(BackoffPolicy, Duration)
variant. This method requires API 26. - Added
Operation.await()
andListenableFuture.await()
Kotlin extension methods. - Renamed
Operation.getException()
toOperation.getThrowable()
. This is a breaking change. - The
ContentUriTriggers
class and methods referencing it are no longer available for public usage. This is a breaking change. - Removed the rest of the varargs methods in
WorkManager
,WorkContinuation
, andOneTimeWorkRequest
to streamline the API. To fix any build problems, you can wrap your existing varargs withArrays.asList(...)
. We still include single-argument versions of each method. This is a breaking change. - Removed
WorkContinuation.combine(OneTimeWorkRequest, *)
variants. They were presenting a confusing API; the existingcombine
methods are more understandable. This is a breaking change.
رفع اشکال
- Pre-Marshmallow implementations are now more reliable in recovering from process death of an already-executing task.
-
LiveData
that is observed viaobserveForever
is tracked via WorkManager. This is a backport of a Room library fix. b/74477406 -
Data.Builder.build()
now throws an exception if the serialized object exceeds its maximum size. This previously would only happen on a background thread where you couldn't properly handle it. - Further distinguished stopped vs. cancelled work;
getWorkInfoById()
will return aWorkInfo
with theCANCELLED
State
duringListenableWorker.onStopped()
. - Treat
null
Result
s as failures inListenableWorker
. b/120362353 - Speculative fix for Shield Tablets running API 24 that sometimes threw an
IllegalArgumentException
. b/119484416
Breaking API Changes
- Support for Firebase JobDispatcher has been removed because of its impending deprecation. This means that the
work-firebase
artifact will no longer be updated as we head into beta. We will be looking into adding an alternative in the future. - Combined
Payload
intoResult
.Result
is now a "sealed class" with three concrete implementations, which you can obtain viaResult.success()
(orResult.success(Data)
),Result.failure()
(orResult.failure(Data)
), andResult.retry()
. YourListenableFuture
s now resultResult
instead ofPayload
.Worker
s don't have getter and setter methods for outputData
. - Added
Operation.await()
andListenableFuture.await()
Kotlin extension methods. - Renamed
Operation.getException()
toOperation.getThrowable()
. - The
ContentUriTriggers
class and methods referencing it are no longer available for public usage. - Removed the rest of the varargs methods in
WorkManager
,WorkContinuation
, andOneTimeWorkRequest
to streamline the API. To fix any build problems, you can wrap your existing varargs withArrays.asList(...)
. We still include single-argument versions of each method. - Removed
WorkContinuation.combine(OneTimeWorkRequest, *)
variants. They were presenting a confusing API; the existingcombine
methods are more understandable.
نسخه 1.0.0-alpha11
8 نوامبر 2018
This release contains many changes that will become stable API at beta
. There are breaking API changes in this release; please see the Breaking API Changes section below.
تغییرات API
-
work-runtime-ktx
introduces a newCoroutineWorker
. -
WorkStatus
has been renamed toWorkInfo
. All correspondinggetStatus
method variants have been renamed to the correspondinggetWorkInfo
variants. This is a breaking change. -
ListenableWorker.onStopped()
no longer accepts has a boolean argument representing if theWorkRequest
was cancelled.WorkManager
no longer makes this distinction. This is a breaking change. -
androidx.work.test
package has been renamed toandroidx.work.testing
package. This is a breaking change. - Setters on
Constraints
are no longer a part of the public API. This is a breaking change. -
WorkerParameters.getTriggeredContentUris()
andWorkerParameters.getTriggeredContentAuthorities()
previously returned arrays. Now these methods return Collections. This is a breaking change. -
ListenableWorker.onStartWork()
is renamed toListenableWorker.startWork()
. This is a breaking change. - The constructor for
WorkStatus
is no longer a part of the public API. This is a breaking change. -
Configuration.getMaxJobSchedulerID()
andConfiguration.getMinJobSchedulerID()
are renamed toConfiguration.getMinJobSchedulerId()
andConfiguration.getMaxJobSchedulerId()
respectively. This is a breaking change. - Added a lot of
@NonNull
annotations to the public API to improve ergonomics of the API. - Add
WorkManager.enqueueUniqueWork()
API to enqueue uniqueOneTimeWorkRequest
s without having to create aWorkContinuation
. - All variants of
enqueue
andcancel
methods onWorkManager
now return a newOperation
type. This is a breaking change. - All variants of
enqueue
no longer accept varargs forWorkRequest
s. This is a breaking change. Use Collections instead. You can useArrays.asList()
to modify existing code. We did this to reduce the API surface and method count. - Attempting to
initialize
WorkManager
more than once per process will now result in anIllegalStateException
. This is a breaking change.
رفع اشکال
-
WorkRequest.Builder
s in thework-runtime-ktx
artifact now useListenableWorker
s. Fixes b/117666259 - Ensure the next run time for
PeriodicWork
is in the future. Fixes b/118204399 - Remove potential disk I/O when using WorkManager on app startup. Fixes b/117796731
- Fix a race condition in
WorkConstraintsTracker
. Fixes android-workmanager/issues/56
Breaking API Changes
-
WorkStatus
has been renamed toWorkInfo
. All correspondinggetStatus
method variants have been renamed to the correspondinggetWorkInfo
variants. -
ListenableWorker.onStopped()
no longer accepts has a boolean argument representing if theWorkRequest
was cancelled.WorkManager
no longer makes this distinction. -
androidx.work.test
package has been renamed toandroidx.work.testing
package. - Setters on
Constraints
are no longer a part of the public API. -
WorkerParameters.getTriggeredContentUris()
andWorkerParameters.getTriggeredContentAuthorities()
previously returned arrays. Now these methods return Collections. -
ListenableWorker.onStartWork()
is renamed toListenableWorker.startWork()
. - The constructor for
WorkStatus
is no longer a part of the public API. -
Configuration.getMaxJobSchedulerID()
andConfiguration.getMinJobSchedulerID()
are renamed toConfiguration.getMinJobSchedulerId()
andConfiguration.getMaxJobSchedulerId()
respectively. - All variants of
enqueue
andcancel
methods onWorkManager
now return a newOperation
type. - All variants of
enqueue
no longer accept varargs forWorkRequest
s. - Attempting to
initialize
WorkManager
more than once per process will now result in anIllegalStateException
.
نسخه 1.0.0-alpha10
11 اکتبر 2018
This release supports developer-controlled asynchronous work. There are breaking API changes in this release; please see the Breaking API Changes section below.
We anticipate that WorkManager is entering the final phases of its alpha period. We expect to be API stable in beta, so please take some time to file your feedback on our issue tracker.
تغییرات API
- Removed all previously
deprecated
methods and classes, notably the defaultWorker
constructor. This is a breaking API change. - Renamed
NonBlockingWorker
toListenableWorker
, which is now an unhidden public class and ready for usage.-
ListenableWorker
provides access to one abstract method,ListenableFuture<Payload> onStartWork()
which is called on the main thread. It is up to you to start and process work asynchronously. When finished, you should update theListenableFuture
appropriately. Reference implementations ofListenableFuture
s are provided in theFutures
package inalpha02
(see below theWorkManager
section). -
Worker
extendsListenableWorker
and still operates as before, with an abstractResult doWork()
method. - Shuffled some methods and members from
Worker
toListenableWorker
. - We shall soon provide reference implementations for
ListenableWorker
s that use Kotlin coroutines (once the stable versions are released) and RxJava2.
-
- The interface
WorkerFactory
and the concrete implementationDefaultWorkerFactory
have been merged into an abstract class calledWorkerFactory
. The implementation ensures that the default reflection-based behavior is called as a last-ditch effort for any user-createdWorkerFactory
instances. This is a breaking change. - Removed
WorkManager.synchronous()
andWorkContinuation.synchronous()
and all related methods. AddedListenableFuture<Void>
as the return type of many methods in the API. This is a breaking API change.- You can now synchronously get and observe by using
ListenableFuture
s. For example,WorkManager.enqueue()
used to returnvoid
; it now returns aListenableFuture<Void>
. You can callListenableFuture.addListener(Runnable, Executor)
orListenableFuture.get()
to run code once the operation is complete. - Note that these
ListenableFuture
s do not tell you if the operation succeeded or failed; only that they finished. You will still need to chain WorkManager methods to find out this information. - We ignore
cancel()
calls on these objects, as they are confusing and hard to reason about (are you cancelling the operation or the resulting work?). This is within theFuture
s contract. - To maintain parity with the synchronous
getStatus*
methods, we have providedListenableFuture
variants, and renamed the existing ones that returnedLiveData
to explicitly have "LiveData" as part of the name (for example,getStatusesByIdLiveData(UUID)
). This is a breaking API change.
- You can now synchronously get and observe by using
رفع اشکال
- Fixed the known issue from alpha09 regarding duplicate
androidx-annotations.pro
files. You may remove the workaround from the previous release notes by deletingexclude 'META-INF/proguard/androidx-annotations.pro'
from your gradle file. - Added proguard configurations to keep new
Worker
constructor. b/116296569 - Fix potential
NullPointerException
in a race condition where work wasREPLACE
d. b/116253486 and b/116677275 -
WorkContinuation.combine()
now accepts one or moreWorkContinuation
s instead of two or more. b/117266752
Breaking API Changes
- Removed all previously
deprecated
methods and classes, notably the defaultWorker
constructor. - The interface
WorkerFactory
and the concrete implementationDefaultWorkerFactory
have been merged into an abstract class calledWorkerFactory
. - Removed
WorkManager.synchronous()
andWorkContinuation.synchronous()
. -
WorkManager.getStatus*()
methods now returnListenableFuture
s.WorkManager.getStatus*LiveData()
returnLiveData
s.
نسخه 1.0.0-alpha09
19 سپتامبر 2018
موضوع شناخته شده
If you run into the following issue: "More than one file was found with OS independent path 'META-INF/proguard/androidx-annotations.pro'", please put the following in your gradle file as a temporary workaround while we fix the issue in alpha10:
شیار
android { packagingOptions { exclude 'META-INF/proguard/androidx-annotations.pro' } }
کاتلین
android { packagingOptions { exclude("META-INF/proguard/androidx-annotations.pro") } }
رفع اشکال
- Added another fix that was needed for the "100 jobs" error. b/115560696
- Added some fixes for foreign key constraint errors due to race conditions. b/114705286
- Delegated
ConstraintTrackingWorker.onStopped(boolean)
calls to the underlyingWorker
. b/114125093 - Enforce correct minimum backoff delay for Firebase JobDispatcher. b/113304626
- Improved threading guarantees internal to the library.
- Correct potential issue with deduping of
LiveData
internally.
تغییرات API
- You can now create your own
Worker
instances at runtime by specifying aWorkerFactory
as part of theWorkManager.Configuration
. The fallback factory isDefaultWorkerFactory
, which matches behavior of previous versions of WorkManager.- The default constructors for
Worker
andNonBlockingWorker
are now marked as deprecated. Please use the new constructor (Worker(Context, WorkerParameters)
) and callsuper(Context, WorkerParameters)
; future versions of WorkManager will remove the default constructor.
- The default constructors for
- We have started using the new
ListenableFuture
artifact internally (free of Guava dependencies). We will introduce ListenableFutures to the API in upcoming releases. This change will support the eventual unhiding ofNonBlockingWorker
. - Add ability to trigger timed work in
TestDriver
viaTestDriver.setInitialDelayMet(UUID)
andTestDriver.setPeriodDelayMet(UUID)
. b/113360060
شکستن تغییرات
- The default
Worker
andNonBlockingWorker
constructors are deprecated. Please migrate to the new constructor ASAP. Future versions will remove the default constructor.
نسخه 1.0.0-alpha08
27 آگوست 2018
رفع اشکال
- Explicitly labelled WorkManager components as direct boot unaware so they don't fire up during direct boot. In the future, we will provide a version of WorkManager that is direct boot-aware. b/112665532
- Fixed an issue where retried work was not running. b/112604021
- Fixed periodic work not executing repeatedly (related to the above issue). b/112859683
- Honored backoff policies when the app process is already running.
- Corrected exception messages in
Data
to indicate the limit is 10KB. - Lowered maximum value of
Configuration.setMaxSchedulerLimit(int)
to 50 to account for some latency inJobScheduler
processing completion. b/112817355
نسخه 1.0.0-alpha07
16 آگوست 2018
رفع اشکال
- Fixed a potential SQL query with negative limits that could return an unbounded number of results.
- Work that has finished execution now correctly cancels all pending copies of that work in other Schedulers. This led to exceeding the
JobScheduler
jobs limit. b/111569265 - Fixed a
ConcurrentModificationException
inConstraintTracker
. b/112272753 - Changed return type annotations of
Data.getBooleanArray(String)
andData.getIntArray(String)
to@Nullable
instead of@NonNull
. b/112275229
تغییرات API
-
Worker
now extends a new class,NonBlockingWorker
. This does not affect any current usage. In the future,NonBlockingWorker
will become a fully supported entity for custom threading solutions. - Changed return type annotations of
Data.getBooleanArray(String)
andData.getIntArray(String)
to@Nullable
instead of@NonNull
. b/112275229 - Kotlin extensions: deprecated
Map.toWorkData()
and added a top-levelworkDataOf(vararg Pair<String, Any?>)
to be more consistent with existing APIs.
نسخه 1.0.0-alpha06
1 آگوست 2018
رفع اشکال
- Prevent a database lock when scheduling work. b/111801342
- Fix a bug which causes
PeriodicWork
to not run on schedule when in Doze mode. b/111469837 - Fix a race condition when tracking constraints which causes
WorkManager
to crash. googlecodelabs/android-workmanager/issues/56 - Create unique
WorkRequest
s when usingWorkRequest.Builder#build()
. b/111408337 - Enable the use of
RescheduleReceiver
only when there areWorkRequest
s that need it. b/111765853
نسخه 1.0.0-alpha05
24 جولای 2018
تغییرات API
-
WorkManager.getInstance()
is now annotated with@NonNull
instead of@Nullable
. Instead, if the singleton isn't properly initialized in cases of manual initialization, the method will throw anIllegalStateException
. This is a breaking API change. - Added a new API,
Configuration.Builder.setMinimumLoggingLevel(int)
, which can control WorkManager verbosity. By default, WorkManager logsLog.INFO
and above. - Changed signature of
Data.getString()
so it no longer takes a default value (it is implicitlynull
). This is a breaking API change. - Marked some methods needed only for internal usage as
@hide
. This includes theConstraints
constructor,Data.toByteArray()
, andData.fromByteArray(byte[])
. This is a breaking API change.
رفع اشکال
- WorkManager no longer executes work during known cases of auto-backup. This could have resulted in a crash. b/110564377
- Fixed double-scheduling of
PeriodicWorkRequest
s when usingJobScheduler
. b/110798652 - Fixed an issue with
PeriodicWorkRequest
s not executing correctly after device doze. b/111469837 - Fixed an issue with initial delays when using Firebase JobDispatcher. b/111141023
- Fixed some potential race conditions and timing issues.
- Correctly freed up
BroadcastReceiver
s that were no longer needed. - Optimized rescheduling performance when apps restart after being force closed.
- Allowed
TestScheduler.setAllConstraintsMet(UUID)
to be called before or after enqueuing the givenWorkRequest
. b/111238024
شکستن تغییرات
-
WorkManager.getInstance()
is now annotated with@NonNull
instead of@Nullable
. - Changed signature of
Data.getString()
so it no longer takes a default value (it is implicitlynull
). - Marked some methods needed only for internal usage as
@hide
. This includes theConstraints
constructor,Data.toByteArray()
, andData.fromByteArray(byte[])
.
نسخه 1.0.0-alpha04
26 ژوئن 2018
رفع اشکال
-
PeriodicWorkRequest
s are now correctly rescheduled when using theAlarmManager
based implementation. - Fixed a potential ANR when rescheduling all workers after a force stop or a reboot. b/110507716
- Added nullability annotations to various WorkManager APIs. b/110344065
- Log uncaught exceptions that occur during Worker execution. b/109900862
- Allowed destructive database migrations in case you decide to roll back to an older version of WorkManager. b/74633270
- Fixed a migration crash if creating duplicate implicit tags. This is a very rare issue that occurred only if you used the same implicit tag format yourself.
نسخه 1.0.0-alpha03
19 ژوئن 2018
رفع اشکال
Fixed a race condition in the
AlarmManager
based implementation. b/80346526 .Fixed duplicate jobs when using
JobScheduler
after a device reboot.Jobs with Content URI triggers now persist across reboots. b/80234744
به روز رسانی اسناد b/109827628 , b/109758949 , b/80230748
Fixed a crash when re-enqueuing a
WorkRequest
. b/109572353 .Fixed Kotlin compiler warnings when using the
work-runtime-ktx
dependency.WorkManager now uses
Room
version1.1.1-rc1
.
تغییرات API
- Added
getStatusesSync()
, the synchronous version ofWorkContinuation.getStatuses()
. -
Worker
has the ability to distinguish between user-initiated cancellation and temporary os-requested stopping.Worker.isStopped()
returnstrue
if any kind of stop has been requested.Worker.isCancelled()
returnstrue
when the work has been explicitly cancelled. b/79632247 - Add support for JobParameters#getNetwork() on API 28. This is exposed via
Worker.getNetwork()
. - Added
Configuration.Builder.setMaxSchedulerLimit(int maxSchedulerLimit)
so you can enforce how many jobs can be sent toJobScheduler
orAlarmManager
. This helps preventWorkManager
from taking all your availableJobScheduler
slots. - Added
Configuration.setJobSchedulerJobIdRange(int minJobSchedulerId, int maxJobSchedulerId)
which helps define a range ofJobScheduler
job ids safe forWorkManager
to use. b/79996760 -
Worker.getRunAttemptCount()
returns the current run count for a givenWorker
. b/79716516 -
WorkManager.enqueueUniquePeriodicWork(String uniqueWorkName, ExistingPeriodicWorkPolicy existingPeriodicWorkPolicy, PeriodicWorkRequest periodicWork)
allows you to enqueue a uniquePeriodicWorkRequest
s. b/79600647 -
WorkManager.cancelAllWork()
cancels allWorker
s. Libraries that depend onWorkManager
can query when this method was called last by usingWorkManager.getLastCancelAllTimeMillis()
for additional cleanup of internal state. - Added
WorkManager.pruneWork()
to remove completed jobs from the internal database. b/79950952 , b/109710758
Behavior Changes
- Added an implicit tag for all
WorkRequest
s, which is the fully qualified class name for theWorker
. This allows the ability to removeWorkRequest
s withouttag
s or when theid
is not available. b/109572351
شکستن تغییرات
- Renamed
Worker.WorkerResult
toWorker.Result
. -
Worker.onStopped
now has an additionalisCancelled
parameter which is set totrue
when theWorker
has explicitly been cancelled.
نسخه 1.0.0-alpha02
24 مه 2018
رفع اشکال
- Fixed a
NullPointerException
onState.isFinished()
. b/79550068 - Fixed an issue which caused
Worker
s to be rescheduled onApplication.onCreate()
. b/79660657 - Fixed an issue where you could schedule more work than is allowed by the OS. b/79497378
- Moved cleanup of wake locks associated with
Worker
s to the background thread. - The
AlarmManager
implementation now correctly cleans up when all pending work is complete. - Fixed cleanup SQL queries which affected non-English locales. b/80065360
- Added support for
float
s inData
. b/79443878 -
Data.Builder.putAll()
now returns an instance of theBuilder
. b/79699162 - More javadoc and fixes in documentation. b/79691663
تغییرات API
-
Worker
s can react to being stopped.Worker.isStopped()
can be used to check if aWorker
has been stopped.Worker.onStopped()
can be used to perform lightweight cleanup operations. -
Worker.getTags()
API returns aSet
of tags associated with theWorker
. - Added
javax.time.Duration
overloads for APIs which take a combination of duration andTimeUnit
s. This is guarded by@RequiresApi(26)
. -
WorkManager
extensions have moved from theandroidx.work.ktx
package to theandroidx.work
package. The old extensions are deprecated and will be removed in a future version. -
Configuration.withExecutor()
is deprecated. UseConfiguration.setExecutor()
instead.
نسخه 1.0.0-alpha01
8 مه 2018
WorkManager simplifies scheduling and execution of guaranteed, constraint-aware background work. This initial release is 1.0.0-alpha01
.