다음 계측 인수로 라이브러리의 동작을 구성합니다. 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의 외부 디렉터리