Open AIDoc

한국어

简体中文
繁體中文
日本語

한국어

简体中文
繁體中文
日本語

Appearance

Compose Multiplatform 1.6.10-rc02의 새로운 기능 ​

이번 EAP 기능 릴리스의 주요 하이라이트는 다음과 같습니다:

이번 릴리스의 전체 변경 사항 목록은 GitHub에서 확인할 수 있습니다.

종속성(Dependencies) ​

중대한 변경 사항(Breaking changes) ​

Kotlin 2.0.0을 위해 새로운 Compose 컴파일러 Gradle 플러그인이 필요합니다. ​

Kotlin 2.0.0-RC2부터 Compose Multiplatform은 새로운 Compose 컴파일러 Gradle 플러그인을 사용해야 합니다. 자세한 내용은 마이그레이션 가이드를 참조하세요.

플랫폼 공통 사항 ​

리소스(Resources) ​

안정적인 리소스 라이브러리 ​

리소스 라이브러리 API의 대부분이 이제 안정화(Stable)된 것으로 간주됩니다.

Compose Multiplatform 리소스를 사용하는 멀티모듈 프로젝트 지원 ​

Compose Multiplatform 1.6.10-beta01부터 모든 Gradle 모듈 및 소스 세트에 리소스를 저장할 수 있으며, 리소스가 포함된 프로젝트 및 라이브러리를 배포할 수 있습니다.

멀티모듈 지원을 활성화하려면 프로젝트를 Kotlin 버전 2.0.0 이상 및 Gradle 7.6 이상으로 업데이트하세요.

멀티플랫폼 리소스를 위한 구성 DSL ​

이제 프로젝트에서 Res 클래스 생성을 세밀하게 조정할 수 있습니다. 클래스의 가시성(Modality)과 할당된 패키지를 변경할 수 있으며, 생성 조건(항상 생성, 생성 안 함, 리소스 라이브러리에 명시적 의존성이 있는 경우에만 생성)을 선택할 수 있습니다.

자세한 내용은 문서 섹션을 참조하세요.

리소스 URI 생성을 위한 공개 함수 ​

새로운 getUri() 함수를 사용하면 리소스의 플랫폼 의존적인 URI를 외부 라이브러리에 전달하여 해당 라이브러리가 파일에 직접 접근하도록 할 수 있습니다. 자세한 내용은 문서를 참조하세요.

문자열 리소스를 위한 복수형(Plurals) 지원 ​

이제 다른 멀티플랫폼 문자열 리소스와 함께 복수형(quantity strings)을 정의할 수 있습니다. 자세한 내용은 문서를 참조하세요.

3자리 문자 로케일 지원 ​

언어 한정자(Language qualifiers)가 이제 로케일에 대해 alpha-3 (ISO 639-2) 코드를 지원합니다.

이미지 및 폰트를 위한 실험적 바이트 배열 함수 ​

폰트와 이미지를 바이트 배열로 가져올 수 있는 두 가지 실험적 함수 getDrawableResourceBytes와 getFontResourceBytes를 사용해 볼 수 있습니다. 이 함수들은 서드파티 라이브러리에서 멀티플랫폼 리소스에 접근하는 것을 돕기 위해 고안되었습니다.

자세한 내용은 풀 리퀘스트(Pull request)를 확인하세요.

실험적 내비게이션 라이브러리 ​

Jetpack Compose를 기반으로 한 공통 내비게이션 라이브러리를 이제 사용할 수 있습니다. 자세한 내용은 문서를 참조하세요.

이 버전의 주요 제한 사항:

Lifecycle 라이브러리 ​

Jetpack Lifecycle을 기반으로 한 공통 Lifecycle 라이브러리를 이제 사용할 수 있습니다. 자세한 내용은 문서를 참조하세요.

이 라이브러리는 주로 공통 내비게이션 기능을 지원하기 위해 도입되었으나, 실험적인 크로스 플랫폼 ViewModel 구현을 제공하며 프로젝트에 구현할 수 있는 공통 LifecycleOwner 인터페이스도 포함하고 있습니다.

또한 Compose Multiplatform은 일반적인 ViewModelStoreOwner 구현을 제공합니다.

Kotlin 2.0.0 지원 ​

Kotlin 2.0.0-RC2가 Compose 컴파일러를 위한 새로운 Gradle 플러그인과 함께 출시되었습니다. 최신 컴파일러 버전과 함께 Compose Multiplatform을 사용하려면 프로젝트의 모듈에 해당 플러그인을 적용하세요(자세한 내용은 마이그레이션 가이드 참조).

데스크톱(Desktop) ​

BasicTextField2 기본 지원 ​

BasicTextField2 Compose 컴포넌트가 이제 데스크톱 타겟에서 기본 수준으로 지원됩니다. 프로젝트에서 반드시 필요하거나 테스트 용도로 사용해 보되, 아직 해결되지 않은 예외 케이스가 있을 수 있음을 유의하세요. 예를 들어, 현재 BasicTextField2는 IME 이벤트를 지원하지 않으므로 중국어, 일본어 또는 한국어용 가상 키보드를 사용할 수 없습니다.

컴포넌트에 대한 전체 지원 및 다른 플랫폼 지원은 Compose Multiplatform 1.7.0 릴리스에서 계획되어 있습니다.

DialogWindow를 위한 alwaysOnTop 플래그 ​

대화 상자(Dialog) 창이 다른 창에 가려지는 것을 방지하기 위해, 이제 DialogWindow 컴포저블에서 alwaysOnTop 플래그를 사용할 수 있습니다.

자세한 내용은 풀 리퀘스트를 확인하세요.

iOS ​

접근성(Accessibility) 지원 개선 ​

이번 릴리스에서는 다음이 개선되었습니다:

  • 대화 상자 및 팝업이 접근성 기능과 적절하게 통합되었습니다.
  • UIKitView 및 UIKitViewController를 사용하여 생성된 상호 운용 뷰(Interop views)를 이제 접근성 서비스(Accessibility Services)에서 인식할 수 있습니다.
  • LiveRegion 시맨틱이 접근성 API에 의해 지원됩니다.
  • 접근성 스크롤(Accessibility scrolling)이 지원됩니다.
  • HapticFeedback이 지원됩니다.

iOS 17 이상을 위한 선택 컨테이너 돋보기 ​

iOS의 Compose Multiplatform 선택 컨테이너(Selection containers)가 이제 네이티브 돋보기 도구를 에뮬레이트합니다.

텍스트 돋보기가 활성화된 iPhone 채팅 앱 스크린샷

대화 상자 중앙 정렬을 위한 소프트웨어 키보드 인셋 ​

Dialog 컴포저블의 동작이 이제 Android와 일치합니다. 화면에 소프트웨어 키보드가 나타나면, 애플리케이션 창의 유효 높이를 고려하여 대화 상자가 중앙에 배치됩니다. DialogProperties.useSoftwareKeyboardInset 속성을 사용하여 이 기능을 비활성화할 수 있는 옵션이 제공됩니다.

웹(Web) ​

기본적인 IME 키보드 지원 ​

Compose Multiplatform의 웹 타겟에서 이제 가상(IME) 키보드를 기본적으로 지원합니다.

Gradle 플러그인 ​

macOS 최소 버전 수정 가능 ​

이전 버전에서는 Intel 버전을 포함하지 않고는 macOS 앱을 App Store에 업로드할 수 없었습니다. 이제 플랫폼별 Compose Multiplatform 옵션을 통해 앱의 최소 macOS 버전을 설정할 수 있습니다.

kotlin
compose.desktop {
    application {
        nativeDistributions {
            macOS {
                minimumSystemVersion = "12.0"
            }
        }
    }
}

자세한 내용은 풀 리퀘스트를 확인하세요.

Proguard 지원을 포함한 uber JAR 생성 옵션 ​

이제 ProGuard Gradle 태스크를 사용하여 uber JAR(애플리케이션과 모든 종속성 JAR가 포함된 복합 패키지)를 생성할 수 있습니다.

자세한 내용은 풀 리퀘스트를 확인하세요.

알려진 문제 ​

MissingResourceException ​

Kotlin 버전을 1.9.x에서 2.0.0으로 변경할 때(또는 그 반대의 경우), org.jetbrains.compose.resources.MissingResourceException: Missing resource with path: ... 오류가 발생할 수 있습니다. 이를 해결하려면 프로젝트의 루트 및 모듈 폴더에 있는 build 디렉토리들을 삭제하세요.

NativeCodeGeneratorException ​

일부 프로젝트에서 다음과 같은 오류와 함께 iOS 컴파일이 실패할 수 있습니다:

org.jetbrains.kotlin.backend.konan.llvm.NativeCodeGeneratorException: Exception during generating code for following declaration: private fun $init_global()

자세한 내용은 GitHub 이슈를 확인하세요.

Copyright © 2026 Open AIDoc.