Robolectric에서 대상 API 버전을 설정하는 방법은 무엇인가요?

Q: Robolectric에서 테스트할 대상 API 버전(target SDK version 또는 Android API level)을 어떻게 설정하나요?

A: Robolectric에서 테스트 대상 API 버전을 지정하는 방법은 여러 가지가 있으며, 대표적으로 다음과 같은 방법들이 있습니다.

---

1. `@Config` 애노테이션 사용하기

`@Config` 애노테이션을 통해 특정 테스트 클래스나 메서드 단위에서 API 레벨을 직접 지정할 수 있습니다.

```java
import org.robolectric.annotation.Config;
import org.junit.Test;
import org.robolectric.RobolectricTestRunner;
import org.junit.runner.RunWith;

@RunWith(RobolectricTestRunner.class)
public class MyTest {

@Test
@Config(sdk = 28) // API 레벨 28로 테스트 실행
public void testAtApi28() {
// 테스트 코드
}

@Test
@Config(sdk = {21, 28}) // API 21과 28 두 가지 버전에서 테스트 실행
public void testAtMultipleApis() {
// 테스트 코드
}
}
```

- `sdk` 파라미터에 단일 정수(`int`)값이나 정수 배열을 전달할 수 있습니다.
- 여러 API 레벨을 지정하면 지정한 각각의 API 버전으로 테스트가 반복 실행됩니다.

---

2. `robolectric.properties` 파일에 기본 API 지정하기

프로젝트의 `src/test/resources/robolectric.properties` 파일에 기본 API 레벨을 설정할 수 있습니다.

```properties
sdk=28
```

- 이 경우 모든 Robolectric 테스트에 대해 별도로 `@Config`를 안 붙여도 기본 API 28로 실행됩니다.
- `@Config` 애노테이션이 지정되어 있으면 해당 값이 우선시됩니다.

---
3. `build.gradle`에서 Robolectric Default Options 설정

최근 버전에서는 `testOptions` 내에 Robolectric 설정을 추가해 기본 API 레벨을 지정할 수 있습니다.

```gradle
android {
...

testOptions {
unitTests.all {
it.systemProperty 'robolectric.sdk', '28'
}
}
}
```

- Gradle을 통해 기본 Robolectric SDK 버전을 설정할 수 있지만, 직접 `@Config`에서 지정하는 것이 더 명확합니다.

---

4. 테스트 실행 시 커맨드라인 옵션으로 SDK 설정 (비권장)

실행 시 다음과 같이 시스템 프로퍼티를 지정할 수도 있습니다.

```bash
-Drobolectric.sdk=28
```

하지만 이 방법보다는 코드 내 `@Config`나 `robolectric.properties` 파일 설정 방식을 추천합니다.

---

요약

|방법|적용 범위|예제|
|-|-|-|
|`@Config(sdk=xx)`|테스트 메서드 또는 클래스|`@Config(sdk=28)`|
|`robolectric.properties`|프로젝트 단위 기본 설정|`sdk=28`|
|`build.gradle` 시스템 프로퍼티|빌드 단위 기본 설정|`systemProperty 'robolectric.sdk', '28'`|
|실행 시 옵션|실행 환경 단위|`-Drobolectric.sdk=28`|

---

참고

- Robolectric 공식 문서: https://github.com/robolectric/robolectric/wiki/Config-Application
- API 레벨 목록: https://developer.android.com/guide/topics/manifest/uses-sdk-element ApiLevels

---

필요에 따라 가장 적절한 방법을 선택하여 Robolectric의 테스트 대상 API 버전을 설정하세요.

Robolectric에서 테스트를 실행할 때 특정 Android API 레벨(즉, SDK 버전)을 지정하는 방법은 여러 가지가 있습니다.

대상 API 버전을 지정하면 Robolectric이 해당 버전에 맞는 Android 프레임워크 클래스를 시뮬레이션 하며, 이를 통해 다양한 API 레벨 간의 동작 차이를 테스트할 수 있습니다.

가장 일반적인 방법은 `@Config` 애너테이션을 사용하는 것입니다.

이 애너테이션을 테스트 클래스나 테스트 메서드에 붙여서 Robolectric이 해당 테스트를 실행할 때 사용할 SDK 버전을 지정할 수 있습니다.

예를 들어: ```java import org.robolectric.annotation.Config; import org.junit.Test; import static org.junit.Assert.*; @Config(sdk = 2

8) public class MyTest { @Test public void testSomething() { // 이 테스트는 API 28 환경에서 실행됩니다.

} } ``` 위 코드에서 `@Config(sdk = 2

8)`은 이 테스트 클래스 내의 모든 테스트 메서드가 Android API 레벨 28 환경에서 실행되도록 지정합니다.

만약 테스트 메서드별로 다른 SDK 버전을 지정하고 싶다면, 메서드 단위로도 적용 가능합니다: ```java @Test @Config(sdk = 21) public void testOnApi21() { // 이 테스트는 API 21 환경에서 실행됩니다.

} @Test @Config(sdk = 30) public void testOnApi30() { // 이 테스트는 API 30 환경에서 실행됩니다.

} ``` `@Config` 애너테이션의 `sdk` 인자에는 단일 숫자(int)를 지정할 수도 있고, 여러 버전을 배열로 지정할 수도 있습니다.

여러 SDK 버전을 지정하면 하나의 테스트가 지정된 각 버전별로 각각 수행됩니다.

예를 들어: ```java @Config(sdk = {21, 28, 30}) public class MultiSdkTest { @Test public void testOnMultipleSdks() { // 이 테스트는 API 21, 28, 30에서 각각 실행됩니다.

} } ``` 또한, Robolectric의 기본 대상 SDK 버전은 프로젝트에 포함된 `build.gradle` 파일이나 `robolectric.properties` 설정에서 결정되는데, `@Config` 애너테이션이 없으면 그 기본값이 사용됩니다.

만약 전체 테스트에서 기본 SDK를 변경하고 싶다면, `robolectric.properties` 파일을 만들고 그 안에 다음처럼 작성할 수도 있습니다: ``` sdk=28 ``` 그러면 명시적으로 지정하지 않는 테스트들은 모두 SDK 28로 실행됩니다.

요약하면 Robolectric에서 대상 API 버전을 설정하는 가장 직관적인 방법은 `@Config(sdk = ...)` 애너테이션을 사용하여 테스트 클래스나 테스트 메서드에 SDK 버전을 지정하는 것입니다.

필요에 따라 여러 SDK 버전을 배열로 지정하여 한꺼번에 여러 API 환경에 대한 테스트를 수행할 수도 있습니다.