계측 테스트 모음은 기기 테스트를 모듈의 기본 src/androidTest/ 디렉터리 외부에 있는 격리된 testApk APK로 패키징합니다. Android Gradle 플러그인(AGP) 테스트 모음 DSL을 사용하여 전용 종속 항목, 변형, 기기 타겟으로 UI, 통합 또는 엔드 투 엔드 검사를 분리하도록 구성합니다.
요구사항
계측 테스트 모음을 사용하려면 프로젝트가 다음 요구사항을 충족해야 합니다.
- Android 스튜디오 Rabbit 3 Canary 3 이상
- AGP 9.6.0-alpha03 이상
- Gradle 9.7.1 이상 및 JDK 17 이상
com.android.application또는com.android.library모듈- Android 디버그 브리지(adb) 또는 빌드 관리 기기 정의를 통해 연결된 기기 또는 에뮬레이터
프리뷰 버전 일치에 관한 자세한 내용은 Android Gradle 플러그인 프리뷰와의 호환성을 참고하세요.
계측 테스트 모음 설정
앱 또는 라이브러리 모듈에 계측 테스트 모음을 추가하려면 다음 단계를 완료하세요.
테스트 모음 사용 설정
프로젝트의 gradle.properties 파일에서 테스트 모음 지원을 사용 설정합니다.
android.experimental.testSuiteSupport=true
도구 모음 구성
모듈의 build.gradle.kts 파일에서 testApk 및 useJunitEngine 블록과 AgpTestSuiteInputParameters enum 값을 사용하여 testOptions.customSuites 블록 내에 모음을 만듭니다.
import com.android.build.api.dsl.AgpTestSuiteInputParameters
android {
testOptions {
// Optional: define build-managed virtual devices and device groups.
managedDevices {
localDevices {
create("api34Atd") {
// Use a device profile from Android Studio.
device = "Pixel 6"
apiLevel = 34
systemImageSource = "aosp-atd"
}
}
groups {
create("ciPhones") {
targetDevices.add(allDevices.getByName("api34Atd"))
}
}
}
customSuites {
create("androidSuite") {
targetVariants += listOf("debug")
testApk {
dependencies {
implementation("junit:junit:4.13.2")
implementation("androidx.test.ext:junit:1.2.1")
implementation("androidx.test:runner:1.6.2")
}
}
useJunitEngine {
includeEngines += listOf("android-test-engine")
// Match the engine and listener versions to your AGP
// version.
enginesDependencies.add(
"com.android.tools.androidtest:" +
"android-test-engine:9.6.0-alpha03"
)
enginesDependencies.add(
"com.android.tools.androidtest:" +
"android-test-engine-result-listener:9.6.0-alpha03"
)
enginesDependencies.add(
"org.junit.platform:junit-platform-launcher:1.10.2"
)
inputs += listOf(
// Omit TESTED_APKS in com.android.library modules.
AgpTestSuiteInputParameters.TESTED_APKS,
AgpTestSuiteInputParameters.TEST_APKS,
AgpTestSuiteInputParameters.ADB_EXECUTABLE,
AgpTestSuiteInputParameters.AAPT2_EXECUTABLE,
)
}
targets {
// Runs on connected adb devices.
create("default")
// Optional: runs on build-managed devices or groups in
// targetDevices.
create("managed") {
targetDevices += listOf("ciPhones")
}
}
}
}
}
}
AGP는 androidTestImplementation 구성에서 종속 항목을 상속하지 않고 AndroidJUnitRunner 테스트 실행기 및 패키지 ID를 자동으로 구성합니다. 커스텀 실행기를 사용하려면 src/{suiteName}/AndroidManifest.xml 파일의 instrumentation 요소에 android:name 속성을 설정합니다.
테스트 만들기
계측 테스트를 {module}/src/{suiteName}/kotlin/ 또는 java/ 디렉터리에 배치하고 선택사항인 res/ 또는 assets/ 디렉터리나 AndroidManifest.xml 파일을 함께 배치합니다. 예를 들어 app/src/androidSuite/kotlin/com/example/myapp/AppContextSuiteTest.kt 파일을 만듭니다.
package com.example.myapp
import androidx.test.ext.junit.runners.AndroidJUnit4
import androidx.test.platform.app.InstrumentationRegistry
import org.junit.Assert.assertEquals
import org.junit.Test
import org.junit.runner.RunWith
@RunWith(AndroidJUnit4::class)
class AppContextSuiteTest {
@Test
fun useAppContext() {
val appContext =
InstrumentationRegistry.getInstrumentation().targetContext
assertEquals("com.example.myapp", appContext.packageName)
}
}
단위 테스트와 계측 테스트 결합
단일 Gradle 작업에서 로컬 JVM 테스트와 계측된 기기 테스트를 실행하려면 하나의 모음에 hostJar 블록과 testApk 블록을 모두 선언합니다. 호스트 테스트는 src/{suiteName}/test/ 디렉터리에, 기기 테스트는 src/{suiteName}/androidTest/ 디렉터리에 배치합니다.
import com.android.build.api.dsl.AgpTestSuiteInputParameters
android {
testOptions {
customSuites {
create("combinedSuite") {
targetVariants += listOf("debug")
hostJar {
dependencies {
implementation(
"org.junit.jupiter:junit-jupiter-api:5.10.2"
)
}
}
testApk {
dependencies {
implementation("junit:junit:4.13.2")
implementation("androidx.test.ext:junit:1.2.1")
implementation("androidx.test:runner:1.6.2")
}
}
useJunitEngine {
includeEngines += listOf(
"junit-jupiter",
"android-test-engine",
)
enginesDependencies.add(
"org.junit.jupiter:junit-jupiter-engine:5.10.2"
)
enginesDependencies.add(
"com.android.tools.androidtest:" +
"android-test-engine:9.6.0-alpha03"
)
enginesDependencies.add(
"com.android.tools.androidtest:" +
"android-test-engine-result-listener:9.6.0-alpha03"
)
enginesDependencies.add(
"org.junit.platform:junit-platform-launcher:1.10.2"
)
inputs += listOf(
// Omit TESTED_APKS in com.android.library modules.
AgpTestSuiteInputParameters.TESTED_APKS,
AgpTestSuiteInputParameters.TEST_APKS,
AgpTestSuiteInputParameters.ADB_EXECUTABLE,
AgpTestSuiteInputParameters.AAPT2_EXECUTABLE,
)
}
targets {
create("default")
}
}
}
}
}
테스트 실행 및 적용 범위 수집
Gradle을 사용하여 계측 모음을 실행하고 테스트 사례를 필터링하고 적용 범위 보고서를 생성합니다.
연결된 기기 또는 빌드 관리 기기에서 실행
모든 온라인 adb 기기에서 연결된 타겟을 실행하거나 targetDevices 속성으로 구성된 타겟을 실행합니다.
# Run on connected adb devices. ./gradlew :app:testDebugAndroidSuiteDefaultTestSuite# Run on the ciPhones build-managed device group. ./gradlew :app:testDebugAndroidSuiteManagedCiPhonesTestSuite
계측 테스트 필터링
Gradle의 --tests 옵션 또는 AndroidJUnitRunner 인수를 사용하여 테스트를 필터링합니다.
./gradlew :app:testDebugAndroidSuiteDefaultTestSuite \
--tests "com.example.myapp.AppContextSuiteTest.useAppContext"-Pandroid.testInstrumentationRunnerArguments.size=small과 같은 프로젝트 속성을 사용하여 명령줄에서 AndroidJUnitRunner 인수를 전달할 수도 있습니다. useJunitEngine 블록에서 기본 실행기 인수를 설정하려면 addInputProperty("android-test.instrumentation-args", "size=small")와 같은 addInputProperty 메서드를 호출합니다.
온디바이스 코드 적용 범위 수집
기기 내 코드 적용 범위에는 디버그 가능한 빌드와 Android 9(API 수준 28) 이상을 실행하는 기기가 필요합니다. 계측 또는 혼합 도구 모음의 적용 범위를 수집하려면 다음 단계를 완료하세요.
gradle.properties파일에서android.experimental.androidTest.coverage.useOnDeviceAgent=true속성을 설정합니다.- 모음에서
codeCoverage속성을true로 설정합니다. - 여러 기기가 연결된 경우
ANDROID_SERIAL환경 변수를 사용하여 하나의 기기를 타겟팅합니다.
에이전트 요구사항에 관한 자세한 내용은 코드 적용 범위 보고서 보기(기기 내 에이전트 사용)를 참고하세요.
검사 보고서
테스트 실행이 완료되면 AGP는 다음 경로에 출력을 생성합니다.
- HTML 테스트 보고서:
{module}/build/reports/tests/{taskName}/index.html - JUnit XML 결과:
{module}/build/test-results/{taskName}/ - 기기별 XML 및 logcat:
{module}/build/intermediates/{variant}/{taskName}/results/ - 코드 적용 범위 보고서:
{module}/build/reports/coverage/{suiteName}/index.html