使用后台任务检查器调试 WorkManager 工作线程

后台任务检查器可帮助您在使用 WorkManager 库 2.5.0 或更高版本时可视化、监控和调试应用的后台工作线程。

开始使用

要列出后台任务检查器中的工作线程,请执行以下操作

  1. 在运行 API 级别 26 或更高版本的模拟器或已连接设备上 运行您的应用

  2. 从菜单栏中选择**查看 > 工具窗口 > 应用检查**。

  3. 选择**后台任务检查器**选项卡。

  4. 从菜单中选择正在运行的应用进程。

  5. 当前正在运行的应用中的工作器会显示在**后台任务检查器**窗格中。点击您要进一步检查的工作器。

查看和检查工作器

当您在运行 API 级别 26 或更高版本的设备上使用 WorkManager 2.5.0 或更高版本部署应用时,**后台任务检查器**选项卡会显示活动的工作器。**后台任务检查器**(在后面的部分中作为图 3 显示)列出了所有作业的类名、当前状态、开始时间和重试次数,无论它们是正在运行、失败还是已完成。

工作详细信息

点击列表中的一个作业以打开**工作详细信息**面板,该面板显示有关工作器的详细信息,如图 1 所示。

Screenshot of the selected Worker's details.
图 1. 工作详细信息面板。
  • 描述:此部分列出了工作器类名(包括完整的限定包名),以及分配的标签和工作器的 UUID。
  • 执行:此部分显示工作器的约束条件(如果有)、运行频率和状态,以及创建和排队工作器的类。
  • WorkContinuation:此部分显示工作器在工作链中的位置。要检查工作链中另一个工作器的详细信息,请点击其 UUID。
  • 结果:此部分显示所选工作器的开始时间、重试次数和输出数据。

取消工作器

要停止当前正在运行或已排队的工作器,请选择该工作器,然后点击工具栏中的**取消选定的工作器**

查看图形视图

由于工作器可以链接在一起,因此有时将工作器依赖项可视化成图形会很有用。

要查看工作器链的可视化表示,请从表格中选择一个工作器,然后点击工具栏中的**显示图形视图** 。图中仅绘制工作器。

Screenshot of the Graph view.
图 2. 图形视图。

通过该图形,您可以快速查看工作器之间的关系,并在复杂的链接关系中监控其进度。

要返回列表视图,请点击**显示列表视图**

查看和检查作业、警报和唤醒锁

后台任务检查器还允许您检查应用的作业、警报和唤醒锁。每种类型的异步任务都会在检查器选项卡中相应的标题下显示,让您轻松监控其状态和进度。

与工作器类似,您可以选择一个作业、警报或唤醒锁以在任务详细信息面板中检查其详细信息。

要查看工作器、作业、警报或唤醒锁的详细信息,请在右侧的**任务详细信息**面板中选择它。

Screenshot of the Background Task Inspector window.
图 3. 后台任务检查器窗口。

其他资源

要了解有关后台任务检查器的更多信息,请参阅以下其他资源

文档

Codelabs

博文