IntelliJ에서 JUnit4 테스트 환경 설정 및 방법

테스트 코드란 무엇인가?

• 개발자가 작성한 기능 코드가 예상대로 동작하는지 확인하기 위해 작성하는 코드
• 하지만 실제로는 시간에 쫓기다 보니 main 함수에서 직접 테스트를 하는 경우가 많다 . . 🙄

 

이번 겨울특강을 통해 테스트 코드 짜는 습관을 들여보려고 한다!

(아니면, 선생님이 머지를 안해주신다 . . 😅)

 

Kotlin 테스트 도구

• JUnit4: 오랜 시간 동안 표준으로 사용되어 온 도구
• JUnit5: 최신 기능을 지원하는 개선된 버전
• Kotest: Kotlin 친화적인 테스트 프레임워크

 

안드로이드 테스트 환경에서는 JUnit4가 오랜 기간 표준으로 자리 잡고 있었기 때문에,

이번 포스팅에서는 JUnit4를 사용해 테스트 환경을 설정하는 방법을 다룬다.

---

JUnit4 추가 하기

2024년 12월 현재 기준으로 Kotlin 프로젝트를 생성하면, 기본적으로 JUnit5가 테스트 도구로 설정이 되어있다.

따라서 JUnit4를 사용하기 위해서는 몇 가지 설정이 필요하다.

 

1. Gradle 파일 수정하기

build.gradle.kts 파일에 아래 코드를 추가

dependencies {
    testImplementation("junit:junit:4.13.2")
}

 

코드를 추가한 후, 오른쪽 상단에 뜨는 "Sync Now" 버튼을 눌러 Gradle을 동기화!

 

또한 하단의

tasks.test {
    useJUnitPlatform()
}

 

해당 코드는 JUnit5용 사용 설정이기 때문에 제거하는 것이 좋다.

 

2. 테스트 클래스 만들기

테스트를 작성하려는 클래스를 IntelliJ에서 선택한 후

1. 클래스 이름 위에서 Alt + Enter
2. "Create Test"를 선택
3. 테스트 라이브러리로 JUnit4를 선택

예시로 간단한 Calculator 클래스를 작성해 보았음.

class Calculator {

    fun add(a: Int, b: Int): Int = a + b

    fun subtract(a: Int, b: Int): Int = a - b

    fun divide(a: Int, b: Int): Int {
        if (b == 0) throw IllegalArgumentException("Cannot divide by zero")
        return a / b
    }
}

 

여기서 Calculator에 커서를 놓고 Alt + Enter를 누르면,

이렇게 Create test를 볼 수 있다.

 

Testing library에서 Junit4를 선택하고 OK를 눌러주면

 

src/test/kotlin 경로에 CalculatorTest가 생성된다.

 

 

3. JUnit4 애노테이션 사용하기

JUnit4에서 사용할 수 있는 주요 애노테이션

• @Test: 테스트 메서드임을 표시
• @Before: 각 테스트 실행 전에 설정 작업을 수행
• @After: 각 테스트 실행 후 정리 작업을 수행

 

CalculatorTest 클래스에 테스트 코드를 작성해 보았다.

import org.hyunjung.Calculator
import org.junit.Assert.assertEquals
import org.junit.Before
import org.junit.Test

class CalculatorTest {

    private lateinit var calculator: Calculator

    @Before
    fun setUp() {
        calculator = Calculator()
    }

    @Test
    fun testAddition() {
        val result = calculator.add(10, 20)
        assertEquals(30, result)
    }

    @Test
    fun testSubtraction() {
        val result = calculator.subtract(50, 30)
        assertEquals(20, result)
    }

    @Test(expected = IllegalArgumentException::class)
    fun testDivisionByZero() {
        calculator.divide(10, 0)
    }
}

 

해당 테스트 코드는 add와 subtract의 정상 동작을 확인하고,

divide에서는 0으로 나눌 수 없는 예외 처리까지 포함한 케이스를 다루는 테스트 코드이다.

 

4. 테스트 실행하기

테스트 클래스 이름이나 메서드 이름 옆에 있는 재생 버튼 아이콘 클릭!

 

다 초록색 체크 표시(테스트 통과)가 되면 희열을 느껴줍시다 !

 

🌟 트러블 슈팅

만약, 테스트 코드 실행 시 빌드가 안된다면 Settings에 들어가서 해당 속성을 확인

 

---

 

테스트 코드 작성 팁

• 작은 단위로 쪼개서 테스트 작성: 한 번에 여러 기능을 테스트하기보다는, 각각의 기능을 작은 단위로 나눠 테스트
• 이해하기 쉬운 이름 짓기: 테스트 메서드 이름은 테스트 목적이 한눈에 보이도록 작성
• 자주 실행하기: 개발 도중에도 주기적으로 테스트를 실행해서 오류를 빨리 잡아내기