Background Task Inspector로 WorkManager 작업자 디버그

Android 스튜디오 Arctic Fox 이상에서는 Background Task Inspector를 사용하면 WorkManager 라이브러리 2.5.0 이상을 사용할 때 앱의 백그라운드 작업자를 시각화하고 모니터링하며 디버그할 수 있습니다.

시작하기

Background Task Inspector에 작업자를 나열하려면 다음 안내를 따르세요.

  1. API 수준 26 이상을 실행하는 에뮬레이터 또는 연결된 기기에서 앱을 실행합니다.

  2. 메뉴 바에서 View > Tool Windows > App Inspection을 선택합니다.

  3. Background Task Inspector 탭을 선택합니다.

  4. 실행 중인 앱 프로세스를 드롭다운 메뉴에서 선택합니다.

  5. 현재 실행 중인 앱의 작업자가 Background Task Inspector 창에 표시됩니다. 추가로 검사하려는 작업자를 클릭합니다.

작업자 보기와 검사

API 수준 26 이상을 실행하는 기기에 WorkManager 2.5.0 이상을 사용하여 앱을 배포하면 아래와 같이 Background Task Inspector 탭에 활성 작업자가 표시됩니다.

Background Task Inspector 창 스크린샷
그림 1. Background Task Inspector 창

Background Task Inspector에는 클래스 이름과 현재 상태, 시작 시간, 재시도, 모든 작업(실행 중이거나 실패하거나 완료된 작업이든 상관없음)의 출력 데이터가 나열됩니다.

작업 세부정보

목록에서 특정 작업을 클릭하면 Work Details 패널이 열리고 여기에는 작업자의 세부정보가 표시됩니다.

선택한 작업자의 세부정보 스크린샷
그림 2. 작업 세부정보

설명

Description 섹션에는 정규화된 패키지가 있는 작업자 클래스 이름과 할당된 태그, 이 작업자의 UUID가 나열됩니다.

실행

Execution 섹션에는 작업자의 제약 조건(있는 경우)과 실행 빈도, 상태, 이 작업자를 만들고 대기열에 추가한 클래스가 표시됩니다.

WorkContuniation

WorkContinuation 섹션에는 이 작업자가 작업 체인에서 어디에 있는지 표시됩니다. 작업 체인에 있는 다른 작업자 세부정보를 확인하려면 UUID를 클릭하세요.

결과

Results 섹션에는 시작 시간과 재시도 횟수, 선택한 작업자의 출력 데이터가 표시됩니다.

작업자 취소

현재 실행 중이거나 대기열에 추가된 작업자를 중지하려면 작업자를 선택하고 툴바에서 Cancel Selected Worker 를 클릭합니다.

그래프 뷰 보기

작업자는 함께 체인될 수 있으므로 작업자 종속 항목을 그래프로 시각화하는 것이 유용할 수도 있습니다. 작업자 체인을 시각적으로 확인하려면 표에서 작업자를 선택하고 툴바에서 Show Graph View 를 클릭합니다.

그래프 뷰 스크린샷
그림 3. 그래프 뷰

그래프를 통해 작업자 간 관계를 빠르게 확인하고 복잡한 체인 관계에서 진행 상황을 모니터링할 수 있습니다.

목록 보기로 돌아가려면 Show List View 를 클릭합니다.

추가 리소스

Background Task Inspector에 관한 자세한 내용은 다음 추가 리소스를 참고하세요.

문서

Codelab

블로그 게시물