2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
트레이스 캡처
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
기기에서, Winscope를 통해 또는 Android 디버그 브리지 (adb) 명령어를 통해 트레이스를 캡처할 수 있습니다.
Winscope에서는 이전 세션 중에 기기에서 수집된 최신 트레이스를 검색할 수 있습니다. 이 기능은 Wi-Fi를 통한 ADB 사용과 같은 연결 문제가 발생하거나 Winscope가 예기치 않게 닫힐 때 특히 유용합니다. 마지막 세션의 트레이스가 없는 경우 Winscope에 유효한 트레이스 파일 없음이 표시됩니다.
오류 메시지
Winscope는 트레이스 수집 중에 다음 메시지를 표시합니다.
| 메시지 |
설명 |
| 선택한 트레이스 타겟 없음 |
선택한 트레이스 체크박스가 없습니다. |
추적 중에 오류가 발생했습니다.
오류: INVALID_LAYER_STACK, 디스플레이 상태를 확인해 주세요 (트레이스 시작 시 켜져 있어야 함). |
화면 녹화가 요청되었지만 트레이스 시작 시 디스플레이가 꺼져 있었습니다. |
추적 중에 오류가 발생했습니다.
adb 명령어에서 수신된 특정 오류 메시지(예:<trace types
requested>의 유효한 파일을 찾을 수 없음) |
adb가 트레이스 파일을 읽을 수 없습니다. 이는 일반적으로 adb가 루트로 실행되지 않을 때 발생합니다. |
| 추적 중에 오류가 발생했습니다.
추적 시간 초과 |
기기의 연결에 문제가 있습니다. |
| 추적 중에 오류가 발생했습니다.
{내부 오류} |
이 메시지는 다른 모든 오류를 포함합니다. |
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Capture traces\n\nYou can capture traces on the\n[device](/docs/core/graphics/winscope/capture/on-device),\nthrough\n[Winscope](/docs/core/graphics/winscope/capture/winscope),\nor through\n[Android Debug Bridge (adb)](/docs/core/graphics/winscope/capture/adb)\ncommands.\n\nIn Winscope, you can retrieve the latest traces collected from a device during\nthe previous session. This feature is especially helpful when facing connection\nissues, such as using ADB over Wi-Fi, or when Winscope closes unexpectedly. If\nthere are no traces from the last session, Winscope displays **No valid trace\nfiles found**.\n\nError messages\n--------------\n\nWinscope shows the following messages during trace collection:\n\n| Message | Description |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| No trace targets selected | No trace checkboxes are selected. |\n| Errors occurred during tracing: ERROR: `INVALID_LAYER_STACK`, please check your display state (must be on at start of trace) | A screen recording was requested, but the display was off at the start of trace. |\n| Errors occurred during tracing: A specific error message received from adb command, such as Failed to find valid files for *\\\u003ctrace types requested\\\u003e* | adb couldn't read the trace files, which typically happens when adb isn't running as root. |\n| Errors occurred during tracing: *Tracing time out* | There's a connection issue with the device. |\n| Errors occurred during tracing: *{inner error}* | This message covers all other errors. |"]]
