Менеджер работ

Менеджер работ

Руководство пользователя Пример кода Codelab

Справочник API
androidx.work
androidx.work.testing

API WorkManager упрощает планирование отложенных асинхронных задач, которые должны выполняться надежно. Эти API позволяют создать задачу и передать ее в WorkManager для выполнения, когда будут соблюдены ограничения по объему работы.

Примечание: Для работы WorkManager требуется версия compileSdk 33 или выше.

Последнее обновление	Стабильный релиз	Предварительная версия для выпуска	Бета-версия	Альфа-версия
28 января 2026 г.	2.11.1	-	-	-

Объявление зависимостей

Чтобы добавить зависимость от WorkManager, необходимо добавить репозиторий Google Maven в ваш проект:

Добавьте зависимости для необходимых артефактов в файл build.gradle вашего приложения или модуля:

классный

dependencies {
    def work_version = "2.11.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.11.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.11

Версия 2.11.1

28 января 2026 г.

Выпущена версия androidx.work:work-*:2.11.1 . Версия 2.11.1 содержит следующие коммиты .

Исправлены ошибки

• Исправлена ​​ошибка, из-за которой ограничение состояния сети не передавалось при заблокированном подключении на Android 15 и выше. ( I5abb7 , b/465016918 )
• Исправлена ​​ошибка, из-за которой отслеживание сетевых ограничений не учитывало состояние блокировки при определении своего начального значения. ( I8a0a2 , b/452081708 )
• Исправлена ​​ошибка, из-за которой ограничение сетевого запроса не проходило при заблокированном подключении на Android 15 и выше. ( I60f24 , b/452081708 )

Версия 2.11.0

22 октября 2025 г.

Выпущена версия androidx.work:work-*:2.11.0 . Версия 2.11.0 содержит следующие коммиты .

Важные изменения по сравнению с версией 2.10.0:

• В версии minSdk обновлен API с 21 до 23.
• В конструктор конфигурации WorkManager добавлен API setRemoteSessionTimeoutMillis , позволяющий настраивать время, в течение которого сессия RemoteWorkManager остается активной с момента последнего использования.

Версия 2.11.0-rc01

8 октября 2025 г.

Выпущена версия androidx.work:work-*:2.11.0-rc01 . Версия 2.11.0-rc01 содержит следующие коммиты .

Версия 2.11.0-beta01

24 сентября 2025 г.

Выпущена версия androidx.work:work-*:2.11.0-beta01 . Версия 2.11.0-beta01 содержит следующие коммиты .

Изменения в API

• Добавить stopRunningWorkWithReason в WorkManager TestDriver . ( Ie53b2 , b/439955564 )

Исправлены ошибки

• Исправлена ​​ошибка, из-за которой служба переднего плана останавливалась при наличии ожидающих команд ( Iae822 , b/432069314 ).
• Исправлена ​​ошибка, из-за которой удаленный сопрограммный обработчик не мог отвязать удаленный сервис ( I842f2 , b/247113322 )

Версия 2.11.0-alpha01

27 августа 2025 г.

Выпущена версия androidx.work:work-*:2.11.0-alpha01 . Версия 2.11.0-alpha01 содержит следующие коммиты .

Изменения в API

• Минимальный SDK был обновлен с API 21 до API 23 ( Ibdfca , b/380448311 , b/435705964 , b/435705223 ).
• В конструктор конфигурации WorkManager добавлен API setRemoteSessionTimeoutMillis , позволяющий настраивать время, в течение которого сессия RemoteWorkManager остается активной с момента последнего использования. ( Ib23c8 )
• Добавьте экспериментальный API в WorkRequest.Builder для применения задержки при прерывании работы системой. ( Ie2dc7 , b/335513480 )
• Добавить тестовый API для передачи в TestListenableWorkerBuilder другого класса обработчика, отличного от того, который создается, для поддержки пользовательских реализаций WorkerFactory ( If6bff , b/389154854 )

Исправлены ошибки

• Кэширование сетевых возможностей в SharedNetworkCallback для предотвращения ненужных межпроцессных взаимодействий ( IE4027 , b/427115602 )
• Исправлена ​​ошибка в оценке сетевых ограничений, из-за которой рабочие элементы после первого не получали текущие сетевые возможности и вместо этого сталкивались с ошибкой ConstraintsNotMet после истечения таймаута ( Ib6a66 , b/427115602 ).

Версия 2.10

Версия 2.10.5

24 сентября 2025 г.

Выпущена версия androidx.work:work-*:2.10.5 . Версия 2.10.5 содержит следующие коммиты .

Исправлены ошибки

• Исправлена ​​ошибка, из-за которой служба переднего плана останавливалась при наличии ожидающих команд ( Iae822 , b/432069314 ).

Версия 2.10.4

10 сентября 2025 г.

Выпущена версия androidx.work:work-*:2.10.4 . Версия 2.10.4 содержит следующие коммиты .

Исправлены ошибки

• Исправлена ​​ошибка, из-за которой RemoteCoroutineWorker не мог отвязать удаленный сервис ( I842f2 , b/247113322 ).

Версия 2.10.3

30 июля 2025 г.

Выпущена версия androidx.work:work-*:2.10.3 . Версия 2.10.3 содержит следующие коммиты .

Исправлены ошибки

• Исправлена ​​ошибка, из-за которой работники с идентичными сетевыми ограничениями, как у предыдущего работника, сообщали о несоблюдении этих ограничений. ( b/427115602 ).

Версия 2.10.2

18 июня 2025 г.

Выпущена версия androidx.work:work-*:2.10.2 . Версия 2.10.2 содержит следующие коммиты .

Исправлены ошибки

• Исправлена ​​ошибка, возникавшая при сохранении рабочих процессов с сетевыми запросами и возможностями по умолчанию, которая приводила к повторному добавлению удаленных возможностей, вызывая некорректную работу рабочих процессов с сетевыми ограничениями. ( b/409716532 )
• Исправлена ​​ошибка, из-за которой рабочие процессы с сетевыми ограничениями не выполнялись оперативно из-за несоблюдения ограничений, даже если сеть и необходимые возможности были доступны. ( b/423403088 )

Версия 2.10.1

23 апреля 2025 г.

Выпущена версия androidx.work:work-*:2.10.1 . Версия 2.10.1 содержит следующие коммиты .

Исправлены ошибки

• Уменьшить вероятность возникновения исключения TooManyRequestsException при регистрации объекта NetworkCallback , используемого для отслеживания ограничений, в WorkManager . ( b/231499040 , b309d5 ).

Версия 2.10.0

30 октября 2024 г.

Выпущена версия androidx.work:work-*:2.10.0 . Версия 2.10.0 содержит следующие коммиты .

Значительные изменения по сравнению с версией 2.9.1

• Добавлены теги трассировки к заданиям из WorkManager что значительно упрощает понимание команды 'adb shell dumpsys jobscheduler', поскольку она будет содержать имя выполняемого рабочего процесса. Также добавлены разделы трассировки вокруг ключевых областей WorkManager .
• Для управления диспетчером, в котором выполняется CoroutineWorker , был добавлен Configuration.workerCoroutineContext .
• Разработчики могут указать NetworkRequest в качестве ограничения для рабочего процесса с помощью метода Constraints.setRequiredNetworkRequest . Это позволяет более точно контролировать, в какой сети должен работать этот рабочий процесс.
• WorkManager 2.10.0 теперь реализована совместимость с SDK 35, и внесены различные изменения для обеспечения совместимости с SDK 35.

Версия 2.10.0-rc01

24 октября 2024 г.

Выпущена версия androidx.work:work-*:2.10.0-rc01 . Версия 2.10.0-rc01 содержит следующие коммиты .

Версия 2.10.0-beta01

2 октября 2024 г.

Выпущена версия androidx.work:work-*:2.10.0-beta01 . Версия 2.10.0-beta01 содержит следующие коммиты .

Версия 2.10.0-alpha04

18 сентября 2024 г.

Выпущена версия androidx.work:work-*:2.10.0-alpha04 . Версия 2.10.0-alpha04 содержит следующие коммиты .

Изменения в API

• Добавьте причину остановки STOP_REASON_FOREGROUND_SERVICE_TIMEOUT для случаев остановки фонового рабочего процесса из-за истечения времени выполнения в зависимости от типа фоновой службы. ( Ibd0af )

Версия 2.10.0-alpha03

4 сентября 2024 г.

Выпущена версия androidx.work:work-*:2.10.0-alpha03 . Версия 2.10.0-alpha03 содержит следующие коммиты .

Новые функции

• Добавлены теги трассировки к заданиям из WorkManager что значительно упрощает понимание команды 'adb shell dumpsys jobscheduler', поскольку она будет содержать имя выполняемого рабочего процесса. Также добавлены разделы трассировки вокруг ключевых областей WorkManager .

Изменения в API

• WorkManager 2.10.0 теперь скомпилирован с использованием SDK 35.
• Исправлена ​​ошибка, из-за которой рабочие процессы переднего плана типов 'short service' и 'data sync' завершались по таймауту и ​​вызывали ANR, если WorkManager не вызывал stopSelf() . Это исправление применимо только к устройствам с 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, рекомендуется обновиться до D8 версии 8.1 или более поздней. Подробнее см. в этой статье . ( Ia60e0 , b/345472586 )

Версия 2.10.0-alpha02

17 апреля 2024 г.

Выпущена версия androidx.work:work-*:2.10.0-alpha02 . Версия 2.10.0-alpha02 содержит следующие коммиты .

Изменения в API

• Добавлена ​​возможность отправки трассировочных данных с помощью настраиваемого параметра @RestrictTo Tracer в WorkManager . ( I17d7f , b/260214125 )
• Для управления диспетчером, в котором выполняется CoroutineWorker , был добавлен Configuration.workerCoroutineContext . Это позволяет полностью избежать использования Dispatchers.Default в WorkManager . ( ICD1B7 )
• Добавить пользовательские обработчики исключений для рабочих процессов ( Ib1b74 , b/261190695 )
• Теперь OneTimeWorkRequest.Builder и PeriodicWorkRequest.Builder можно создавать с помощью KClass вместо Class : val request = OneTimeWorkRequest.Builder(Worker::class).setConstraints(...).build() ( Ib55f6 )
• Класс WorkManager был переведён на Kotlin. Теперь методы, возвращающие LiveData , ListenableFuture или Flow предоставляют корректную информацию о возможности значения NULL. Если предположения о возможности значения NULL в исходном коде были неверны, это могло бы потребовать изменений в исходном коде клиента. ( If6757 )

Версия 2.10.0-alpha01

24 января 2024 г.

Выпущена версия androidx.work:work-*:2.10.0-alpha01 . Версия 2.10.0-alpha01 содержит следующие коммиты.

Новые функции

• Разработчики могут указать NetworkRequest в качестве ограничения для рабочего процесса с помощью метода Constraints.setRequiredNetworkRequest . Это позволяет более точно контролировать, в какой сети должен работать этот рабочий процесс.

Изменения в API

• Добавлена ​​возможность указывать NetworkRequest в качестве ограничения. ( Id98a1 , b/280634452 )

Версия 2.9

Версия 2.9.1

7 августа 2024 г.

Выпущена версия androidx.work:work-*:2.9.1 . Версия 2.9.1 содержит следующие коммиты .

Исправлены ошибки

• Исправлена ​​ошибка, приводящая к сбою, вызванному попыткой WorkManager перезапустить длительно работающий рабочий процесс (т.е. рабочий процесс на переднем плане), если для типа работы на переднем плане были отозваны необходимые разрешения Android 14. ( b/333957914 )

Версия 2.9.0

29 ноября 2023 г.

Выпущена библиотека androidx.work:work-*:2.9.0 . Версия 2.9.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 2.8.0

• Наблюдаемость через Flow . Вместо LiveData , теперь прогресс работника можно отслеживать через Flow с помощью методов WorkManager.getWorkInfosFlow и аналогичных.
• Теперь WorkManager предоставляет подсказку о причине предыдущей остановки рабочего процесса. Эту информацию можно получить непосредственно у рабочего процесса с помощью метода getStopReason() или из WorkInfo с помощью метода getStopReason() .
• Точное планирование периодических задач осуществляется с помощью setNextScheduleTimeOverride . Это позволяет динамически рассчитывать следующее расписание периодических задач, что может быть использовано для реализации таких расширенных функций, как адаптивное время обновления, пользовательское поведение повторных попыток или запуск задачи отображения новостной ленты до пробуждения пользователя каждое утро без смещения. Для предотвращения отмены текущей запущенной задачи при планировании следующей, следует использовать метод ExistingPeriodicWorkPolicy.UPDATE .
• Тестирование WorkManager с использованием многопоточности соответствует производственной среде. ExecutorsMode.PRESERVE_EXECUTORS можно использовать в initializeTestWorkManager для сохранения исполнителей, заданных в Configuration , и использования реального основного потока.
• API корутин, такие как CoroutineWorker были перемещены из дополнительного артефакта work-runtime-ktx в основной артефакт work-runtime. Теперь каталог work-runtime-ktx пуст.

Изменения в API

• stopReason была добавлена ​​в WorkInfo . Она делает stopReason доступной после завершения работы воркера. Это может быть полезно для удобного представления информации stopReason , поскольку после остановки воркера само приложение может быть очень быстро завершено. ( I21386 )
• Разрешить установку Clock через конфигурацию и использовать его для управления последовательностью выполнения тестов Worker. ( Ic586e )
• В ListenableWorker добавлен метод getStopReason() , который выдает подсказку о причине остановки воркера. ( I07060 )
• Добавлен WorkManagerTestInitHelper#closeWorkDatabase() , чтобы избежать предупреждения Closeguard об утечке ресурсов. ( Ia8d49 )
• Конструктор класса WorkInfo теперь является публичным, что может быть полезно при тестировании. ( Ia00b6 , b/209145335 )
• work-runtime-ktx теперь пуста, CoroutineWorker и другие специфические для Kotlin утилиты теперь доступны в основном артефакте work-runtime. ( 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 содержит следующие коммиты.

• С момента последнего бета-релиза изменений не наблюдалось.

Версия 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 содержит следующие коммиты.

Новые функции

• Теперь WorkManager предоставляет подсказку о причине предыдущей остановки рабочего процесса. Эту информацию можно получить непосредственно у рабочего процесса с помощью метода getStopReason() или из WorkInfo с помощью метода getStopReason() .

Изменения в API

• stopReason была добавлена ​​в WorkInfo . Она делает stopReason доступной после завершения работы воркера. Это может быть полезно для удобного отображения информации stopReason , поскольку после остановки воркера само приложение может быть очень быстро завершено. ( I21386 )
• Разрешить установку параметра Clock через конфигурацию и использовать его для управления последовательностью выполнения тестов Worker. ( Ic586e )
• В ListenableWorker добавлен метод getStopReason() , который выдает подсказку о причине остановки воркера. ( 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 содержит следующие коммиты.

Новые функции

• Наблюдаемость через Flow . Вместо LiveData , теперь прогресс работника можно отслеживать через Flow с помощью методов WorkManager.getWorkInfosFlow и аналогичных.
• Точное планирование периодических задач осуществляется с помощью setNextScheduleTimeOverride . Это позволяет динамически рассчитывать следующее расписание периодической задачи, что может быть использовано для реализации таких расширенных функций, как адаптивное время обновления, пользовательское поведение повторных попыток или запуск задачи отображения новостной ленты до пробуждения пользователя каждое утро без смещения. Для предотвращения отмены текущей запущенной задачи при планировании следующей, следует использовать метод ExistingPeriodicWorkPolicy.UPDATE .
• Тестирование WorkManager с использованием многопоточности соответствует производственной среде. ExecutorsMode.PRESERVE_EXECUTORS можно использовать для сохранения исполнителей, заданных в Configuration , и использования реального основного потока.
• API корутин, такие как CoroutineWorker были перемещены из дополнительного артефакта work-runtime-ktx в основной артефакт work-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 , чтобы предотвратить пропуск обновлений контента при высокой нагрузке. Лимит можно настроить с помощью Configuration.Builder.setContentUriTriggerWorkersLimit . ( Ic128f )
• В WorkInfo добавлены ограничения. ( I162c0 )

Версия 2.8

Версия 2.8.1

22 марта 2023 г.

Выпущена библиотека androidx.work:work-*:2.8.1 . Версия 2.8.1 содержит следующие коммиты.

Исправлены ошибки

• Исправлена ​​ошибка ANR в RescheduleReceiver , которая ранее некорректно обрабатывала две одновременные широковещательные рассылки. ( b/236906724 )

Версия 2.8.0

8 февраля 2023 г.

Выпущена библиотека androidx.work:work-*:2.8.0 . Версия 2.8.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 2.7.0

Новые функции

• Добавлена ​​возможность неинтрузивного обновления WorkRequests с сохранением исходного времени постановки в очередь, цепочки вызовов и т. д. Подробное описание этой функции, а также документация Javadoc для WorkManager.updateWork и ExistingPeriodicWorkPolicy.UPDATE доступны в соответствующей статье блога .

Изменения в API

• WorkManager.updateWork была добавлена ​​для обновления задач с сохранением их исходного времени постановки в очередь и цепочки вызовов. ( I9a248 , b/219446409 )
• Добавлена ​​политика ExistingPeriodicWorkPolicy.UPDATE . Эта политика позволяет обновлять периодическое задание по имени. Она похожа на существующую REPLACE , но менее инвазивна: она не отменяет выполнение задания, если оно в данный момент выполняется, и сохраняет время постановки в очередь — начальная задержка и период рассчитываются исходя из исходного времени постановки в очередь, а не из времени обновления. REPLACE была объявлена ​​устаревшей, чтобы уменьшить путаницу между очень похожими по названию политиками REPLACE и UPDATE . Если вы все еще хотите сохранить предыдущую семантику REPLACE , можно использовать недавно добавленную CANCEL_AND_REENQUEUE , которая идентична REPLACE . ( I985ed , b/219446409 )
• Добавлена ​​возможность перехвата исключений планирования с помощью метода `setSchedulingExceptionHandler` , предоставляющего объект Consumer<Throwable> `.
• Добавлена ​​возможность передавать объект Consumer<Throwable> через setInitializationExceptionHandler для определения наличия проблем при попытке инициализации WorkManager.
• Встроенные вспомогательные функции для OneTimeWorkRequest и PeriodicWorkRequest были перемещены из androidx.work:work-runtime-ktx в androidx.work:work-runtime ( I0010f , b/209145335 )
• Для непосредственного создания WorkQuery были добавлены вспомогательные методы WorkQuery.fromIds , WorkQuery.fromStates , WorkQuery.fromUniqueWorkNames , WorkQuery.fromTags . ( 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 . Также добавлен новый API getConfiguration() для разработчиков библиотек, позволяющий получить конфигурацию, с которой был инициализирован 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 содержит следующие коммиты.

Новые функции

• В этом релизе нет новых функций. В основном это просто обновление версии.

Версия 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 содержит следующие коммиты.

Изменения в API

• Добавлены WorkerInfo.getGeneration() и WorkerParameters.getGeneration() , которые возвращают поколение рабочего процесса. У рабочего процесса может быть несколько поколений, если он был обновлен с помощью WorkManager.updateWork или WorkManager.enqueueUniquePeriodicWork с использованием ExistingPeriodicWorkPolicy.UPDATE . Обратите внимание, что если рабочий процесс в данный момент выполняется, этот метод может вернуть более новое поколение, чем у текущего выполняющегося рабочего процесса, если обновление произошло во время выполнения рабочего процесса. ( I665c5 , b/219446409 ) ( I128a9 , b/219446409 )
• Добавлен обработчик исключений InitializationExceptionHandler , который можно использовать для определения наличия проблем при попытке инициализации WorkManager . ( I061de )

Версия 2.8.0-alpha03

10 августа 2022 г.

Выпущен репозиторий androidx.work:work-*:2.8.0-alpha03 . Версия 2.8.0-alpha03 содержит следующие коммиты.

Новые функции

• Добавлена ​​возможность неинвазивного обновления 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 содержит следующие коммиты.

Изменения в API

• Теперь ограничения можно создавать напрямую, а не с помощью Builder, что удобно для пользователей Kotlin. ( Idc390 , b/137568653 )
• Добавлена ​​возможность проверки инициализации WorkManager . Также добавлен новый API getConfiguration() для разработчиков библиотек, позволяющий получить конфигурацию, с которой был инициализирован WorkManager . ( I6eff3 , b/212300336 )

Версия 2.8.0-alpha01

12 января 2022 г.

Выпущен репозиторий androidx.work:work-*:2.8.0-alpha01 . Версия 2.8.0-alpha01 содержит следующие коммиты.

Изменения в API

• Для непосредственного создания WorkQuery были добавлены вспомогательные методы WorkQuery.fromStates , WorkQuery.fromUniqueWorkNames , WorkQuery.fromTags . ( If48f2 , b/199919736 )
• Добавлены экспериментальные методы BuildCompat для будущих SDK ( Iafd82 , b/207528937 )
• Добавьте getForegroundInfo в Worker . ( Ic1ead )
• Добавлены вспомогательные методы WorkQuery.fromIds для создания WorkQuery непосредственно из идентификаторов. ( Ie5bdf , b/199919736 )
• В RxWorker теперь есть setForeground возвращающий Completable , который можно использовать вместо setForegroundInfoAsync , возвращающего ListenableFuture . ( I85156 )
• В RxWorker для RxJava 2 теперь есть getForegroundInfo возвращающий Single , который можно использовать вместо getForegroundInfoAsync , возвращающего ListenableFuture . ( I21c91 , b/203851459 )
• В RxJava 3 класс RxWorker теперь имеет getForegroundInfo возвращающую Single , которую можно использовать вместо getForegroundInfoAsync , возвращающей ListenableFuture . ( I1ca8a )
• В RxWorker теперь есть setForeground возвращающий Completable , который можно использовать вместо setForegroundInfoAsync , возвращающего ListenableFuture . ( I992a3 , b/203851459 )

Исправлены ошибки

• Передача отмен в CoroutineScope в ListenableFuture при использовании suspendCancellableCoroutine . ( I77e63 )

Версия 2.7

Примечание: для приложений, ориентированных на Android 12 (S), требуется WorkManager версии 2.7.0 .

Версия 2.7.1

17 ноября 2021 г.

Выпущена библиотека androidx.work:work-*:2.7.1 . Версия 2.7.1 содержит следующие коммиты.

Исправлены ошибки

• При использовании suspendCancellableCoroutine отмены в CoroutineScope распространяются на ListenableFuture . ( I77e63 )
• Исключение возникает немедленно, когда отложенные запросы на выполнение работ помечаются как ускоренные. bef1762

Версия 2.7.0

13 октября 2021 г.

Выпущена библиотека androidx.work:work-*:2.7.0 . Версия 2.7.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 2.6.0

• В Android 12 WorkManager представляет новый API WorkRequest.Builder.setExpedited(...) помогающий справляться с ограничениями для служб переднего плана.

• При использовании setExpedited(...) WorkManager делегирует выполнение ускоренным заданиям в JobScheduler, начиная с Android 12, обеспечивая при этом обратную совместимость с более ранними версиями Android за счет делегирования задач службе переднего плана.

Версия 2.7.0-rc01

29 сентября 2021 г.

Выпущен репозиторий androidx.work:work-*:2.7.0-rc01 . Версия 2.7.0-rc01 содержит следующие коммиты.

Эта версия идентична androidx.work:work-*:2.7.0-beta01 .

Версия 2.7.0-beta01

1 сентября 2021 г.

Выпущена библиотека androidx.work:work-*:2.7.0-beta01 . Версия 2.7.0-beta01 содержит следующие коммиты.

Новые функции

• Уменьшите конкуренцию за доступ к SQLite между несколькими процессами при инициализации WorkManager.

Изменения в 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 содержит следующие коммиты.

В этом релизе также содержатся исправления ошибок из версии 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() больше не является устаревшим.
• Мы рекомендуем по возможности использовать API WorkRequest.Builder.setExpedited(...) . Для лучшей поддержки ситуаций, когда приложение не подчиняется ограничениям, связанным с работой служб переднего плана , разработчики могут использовать API ListenableWorker.setForegroundAsync() .
• Если вызывается ListenableWorker.setForegroundAsync() , и приложение подчиняется ограничениям, связанным с работой служб переднего плана, это вызовет исключение ForegroundServiceStartNotAllowedException .

Исправлены ошибки

• Когда срочные заказы переносятся на другое время, они перестают быть срочными и становятся обычными .

Версия 2.7.0-alpha03

21 апреля 2021 г.

Примечание: WorkManager версии 2.7.0-alpha03 совместим только с SDK Android 12 Developer Preview 3.

Выпущена версия androidx.work:work-*:2.7.0-alpha03 . Версия 2.7.0-alpha03 содержит следующие коммиты.

Новые функции

• Начиная с WorkManager 2.6.0-alpha02 : Добавлена ​​поддержка рабочих процессов, которые могут выполняться в любом процессе. ( 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 содержит следующие коммиты.

Примечание: WorkManager версии 2.7.0-alpha02 совместим только с SDK Android 12 Developer Preview 1.

Исправлены ошибки

• Необходимо явно указать возможность изменения PendingIntent , чтобы исправить ошибку, приводящую к сбою при работе с Android 12. ( b/180884673 )

Версия 2.7.0-alpha01

18 февраля 2021 г.

Выпущен репозиторий androidx.work:work-*:2.7.0-alpha01 . Версия 2.7.0-alpha01 содержит следующие коммиты.

Примечание: WorkManager версии 2.7.0-alpha01 совместим только с SDK Android 12 Developer Preview 1.

Новые функции

• В Android 12 WorkManager представляет новый API WorkRequest.Builder.setExpedited(...) , учитывающий ограничения служб переднего плана .

  Приложения больше не могут запускать службы переднего плана, находясь в фоновом режиме. Поэтому, чтобы лучше поддерживать длительные задачи, которые ранее были привязаны к жизненному циклу службы переднего плана, приложения могут помечать запросы WorkRequest как ускоренные .

  Этот API заменяет API setForegroundAsync(...) / setForeground(...) , которые теперь устарели .

  При использовании setExpedited(...) WorkManager делегирует выполнение ускоренным заданиям в JobScheduler , начиная с Android 12, обеспечивая при этом обратную совместимость с более ранними версиями Android за счет делегирования задач службам переднего плана.

Изменения в API

• Добавить поддержку ускоренных запросов на WorkRequest ).

Версия 2.6.0

Версия 2.6.0

1 сентября 2021 г.

Выпущена библиотека androidx.work:work-*:2.6.0 . Версия 2.6.0 содержит следующие коммиты.

Примечание: WorkManager версии 2.6.0 несовместим с приложениями, ориентированными на Android 12 (S). Вместо него следует использовать версию 2.7.0 .

Важные изменения по сравнению с версией 2.5.0

• Теперь WorkManager использует androidx.startup для инициализации. Если ранее вы использовали 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" />
  

• Добавлена ​​поддержка рабочих процессов, которые могут запускаться в любом процессе. ( Iaf200 )

• Добавлен RemoteCoroutineWorker , представляющий собой реализацию RemoteListenableWorker, который может привязываться к удалённому процессу. ( I30578 )

Версия 2.6.0-rc01

4 августа 2021 г.

Выпущен репозиторий androidx.work:work-*:2.6.0-rc01 . Версия 2.6.0-rc01 содержит следующие коммиты.

Эта версия идентична 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 содержит следующие коммиты.

Новые функции

• Добавляет поддержку рабочих процессов, которые могут выполняться в любом процессе. ( 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 содержит следующие коммиты.

Новые функции

• Теперь WorkManager использует androidx.startup для инициализации. Ранее это делалось с помощью 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-производителя, из-за которой при использовании API AlarmManager возникает исключение SecurityException . ( aosp/1587518 )

Версия 2.5.0

Примечание: WorkManager версии 2.5.0 несовместим с приложениями, ориентированными на Android 12 (S).

Версия 2.5.0

27 января 2021 г.

Выпущена библиотека androidx.work:work-*:2.5.0 . Версия 2.5.0 содержит следующие коммиты.

Значительные изменения по сравнению с версией 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 всегда обращается к указанному процессу. Планировщик задач внутри процесса также работает в указанном процессе.
• Sometimes, ActivityManager cannot instantiate the JobService 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 single WorkRequest when an Application 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 that WorkRequest s are tracked after a WorkRequest is complete. The duration was 7 days previously. It has been reduced to 1 day + the keepResultsForAtLeast duration. ( aosp/1419708 )
• The TestListenableWorkerBuilder now supports the reified class extending ListenableWorker 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 the WorkQuery 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 a ListenableWorker 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 of WorkRequest 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 them ENQUEUED 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 and TestWorkerBuilder 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 and RemoteWorkContinuation . 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 query WorkInfo 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) . The processName is a fully qualified process name which looks like packageName:processName (eg com.example:remote ).
  • A set of new APIs: RemoteWorkManager and RemoteWorkContinuation to enqueue , cancel and query work requests. These APIs do not include LiveData variants to avoid SQLite contention across multiple-processes. All calls to enqueue , cancel and query are forwarded to a primary app process using AIDL and return a fluent ListenableFuture . ( aosp/1392657 , aosp/1411210 , aosp/1412215 , aosp/1417713 )

Изменения в API

• WorkManager now prunes completed WorkRequest s that have no incomplete dependencies more aggressively. The buffer duration changed from 7 days to 1 day. ( aosp/1419708 )

Исправлены ошибки

• WorkManager now reconciles jobs proactively so WorkRequest s and JobScheduler jobs are in sync when WorkManager 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-process Scheduler would only consider executing work that was not delayed and whose constraints were met. Now, the in-process scheduler tracks WorkRequest s which might be executed in the future, including PeriodicWorkRequests. The in-process Scheduler also does not observe scheduling limits (but is still restricted to the size of the Executor 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 configurable RunnableScheduler . ( 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 a WorkQuery . This is useful when developers want to query WorkInfo s by a combination of multiple attributes. For more information look at WorkQuery.Builder.fromStates(...) , WorkQuery.Builder. fromTags(...) or WorkQuery.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 to APPEND , 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 using setForegroundAsync() 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 now public when using the default WorkerFactory . ( aosp/1291262 )

• Calls to setForegroundAsync() that do not complete before completion of a ListenableWorker will now be signalled via an IllegalStateException on the returned ListenableFuture . ( aosp/1262743 )

• Fix a bug where the ForegroundService is not stopped after a foreground Worker is interrupted. ( b/155579898 , aosp/1302153 )

• Fix a bug where WorkManager attempts to execute multiple instances of a Worker 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

May 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 foreground Worker is interrupted. ( b/155579898 , aosp/1302153 )
• Fix a bug where WorkManager attempts to execute multiple instances of a Worker 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 now public when using the default WorkerFactory . ( aosp/1291262 )

Изменения в API

• Calling setProgressAsync() after a ListenableWorker has finished execution will now signal an Exception via the ListenableFuture . ( aosp/1285494 )
• WorkQuery.Builder is now marked final . ( aosp/1275037 )
• WorkQuery.Builder factory methods withStates , withTags and withUniqueWorkNames have been renamed to fromStates , fromTags and fromUniqueWorkNames 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 both Constraints.setRequiresCharging(...) and Constraints.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 a WorkQuery . This is useful when developers want to query WorkInfo s by a combination of multiple attributes. For more information look at WorkQuery.Builder withStates(...) , WorkQuery.Builder withTags(...) or WorkQuery.Builder withUniqueWorkNames(...) . ( aosp/1253230 , b/143847546 )

• Calls to setForegroundAsync() that do not complete before completion of a ListenableWorker will now be signalled via an IllegalStateException on the returned ListenableFuture . ( aosp/1262743 )

Исправлены ошибки

• Fixed the lint rule that checks for invalid interval durations for PeriodicWorkRequest s. ( aosp/1254846 , b/152606442 )

Version 2.4.0-alpha01

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 tracks WorkRequest s which might be executed in the future, including PeriodicWorkRequest s. The in-process Scheduler also does not observe scheduling limits (but is still restricted to the size of the Executor being used by WorkManager). This means that the application can now execute a lot more WorkRequest 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 using setForegroundAsync() APIs. ( b/147873061 , aosp/1215915 )
  • Specifying JobScheduler ids that WorkManager should use when using JobService APIs directly. ( aosp/1223567 )

Изменения в API

• Add ExistingWorkPolicy.APPEND_OR_REPLACE which is similar to APPEND , but replaces a chain that has cancelled or failed prerequisites. ( b/134613984 , aosp/1199640 )

• Provide the ability to add a custom RunnableScheduler to track WorkRequest s that need to be executed in the future. This is used by the in-process Scheduler. ( aosp/1203944 )

Исправлены ошибки

• Deprecated setProgress() in RxWorker because it previously returned a Single<Void> which is an impossible type. Added a new API setCompletableProgress() which returns a Completable instead; and added new Lint rules which help migrate to the new APIs. ( b/150080946 , aosp/1242665 )

Версия 2.3.4

Версия 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

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 )

Версия 2.3.2

Версия 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 )

Версия 2.3.1

Версия 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 running Worker s that run when a foreground Service is active. ( aosp/1218539 , b/147249312 )
• WorkManager now depends on androidx.sqlite:sqlite-framework:2.1.0 stable. ( aosp/1217729 )
• Added lint rules to ensure that a foregroundServiceType is specified in the AndroidManifest.xml when using foregroundServiceType s in ForegroundInfo . ( aosp/1214207 , b/147873061 )

Версия 2.3.0

Версия 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 an api dependency on work-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 the AndroidManifest.xml when using on demand initialization. ( aosp/1167007 )
• Added a lint warning when enqueue() is used for a PeriodicWorkRequest instead of enqueueUniquePeriodicWork() . ( aosp/1166032 )

API changes

• ForegroundInfo now requires you to specify the notificationId to be used when using ListenableWorker.setForegroundAsync() . This is a breaking change. This allows you to run multiple long running Worker s in parallel. WorkManager also better manages lifetimes of the provided Notification 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 incorrect WorkContinuation 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 cancel WorkRequest s without having to register another component in the AndroidManifest.xml . This API makes it especially easy to cancel WorkRequest s from Notification 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() to ForegroundInfo.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() (or CoroutineWorker#setForeground() for Kotlin). ( aosp/1133636 )

API changes

• The containsKey API in Data is renamed to hasKeyWithValueOfType . The corresponding extension method in the ktx 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 useful toString() representation. ( b/140945323 )
• Data now has a better equals() method. It also supports deepEquals for Array types. ( b/140922528 )
• WorkManager now stores its internal database and preference files in a no backup directory. ( b/114808216 )

Версия 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 the setProgressAsync() API. Also added a corresponding suspend -ing setProgress API in CoroutineWorker and a setProgress in RxWorker which returns a Single<Void> . With these new APIs Workers can convey progress information via WorkInfo which has a corresponding getProgress API. ( b/79481554 )
• Data has a containsKey() API which can be used to validate that input data to Worker s has keys with the expected type. ( b/117136838 )
• Data can now be serialized using Data.toByteArray() and Data.fromByteArray() . Note that there are no versioning guarantees with Data 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 via Configuration.setInputMergerFactory . ( b/133273159 )

API changes

• WorkManager will throw an instance of IllegalStateException if a WorkerFactory returns an instance of ListenableWorker which has been previously invoked. ( b/139554406 )
• Documentation updates around ListenableFuture cancellation and the onStopped() callback in ListenableWorker . ( b/138413671 )

Исправлены ошибки

• The in-process Scheduler now ignores WorkRequest s with the idle constraint. These requests are now only picked up by JobScheduler when the device is actually idle . ( aosp/1089779 )
• TestScheduler now correctly uses the specified Executor for its internal task executor in tests. ( aosp/1090749 )

Версия 2.2.0

Версия 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 using JobScheduler 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 .

Caution: This version contains an unintentional dependency on org.jacoco:org.jacoco.agent:0.8.3 , which can cause a build failure. Please update to the latest version, in which this dependency has been removed.

Новые функции

• 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 your build.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:
  1. Disable the automatic initializer .
  2. Implement Configuration.Provider on your custom Application object.
  3. Change all references of WorkManager.getInstance() to WorkManager.getInstance(Context) . As part of this change, we have deprecated WorkManager.getInstance() . It is always safer to call the new WorkManager.getInstance(Context) replacement, even if you're not doing on-demand initialization.
• PeriodicWorkRequest s now support initial delays. You can use the setInitialDelay method on PeriodicWorkRequest.Builder to set an initial delay. b/111404867
• Added the ability to delegate to one or more registered WorkerFactory s using DelegatingWorkerFactory . b/131435993
• Added the ability to customize the Executor used by WorkManager for all its internal book-keeping via Configuration.Builder.setTaskExecutor .
• Added the ability to create unit testable Worker and ListenableWorker classes by using TestWorkerBuilder and TestListenableWorkerBuilder in the work-testing artifact.
  • Note that work-testing now pulls in Kotlin as a dependency and includes several Kotlin extensions by default.
• 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 of Data 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

June 20, 2019

androidx.work:work-*:2.1.0-beta02 is released. The commits included in this version can be found here .

Note: This version is dependent on the Java 8 programming language. Please read Use Java 8 language features to learn how to use it in your project.

Исправлены ошибки

• TestListenableWorkerBuilder now uses the correct WorkerFactory when creating instances of ListenableWorker . b/135275844
• Fixed a bug which caused drifts in the execution windows for WorkRequest s due to process death. b/135272196

Версия 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 .

Note: This version is dependent on the Java 8 programming language. Please read Use Java 8 language features to learn how to use it in your project.

Исправлены ошибки

• 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 )

Версия 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 the setInitialDelay method on PeriodicWorkRequest.Builder to set an initial delay. b/111404867

• Added the ability to delegate to one or more registered WorkerFactory s using DelegatingWorkerFactory . b/131435993

• Added the ability to customize the Executor used by WorkManager for all its internal book-keeping via Configuration.Builder.setTaskExecutor .

• Improved documentation around WorkRequest.keepResultsForAtLeast ( b/130638001 ), on-demand initialization, and PeriodicWorkRequest.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:
  1. Disable the automatic initializer .
  2. Implement Configuration.Provider on your custom Application object.
  3. Change all references of WorkManager.getInstance() to WorkManager.getInstance(Context) . As part of this change, we have deprecated WorkManager.getInstance() . It is always safer to call the new WorkManager.getInstance(Context) replacement, even if you're not doing on-demand initialization.
• Added the ability to create unit testable Worker and ListenableWorker classes by using TestWorkerBuilder and TestListenableWorkerBuilder in the work-testing artifact.
  • Note that work-testing now pulls in Kotlin as a dependency, but also includes several Kotlin extensions by default.
• 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 of Data objects.
• Deprecated CoroutineWorker.coroutineContext . This field was incorrectly typed as a CoroutineDispatcher ; you should no longer need it as you can go to the desired coroutineContext yourself in the body of the suspending function.
• RxWorker.createWork() and RxWorker.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.

Версия 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

For information on using Kotlin extensions, see the KTX documentation .
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"
}

Kotlin

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")
}

Note: WorkManager classes are already in the androidx.work package, but currently depend on non-AndroidX dependencies including the Support Library 27.1 and associated Arch component versions. A version of WorkManager with AndroidX dependencies will be released in the future.

Версия 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.

Версия 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/124546316

• Worker s that throw an unchecked Exception are now correctly marked as FAILED 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

Версия 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 in 1.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

January 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 dependency 1.1.1 instead of 1.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).

Version 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 of ListenableWorker . This prevents refactoring conflicts with Kotlin's top-level Result class. This is a breaking API change. b/120564418

Breaking API Changes

• androidx.work.Result has been moved to be an inner class of ListenableWorker .

Версия 1.0.0-alpha12

December 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 , introduces RxWorker . This is a ListenableWorker that expects a Single<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 into Result . Result is now a "sealed class" with three concrete implementations, which you can obtain via Result.success() (or Result.success(Data) ), Result.failure() (or Result.failure(Data) ), and Result.retry() . Your ListenableFuture s now result Result instead of Payload . Worker s don't have getter and setter methods for output Data . This is a breaking change.
• Added Constraints.Builder.setTriggerContentMaxDelay(long, TimeUnit) and Constraints.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() and ListenableFuture.await() Kotlin extension methods.
• Renamed Operation.getException() to Operation.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 , and OneTimeWorkRequest to streamline the API. To fix any build problems, you can wrap your existing varargs with Arrays.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 existing combine 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 via observeForever 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 a WorkInfo with the CANCELLED State during ListenableWorker.onStopped() .
• Treat null Result s as failures in ListenableWorker . 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 into Result . Result is now a "sealed class" with three concrete implementations, which you can obtain via Result.success() (or Result.success(Data) ), Result.failure() (or Result.failure(Data) ), and Result.retry() . Your ListenableFuture s now result Result instead of Payload . Worker s don't have getter and setter methods for output Data .
• Added Operation.await() and ListenableFuture.await() Kotlin extension methods.
• Renamed Operation.getException() to Operation.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 , and OneTimeWorkRequest to streamline the API. To fix any build problems, you can wrap your existing varargs with Arrays.asList(...) . We still include single-argument versions of each method.
• Removed WorkContinuation.combine(OneTimeWorkRequest, *) variants. They were presenting a confusing API; the existing combine 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 new CoroutineWorker .
• WorkStatus has been renamed to WorkInfo . All corresponding getStatus method variants have been renamed to the corresponding getWorkInfo variants. This is a breaking change.
• ListenableWorker.onStopped() no longer accepts has a boolean argument representing if the WorkRequest was cancelled. WorkManager no longer makes this distinction. This is a breaking change.
• androidx.work.test package has been renamed to androidx.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() and WorkerParameters.getTriggeredContentAuthorities() previously returned arrays. Now these methods return Collections. This is a breaking change.
• ListenableWorker.onStartWork() is renamed to ListenableWorker.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() and Configuration.getMinJobSchedulerID() are renamed to Configuration.getMinJobSchedulerId() and Configuration.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 unique OneTimeWorkRequest s without having to create a WorkContinuation .
• All variants of enqueue and cancel methods on WorkManager now return a new Operation type. This is a breaking change.
• All variants of enqueue no longer accept varargs for WorkRequest s. This is a breaking change. Use Collections instead. You can use Arrays.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 an IllegalStateException . This is a breaking change.

Исправлены ошибки

• WorkRequest.Builder s in the work-runtime-ktx artifact now use ListenableWorker 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 to WorkInfo . All corresponding getStatus method variants have been renamed to the corresponding getWorkInfo variants.
• ListenableWorker.onStopped() no longer accepts has a boolean argument representing if the WorkRequest was cancelled. WorkManager no longer makes this distinction.
• androidx.work.test package has been renamed to androidx.work.testing package.
• Setters on Constraints are no longer a part of the public API.
• WorkerParameters.getTriggeredContentUris() and WorkerParameters.getTriggeredContentAuthorities() previously returned arrays. Now these methods return Collections.
• ListenableWorker.onStartWork() is renamed to ListenableWorker.startWork() .
• The constructor for WorkStatus is no longer a part of the public API.
• Configuration.getMaxJobSchedulerID() and Configuration.getMinJobSchedulerID() are renamed to Configuration.getMinJobSchedulerId() and Configuration.getMaxJobSchedulerId() respectively.
• All variants of enqueue and cancel methods on WorkManager now return a new Operation type.
• All variants of enqueue no longer accept varargs for WorkRequest s.
• Attempting to initialize WorkManager more than once per process will now result in an IllegalStateException .

Версия 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 default Worker constructor. This is a breaking API change.
• Renamed NonBlockingWorker to ListenableWorker , 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 the ListenableFuture appropriately. Reference implementations of ListenableFuture s are provided in the Futures package in alpha02 (see below the WorkManager section).
  • Worker extends ListenableWorker and still operates as before, with an abstract Result doWork() method.
  • Shuffled some methods and members from Worker to ListenableWorker .
  • 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 implementation DefaultWorkerFactory have been merged into an abstract class called WorkerFactory . The implementation ensures that the default reflection-based behavior is called as a last-ditch effort for any user-created WorkerFactory instances. This is a breaking change.
• Removed WorkManager.synchronous() and WorkContinuation.synchronous() and all related methods. Added ListenableFuture<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 return void ; it now returns a ListenableFuture<Void> . You can call ListenableFuture.addListener(Runnable, Executor) or ListenableFuture.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 the Future s contract.
  • To maintain parity with the synchronous getStatus* methods, we have provided ListenableFuture variants, and renamed the existing ones that returned LiveData to explicitly have "LiveData" as part of the name (for example, getStatusesByIdLiveData(UUID) ). This is a breaking API change.

Исправлены ошибки

• Fixed the known issue from alpha09 regarding duplicate androidx-annotations.pro files. You may remove the workaround from the previous release notes by deleting exclude '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 was REPLACE d. b/116253486 and b/116677275
• WorkContinuation.combine() now accepts one or more WorkContinuation s instead of two or more. b/117266752

Breaking API Changes

• Removed all previously deprecated methods and classes, notably the default Worker constructor.
• The interface WorkerFactory and the concrete implementation DefaultWorkerFactory have been merged into an abstract class called WorkerFactory .
• Removed WorkManager.synchronous() and WorkContinuation.synchronous() .
• WorkManager.getStatus*() methods now return ListenableFuture s. WorkManager.getStatus*LiveData() return LiveData s.

Версия 1.0.0-alpha09

19 сентября 2018 г.

Known Issue

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'
    }
}

Kotlin

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 underlying Worker . 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 a WorkerFactory as part of the WorkManager.Configuration . The fallback factory is DefaultWorkerFactory , which matches behavior of previous versions of WorkManager.
  • The default constructors for Worker and NonBlockingWorker are now marked as deprecated. Please use the new constructor ( Worker(Context, WorkerParameters) ) and call super(Context, WorkerParameters) ; future versions of WorkManager will remove the default constructor.
• 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 of NonBlockingWorker .
• Add ability to trigger timed work in TestDriver via TestDriver.setInitialDelayMet(UUID) and TestDriver.setPeriodDelayMet(UUID) . b/113360060

Решающие перемены

• The default Worker and NonBlockingWorker 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 in JobScheduler 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 in ConstraintTracker . b/112272753
• Changed return type annotations of Data.getBooleanArray(String) and Data.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) and Data.getIntArray(String) to @Nullable instead of @NonNull . b/112275229
• Kotlin extensions: deprecated Map.toWorkData() and added a top-level workDataOf(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 using WorkRequest.Builder#build() . b/111408337
• Enable the use of RescheduleReceiver only when there are WorkRequest s that need it. b/111765853

Версия 1.0.0-alpha05

July 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 an IllegalStateException . This is a breaking API change.
• Added a new API, Configuration.Builder.setMinimumLoggingLevel(int) , which can control WorkManager verbosity. By default, WorkManager logs Log.INFO and above.
• Changed signature of Data.getString() so it no longer takes a default value (it is implicitly null ). This is a breaking API change.
• Marked some methods needed only for internal usage as @hide . This includes the Constraints constructor, Data.toByteArray() , and Data.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 using JobScheduler . 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 given WorkRequest . 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 implicitly null ).
• Marked some methods needed only for internal usage as @hide . This includes the Constraints constructor, Data.toByteArray() , and Data.fromByteArray(byte[]) .

Версия 1.0.0-alpha04

June 26, 2018

Исправлены ошибки

• PeriodicWorkRequest s are now correctly rescheduled when using the AlarmManager 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

June 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

• Documentation updates. 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 version 1.1.1-rc1 .

Изменения в API

• Added getStatusesSync() , the synchronous version of WorkContinuation.getStatuses() .
• Worker has the ability to distinguish between user-initiated cancellation and temporary os-requested stopping. Worker.isStopped() returns true if any kind of stop has been requested. Worker.isCancelled() returns true 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 to JobScheduler or AlarmManager . This helps prevent WorkManager from taking all your available JobScheduler slots.
• Added Configuration.setJobSchedulerJobIdRange(int minJobSchedulerId, int maxJobSchedulerId) which helps define a range of JobScheduler job ids safe for WorkManager to use. b/79996760
• Worker.getRunAttemptCount() returns the current run count for a given Worker . b/79716516
• WorkManager.enqueueUniquePeriodicWork(String uniqueWorkName, ExistingPeriodicWorkPolicy existingPeriodicWorkPolicy, PeriodicWorkRequest periodicWork) allows you to enqueue a unique PeriodicWorkRequest s. b/79600647
• WorkManager.cancelAllWork() cancels all Worker s. Libraries that depend on WorkManager can query when this method was called last by using WorkManager.getLastCancelAllTimeMillis() for additional cleanup of internal state.
• Added WorkManager.pruneWork() to remove completed jobs from the internal database. b/79950952 , b/109710758

Изменения в поведении

• Added an implicit tag for all WorkRequest s, which is the fully qualified class name for the Worker . This allows the ability to remove WorkRequest s without tag s or when the id is not available. b/109572351

Решающие перемены

• Renamed Worker.WorkerResult to Worker.Result .
• Worker.onStopped now has an additional isCancelled parameter which is set to true when the Worker has explicitly been cancelled.

Версия 1.0.0-alpha02

24 мая 2018 г.

Исправлены ошибки

• Fixed a NullPointerException on State.isFinished() . b/79550068
• Fixed an issue which caused Worker s to be rescheduled on Application.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 in Data . b/79443878
• Data.Builder.putAll() now returns an instance of the Builder . 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 a Worker has been stopped. Worker.onStopped() can be used to perform lightweight cleanup operations.
• Worker.getTags() API returns a Set of tags associated with the Worker .
• Added javax.time.Duration overloads for APIs which take a combination of duration and TimeUnit s. This is guarded by @RequiresApi(26) .
• WorkManager extensions have moved from the androidx.work.ktx package to the androidx.work package. The old extensions are deprecated and will be removed in a future version.
• Configuration.withExecutor() is deprecated. Use Configuration.setExecutor() instead.

Версия 1.0.0-alpha01

May 8, 2018

WorkManager simplifies scheduling and execution of guaranteed, constraint-aware background work. This initial release is 1.0.0-alpha01 .