🔍 프로젝트 개요

PhotoCalendar는 Kotlin 기반의 오픈소스 캘린더 라이브러리로, 날짜 및 일정 관리를 위한 다양한 기능을 제공한다. 기존 코드베이스는 java.util.time을 사용하고 있었지만, 특정 버전에서는 호환되지 않는 문제가 발생했기에 kotlinx.datetime으로 마이그레이션하는 작업을 진행했다.

🛠 해결 방안

기존 java.util.time 를 kotlinx.datetime으로 대체하기 위해 주요 변경 사항은 다음과 같다.

1️⃣ LocalDate.now() 대체

java.util.time의 LocalDate.now()를 대체하기 위해 Clock.System.now()와 TimeZone.currentSystemDefault()를 활용하여 현재 날짜를 가져오는 확장 함수를 구현했다.

fun LocalDate.Companion.now(): LocalDate {
    return Clock.System.now()
        .toLocalDateTime(TimeZone.currentSystemDefault())
        .date
}

2️⃣ YearMonth 대체: 커스텀 DateYearMonth 클래스 구현

기존 java.util.time.YearMonth를 kotlinx.datetime에서 제공하지 않기 때문에 커스텀 데이터 클래스 DateYearMonth를 생성하여 연-월을 다룰 수 있도록 했다.

data class DateYearMonth(val year: Int, val month: Int)

이를 통해 YearMonth와 동일한 기능을 제공하며, 연-월 연산을 수행할 수 있도록 확장했다.

3️⃣ 확장 함수 구현

java.util.time에서 제공하던 주요 기능들을 유지하기 위해 확장 함수를 활용하여 대체했다.

예를 들어, 특정 요일을 기준으로 날짜를 계산하는 previousOrSame(target: DayOfWeek) 함수와, DateYearMonth 객체에서 월을 더하는 plusMonths(months: Int) 함수를 직접 구현했다.

internal fun LocalDate.previousOrSame(target: DayOfWeek): LocalDate { ... }
internal fun DateYearMonth.plusMonths(months: Int): DateYearMonth { ... }

해당 PR 링크

🎯 적용 결과

kotlinx.datetime을 사용하여 Kotlin 멀티플랫폼 지원 강화
java.util.time 종속성을 제거하고, 보다 가볍고 효율적인 날짜 처리 가능
기존 기능을 유지하면서, Kotlin 스타일에 맞는 API로 개선

🔗 마무리

앞으로도 Kotlin 생태계에 맞춰 개선을 진행할 계획이며, PhotoCalendar 오픈소스에 기여할 수 있어 뜻깊은 경험이었다.

참고

PhotoCalendar Repo