Отладка рабочих WorkManager с помощью инспектора фоновых задач

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

Начать

Чтобы просмотреть список работников в инспекторе фоновых задач, выполните следующие действия:

  1. Запустите свое приложение на эмуляторе или подключенном устройстве с API уровня 26 или выше.

  2. В строке меню выберите «Просмотр» > «Инструменты Windows» > «Проверка приложений» .

  3. Выберите вкладку «Инспектор фоновых задач» .

  4. Выберите в меню запущенный процесс приложения.

  5. Работники текущего запущенного приложения отображаются на панели инспектора фоновых задач . Нажмите на работника, которого вы хотите проверить дальше.

Просмотр и проверка работников

При развертывании приложения с помощью WorkManager 2.5.0 или более поздней версии на устройстве с API уровня 26 или более поздней на вкладке «Инспектор фоновых задач» отображаются активные рабочие процессы. Инспектор фоновых задач (показанный ниже на рис. 3) отображает имя класса, текущий статус, время запуска и повторные попытки всех заданий, независимо от того, выполняются ли они, завершились сбой или завершены.

Детали работы

Щелкните задание из списка, чтобы открыть панель «Сведения о работе» , на которой отображается подробная информация о работнике, как показано на рисунке 1.

Снимок экрана с данными выбранного работника.
Рисунок 1. Панель «Сведения о работе» .
  • Описание : в этом разделе указано имя рабочего класса с полным пакетом, а также назначенный тег и UUID рабочего.
  • Выполнение : в этом разделе показаны ограничения работника (если таковые имеются), частота выполнения и состояние, а также какой класс создал и поставил в очередь работника.
  • WorkContinuation : в этом разделе показано, где находится работник в рабочей цепочке. Чтобы проверить сведения о другом работнике в рабочей цепочке, щелкните его UUID.
  • Результаты : в этом разделе отображается время начала, количество повторов и выходные данные выбранного работника.

Отменить работников

Чтобы остановить работающего в данный момент или поставленного в очередь работника, выберите работника и нажмите «Отменить выбранный работник».с панели инструментов.

Просмотр графика

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

Чтобы увидеть визуальное представление цепочки исполнителей, выберите работника из таблицы и нажмите «Показать представление графика». с панели инструментов. На графике нарисованы только рабочие.

Снимок экрана с видом графика.
Рисунок 2. Представление графика.

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

Чтобы вернуться к просмотру списка, нажмите «Показать представление списка». .

Просмотр и проверка заданий, сигналов тревоги и Wakelocks

Инспектор фоновых задач также позволяет вам проверять задания, сигналы тревоги и Wakelocks вашего приложения. Каждый тип асинхронной задачи отображается под соответствующим заголовком на вкладке «Инспектор», что позволяет легко отслеживать ее состояние и ход выполнения.

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

Чтобы просмотреть подробную информацию о работнике, задании, сигнале тревоги или блокировке пробуждения, выберите его на панели сведений о задаче справа.

Снимок экрана окна инспектора фоновых задач.
Рисунок 3. Окно инспектора фоновых задач.

Дополнительные ресурсы

Дополнительные сведения об инспекторе фоновых задач см. в следующих дополнительных ресурсах:

Документация

Кодлабы

Сообщения в блоге