Skip to content

Compose Multiplatform 1.7.3의 새로운 기능 ​

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

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

종속성(Dependencies) ​

주요 변경 사항(Breaking changes) ​

최소 AGP 버전이 8.1.0으로 상향 ​

Compose Multiplatform 1.7.0에서 사용하는 Jetpack Compose 1.7.0과 Lifecycle 2.8.0 모두 AGP 7을 지원하지 않습니다. 따라서 Compose Multiplatform 1.7.3으로 업데이트할 때 AGP 종속성도 함께 업그레이드해야 할 수 있습니다.

Android Studio에서 새로 구현된 Android 컴포저블 미리보기 기능을 사용하려면 최신 AGP 버전 중 하나가 필요합니다.

Java 리소스 API 지원 중단 및 멀티플랫폼 리소스 라이브러리로 대체 ​

이번 릴리스에서는 compose.ui 패키지에서 제공되는 Java 리소스 API인 painterResource(), loadImageBitmap(), loadSvgPainter(), loadXmlImageVector() 함수와 ClassLoaderResourceLoader 클래스 및 이에 의존하는 함수들이 공식적으로 지원 중단(deprecated)되었습니다.

멀티플랫폼 리소스 라이브러리로 전환하는 것을 권장합니다. Compose Multiplatform에서 Java 리소스를 계속 사용할 수는 있지만, 생성된 접근자(accessor), 멀티모듈 지원, 현지화 등 프레임워크가 제공하는 확장된 기능의 이점을 누릴 수 없습니다.

여전히 Java 리소스에 접근해야 하는 경우, 풀 리퀘스트에서 제안된 구현을 복사하여 Compose Multiplatform 1.7.3으로 업그레이드한 후에도 코드가 작동하도록 유지하고, 가능한 부분부터 멀티플랫폼 리소스로 전환할 수 있습니다.

iOS 네이티브 요소의 터치 처리 기본 동작 변경 ​

1.7.3 이전에는 Compose Multiplatform이 상호 운용(interop) UI 뷰 내부에서 발생하는 터치 이벤트를 처리할 수 없어, 상호 운용 뷰가 이러한 일련의 터치 시퀀스를 전적으로 처리했습니다.

Compose Multiplatform 1.7.3에서는 상호 운용 터치 시퀀스를 처리하기 위한 정교한 로직이 구현되었습니다. 이제 기본적으로 최초 터치 후 딜레이가 적용되어, 상위 컴포저블이 해당 터치 시퀀스가 네이티브 뷰와 상호작용하기 위한 것인지 파악하고 적절히 반응할 수 있도록 돕습니다.

자세한 내용은 이 페이지의 iOS 섹션 설명을 참조하거나 이 기능의 문서를 읽어보세요.

iOS에서 최소 프레임 지속 시간 비활성화 필수화 ​

개발자가 고주사율 디스플레이에 대한 경고 로그를 인지하지 못해, 사용자가 120Hz 지원 기기에서 부드러운 애니메이션을 경험하지 못하는 경우가 자주 발생했습니다. 이제 이 검사를 엄격하게 적용합니다. Info.plist 파일에 CADisableMinimumFrameDurationOnPhone 속성이 없거나 false로 설정되어 있으면 Compose Multiplatform으로 빌드된 앱이 강제 종료(crash)됩니다.

ComposeUIViewControllerConfiguration.enforceStrictPlistSanityCheck 속성을 false로 설정하여 이 동작을 비활성화할 수 있습니다.

데스크톱에서 Modifier.onExternalDrag 지원 중단 ​

실험적 기능이었던 Modifier.onExternalDrag 및 관련 API가 새로운 Modifier.dragAndDropTarget으로 대체되면서 지원 중단되었습니다. DragData 인터페이스는 compose.ui.draganddrop 패키지로 이동했습니다.

Compose Multiplatform 1.7.0에서 지원 중단된 API를 사용하면 지원 중단 오류가 발생합니다. 1.8.0에서는 onExternalDrag 수정자가 완전히 제거될 예정입니다.

플랫폼 공통(Across platforms) ​

공유 요소 전환(Shared element transitions) ​

Compose Multiplatform은 이제 일관된 요소를 공유하는 컴포저블 간의 매끄러운 화면 전환을 위한 API를 제공합니다. 이러한 전환 효과는 내비게이션 시 사용자가 UI의 변경 흐름을 시각적으로 따라갈 수 있도록 돕는 데 매우 유용합니다.

API에 대한 자세한 내용은 Jetpack Compose 문서를 참조하세요.

타입 세이프 네비게이션(Type-safe Navigation) ​

Compose Multiplatform은 네비게이션 경로(route)를 따라 객체를 전달할 때 Jetpack Compose의 타입 세이프 방식을 채택했습니다. Navigation 2.8.0의 새로운 API를 통해 Compose는 네비게이션 그래프에 컴파일 타임 안전성을 제공할 수 있습니다. 이 API들은 XML 기반 네비게이션을 위한 Safe Args 플러그인과 동일한 결과를 제공합니다.

자세한 내용은 Navigation Compose의 타입 안전성에 관한 Google 공식 문서를 참조하세요.

멀티플랫폼 리소스 ​

Android 에셋으로 패키징되는 리소스 ​

모든 멀티플랫폼 리소스가 이제 Android 에셋(assets)으로 패키징됩니다. 이를 통해 Android Studio는 Android 소스 세트에 있는 Compose Multiplatform 컴포저블의 미리보기를 생성할 수 있습니다.

Android Studio 미리보기는 Android 소스 세트의 컴포저블에서만 사용할 수 있습니다. 또한 최신 AGP 버전(8.5.2, 8.6.0-rc01, 8.7.0-alpha04 중 하나)이 필요합니다.

또한 리소스에 Res.getUri(“files/index.html”)와 같은 단순한 경로로 접근할 수 있게 됨에 따라, Android의 WebView 및 미디어 플레이어 컴포넌트에서 멀티플랫폼 리소스에 직접 접근할 수 있습니다.

다음은 리소스 이미지 링크가 포함된 리소스 HTML 페이지를 표시하는 Android 컴포저블의 예입니다.

AndroidView(factory = { WebView(it).apply {...}
kotlin
// androidMain/kotlin/com/example/webview/App.kt
@OptIn(ExperimentalResourceApi::class)
@Composable
@Preview
fun App() {
    MaterialTheme {
        val uri = Res.getUri("files/webview/index.html")

        // 레이아웃을 전체 화면으로 설정하여 AndroidView 내에 WebView 추가.
        AndroidView(factory = {
            WebView(it).apply {
                layoutParams = ViewGroup.LayoutParams(
                    ViewGroup.LayoutParams.MATCH_PARENT,
                    ViewGroup.LayoutParams.MATCH_PARENT
                )
            }
        }, update = {
            it.loadUrl(uri)
        })
    }
}

이 예제는 다음과 같은 간단한 HTML 파일과 함께 동작합니다.

<title>Cat Resource</title> {...}
html
<html>
<header>
    <title>
        Cat Resource
    </title>
</header>
<body>
    <img src="cat.jpg">
</body>
</html>

이 예제의 두 리소스 파일은 모두 commonMain 소스 세트에 위치합니다.

composeResources 디렉터리의 파일 구조

커스텀 리소스 디렉터리 ​

구성 DSL의 새로운 customDirectory 설정을 사용하면 커스텀 디렉터리를 특정 소스 세트와 연결할 수 있습니다. 이를 통해 다운로드한 파일을 리소스로 활용하는 등의 작업이 가능해집니다.

멀티플랫폼 폰트 캐시 ​

Compose Multiplatform은 Android의 폰트 캐시 기능을 다른 플랫폼으로도 확장하여, Font 리소스에 대한 과도한 바이트 읽기 작업을 방지합니다.

멀티플랫폼 테스트 리소스 지원 ​

이제 리소스 라이브러리에서 프로젝트 내 테스트 리소스 사용을 지원합니다. 다음과 같은 작업이 가능합니다:

  • 테스트 소스 세트에 리소스 추가.
  • 해당 소스 세트에서만 사용할 수 있는 생성된 접근자(accessor) 사용.
  • 테스트 실행 시에만 앱에 테스트 리소스 패키징.

쉬운 접근을 위한 문자열 ID 매핑 리소스 ​

각 유형의 리소스는 해당 파일 이름과 매핑됩니다. 예를 들어, Res.allDrawableResources 속성을 사용하여 모든 drawable 리소스의 맵을 가져오고, 문자열 ID를 전달하여 필요한 리소스에 접근할 수 있습니다.

kotlin
Image(painterResource(Res.allDrawableResources["compose_multiplatform"]!!), null)

바이트 배열을 ImageBitmap 또는 ImageVector로 변환하는 함수 ​

ByteArray를 이미지 리소스로 변환하는 새로운 함수들이 추가되었습니다.

  • decodeToImageBitmap(): JPEG, PNG, BMP 또는 WEBP 파일을 ImageBitmap 객체로 변환합니다.
  • decodeToImageVector(): XML 벡터 파일을 ImageVector 객체로 변환합니다.
  • decodeToSvgPainter(): SVG 파일을 Painter 객체로 변환합니다. 이 함수는 Android에서는 사용할 수 없습니다.

자세한 내용은 문서를 참조하세요.

새로운 공통 모듈 ​

material3.adaptive:adaptive* ​

Compose Multiplatform을 통해 공통 코드에서 Material3 adaptive 모듈을 사용할 수 있게 되었습니다. 사용하려면 모듈의 build.gradle.kts 파일 내 공통 소스 세트에 해당 종속성을 명시적으로 추가하세요:

kotlin
commonMain.dependencies {
    implementation("org.jetbrains.compose.material3.adaptive:adaptive:1.0.0-alpha03")
    implementation("org.jetbrains.compose.material3.adaptive:adaptive-layout:1.0.0-alpha03")
    implementation("org.jetbrains.compose.material3.adaptive:adaptive-navigation:1.0.0-alpha03")
}

material3.material3-adaptive-navigation-suite ​

Compose로 반응형/적응형 네비게이션을 구축하는 데 필요한 Material3 adaptive navigation suite를 이제 Compose Multiplatform의 공통 코드에서 사용할 수 있습니다. 사용하려면 모듈의 build.gradle.kts 파일 내 공통 소스 세트에 종속성을 명시적으로 추가하세요:

kotlin
commonMain.dependencies {
    implementation(compose.material3AdaptiveNavigationSuite)
}

material3:material3-window-size-class ​

WindowSizeClass 클래스를 사용하려면 모듈의 build.gradle.kts 파일 내 공통 소스 세트에 material3-window-size-class 종속성을 명시적으로 추가하세요:

kotlin
commonMain.dependencies {
    implementation("org.jetbrains.compose.material3:material3-window-size-class:1.7.3")
}

calculateWindowSizeClass() 함수는 아직 공통 코드에서 제공되지 않습니다. 그러나 다음과 같이 플랫폼별 코드에서 가져와 호출할 수 있습니다:

kotlin
// desktopMain/kotlin/main.kt
import androidx.compose.material3.windowsizeclass.calculateWindowSizeClass

// ...

val size = calculateWindowSizeClass()

material-navigation ​

Compose Multiplatform Navigation 외에도 material-navigation 라이브러리를 공통 코드에서 사용할 수 있습니다. 사용하려면 모듈의 build.gradle.kts 파일 내 공통 소스 세트에 다음과 같이 명시적 종속성을 추가하세요:

kotlin
commonMain.dependencies {
    implementation("org.jetbrains.androidx.navigation:navigation-compose:2.8.0-alpha10")
    implementation("org.jetbrains.compose.material:material-navigation:1.7.0-beta02")
}

Skia 버전 마일스톤 126으로 업데이트 ​

Skiko를 통해 Compose Multiplatform에서 사용하는 Skia 버전이 마일스톤 126으로 업데이트되었습니다.

이전에 사용되던 Skia 버전은 마일스톤 116이었습니다. 버전 간 변경 사항은 릴리스 노트에서 확인할 수 있습니다.

새로운 드로잉 API – GraphicsLayer ​

Jetpack Compose 1.7.0에 추가된 새로운 드로잉 레이어를 이제 Compose Multiplatform에서도 사용할 수 있습니다.

Modifier.graphicsLayer와 달리 새로운 GraphicsLayer 클래스를 사용하면 Composable 콘텐츠를 어디에나 렌더링할 수 있습니다. 애니메이션 콘텐츠를 서로 다른 장면에 렌더링해야 하는 경우에 유용합니다.

자세한 설명과 예제는 참조 문서를 확인하세요.

LocalLifecycleOwner의 Compose UI 외부 이동 ​

LocalLifecycleOwner 클래스가 Compose UI 패키지에서 Lifecycle 패키지로 이동했습니다.

이 변경을 통해 Compose UI와 무관하게 클래스에 접근하고 Compose 기반 헬퍼 API를 호출할 수 있습니다. 단, Compose UI 바인딩이 없으면 LocalLifecycleOwner 인스턴스에 플랫폼 연동이 없어 수신할 플랫폼별 이벤트도 없다는 점에 유의하세요.

iOS ​

Compose Multiplatform과 네이티브 iOS 간 터치 상호 운용성(Touch Interop) 개선 ​

이번 릴리스에서는 iOS 상호 운용 뷰에 대한 터치 처리가 개선되었습니다. Compose Multiplatform은 이제 터치가 상호 운용 뷰를 위한 것인지, 아니면 Compose에서 처리해야 하는지 감지하려고 시도합니다. 이를 통해 Compose Multiplatform 앱 내의 UIKit 또는 SwiftUI 영역에서 발생하는 터치 이벤트를 처리할 수 있게 되었습니다.

기본적으로 Compose Multiplatform은 상호 운용 뷰로 터치 이벤트를 전달하는 것을 150ms 동안 지연시킵니다:

  • 이 시간 동안 임계값을 초과하는 움직임이 발생하면 상위 컴포저블이 터치 시퀀스를 가로채며, 상호 운용 뷰로 전달되지 않습니다.
  • 눈에 띄는 움직임이 없으면 Compose는 나머지 터치 시퀀스를 처리하지 않으며, 해당 터치는 상호 운용 뷰에서만 전적으로 처리됩니다.

이 동작은 네이티브 UIScrollView의 작동 방식과 일치합니다. 상호 운용 뷰에서 시작된 터치 시퀀스가 중간에 가로채여 Compose Multiplatform이 이를 처리할 기회를 얻지 못하는 상황을 방지하며, 이로 인한 불편한 사용자 경험을 개선합니다. 예를 들어 지연 목록(lazy list)과 같이 스크롤 가능한 컨텍스트 내에서 대형 상호 운용 비디오 플레이어를 사용하는 경우를 생각해 볼 수 있습니다. 화면의 대부분을 차지하는 비디오가 Compose Multiplatform 모르게 모든 터치를 가로챈다면 목록을 스크롤하기가 까다로워집니다.

네이티브 성능 개선 ​

Kotlin 2.0.20을 통해 Kotlin/Native 팀은 iOS에서 Compose 앱이 더 빠르고 부드럽게 작동하도록 많은 진전을 이루었습니다. Compose Multiplatform 1.7.3 릴리스는 이러한 최적화 사항을 활용할 뿐만 아니라 Jetpack Compose 1.7.0의 성능 개선 사항도 함께 제공합니다.

Kotlin 2.0.0 기반의 Compose Multiplatform 1.6.11과 Kotlin 2.0.20 기반의 Compose Multiplatform 1.7.3을 비교했을 때 전반적으로 더 나은 결과를 보여줍니다:

  • 실제 사용 사례와 가장 유사한 LazyVerticalGrid 스크롤을 시뮬레이션하는 LazyGrid 벤치마크는 평균 ~9% 더 빠르게 실행됩니다. 또한 사용자가 UI의 반응성을 낮게 느끼게 만드는 프레임 드롭(누락된 프레임) 횟수도 크게 줄었습니다. 직접 확인해 보세요. iOS용 Compose Multiplatform으로 제작된 앱이 훨씬 더 부드럽게 느껴질 것입니다.
  • 무작위로 배치된 수많은 컴포넌트를 렌더링하는 VisualEffects 벤치마크는 3.6배 더 빠르게 동작합니다. 1000프레임당 평균 CPU 시간이 8.8초에서 2.4초로 단축되었습니다.
  • 이미지의 표시 및 숨김 애니메이션을 처리하는 AnimatedVisibility 컴포저블은 ~6% 더 빠른 렌더링 속도를 보여줍니다.

이에 더해 Kotlin 2.0.20에서는 가비지 컬렉터의 동시 마킹(concurrent marking)에 대한 실험적 지원이 도입되었습니다. 동시 마킹을 활성화하면 가비지 컬렉터 일시 정지 시간이 단축되어 모든 벤치마크에서 더욱 큰 폭의 성능 향상을 얻을 수 있습니다.

이러한 Compose 관련 벤치마크 코드는 Compose Multiplatform 저장소에서 확인할 수 있습니다:

데스크톱(Desktop) ​

드래그 앤 드롭 ​

사용자가 Compose 애플리케이션 안팎으로 콘텐츠를 드래그할 수 있도록 하는 드래그 앤 드롭(drag-and-drop) 메커니즘이 Compose Multiplatform 데스크톱에 구현되었습니다. 드래그 앤 드롭의 잠재적 소스와 대상을 지정하려면 dragAndDropSource 및 dragAndDropTarget 수정자(modifier)를 사용하세요.

이러한 수정자는 공통 코드에서 사용할 수 있지만, 현재는 데스크톱 및 Android 소스 세트에서만 작동합니다. 향후 릴리스를 기대해 주세요.

일반적인 사용 사례는 Jetpack Compose 문서의 관련 가이드를 참조하세요.

데스크톱에 BasicTextField(구 BasicTextField2) 도입 ​

Jetpack Compose에서 BasicTextField2 컴포넌트가 안정화(stable)되면서 BasicTextField로 이름이 변경되었습니다. 이번 릴리스에서 Compose Multiplatform은 데스크톱 타깃에 이 변경 사항을 적용했으며, 안정화 버전인 1.7.0에서는 iOS도 지원할 계획입니다.

새로운 BasicTextField의 특징:

  • 상태를 더욱 안정적으로 관리할 수 있습니다.
  • 텍스트 필드 콘텐츠를 프로그래밍 방식으로 변경할 수 있는 새로운 TextFieldBuffer API를 제공합니다.
  • 시각적 변환 및 스타일 지정을 위한 몇 가지 새로운 API를 포함합니다.
  • 필드의 이전 상태로 되돌릴 수 있는 기능을 갖춘 UndoState에 대한 접근을 제공합니다.

ComposePanel의 렌더 설정 ​

ComposePanel 생성자에서 새로운 RenderSettings.isVsyncEnabled 파라미터를 지정하여 백엔드 렌더링 구현 시 수직 동기화(VSync)를 비활성화하도록 힌트를 줄 수 있습니다. 이를 통해 입력과 UI 변경 간의 시각적 지연 시간(latency)을 줄일 수 있지만 화면 찢김(tearing) 현상이 발생할 수도 있습니다.

기본 동작은 동일하게 유지됩니다. ComposePanel은 드로어블 표현을 VSync와 동기화하려고 시도합니다.

웹(Web) ​

Kotlin/Wasm 애플리케이션에서 skiko.js 불필요 ​

Compose Multiplatform으로 빌드된 Kotlin/Wasm 애플리케이션에서 skiko.js 파일이 더 이상 필요하지 않습니다. index.html 파일에서 이를 제거하여 앱의 로딩 시간을 단축할 수 있습니다. 향후 릴리스에서는 Kotlin/Wasm 배포 아티팩트에서 skiko.js가 완전히 제거될 예정입니다.

Kotlin/JS 애플리케이션의 경우 Compose Multiplatform 1.9.0까지는 여전히 skiko.js 파일이 필요합니다. 해당 변경 시점에 대해서는 Compose Multiplatform 1.9.3의 새로운 기능을 참조하세요.