수정하기 - Robolectric의 컴파일 타임 오류를 방지하는 방법은 무엇인가요?

닉네임

비밀번호

제목

내용 [이미지 업로드는 권한이 있는 사람만 가능. 하단 카톡으로 연락]

<a href='https://sangseek.com/sangseeks/Robolectric/ko'>Robolectric</a>을 사용할 때 컴파일 타임 오류가 발생하는 경우는 주로 의존성 설정 문제, Android API 호환성 문제, 혹은 테스트 환경 설정 문제에서 비롯됩니다. 이를 방지하고 원활하게 Robolectric 테스트를 작성하기 위한 주요 방안들을 아래와 같이 자세히 설명하겠습니다.    1.   적절한 Robolectric 버전 선택         Robolectric은 Android SDK 버전과의 호환성이 중요합니다. 프로젝트의 `compileSdkVersion`과 Robolectric에서 사용하는 Android SDK 버전이 크게 다르면 컴파일 오류가 발생할 수 있습니다.       - `compileSdkVersion`과 같은 버전대의 Robolectric을 사용하세요. 예를 들어 `compileSdkVersion 33`이라면 Robolectric 4.10 이상을 사용해야 더 잘 호환됩니다.       - Robolectric 공식 GitHub나 릴리즈 노트에서 지원하는 SDK 버전을 확인하세요.    2.   Gradle 의존성 정확히 추가하기         Robolectric을 사용할 때는 Gradle 의존성을 정확한 scope와 함께 추가해야 합니다. 보통 테스트용 라이브러리로 추가합니다. 예:       ```gradle     testImplementation "org.robolectric:robolectric:4.10"     ```       - `testImplementation` 또는 `testCompile`로 지정해야 테스트 컴파일 시 포함됩니다.       - AndroidX와 호환되는 의존성을 사용 중이라면 Robolectric 역시 AndroidX 지원 버전을 쓰는 것이 중요합니다.    3.   Android Test와 일반 Unit Test 구분하기         Robolectric은 JVM 환경에서 Android 코드를 실행하는 단위 테스트용 도구입니다. 실제 디바이스(또는 에뮬레이터)에서 실행하는 Android Instrumented Test와 다릅니다.       - 반드시 `src/test/java` 폴더 내에 테스트 코드를 작성하세요.       - `src/androidTest/java`에서는 Espresso 등 인스트루먼트 테스트를 작성하며 Robolectric이 동작하지 않습니다.    4.   Proper <a href='https://sangseek.com/sangseeks/SDK 설정/ko'>SDK 설정</a> 및 `robolectric.properties` 구성         경우에 따라 SDK 경로나 설정이 부족해 컴파일 오류가 날 수 있습니다. 기본적으로 Robolectric은 Android SDK 경로를 알아서 찾지만, 커스텀 설정이 필요한 경우 파일을 만들어 설정할 수 있습니다.       - `src/test/resources/robolectric.properties` 파일을 만들어 아래와 같이 SDK 경로나 설정 명시 가능       ```     sdk=33     ```       - 시스템 환경변수 `ANDROID_HOME`이 올바르게 설정되어 있는지 확인하세요.    5.   Annotation 사용법 점검         테스트 클래스 위에 `@RunWith(RobolectricTestRunner.class)` 어노테이션을 반드시 붙여야 합니다.       ```java     @RunWith(RobolectricTestRunner.class)     public class MyTest {         // ...     }     ```       이 어노테이션이 없으면 컴파일 타임 또는 런타임에 오류가 발생할 수 있습니다.    6.   AndroidX와 호환되는 버전으로 통일         AndroidX 라이브러리를 쓰고 있다면 Robolectric, androidx.test 라이브러리도 버전을 맞춰야 문제를 예방할 수 있습니다. 서드파티 라이브러리와 충돌이 있을 경우 버전을 조절하거나 exclude 설정으로 충돌을 해결해야 합니다.    7.   빌드 스크립트 캐시 및 클린 빌드         의존성 변경 후 빌드 캐시가 꼬인 경우 컴파일 오류가 날 수 있습니다.       - `./gradlew clean build`로 클린 빌드 해보세요.       - Gradle 캐시 문제거나 IDE 문제라면 IDE 캐시 무효화 후 재시작(Invalidate Caches / Restart)도 도움이 됩니다.    8.   <a href='https://sangseek.com/sangseeks/자바/ko'>자바</a> 버전 호환 확인         Robolectric은 특정 Java 버전에서 더 안정적으로 동작합니다. 예를 들어 Java 11까지는 무난하지만 Java 17 이상에서는 호환 문제가 있을 수 있습니다.       - 프로젝트 Java 버전을 Robolectric과 호환되는 버전으로 맞추세요.       - Gradle에서 `sourceCompatibility`, `targetCompatibility` 설정도 맞춰야 합니다.    ---    요약하면, 컴파일 타임 오류 없이 Robolectric 테스트를 작성하려면 프로젝트 `compileSdkVersion`과 Robolectric 버전을 맞추고, Gradle 의존성을 `testImplementation`으로 정리하며, 테스트 코드는 `src/test/java`에 위치시켜야 합니다. 그리고 꼭 `@RunWith(RobolectricTestRunner.class)`를 붙이고, SDK 환경 변수를 정확히 설정하는 것도 중요합니다. 이 밖에도 빌드 캐시 정리, Java 버전 호환성 확인 등 기본 점검을 꼼꼼히 하면 대부분의 컴파일 오류를 예방할 수 있습니다.