Tracing

  
시스템 트레이스 버퍼에 트레이스 이벤트를 씁니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2023년 11월 29일 1.2.0 - - 1.3.0-alpha02

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.3

버전 1.3.0-alpha02

2023년 6월 21일

androidx.tracing:tracing:1.3.0-alpha02androidx.tracing:tracing-ktx:1.3.0-alpha02 버전은 이전 알파에서 변경사항 없이 출시되었습니다. 버전 1.3.0-alpha02에 포함된 커밋을 확인하세요.

버전 1.3.0-alpha01

2023년 6월 7일

androidx.tracing:tracing:1.3.0-alpha01androidx.tracing:tracing-ktx:1.3.0-alpha01가 출시되었습니다. 버전 1.3.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • @Composable에서 사용을 허용하려면 트레이스에서 교차 인라인을 삭제하세요. 추가했습니다. (I53882, b/248344805)

버전 1.2

버전 1.2.0

2023년 11월 29일

androidx.tracing:tracing:1.2.0androidx.tracing:tracing-ktx:1.2.0가 출시되었습니다. 버전 1.2.0에 포함된 커밋을 확인하세요.

1.1.0 이후 중요 변경사항

  • 지연 문자열 및 쿠키 계산을 사용하여 trace()traceAsync() 변형을 추가합니다. 또한 이제 Trace.begin이 발생하면 Trace.end를 올바르게 건너뜁니다.

버전 1.2.0-rc01

2023년 5월 24일

androidx.tracing:tracing:1.2.0-rc01androidx.tracing:tracing-ktx:1.2.0-rc01가 출시되었습니다. 버전 1.2.0-rc01에 포함된 커밋을 확인하세요.

버그 수정

  • 긴 트레이스 섹션 이름이 전달될 때 자동으로 잘라내어 비정상 종료를 방지합니다. (Iaf6e2)

버전 1.2.0-beta04

2023년 5월 3일

androidx.tracing:tracing:1.2.0-beta04androidx.tracing:tracing-ktx:1.2.0-beta04 버전은 변경사항 없이 출시되었습니다. 버전 1.2.0-beta04에 포함된 커밋을 확인하세요.

버전 1.2.0-beta03

2023년 4월 5일

androidx.tracing:tracing:1.2.0-beta03androidx.tracing:tracing-ktx:1.2.0-beta03 버전은 새로운 변경사항 없이 출시되었습니다. 버전 1.2.0-beta03에 포함된 커밋을 확인하세요.

버전 1.2.0-beta02

2023년 3월 22일

androidx.tracing:tracing:1.2.0-beta02androidx.tracing:tracing-ktx:1.2.0-beta02 버전은 이전 베타 이후 변경사항 없이 출시되었습니다. 버전 1.2.0-beta02에 포함된 커밋을 확인하세요.

버전 1.2.0-beta01

2023년 3월 8일

androidx.tracing:tracing:1.2.0-beta01androidx.tracing:tracing-ktx:1.2.0-beta01은 마지막 알파 이후 변경사항 없이 출시되었습니다. 버전 1.2.0-beta01에 포함된 커밋을 확인하세요.

버전 1.2.0-alpha02

2023년 2월 23일

androidx.tracing:tracing:1.2.0-alpha02androidx.tracing:tracing-ktx:1.2.0-alpha02이 이전 알파에서 변경사항 없이 출시되었습니다. 버전 1.2.0-alpha02에 포함된 커밋을 확인하세요.

버그 수정

  • 이 버전은 androidx.tracing: tracing-perfetto-common:1.0.0-alpha11로 업그레이드할 때 발생하는 Could not find androidx.tracing:tracing-ktx:1.2.0-alpha02 오류를 해결합니다.

버전 1.2.0-alpha01

2022년 10월 5일

androidx.tracing:tracing:1.2.0-alpha01androidx.tracing:tracing-ktx:1.2.0-alpha01가 출시되었습니다. 버전 1.2.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 지연 문자열 및 쿠키 계산을 사용하여 trace()traceAsync() 변형을 추가합니다. 또한 이제 Trace.begin이 발생하면 Trace.end를 올바르게 건너뜁니다. (I31421, b/175233952, b/247066503)

트레이싱 버전 1.1

버전 1.1.0

2022년 5월 11일

androidx.tracing:tracing:1.1.0androidx.tracing:tracing-ktx:1.1.0가 출시되었습니다. 버전 1.1.0에 포함된 커밋을 확인하세요.

1.0.0 이후 중요 변경사항

  • 디버그할 수 없는 빌드에서 앱 추적 섹션 캡처(android.os.Trace/androidx.tracing API)를 강제로 사용 설정하는 API인 Trace.forceEnableAppTracing()을 추가했습니다. API 29에서 프로파일링 가능한 매니페스트 태그를 도입하기 전까지는 시작 시 이 API를 호출하여 디버그할 수 없는 빌드에 대해 정확한 시스템 추적을 사용 설정하세요. (I3a309)
  • Trace.java가 처음 로드될 때 발생하는 클래스 확인 오류를 방지했습니다. (05f6b4cb101f)

버전 1.1.0-rc01

2022년 4월 20일

androidx.tracing:tracing:1.1.0-rc01androidx.tracing:tracing-ktx:1.1.0-rc01 버전은 beta01 이후 변경사항 없이 출시되었습니다. 버전 1.1.0-rc01에 포함된 커밋을 확인하세요.

버전 1.1.0-beta01

2021년 12월 1일

androidx.tracing:tracing:1.1.0-beta01androidx.tracing:tracing-ktx:1.1.0-beta01이 출시되었습니다. 버전 1.1.0-beta01에 포함된 커밋을 확인하세요.

1.1.0-alpha02 이후 변경사항이 없습니다.

버전 1.1.0-alpha02

2021년 11월 17일

androidx.tracing:tracing:1.1.0-alpha02androidx.tracing:tracing-ktx:1.1.0-alpha02가 출시되었습니다. 버전 1.1.0-alpha02에 포함된 커밋을 확인하세요.

새로운 기능

  • 디버그할 수 없는 빌드에서 앱 추적 섹션 캡처(android.os.Trace/andoridx.tracing API)를 강제로 사용 설정하는 API인 Trace.forceEnableAppTracing()을 추가했습니다. API 29에서 프로파일링 가능한 매니페스트 태그를 도입하기 전까지는 시작 시 이 API를 호출하여 디버그할 수 없는 빌드에 대해 정확한 시스템 추적을 사용 설정하세요. (I3a309)

버전 1.1.0-alpha01

2021년 11월 3일

androidx.tracing:tracing:1.1.0-alpha01androidx.tracing:tracing-ktx:1.1.0-alpha01가 출시되었습니다. 버전 1.1.0-alpha01에 포함된 커밋을 확인하세요.

버그 수정

  • Trace.java가 처음 로드될 때 발생하는 클래스 확인 오류를 방지했습니다. (05f6b4cb101f)

Tracing Perfetto 버전 1.0.0

버전 1.0.0

2023년 10월 4일

androidx.tracing:tracing-perfetto:1.0.0, androidx.tracing:tracing-perfetto-binary:1.0.0, androidx.tracing:tracing-perfetto-handshake:1.0.0이 출시되었습니다. 버전 1.0.0에 포함된 커밋을 확인하세요.

1.0.0의 주요 기능

  • Tracing-perfetto 라이브러리의 첫 번째 안정화 버전입니다.

버전 1.0.0-rc01

2023년 9월 20일

androidx.tracing:tracing-perfetto:1.0.0-rc01, androidx.tracing:tracing-perfetto-binary:1.0.0-rc01androidx.tracing:tracing-perfetto-handshake:1.0.0-rc01은 지난 베타 이후 변경사항 없이 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.

버전 1.0.0-beta03

2023년 8월 30일

androidx.tracing:tracing-perfetto:1.0.0-beta03, androidx.tracing:tracing-perfetto-binary:1.0.0-beta03, androidx.tracing:tracing-perfetto-handshake:1.0.0-beta03이 출시되었습니다. 버전 1.0.0-beta03에 포함된 커밋을 확인하세요.

  • androidx.benchmark 출시와 일치하는 버전 범프

버전 1.0.0-beta02

2023년 8월 23일

androidx.tracing:tracing-perfetto:1.0.0-beta02, androidx.tracing:tracing-perfetto-binary:1.0.0-beta02, androidx.tracing:tracing-perfetto-handshake:1.0.0-beta02이 출시되었습니다. 버전 1.0.0-beta02에 포함된 커밋을 확인하세요.

새로운 기능

  • 앱 시작 (콜드 스타트) 시 추적 지원을 사용 설정했습니다.

버전 1.0.0-beta01

2023년 7월 18일

androidx.tracing:tracing-perfetto:1.0.0-beta01, androidx.tracing:tracing-perfetto-binary:1.0.0-beta01, androidx.tracing:tracing-perfetto-handshake:1.0.0-beta01이 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

  • androidx.tracing.perfetto.Trace의 이름을 androidx.tracing.perfetto.PerfettoSdkTrace로 바꿨습니다. (I44af8)
  • 일관성을 위해 프로토콜에서 '종료 코드'의 이름을 '결과 코드' 상수로 변경했습니다. (Id1d1e)
  • EnableTracingResponse에서 Response으로 이름이 변경되었습니다. 추가했습니다. (I56275)
  • 영구 모드에서 콜드 스타트 추적을 사용 설정하는 옵션이 추가되었습니다. 영구적 또는 비영구적 콜드 스타트 추적을 지우기 위한 함수가 추가되었습니다. 추가했습니다. (Iaa09d)
  • Tracing Perfetto SDK API가 android.os.Trace와 일치하도록 했습니다. 추가했습니다. (I73ba0, b/282199917)
  • 필요한 경우 향후 사용 사례 (예: .so 파일 직접 로드)를 API에 쉽게 추가할 수 있도록 LibrarySource의 팩토리 패턴으로 이동했습니다. 추가했습니다. (I128df)
  • enableTracingColdStart 매개변수를 enableTracingImmediate와 일치시킵니다. (I54126)
  • enableTracingColdStart에서 killProcess 인수를 삭제했습니다. (I81c4d)

버전 1.0.0-alpha17

2023년 6월 21일

androidx.tracing:tracing-perfetto:1.0.0-alpha17, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha17androidx.tracing:tracing-perfetto-handshake:1.0.0-alpha17이 이전 알파에서 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha17에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha16

2023년 6월 7일

androidx.tracing:tracing-perfetto:1.0.0-alpha16, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha16androidx.tracing:tracing-perfetto-common:1.0.0-alpha16이 이전 알파에서 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha16에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha15

2023년 5월 3일

androidx.tracing:tracing-perfetto:1.0.0-alpha15, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha15, androidx.tracing:tracing-perfetto-common:1.0.0-alpha15은 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha15에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha14

2023년 4월 5일

androidx.tracing:tracing-perfetto:1.0.0-alpha14, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha14androidx.tracing:tracing-perfetto-common:1.0.0-alpha14 버전은 새로운 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha14에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha13

2023년 3월 22일

androidx.tracing:tracing-perfetto:1.0.0-alpha13, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha13androidx.tracing:tracing-perfetto-common:1.0.0-alpha13 버전은 마지막 버전 이후 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha13에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha12

2023년 3월 8일

androidx.tracing:tracing-perfetto:1.0.0-alpha12, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha12androidx.tracing:tracing-perfetto-common:1.0.0-alpha12은 이전 알파 이후 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha12에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha11

2023년 2월 22일

androidx.tracing:tracing-perfetto:1.0.0-alpha11, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha11, androidx.tracing:tracing-perfetto-common:1.0.0-alpha11이 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha11에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha10

2023년 2월 8일

androidx.tracing:tracing-perfetto:1.0.0-alpha10, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha10, androidx.tracing:tracing-perfetto-common:1.0.0-alpha10은 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha10에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha09

2023년 2월 10일

androidx.tracing:tracing-perfetto-binary:1.0.0-alpha09가 출시되었습니다. 버전 1.0.0-alpha09에 포함된 커밋을 확인하세요.

새로운 기능

  • 다른 androidx.tracing:tracing-perfetto*: 1.0.0-alpha09 라이브러리가 함께 작동할 수 있도록 버전 범프 출시

2023년 1월 11일

androidx.tracing:tracing-perfetto:1.0.0-alpha09androidx.tracing:tracing-perfetto-common:1.0.0-alpha09 버전은 변경사항 없이 출시되었습니다. 버전 1.0.0-alpha09에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha08

2022년 12월 7일

androidx.tracing:tracing-perfetto:1.0.0-alpha08, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha08, androidx.tracing:tracing-perfetto-common:1.0.0-alpha08이 출시되었습니다. 버전 1.0.0-alpha08에 포함된 커밋을 확인하세요.

새로운 기능

  • 문자열 처리 방식을 최적화하여 성능을 개선했습니다.

버그 수정

  • 클래스가 조금이라도 사용되는 경우 PerfettoNative의 메서드가 가지치기되는 것을 방지하는 ProGuard 규칙이 추가되었습니다(추적이 초기화되었지만 앱에 추적 호출이 없는 경우 틈새 사례에서 비정상 종료를 방지함).

버전 1.0.0-alpha07

2022년 11월 9일

androidx.tracing:tracing-perfetto:1.0.0-alpha07, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha07, androidx.tracing:tracing-perfetto-common:1.0.0-alpha07이 출시되었습니다. 버전 1.0.0-alpha07에 포함된 커밋을 확인하세요.

  • androidx.tracing:tracing-perfetto API의 JNI 오버헤드가 감소되었습니다.

버전 1.0.0-alpha06

2022년 10월 24일

androidx.tracing:tracing-perfetto:1.0.0-alpha06, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha06, androidx.tracing:tracing-perfetto-common:1.0.0-alpha06이 출시되었습니다. 버전 1.0.0-alpha06에 포함된 커밋을 확인하세요.

  • 이 업데이트에는 변경사항이 없습니다. 버전 번호만 업데이트하여 androidx.benchmark와 동기화합니다.

버전 1.0.0-alpha05

2022년 10월 5일

androidx.tracing:tracing-perfetto:1.0.0-alpha05, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha05, androidx.tracing:tracing-perfetto-common:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha04

2022년 9월 21일

androidx.tracing:tracing-perfetto:1.0.0-alpha04, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha04, androidx.tracing:tracing-perfetto-common:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha03

2022년 9월 7일

androidx.tracing:tracing-perfetto:1.0.0-alpha03, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha03, androidx.tracing:tracing-perfetto-common:1.0.0-alpha03이 출시되었습니다.

새로운 기능

  • 1.0.0-alpha02와 비교해 새로운 기능이 없습니다.

버전 1.0.0-alpha02

2022년 8월 24일

androidx.tracing:tracing-perfetto:1.0.0-alpha02, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha02, androidx.tracing:tracing-perfetto-common:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.

버그 수정

  • Perfetto 서비스 초기화의 몇 가지 개선사항
  • 전용 종료 코드(RESULT_CODE_CANCELLED)를 도입하여 무응답 케이스 처리를 개선했습니다.
  • 파싱 오류 처리를 개선했습니다.
  • 패키지와 통신할 수 없는 경우 버전을 알 수 없으므로 EnableTracingResponse.requiredVersion가 null을 허용하게 만들었습니다. (I5ba20)

버전 1.0.0-alpha01

2022년 7월 27일

androidx.tracing:tracing-perfetto:1.0.0-alpha01, androidx.tracing:tracing-perfetto-binary:1.0.0-alpha01, androidx.tracing:tracing-perfetto-common:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

  • 참고: 모든 androidx.tracing:tracing-perfetto* 라이브러리는 처음에는 AndroidX 라이브러리 내부에서만 사용하도록 된 것입니다. 이 라이브러리에 직접 의존하지 않아도 됩니다.

새로운 기능

  • 모든 androidx.tracing:tracing-perfetto* 라이브러리는 처음에는 AndroidX 라이브러리 내부에서만 사용하도록 된 것입니다. 따라서 이 라이브러리에 직접 의존하지 않아도 됩니다. 투명성을 위해 구현 세부정보를 기록하고 있습니다.

  • androidx.tracing:tracing-perfetto는 오버헤드가 낮은 Perfetto SDK를 사용하여 트레이스 이벤트를 작성하는 데 도움이 되는 라이브러리입니다. 벤치마크나 Android 스튜디오, Perfetto UI 내에서 사용할 수 있습니다.

  • androidx.tracing:tracing-perfetto-binary는 androidx.tracing:tracing-perfetto에 필요한 바이너리 종속 항목 집합입니다.

  • androidx.tracing:tracing-perfetto-common은 androidx.tracing:tracing-perfetto의 내부 종속 항목이며 도구에서 사용하여 androidx.tracing:tracing-perfetto와 통합할 수 있습니다.

트레이싱 버전 1.0.0

버전 1.0.0

2020년 10월 28일

androidx.tracing:tracing:1.0.0androidx.tracing:tracing-ktx:1.0.0가 출시되었습니다. 버전 1.0.0에 포함된 커밋을 확인하세요.

1.0.0의 주요 기능

시스템 추적 버퍼에 추적 이벤트를 작성하는 데 도움이 됩니다. Systrace, Perfetto 같은 도구를 사용하여 이 라이브러리를 시각화할 수 있습니다. 이 라이브러리는 지원 중단된 androidx.core.os.TraceCompat 클래스를 대체합니다.

버전 1.0.0-rc01

2020년 10월 14일

androidx.tracing:tracing:1.0.0-rc01androidx.tracing:tracing-ktx:1.0.0-rc01이 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.

이 버전은 1.0.0-beta01 버전과 동일합니다.

버전 1.0.0-beta01

2020년 6월 24일

androidx.tracing:tracing:1.0.0-beta01androidx.tracing:tracing-ktx:1.0.0-beta01 버전은 1.0.0-alpha01 이후 변경사항 없이 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

버전 1.0.0-alpha01

2020년 6월 10일

androidx.tracing:tracing:1.0.0-alpha01androidx.tracing:tracing-ktx:1.0.0-alpha01가 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

androidx.tracing은 시스템 추적 버퍼에 추적 이벤트를 작성하는 데 도움이 되는 라이브러리입니다. Systrace, Perfetto 같은 도구를 사용하여 이 라이브러리를 시각화할 수 있습니다. 이 라이브러리는 지원 중단된 androidx.core.os.TraceCompat 클래스를 대체합니다. 최초 출시 버전은 1.0.0-alpha01입니다.