Skip to content

Kotlin 발전 원칙 ​

실용적 발전 원칙 ​

언어 설계는 돌에 새겨진 것과 같지만,

이 돌은 제법 부드러워서,

노력을 기울인다면 나중에 다시 다듬을 수 있습니다.

Kotlin 설계 팀

Kotlin은 프로그래머를 위한 실용적인 도구로 설계되었습니다. 언어 발전에 있어 이러한 실용적인 특성은 다음과 같은 원칙에 담겨 있습니다.

  • 시간이 지나도 언어를 현대적으로 유지합니다.
  • 사용자와 지속적인 피드백 루프를 유지합니다.
  • 사용자가 새로운 버전으로 쉽고 편안하게 업데이트할 수 있도록 합니다.

이는 Kotlin이 앞으로 나아가는 방향을 이해하는 핵심이므로, 이 원칙들을 더 자세히 살펴보겠습니다.

현대적인 언어 유지(Keeping the Language Modern). 시스템은 시간이 지남에 따라 레거시(legacy)가 쌓이기 마련입니다. 한때 최첨단 기술이었던 것이 오늘날에는 완전히 뒤처진 구식이 될 수 있습니다. 사용자의 요구에 부응하고 그들의 기대에 발맞추기 위해서는 언어를 발전시켜야 합니다. 여기에는 새로운 기능을 추가하는 것뿐만 아니라, 프로덕션 환경에서 더 이상 권장되지 않고 레거시가 된 이전 기능들을 점진적으로 제거(phasing out)하는 것도 포함됩니다.

편안한 업데이트(Comfortable Updates). 언어에서 특정 요소를 제거하는 것과 같은 비호환 변경 사항(Incompatible changes)은 신중하게 다루지 않으면 한 버전에서 다음 버전으로 마이그레이션할 때 큰 고통을 초래할 수 있습니다. Kotlin 팀은 항상 이러한 변경 사항을 충분히 미리 공지하고, 지원 중단(deprecated)으로 표시하며, 변경이 실제로 발생하기 전에 자동 마이그레이션 도구를 제공할 것입니다. 언어가 변경될 시점이 되면, 전 세계 대부분의 코드가 이미 업데이트되어 새로운 버전으로 마이그레이션하는 데 아무런 문제가 없도록 하는 것이 목표입니다.

피드백 루프(Feedback Loop). 지원 중단 주기를 거치는 것에는 상당한 노력이 들기 때문에, 앞으로 발생할 비호환 변경 사항의 수를 최소화하고자 합니다. 최선의 판단을 내리는 것 외에도, 실환경에서 직접 사용해 보는 것이 설계를 검증하는 가장 좋은 방법이라고 믿습니다. 돌에 완전히 새기기 전에, 실전 테스트(battle-tested)를 거치길 원합니다. 이것이 바로 초기 설계 버전을 언어의 프로덕션 버전에서 제공하되, Experimental, Alpha, 또는 Beta와 같은 사전 안정화(pre-stable) 상태 중 하나로 제공할 수 있는 모든 기회를 활용하는 이유입니다. 이러한 기능들은 안정적이지 않으며 언제든지 변경될 수 있습니다. 또한 이를 사용하도록 선택(opt-in)한 사용자는 향후 마이그레이션 문제를 감수할 준비가 되어 있음을 명시적으로 나타낸 것입니다. 이러한 사용자들이 제공하는 귀중한 피드백을 모아 설계를 반복 개선하고 견고하게 완성해 나갑니다.

비호환 변경 사항 ​

한 버전에서 다른 버전으로 업데이트했을 때 이전에 잘 작동하던 코드가 더 이상 작동하지 않는다면, 이는 언어의 비호환 변경 사항(incompatible change)(때로는 "호환성을 깨는 변경(breaking change)"이라고도 함)입니다. 특정 상황에서 "더 이상 작동하지 않는다"는 의미가 정확히 무엇인지에 대해 논쟁이 있을 수 있지만, 최소한 다음 사항은 분명히 포함됩니다.

  • 정상적으로 컴파일되고 실행되던 코드가 이제 오류와 함께 거부되는 경우(컴파일 또는 링크 시점). 여기에는 언어 구문 제거 및 새로운 제약 조건 추가가 포함됩니다.
  • 정상적으로 실행되던 코드가 이제 예외를 던지는 경우.

"회색 영역(gray area)"에 속하는 덜 명확한 사례로는 코너 케이스를 다르게 처리하거나, 이전과 다른 유형의 예외를 던지거나, 리플렉션을 통해서만 관찰 가능한 동작을 변경하거나, 문서화되지 않았거나 정의되지 않은 동작을 수정하거나, 바이너리 아티팩트의 이름을 변경하는 것 등이 있습니다. 때로는 이러한 변경이 매우 중요하여 마이그레이션 경험에 극적인 영향을 미치기도 하지만, 때로는 미미한 영향을 주기도 합니다.

비호환 변경 사항이 아닌 것이 확실한 예는 다음과 같습니다.

  • 새로운 경고 추가.
  • 새로운 언어 구문 활성화 또는 기존 구문에 대한 제한 완화.
  • private/internal API 및 기타 구현 세부 정보 변경.

현대적인 언어 유지 및 편안한 업데이트 원칙에 따르면 비호환 변경 사항이 때때로 필요하지만, 매우 신중하게 도입되어야 합니다. 우리의 목표는 사용자가 코드를 편안하게 마이그레이션할 수 있도록 예정된 변경 사항을 충분히 미리 인지시키는 것입니다.

이상적으로는 모든 비호환 변경 사항이 문제가 되는 코드에서 컴파일 타임 경고(일반적으로 _지원 중단 경고(deprecation warning)_라고 함)를 통해 보고되어야 하며, 자동화된 마이그레이션 지원 도구가 함께 제공되어야 합니다. 따라서 이상적인 마이그레이션 워크플로는 다음과 같습니다.

  • 버전 A(변경 사항이 공지된 버전)로 업데이트
    • 예정된 변경 사항에 대한 경고 확인
    • 도구의 도움을 받아 코드 마이그레이션
  • 버전 B(실제 변경이 일어나는 버전)로 업데이트
    • 아무런 문제 없이 동작

실제로는 일부 변경 사항을 컴파일 타임에 정확하게 감지할 수 없어 경고를 보고할 수 없는 경우도 있지만, 적어도 버전 A의 릴리스 노트를 통해 버전 B에서 변경이 예정되어 있음을 사용자에게 공지합니다.

컴파일러 버그 처리 ​

컴파일러는 복잡한 소프트웨어이며, 개발자들의 최선의 노력에도 불구하고 버그가 발생합니다. 컴파일러 자체를 중단시키거나 잘못된 오류를 보고하거나 명백히 실패하는 코드를 생성하게 만드는 버그는, 성가시고 종종 당혹스럽긴 하지만 수정 사항이 비호환 변경에 해당하지 않기 때문에 쉽게 고칠 수 있습니다. 그러나 어떤 버그는 컴파일러가 실패하지 않는 잘못된 코드를 생성하게 만들기도 합니다. 예를 들어 소스 코드의 특정 오류를 감지하지 못하거나 단순히 잘못된 명령어를 생성하는 경우입니다. 이러한 버그에 대한 수정은 기술적으로 비호환 변경 사항(이전에는 잘 컴파일되던 코드가 이제는 컴파일되지 않음)이지만, 잘못된 코드 패턴이 사용자 코드 전반에 확산되는 것을 방지하기 위해 가능한 한 빨리 수정하는 편입니다. 이렇게 하면 더 적은 사용자가 해당 문제를 겪게 되므로, 이 방식이 '편안한 업데이트' 원칙에도 부합한다고 생각합니다. 물론 이는 릴리스된 버전에서 나타난 지 얼마 되지 않아 발견된 버그에만 적용됩니다.

의사 결정 ​

Kotlin의 최초 개발사인 JetBrains는 커뮤니티의 도움과 Kotlin Foundation과의 협력을 바탕으로 Kotlin의 발전을 이끌어가고 있습니다.

Kotlin 프로그래밍 언어에 대한 모든 변경 사항은 Lead Language Designer(현재 Michail Zarečenskij)가 총괄합니다. Lead Designer는 언어 발전과 관련된 모든 사안에 대해 최종 결정권을 가집니다. 또한, 완전히 안정화된 컴포넌트에 대한 비호환 변경 사항은 Kotlin Foundation 산하에 지정된 Language Committee(현재 Jeffrey van Gogh, Werner Dietl, Michail Zarečenskij로 구성)의 승인을 받아야 합니다.

Language Committee는 어떤 비호환 변경 사항을 적용할지, 사용자의 업데이트를 최대한 원활하게 만들기 위해 구체적으로 어떤 조치를 취해야 할지에 대한 최종 결정을 내립니다. 이러한 결정을 내릴 때 Language committee guidelines을 따릅니다.

언어 기능 제공 방식 ​

Kotlin 릴리스 프로세스에 설명된 바와 같이, 언어 기능은 언어 릴리스(language release)(2.x.0) 또는 그 이후의 툴링 릴리스(tooling release)(2.x.20)를 통해 제공됩니다.

언어 릴리스와 툴링 릴리스 간의 호환성을 유지하기 위해 컴파일러 변경 사항은 대부분 최적화 및 경고 추가/제거 위주로 이루어집니다. 사전 안정화 상태의 기능은 언제든지 추가, 제거 또는 변경될 수 있습니다.

언어 릴리스에서는 새로운 기능이 추가되거나 사전 안정화 기능이 안정(stable) 상태로 승격되는 경우가 많으며, 이전에 지원 중단된 기능이 제거되거나 변경될 수도 있습니다.

EAP 빌드 ​

언어 및 툴링 릴리스의 안정화 버전을 출시하기 전에, 더 빠르게 반복 작업을 수행하고 커뮤니티의 피드백을 수집하기 위해 EAP("Early Access Preview"의 약자)라는 여러 프리뷰 빌드를 배포합니다. 언어 릴리스의 EAP는 대개 이후 출시될 안정화 컴파일러에서 거부될 바이너리를 생성하는데, 이는 바이너리 포맷에 존재할 수 있는 버그가 프리뷰 기간을 넘겨 지속되지 않도록 하기 위함입니다. RC2나 RC3 같은 최종 릴리스 후보(Release Candidate) 빌드에는 일반적으로 이러한 제한이 없습니다. 자세한 내용은 Kotlin Early Access Preview 참여하기를 참조하세요.

사전 안정화 기능 ​

위에서 설명한 피드백 루프 원칙에 따라, 공개된 환경에서 설계를 반복하고 일부 기능이 사전 안정화(pre-stable) 상태 중 하나를 가지며 _변경될 예정_인 언어 버전을 릴리스합니다. 이러한 기능은 언제든지 예고 없이 추가, 변경 또는 제거될 수 있습니다. 사전 안정화 기능이 인지하지 못한 사용자에게 실수로 사용되지 않도록 최선을 다하고 있습니다. 이러한 기능은 일반적으로 코드나 프로젝트 설정에서 일종의 명시적인 opt-in을 요구합니다.

Kotlin 언어 기능은 다음 상태 중 하나를 가질 수 있습니다.

  • Exploration and design(탐색 및 설계). 언어에 새로운 기능을 도입하는 것을 검토하고 있는 단계입니다. 기존 기능과 어떻게 통합될지 논의하고, 유스케이스를 수집하며, 잠재적 영향을 평가합니다. 이 기능이 해결할 문제와 다루는 유스케이스에 대해 사용자의 피드백이 필요합니다. 가능하다면 이러한 유스케이스와 문제가 얼마나 자주 발생하는지도 추정해 봅니다. 일반적으로 아이디어는 YouTrack 이슈로 문서화되어 논의가 이어집니다.

  • KEEP discussion(KEEP 논의). 해당 기능을 언어에 추가해야 한다는 확신이 꽤 높은 단계입니다. Kotlin Evolution and Enhancement Process(KEEP)라고 불리는 문서에 동기, 유스케이스, 설계 및 기타 중요한 세부 사항을 제공하는 것을 목표로 합니다. 사용자 피드백은 KEEP에 제공된 모든 정보를 논의하는 데 집중될 것으로 기대합니다.

  • In preview(프리뷰). 기능 프로토타입이 준비되었으며, 기능 전용 컴파일러 옵션을 사용하여 활성화할 수 있는 단계입니다. 코드베이스에 얼마나 쉽게 통합되는지, 기존 코드와 어떻게 상호 작용하는지, IDE 지원 문제나 제안 사항 등을 포함하여 기능 사용 경험에 대한 피드백을 구합니다. 피드백에 따라 기능의 설계가 크게 변경되거나 완전히 철회될 수 있습니다. 기능이 in preview 상태일 때는 Experimental 또는 Beta 안정성 수준(stability level)을 가집니다.

  • Stable(안정). 해당 언어 기능이 이제 Kotlin 언어의 일급 시민(first-class citizen)이 된 단계입니다. 이 기능의 하위 호환성을 보장하며 툴링 지원을 제공합니다.

  • Revoked(철회됨). 제안을 철회했으며 해당 기능을 Kotlin 언어에 구현하지 않기로 결정한 단계입니다. in preview 상태인 기능이 Kotlin에 적합하지 않다고 판단되면 철회할 수 있습니다.

Kotlin 언어 제안 및 해당 상태의 전체 목록 보기.

다양한 컴포넌트의 상태 ​

Kotlin/JVM, JS, Native 컴파일러 및 다양한 라이브러리와 같은 Kotlin의 다양한 컴포넌트 안정성 상태에 대해 자세히 알아보세요.

라이브러리 ​

생태계가 없는 언어는 무의미하므로, 매끄러운 라이브러리 발전을 가능하게 하는 데 각별한 주의를 기울이고 있습니다.

이상적으로는 새 버전의 라이브러리를 이전 버전의 "직접적인 대체품(drop-in replacement)"으로 사용할 수 있어야 합니다. 즉, 애플리케이션을 다시 컴파일하지 않더라도 바이너리 종속성을 업그레이드했을 때 아무것도 망가지지 않아야 합니다(동적 링킹 환경에서 가능).

이를 달성하기 위해 한편으로는 분리 컴파일(separate compilation)의 제약 조건 하에서 컴파일러가 특정 Application Binary Interface(ABI) 안정성 보장을 제공해야 합니다. 이것이 바로 언어의 모든 변경 사항을 바이너리 호환성 관점에서 검토하는 이유입니다.

다른 한편으로는 라이브러리 작성자가 어떤 변경이 안전한지 신중하게 판단하는 것에 많은 부분이 달려 있습니다. 따라서 라이브러리 작성자가 소스 코드 변경이 호환성에 어떤 영향을 미치는지 이해하고, 라이브러리의 API와 ABI를 모두 안정적으로 유지하기 위한 특정 모범 사례를 따르는 것이 중요합니다. 라이브러리 발전 관점에서 언어 변경을 고려할 때 세우는 몇 가지 가정은 다음과 같습니다.

  • 라이브러리 코드는 항상 public/protected 함수 및 프로퍼티의 반환 타입을 명시적으로 지정해야 하며, public API에 대해 타입 추론에 의존해서는 안 됩니다. 타입 추론의 미세한 변화로 인해 반환 타입이 부주의하게 변경되어 바이너리 호환성 문제가 발생할 수 있습니다.
  • 동일한 라이브러리에서 제공하는 오버로드된 함수와 프로퍼티는 본질적으로 동일한 작업을 수행해야 합니다. 타입 추론이 변경되면 호출 지점에서 더 정확한 정적 타입을 알게 되어 오버로드 확인(overload resolution) 결과가 달라질 수 있습니다.

라이브러리 작성자는 @Deprecated 및 @RequiresOptIn 어노테이션을 사용하여 API 노출 범위를 제어할 수 있습니다. @Deprecated(level=HIDDEN)을 사용하면 API에서 제거된 선언에 대해서도 바이너리 호환성을 유지할 수 있습니다.

또한 관례상 "internal"이라는 이름의 패키지는 public API로 간주되지 않습니다. "experimental"이라는 이름의 패키지에 있는 모든 API는 사전 안정화 상태로 간주되며 언제든지 변경될 수 있습니다.

Kotlin 표준 라이브러리(kotlin-stdlib)는 위에서 언급한 원칙에 따라 안정적인 플랫폼을 위해 발전해 나갑니다. 표준 라이브러리 API의 규약(contract) 변경은 언어 자체의 변경과 동일한 절차를 거칩니다.

컴파일러 옵션 ​

컴파일러가 지원하는 커맨드 라인 옵션 또한 일종의 public API이며, 동일한 고려 사항이 적용됩니다. 지원되는 옵션("-X" 또는 "-XX" 접두사가 없는 옵션)은 언어 릴리스에서만 추가될 수 있으며, 제거하기 전에 적절한 지원 중단 절차를 거쳐야 합니다. "-X" 및 "-XX" 옵션은 실험적이며 언제든지 추가 및 제거될 수 있습니다.

호환성 도구 ​

레거시 기능이 제거되고 버그가 수정됨에 따라 소스 언어가 변경되므로, 적절히 마이그레이션되지 않은 이전 코드는 더 이상 컴파일되지 않을 수 있습니다. 일반적인 지원 중단 주기는 마이그레이션을 위한 충분한 시간을 제공하며, 그 주기가 끝나고 변경 사항이 안정 버전에 반영된 후에도 마이그레이션되지 않은 코드를 컴파일할 수 있는 방법이 여전히 존재합니다.

호환성 옵션 ​

최신 Kotlin 버전이 이전 버전의 동작을 에뮬레이트하도록 하는 호환성 옵션을 제공합니다.

  • -language-version X.Y – Kotlin 언어 버전 X.Y에 대한 호환 모드입니다. 이후 버전에서 도입된 언어 기능을 코드에서 사용할 경우 컴파일러가 오류를 보고합니다.
  • -api-version X.Y – Kotlin API 버전 X.Y에 대한 호환 모드입니다. 컴파일러 생성 코드에서 참조하는 API를 포함하여, 이후 버전에서 도입된 Kotlin 표준 라이브러리 API를 사용하는 선언을 컴파일러가 무시합니다.

마이그레이션 시간을 더 확보할 수 있도록, JVM에서는 최신 안정 버전 외에도 이전 언어 및 API 버전을 최소 3개까지 지원합니다. 이를 통해 라이브러리 작성자는 이전 컴파일러 버전을 사용하는 소비자와의 호환성을 유지하면서 최신 컴파일러 릴리스를 채택할 수 있습니다. 다른 플랫폼에서도 이전 언어 및 API 버전을 구성할 수 있지만, JVM과 달리 소비자는 여전히 최신 컴파일러 버전을 사용해야 합니다.

대부분의 프로젝트에서는 두 옵션을 동일한 버전으로 설정합니다. 더 낮은 API 버전은 주로 이전 버전의 Kotlin 표준 라이브러리와 호환성을 유지해야 할 때 유용합니다.

활발히 유지 관리되는 코드베이스의 경우 전체 지원 중단 주기가 완료될 때까지 기다리지 않고 가능한 한 빨리 버그 수정을 적용하는 것이 유리할 수 있습니다. 이러한 프로젝트는 -progressive 옵션을 활성화하여 툴링 릴리스에서 이러한 변경 사항이 기본값이 되기 전에 미리 채택할 수 있습니다.

이러한 옵션은 커맨드 라인이나 Gradle 또는 Maven 빌드 도구에서 설정할 수 있습니다.

바이너리 포맷의 발전 ​

최악의 경우 수작업으로 수정할 수 있는 소스 코드와 달리 바이너리는 마이그레이션하기가 훨씬 더 어려우므로, 바이너리의 경우 하위 호환성이 결정적으로 중요합니다. 바이너리에 대한 비호환 변경 사항은 업데이트를 매우 불편하게 만들 수 있으므로 소스 언어 구문의 변경보다 훨씬 더 신중하게 도입해야 합니다.

완전히 안정화된 컴파일러 버전의 경우 기본 바이너리 호환성 프로토콜은 다음과 같습니다.

  • 모든 바이너리는 하위 호환됩니다. 즉, 최신 컴파일러가 이전 바이너리를 읽을 수 있습니다(예: 1.3은 1.0부터 1.2까지의 바이너리를 이해함).
  • 이전 컴파일러는 새로운 기능에 의존하는 바이너리를 거부합니다(예: 1.0 컴파일러는 코루틴을 사용하는 바이너리를 거부함).
  • 보장할 수는 없지만 가급적이면, 바이너리 포맷은 다음 언어 릴리스와 대부분 상위 호환됩니다(새로운 기능이 사용되지 않은 경우. 예를 들어 1.9는 2.0의 바이너리 대부분을 이해할 수 있지만 2.1은 불가). 단, 그 이후 릴리스와는 호환되지 않습니다.

이 프로토콜은 약간 구버전 컴파일러를 사용하더라도 어떤 프로젝트도 종속성 업데이트가 차단되지 않도록 하여 편안한 업데이트를 지원하도록 설계되었습니다.

모든 타깃 플랫폼이 이러한 수준의 안정성에 도달한 것은 아니지만, Kotlin/JVM은 도달했습니다.

Kotlin klib 바이너리 ​

Kotlin klib 바이너리는 Kotlin 1.9.20에서 Stable 수준에 도달했습니다. 그러나 염두에 두어야 할 몇 가지 호환성 세부 사항이 있습니다.

  • klib 바이너리는 Kotlin 1.9.20부터 하위 호환됩니다. 예를 들어, 2.0.x 컴파일러는 1.9.2x 컴파일러에서 생성된 바이너리를 읽을 수 있습니다.
  • 상위 호환성은 보장되지 않습니다. 예를 들어, 2.0.x 컴파일러가 2.1.x 컴파일러에서 생성된 바이너리를 읽을 수 있다는 보장은 없습니다.

Kotlin cinterop klib 바이너리는 아직 Beta 상태입니다. 현재로서는 cinterop klib 바이너리에 대해 서로 다른 Kotlin 버전 간의 구체적인 호환성을 보장할 수 없습니다.