使用背景工作檢查器對 WorkManager 工作站進行偵錯

在 Android Studio Arctic Fox 以上版本中,使用 WorkManager 程式庫 2.5.0 以上版本時,背景工作檢查器可協助您以視覺化方式呈現、監控及偵錯應用程式的背景工作站。

開始使用

如要在背景工作檢查器中列出工作站,請執行下列操作:

  1. 在執行 API 級別 26 以上的模擬器或已連結裝置上執行應用程式

  2. 從選單列中選取檢視 > 工具視窗 > 應用程式檢查

  3. 選取背景工作檢查器分頁標籤。

  4. 從下拉式選單中選取正在執行的應用程式程序。

  5. 執行中應用程式的工作站會顯示在背景工作檢查器窗格中。按一下要進一步檢查的工作站。

檢視及查看工作站

在搭載 API 級別 26 以上版本的裝置上,使用 WorkManager 2.5.0 以上版本部署應用程式時,背景工作檢查器分頁標籤應該會顯示運作中的工作站。背景工作檢查器 (如下方所示) 會列出所有執行中、失敗或已完成工作的類別名稱、目前狀態、開始時間和重試次數。

工作詳細資料

按一下清單中的特定工作,即可開啟工作詳細資料面板,其中顯示工作站的詳細資訊。

所選工作站詳細資料的螢幕截圖。
圖 1. 工作詳細資料。
  • 說明:這個部分會列出內含完整套件的工作站類別名稱,以及該工作站指派的標記和 UUID。
  • 執行:這個部分會顯示工作站的限制 (如果有)、執行頻率、狀態,以及建立這個工作站並排入佇列的類別。
  • WorkContuniation:這個部分顯示此工作站在工作鏈結中的位置。若查看工作鏈結中其他工作站的詳細資料,請按一下其 UUID。
  • 結果:這個部分會顯示所選工作站的開始時間、重試次數和輸出資料。

取消工作站

若要停止目前正在執行或已加入佇列的工作站,請選取該工作站,然後按一下工具列中的取消選取工作站

查看圖形檢視

由於工作站可以串連在一起,因此有時可用來將工作站依附元件以圖形呈現。若要查看工作站鏈結的視覺化呈現,請在表格中選取工作站,然後按一下工具列中的顯示圖形檢視 。圖形中只會顯示工作站。

圖形檢視的螢幕截圖。
圖 2. 圖形檢視。

此圖形可讓您快速查看工作站之間的關聯,並監控其在複雜鏈結關聯中的進度。

若要返回清單檢視,請按一下顯示清單檢視

檢視及查看工作、鬧鐘和 Wakelock

背景工作檢查器也可讓您檢查應用程式的工作、鬧鐘和 Wakelock。各類型的非同步工作現在會顯示在檢查器分頁的對應標題底下,方便您監控工作的狀態和進度。與工作站類似,您可以在「工作詳細資料」面板中選取工作、鬧鐘或 Wakelock,藉此檢查其詳細資訊。

若要檢視工作站、工作、鬧鐘或 Wakelock 的詳細資訊,可在右側的工作詳細資料面板中進行選取。

背景工作檢查器視窗的螢幕截圖。
圖 3. 背景工作檢查器視窗。

其他資源

如要進一步瞭解背景工作檢查器,請參閱下列其他資源:

說明文件

程式碼研究室

網誌文章