后台任务检查器可帮助您在使用 WorkManager 库 2.5.0 或更高版本时可视化、监控和调试应用的后台工作线程。
开始使用
要列出后台任务检查器中的工作线程,请执行以下操作
在运行 API 级别 26 或更高版本的模拟器或已连接设备上 运行您的应用。
从菜单栏中选择**查看 > 工具窗口 > 应用检查**。
选择**后台任务检查器**选项卡。
从菜单中选择正在运行的应用进程。
当前正在运行的应用中的工作器会显示在**后台任务检查器**窗格中。点击您要进一步检查的工作器。
查看和检查工作器
当您在运行 API 级别 26 或更高版本的设备上使用 WorkManager 2.5.0 或更高版本部署应用时,**后台任务检查器**选项卡会显示活动的工作器。**后台任务检查器**(在后面的部分中作为图 3 显示)列出了所有作业的类名、当前状态、开始时间和重试次数,无论它们是正在运行、失败还是已完成。
工作详细信息
点击列表中的一个作业以打开**工作详细信息**面板,该面板显示有关工作器的详细信息,如图 1 所示。
- 描述:此部分列出了工作器类名(包括完整的限定包名),以及分配的标签和工作器的 UUID。
- 执行:此部分显示工作器的约束条件(如果有)、运行频率和状态,以及创建和排队工作器的类。
- WorkContinuation:此部分显示工作器在工作链中的位置。要检查工作链中另一个工作器的详细信息,请点击其 UUID。
- 结果:此部分显示所选工作器的开始时间、重试次数和输出数据。
取消工作器
要停止当前正在运行或已排队的工作器,请选择该工作器,然后点击工具栏中的**取消选定的工作器** 。
查看图形视图
由于工作器可以链接在一起,因此有时将工作器依赖项可视化成图形会很有用。
要查看工作器链的可视化表示,请从表格中选择一个工作器,然后点击工具栏中的**显示图形视图** 。图中仅绘制工作器。
通过该图形,您可以快速查看工作器之间的关系,并在复杂的链接关系中监控其进度。
要返回列表视图,请点击**显示列表视图** 。
查看和检查作业、警报和唤醒锁
后台任务检查器还允许您检查应用的作业、警报和唤醒锁。每种类型的异步任务都会在检查器选项卡中相应的标题下显示,让您轻松监控其状态和进度。
与工作器类似,您可以选择一个作业、警报或唤醒锁以在任务详细信息面板中检查其详细信息。
要查看工作器、作业、警报或唤醒锁的详细信息,请在右侧的**任务详细信息**面板中选择它。
其他资源
要了解有关后台任务检查器的更多信息,请参阅以下其他资源