Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

컴포지션 추적

추적은 성능 문제를 처음 살펴볼 때 가장 좋은 정보 출처입니다. 이를 바탕으로 문제가 무엇이고 어디서부터 살펴보아야 하는지에 관한 가설을 세울 수 있습니다.

Android에서는 시스템 추적과 메서드 트레이스, 이렇게 두 가지 수준의 추적이 지원됩니다.

시스템 추적은 추적하도록 표시된 영역만 추적하므로 오버헤드가 낮고 앱의 성능에 크게 영향을 미치지 않습니다. 시스템 추적은 코드의 특정 섹션을 실행하는 데 걸리는 시간을 파악하는 데 좋습니다.

메서드 트레이스는 앱의 모든 함수 호출을 추적합니다. 이 방법은 비용이 많이 들기 때문에 앱의 성능에 크게 영향을 미치지만, 무슨 일이 일어나고 있는지, 어떤 함수가 얼마나 자주 호출되고 있는지를 전체적으로 파악할 수 있습니다.

시스템 추적에는 기본적으로 개별 구성 가능한 함수가 포함되지 않습니다. 개별 구성 가능한 함수는 메서드 트레이스에서 사용할 수 있습니다.

컴포지션 추적은 시스템 추적 내에서 구성 가능한 함수를 표시합니다. 이 기능은 시스템 추적의 낮은 오버헤드와 메서드 트레이스 수준의 컴포지션 세부 정보라는 두 가지 이점을 제공합니다.

컴포지션 추적 설정

프로젝트에서 리컴포지션 추적을 사용해 보려면 최소한 다음 버전으로 업데이트해야 합니다.

Android 스튜디오 Flamingo
Compose UI: 1.3.0
Compose Compiler: 1.3.0

추적을 실행하는 기기 또는 에뮬레이터도 API 수준 30 및 이후 버전이어야 합니다.

여기에 더해 Compose 런타임 추적에 새 종속 항목을 추가해야 합니다.

implementation("androidx.compose.runtime:runtime-tracing:1.11.1")

Compose BOM을 사용하는 경우 버전을 지정할 필요가 없습니다.

val composeBom = platform("androidx.compose:compose-bom:2026.05.00")
implementation(composeBom)
// ...

// dependency without a version
implementation("androidx.compose.runtime:runtime-tracing")

이 종속 항목을 추가하고 재구성이 포함된 시스템 추적을 실행하면 구성 가능한 함수를 자동으로 볼 수 있습니다.

시스템 추적 실행

시스템 추적을 실행하여 새로운 재구성 추적이 어떻게 작동하는지 확인하려면 다음 단계를 따르세요.

프로파일러를 엽니다.

그림 2. Android 스튜디오 - 프로파일링 시작
CPU 타임라인 을 클릭합니다.

그림 3. Android 스튜디오 프로파일러 - CPU 타임라인
앱에서 추적하려는 UI로 이동한 다음 System Trace를 선택하고 Record를 선택합니다.

그림 4. 추적 옵션 - System Trace
앱에서 재구성을 유발한 다음 녹화를 중지합니다. 추적이 처리되고 표시되면 재구성 추적에서 컴포저블을 볼 수 있습니다. 키보드와 마우스를 사용하여 추적을 확대/축소하고 패닝할 수 있습니다. 추적을 살펴보는 데 익숙하지 않으면 트레이스 기록 문서를 참고하세요.

그림 5. 시스템 추적

차트에서 컴포저블을 더블클릭하면 소스 코드로 이동합니다.
Flame Chart의 컴포저블도 파일 및 줄 번호와 함께 확인할 수 있습니다.

그림 6. Flame Chart

주의사항

컴포지션 추적을 사용할 때는 APK 크기 및 성능과 관련된 다음 주의사항을 고려하세요.

APK 크기 오버헤드

Google에서는 이 기능의 오버헤드를 가급적 최소화하려고 했지만, Compose 컴파일러가 APK에 삽입한 추적 문자열로 인해 Compose 앱의 APK 크기가 늘어납니다. 이 크기 증가는 앱에서 Compose를 많이 사용하지 않는 경우 비교적 작을 수 있으며 전체 Compose 앱의 경우 더 클 수 있습니다. 이러한 추적 문자열은 앞서 설명한 대로 추적 도구에 표시될 수 있도록 추가로 난독화 해제됩니다. Compose 컴파일러는 버전 1.3.0부터 모든 앱에 추적 문자열을 삽입합니다.

다음 Proguard 규칙을 추가하여 프로덕션 빌드에서 추적 문자열을 삭제할 수 있습니다.

-assumenosideeffects public class androidx.compose.runtime.ComposerKt {

   boolean isTraceInProgress();

   void traceEventStart(int,int,int,java.lang.String);

   void traceEventStart(int,java.lang.String);

   void traceEventEnd();

}

이러한 함수는 추후 변경될 수 있으며, 모든 변경사항은 Compose 출시 노트에서 확인할 수 있습니다.

함수를 유지하면 APK 크기 비용이 발생하지만 프로파일링되는 APK가 앱 사용자가 실행하는 APK와 동일하도록 보장합니다.

정확한 타이밍

모든 성능 테스트가 그렇듯이 정확한 프로파일링을 위해서는 프로파일링 가능한 애플리케이션에 따라 앱을 profileable 및 non-debuggable로 만들어야 합니다.

터미널에서 트레이스 캡처

터미널에서 컴포지션 트레이스를 캡처할 수 있습니다. 이렇게 하려면 Android 스튜디오에서 일반적으로 자동으로 실행하는 단계를 수행해야 합니다.

종속 항목 추가

먼저 앱에 종속 항목을 추가합니다.

implementation("androidx.tracing:tracing-perfetto:1.0.0")
implementation("androidx.tracing:tracing-perfetto-binary:1.0.0")

레코드 명령어 생성

Perfetto를 사용하여 레코드 명령어를 생성합니다.

다음 예와 같이 track_event 데이터 소스 섹션을 직접 추가합니다.

adb shell perfetto \
  -c - --txt \
  -o /data/misc/perfetto-traces/trace \
<<EOF
buffers: {
    size_kb: 63488
    fill_policy: RING_BUFFER
}
buffers: {
    size_kb: 2048
    fill_policy: RING_BUFFER
}
data_sources: {
    config {
        name: "track_event"
    }
}
duration_ms: 10000
flush_period_ms: 30000
incremental_state_config {
    clear_period_ms: 5000
}
EOF

trace 캡처

앱을 실행하고 추적하려는 섹션을 준비합니다.

브로드캐스트를 실행하여 앱에서 추적을 사용 설정합니다.

# set app package variable, e.g. com.google.samples.apps.nowinandroid.debug
# can be found through `adb shell ps -ef` or `adb shell cmd package list packages`
package=<your app process>

# issue a broadcast to enable tracing
adb shell am broadcast \
-a androidx.tracing.perfetto.action.ENABLE_TRACING \
$package/androidx.tracing.perfetto.TracingReceiver

이전에 만든 녹화 명령어를 시작합니다.

트레이스 열기

adb pull <location> 기기에서 트레이스를 합니다 (레코드 명령어에 지정된 위치).
Perfetto에서 엽니다.

Jetpack Macrobenchmark로 트레이스 캡처

결과로 트레이스를 제공하는 Jetpack Macrobenchmark 로 성능을 측정할 수 있습니다. Macrobenchmark로 컴포지션 추적을 사용 설정하려면 다음을 실행해야 합니다.

Macrobenchmark 테스트 모듈에 다음 종속 항목을 추가합니다.

implementation("androidx.tracing:tracing-perfetto:1.0.0")
implementation("androidx.tracing:tracing-perfetto-binary:1.0.0")

벤치마크를 실행하기 전에 androidx.benchmark.fullTracing.enable=true 계측 인수를 추가합니다. Macrobenchmark 계측 인수에 관한 자세한 내용은 Macrobenchmark instrumentation arguments를 참고하세요.

의견

이 기능 및 발견한 버그와 요청에 관한 의견을 보내주세요. Issue Tracker를 사용하여 의견을 보내주실 수 있습니다 .

개요

스택 추적