Macrobenchmark 계측 인수

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

다음 계측 인수로 라이브러리의 동작을 구성합니다. Gradle 구성에 추가하거나 명령줄에서 계측을 실행할 때 직접 적용할 수 있습니다. Gradle을 사용하는 경우 다음과 같이 testInstrumentationRunnerArguments에 인수를 추가합니다.

android {
    defaultConfig {
        // ...
        testInstrumentationRunnerArguments["androidx.benchmark.enabledRules"] = "BaselineProfile"
    }
}

명령줄에서 직접 호출하는 경우 -P android.testInstrumentationRunnerArguments.[name of the argument]를 사용합니다.

./gradlew :benchmark:connectedAndroidTest -P android.testInstrumentationRunnerArguments.androidx.benchmark.enabledRules=BaselineProfile

androidx.benchmark.compilation.enabled

벤치마크의 각 반복 사이에 컴파일을 사용 중지할 수 있습니다. 기본적으로 타겟 애플리케이션은 다시 설치되고 각 벤치마크 간에 다시 컴파일되어, measureRepeated에 전달된 CompilationMode를 준수합니다. 예를 들어 테스트 모음을 실행하기 전에 타겟 앱을 한 번 완전히 컴파일하고 완전히 컴파일된 타겟에 모든 벤치마크를 실행하려는 경우 이 기능을 사용 중지하면 재설치와 컴파일을 모두 건너뛸 수 있습니다.

  • 인수 유형: 불리언
  • 기본값: true

androidx.benchmark.dryRunMode.enable

벤치마크를 단일 루프로 실행하여 제대로 작동하는지 확인할 수 있습니다. 일반 테스트와 함께 인증 과정의 일부로 사용할 수 있습니다.

  • 인수 유형: 불리언
  • 기본값: false

androidx.benchmark.enabledRules

한 가지 유형의 테스트(기준 프로필 생성 또는 Macrobenchmark 테스트)에만 필터링 실행을 허용합니다. 쉼표로 구분된 목록도 지원됩니다.

  • 인수 유형: 문자열
  • 사용 가능한 옵션:
    • Macrobenchmark
    • BaselineProfile
  • 기본값: 지정되지 않음

androidx.benchmark.fullTracing.enable(실험용)

Jetpack Compose 컴포지션 추적과 같은 androidx.tracing.perfetto tracepoint를 사용 설정합니다. 이는 StartupMode.COLD가 사용되지 않는 경우에만 영향을 받습니다. tracepoint를 사용 설정하면 타겟 프로세스가 실행되기 때문입니다.

  • 인수 유형: 불리언
  • 기본값: false

androidx.benchmark.suppressErrors

쉼표로 구분된 오류 목록이 경고로 전환되도록 허용합니다.

  • 인수 유형: 문자열 목록
  • 사용 가능한 옵션:
    • DEBUGGABLE
    • LOW-BATTERY
    • EMULATOR
    • NOT-PROFILEABLE
  • 기본값: 빈 목록

additionalTestOutputDir

JSON 벤치마크 보고서 및 프로파일링 결과를 저장할 기기 내 위치를 구성합니다.

  • 인수 유형: 파일 경로 문자열
  • 기본값: 테스트 APK의 외부 디렉터리
이전
앱 제어