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

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

開始使用

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

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

  2. 在選單列中依序選取「View」>「Tool Windows」>「App Inspection」。

  3. 選取「Background Task Inspector」分頁標籤。

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

  5. 正在執行應用程式的工作站會顯示在「Background Task Inspector」窗格中。按一下要進一步檢查的工作站。

檢視並檢查工作站

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

工作詳細資料

按一下清單中的特定工作,即可開啟「Work Details」面板,該面板會顯示工作站的詳細資訊。

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

取消工作站

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

查看圖形檢視

由於工作站可以串連在一起,因此有時可以將工作站的依附關係以圖形呈現。若要以視覺化的方式查看工作站鏈結,請在表格中選取工作站,然後按一下工具列中的「Show Graph View」。圖形中只會顯示工作站。

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

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

若要返回清單檢視,請按一下「Show List View」

瀏覽及檢查工作、鬧鐘和 Wakelock

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

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

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

其他資源

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

說明文件

程式碼研究室

網誌文章