SDK 관련 문의 드립니다.

[JeonJaeRyeol]

사용 중인 프로그래밍 언어 및 버전

jdk17

SDK 버전

1.0.0

운영 환경

AWS/클라우드/호스팅 서버 등 상용 웹 서버

질문/문제 설명

1.0.3 버전을 적용하니 kotlin-stdlib의 ABI 버전이 2.2.0 이상을 요구하여, 다음과 같은 오류가 발생했습니다.

java.lang.NoClassDefFoundError: kotlin/enums/EnumEntriesKt

이는 solapi:sdk:1.0.3이 코틀린 컴파일러 ABI 2.2.0 이상으로 빌드되어, 현재 저희 프로젝트 환경(ABI 2.0.0)에서는 해당 클래스를 찾지 못해 발생하는 것으로 보입니다.

저희 프로젝트 환경상 Gradle 버전을 당장 업데이트하기에는 부담이 있어, 우선 com.solapi:sdk:1.0.0 버전을 적용해볼까 합니다
(최신 코틀린 플러그인(2.2.0) 최소 Gradle 7.6.3요구)

1. com.solapi:sdk:1.0.0 버전을 사용하는 데 큰 문제는 없을까요?
2. 1.0.0 버전과 1.0.3 버전 사이에 기능적으로 중요한 변경 사항이 있는지 궁금합니다.
3. 장기적으로 1.0.3 버전 이상을 안정적으로 사용하려면 Gradle을 7.6.3 이상으로 올리고 코틀린 컴파일러 ABI 2.2.0 환경을 갖추는 것이 유일한 해결책인지 확인 부탁드립니다.

코드 예시

No response

시도한 해결 방법

No response

기대하는 결과

질문에 대한 답변

확인사항

• 관련 문서를 확인했습니다
• 이전 토론/이슈에서 유사한 질문이 없는지 확인했습니다
• 문의 전 읽어야 하는 사항(문의 전 꼭 읽어봐주세요! #7)을 확인했습니다

[Palbahngmiyine]

안녕하세요 회원님, 솔라피 기술지원팀입니다.
보내주신 문의에 순차적으로 답변드리겠습니다.

1. com.solapi:sdk:1.0.0 버전을 사용하는 데 큰 문제는 없을까요?

사용하시는 데에 있어 오류 혹은 큰 문제점이 없으시다면 사용하셔도 큰 문제는 없으십니다. 다만 해당 버전은 Kotlin에서 이용할 때 Java 문법을 그대로 사용해야 한다거나 발송 외 다른 메소드에서 일부 역직렬화 문제 등이 있어서 기존 프로젝트를 Kotlin 2.1.0 이상 혹은 구 버전 SDK를 사용하시는 것을 권장합니다, 구 버전의 SDK는 send 메소드를 사용하실 경우 큰 기능상의 차이점은 없습니다.

2. 1.0.0 버전과 1.0.3 버전 사이에 기능적으로 중요한 변경 사항이 있는지 궁금합니다.

앞서 말씀드린 사항외에는 기능적인 변경사항은 없습니다, 메소드 자체에 breaking change가 있는 것은 아니나 data class 상의 구조 변경(date 계열 타입들이 Spring framework 호환성을 위해 모두 String으로 전환되었습니다) 등의 차이점이 있습니다.

3. 장기적으로 1.0.3 버전 이상을 안정적으로 사용하려면 Gradle을 7.6.3 이상으로 올리고 코틀린 컴파일러 ABI 2.2.0 환경을 갖추는 것이 유일한 해결책인지 확인 부탁드립니다.

송구스럽지만 그렇습니다. 개발 당시 시점에서는 관련 버전들(기존 계획엔 Kotlin 1.8 ~ 지원을 목표로 했었습니다)의 호환성을 고려했으나, 실제 빌드 시 관련 구 버전의 Kotlin 요소들이 depcreated 됐거나, Breaking change 요소들이 있어 부득이하게 2.2.0(실제로는 2.1.0 부터 사용 가능합니다) 버전으로 개발을 진행한 점은 양해 부탁드립니다.