Compose Material
최근 업데이트 | 안정화 버전 | 출시 후보 버전 | 베타 버전 | 알파 버전 |
---|---|---|---|---|
2024년 8월 7일 | 1.6.8 | - | 1.7.0-beta07 | - |
구조
Compose는 androidx
내의 Maven 그룹 ID 7개의 조합입니다. 각 그룹에는 타겟팅된 기능의 하위 집합이 있으며, 각 기능은 자체적인 출시 노트를 포함하고 있습니다.
다음 표에서는 그룹에 관한 설명과 각 출시 노트 조합의 링크를 제시합니다.
그룹 | 설명 |
---|---|
compose.animation | Jetpack Compose 애플리케이션에서 애니메이션을 빌드하여 풍부한 사용자 경험을 제공합니다. |
compose.compiler | Kotlin 컴파일러 플러그인으로 최적화를 사용 설정하고 @Composable 함수를 변환합니다. |
compose.foundation | 즉시 사용 가능한 구성요소를 사용해 Jetpack Compose 애플리케이션을 작성하고 기초를 확장해 나만의 디자인 시스템 요소를 빌드합니다. |
compose.material | 즉시 사용 가능한 Material Design 구성요소로 Jetpack Compose UI를 빌드합니다. 이는 Compose를 고급 수준에서 사용하는 첫 단계이며, www.material.io에 설명된 것과 동일한 구성요소를 제공합니다. |
compose.material3 | 차세대 Material Design인 Material Design 3 구성요소로 Jetpack Compose UI를 빌드합니다. Material 3은 업데이트된 테마 설정 및 구성요소, Material You 맞춤설정 기능(동적 색상 등)을 포함하며 새로운 Android 12의 시각적 스타일 및 시스템 UI와 일관되도록 설계되었습니다. |
compose.runtime | Compose의 프로그래밍 모델과 상태 관리를 위한 기본 구성요소이며, Compose 컴파일러 플러그인이 타겟팅하는 핵심 런타임입니다. |
compose.ui | 레이아웃, 그리기, 입력 등 기기와 상호작용할 때 필요한 Compose UI의 기본적인 구성요소입니다. |
종속 항목 선언
Compose의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용을 알아보려면 Google Maven 저장소를 읽어보세요.
다음과 같이 앱 또는 모듈의 build.gradle
파일에 필요한 아티팩트의 종속 항목을 추가합니다.
Groovy
dependencies { implementation "androidx.compose.material:material:1.6.8" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.5.15" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material:material:1.6.8") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.5.15" } kotlinOptions { jvmTarget = "1.8" } }
종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.
의견
제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.
자세한 내용은 Issue Tracker 문서를 참고하세요.
버전 1.7
버전 1.7.0-beta07
2024년 8월 7일
androidx.compose.material:material-*:1.7.0-beta07
이 출시되었습니다. 버전 1.7.0-beta07에 포함된 커밋을 확인하세요.
버전 1.7.0-beta06
2024년 7월 24일
androidx.compose.material:material-*:1.7.0-beta06
이 출시되었습니다. 버전 1.7.0-beta06에 포함된 커밋을 확인하세요.
버전 1.7.0-beta05
2024년 7월 10일
androidx.compose.material:material-*:1.7.0-beta05
이 출시되었습니다. 버전 1.7.0-beta05에 포함된 커밋을 확인하세요.
버전 1.7.0-beta04
2024년 6월 26일
androidx.compose.material:material-*:1.7.0-beta04
이 출시되었습니다. 버전 1.7.0-beta04에 포함된 커밋을 확인하세요.
버전 1.7.0-beta03
2024년 6월 12일
androidx.compose.material:material-*:1.7.0-beta03
이 출시되었습니다. 버전 1.7.0-beta03에 포함된 커밋을 확인하세요.
버전 1.7.0-beta02
2024년 5월 29일
androidx.compose.material:material-*:1.7.0-beta02
이 출시되었습니다. 버전 1.7.0-beta02에 포함된 커밋을 확인하세요.
API 변경사항
- 링크 스타일을 지정하기 위한 API 업데이트:
TextLinkStyles
를TextStyle
로 이동하고 머티리얼에서TextDefaults
를 삭제했습니다. (I5477b)
버전 1.7.0-beta01
2024년 5월 14일
androidx.compose.material:material-*:1.7.0-beta01
이 출시되었습니다. 버전 1.7.0-beta01에 포함된 커밋을 확인하세요.
API 변경사항
- Text에서 Material 테마 링크를 가져오기 위한 API를 업데이트했습니다. 구체적으로, 테마
LinkAnnotations
를 구성하고 테마 링크로 HTML을 파싱하기 위한TextDefaults
에서 메서드를 삭제했습니다. 대신 Text 컴포저블의 매개변수로 링크 스타일을 지정할 수 있는TextLinkStyles
클래스를 추가했습니다. 추가했습니다. (I31b93)
버전 1.7.0-alpha08
2024년 5월 1일
androidx.compose.material:material-*:1.7.0-alpha08
이 출시되었습니다. 버전 1.7.0-alpha08에 포함된 커밋을 확인하세요.
API 변경사항
backgroundColor
가TextFieldDecorationBox
및OutlinedTextFieldDecorationBox
에 적용되지 않는 문제를 수정합니다. 이제 장식 상자에서shape
매개변수를 사용할 수 있습니다. 추가했습니다. (I371c2, b/307694651)RippleConfiguration#isEnabled
가 삭제되고LocalRippleConfiguration
가 null을 허용하도록 설정되었습니다. 물결 효과를 사용 중지하려면isEnabled = false
에RippleConfiguration
를 제공하는 대신LocalRippleConfiguration
에null
를 제공합니다. 추가했습니다. (I22725)- 텍스트 링크에는 일반적인 스타일 지정, 마우스 오버 및 포커스가 있는 것 외에도 누름 상태 스타일 지정 옵션이 있습니다.
TextDefaults
메서드에는 각각 이를 지원하는pressedStyle
인수가 있습니다. 추가했습니다. (Ic473f, b/139312671)
버그 수정
- 라벨의
OutlinedTextField
상단 패딩이 이제 시스템 글꼴 크기를 고려합니다. 추가했습니다. (Idc781)
버전 1.7.0-alpha07
2024년 4월 17일
androidx.compose.material:material-*:1.7.0-alpha07
이 출시되었습니다. 버전 1.7.0-alpha07에 포함된 커밋을 확인하세요.
API 변경사항
- 텍스트 링크에 일반적인 스타일 지정, 마우스 오버 및 포커스가 있는 것 외에도 눌린 상태 스타일 지정 옵션이 적용되었습니다. 추가했습니다. (I5f864, b/139312671)
LinkAnnotation
를 구성하고 링크에MaterialTheme
를 적용하는 HTML 태그가 지정된 문자열을 파싱하는 메서드가 포함된TextDefaults
객체를 추가했습니다. 추가했습니다. (I98532, b/139312671)
버전 1.7.0-alpha06
2024년 4월 3일
androidx.compose.material:material-*:1.7.0-alpha06
이 출시되었습니다. 버전 1.7.0-alpha06에 포함된 커밋을 확인하세요.
공지사항
androidx.compose.material
에서 더 이상 이 Maven 그룹이므로 모든 아티팩트에 동일한 버전을 사용할 필요가 없습니다. 사용자가 Compose 기반 라이브러리의 여러 버전을 조합할 수 있습니다. (Ie5fba)
API 변경사항
- 더 많은
ModalDrawer
및BottomDrawer
기본값을DrawerDefaults
객체로 이동했습니다. 추가했습니다. (Ib5b2e)
버전 1.7.0-alpha05
2024년 3월 20일
androidx.compose.material:material-*:1.7.0-alpha05
이 출시되었습니다. 버전 1.7.0-alpha05에 포함된 커밋을 확인하세요.
API 변경사항
ScaffoldSubcomposeInMeasureFix
플래그가 삭제되었습니다. 추가했습니다. (I67363)
버전 1.7.0-alpha04
2024년 3월 6일
androidx.compose.material:material-*:1.7.0-alpha04
이 출시되었습니다. 버전 1.7.0-alpha04에 포함된 커밋을 확인하세요.
새로운 기능
- Navigation Compose를 사용할 때 하단 시트 지원을 대상으로 추가하는 새로운
androidx.compose.material:material-navigation
아티팩트를 추가했습니다. 이는 Accompanist Navigation Material 라이브러리를 대체합니다. 추가했습니다. (d65d57, b/180247978)
버전 1.7.0-alpha03
2024년 2월 21일
androidx.compose.material:material-*:1.7.0-alpha03
이 출시되었습니다. 버전 1.7.0-alpha03에 포함된 커밋을 확인하세요.
API 변경사항
BottomDrawer
이 실험용에서 안정화 버전으로 승격되었습니다. 이제BottomDrawerState
가 진행률을 함수로 노출하여 특정 타겟 간의 진행률을 쿼리할 수 있습니다. 이제BottomDrawerState
에서 애니메이션 사양을 맞춤설정할 수 있으며confirmStateChange
는 더 이상 후행 람다가 아닙니다. 추가했습니다. (I9c029, b/261423850)BackdropScaffold
이 실험용에서 안정화 버전으로 승격되었습니다. 이제 애니메이션 사양은 가이드라인에 따라tween
사양입니다.BackdropScaffold
의snackbarHost
매개변수는 후행 람다와의 혼동을 방지하기 위해 더 이상 마지막 매개변수가 아닙니다.BackdropScaffoldState
는 앵커 간 진행률을 쿼리하기 위해progress(from, to)
API를 노출합니다. 추가했습니다. (I73f48, b/261423218)- 표준 하단 시트가 실험용에서 안정화 버전으로 승격되었습니다. 지원 중단된 생성자가 삭제되었습니다. 이제 애니메이션 사양은 가이드라인에 따라 트윈 사양입니다. 추가했습니다. (I3c1a8, b/278692145, b/261409034)
- 모달 하단 시트가 실험용에서 안정화 버전으로 승격되었습니다. 지원 중단된 생성자가 삭제되었습니다. 이제 애니메이션 사양은 가이드라인에 따라
tween
사양입니다. (Ic53f4, b/278692145, b/266780235, b/261409034)
버그 수정
LookaheadScope
와 함께 사용할 때 특정 시나리오에서BackdropScaffold
가 비정상 종료될 수 있는 문제를 수정했습니다. 추가했습니다. (I51396)- 성능을 개선하기 위해
BottomSheetScaffold
내의 하위 컴포지션을 삭제했습니다.LookaheadScope
와 함께 사용되는 특정 시나리오에서BottomSheetScaffold
가 비정상 종료되는 문제를 수정했습니다. 추가했습니다. (I2f90c) ModalBottomSheetLayout
내의 하위 컴포지션을 삭제하여 성능을 개선했습니다. 추가했습니다. (I7a025)
버전 1.7.0-alpha02
2024년 2월 7일
androidx.compose.material:material-*:1.7.0-alpha02
이 출시되었습니다. 버전 1.7.0-alpha02에 포함된 커밋을 확인하세요.
버전 1.7.0-alpha01
2024년 1월 24일
androidx.compose.material:material-*:1.7.0-alpha01
이 출시되었습니다. 버전 1.7.0-alpha01에 포함된 커밋을 확인하세요.
동작 변경사항
- Material 구성요소가 새 물결 효과 API를 사용하도록 이전되었으며 더 이상
RippleTheme
를 쿼리하지 않습니다.
API 변경사항
머티리얼 물결 효과에서
rememberRipple
및RippleTheme
가 지원 중단되었으며, Material 및 기타 디자인 시스템 라이브러리에 새로운 물결 효과와RippleConfiguration
API가 추가되었습니다.이전에
MutableInteractionSource
를 허용하고{ MutableInteractionSource() }
를 기억하도록 기본값을 설정했던 Material 구성요소가 이제 null을 허용하는MutableInteractionSource
를 허용하고 대신 null로 기본 설정됩니다.MutableInteractionSource
를 호이스팅하거나 사용하지 않는 경우 null을 전달해야 합니다. 이를 통해 일부 구성요소는 필요할 때만 인스턴스를 지연 생성함으로써 성능을 개선할 수 있습니다. 자체 구성요소에도 비슷하게 변경하는 것이 좋습니다.
버전 1.6
버전 1.6.8
2024년 6월 12일
androidx.compose.material:material-*:1.6.8
이 출시되었습니다. 버전 1.6.8에 포함된 커밋을 확인하세요.
버전 1.6.7
2024년 5월 1일
androidx.compose.material:material-*:1.6.7
이 출시되었습니다. 버전 1.6.7에 포함된 커밋을 확인하세요.
버전 1.6.6
2024년 4월 17일
androidx.compose.material:material-*:1.6.6
이 출시되었습니다. 마지막 출시 이후 변경사항이 없습니다.
버전 1.6.5
2024년 4월 3일
androidx.compose.material:material-*:1.6.5
이 출시되었습니다. 버전 1.6.5에 포함된 커밋을 확인하세요.
버전 1.6.4
2024년 3월 20일
androidx.compose.material:material-*:1.6.4
이 출시되었습니다. 버전 1.6.4에 포함된 커밋을 확인하세요.
버전 1.6.3
2024년 3월 6일
androidx.compose.material:material-*:1.6.3
이 출시되었습니다. 버전 1.6.3에 포함된 커밋을 확인하세요.
버그 수정
- 다시 포커스를 설정할 수 있도록
ExposedDropdownMenu
의 회귀를 수정합니다. 추가했습니다. (c0e0ed, b/323694447)
버전 1.6.2
2024년 2월 21일
androidx.compose.material:material-*:1.6.2
이 출시되었습니다. 버전 1.6.2에 포함된 커밋을 확인하세요.
버전 1.6.1
2024년 2월 7일
androidx.compose.material:material-*:1.6.1
이 출시되었습니다. 버전 1.6.1에 포함된 커밋을 확인하세요.
버전 1.6.0
2024년 1월 24일
androidx.compose.material:material-*:1.6.0
이 출시되었습니다. 버전 1.6.0에 포함된 커밋을 확인하세요.
버전 1.6.0-rc01
2024년 1월 10일
androidx.compose.material:material-*:1.6.0-rc01
이 출시되었습니다. 버전 1.6.0-rc01에 포함된 커밋을 확인하세요.
버전 1.6.0-beta03
2023년 12월 13일
androidx.compose.material:material-*:1.6.0-beta03
이 출시되었습니다. 버전 1.6.0-beta03에 포함된 커밋을 확인하세요.
버전 1.6.0-beta02
2023년 11월 29일
androidx.compose.material:material-*:1.6.0-beta02
이 출시되었습니다. 버전 1.6.0-beta02에 포함된 커밋을 확인하세요.
버전 1.6.0-beta01
2023년 11월 15일
androidx.compose.material:material-*:1.6.0-beta01
이 출시되었습니다. 버전 1.6.0-beta01에 포함된 커밋을 확인하세요.
버전 1.6.0-alpha08
2023년 10월 18일
androidx.compose.material:material-*:1.6.0-alpha08
이 출시되었습니다. 버전 1.6.0-alpha08에 포함된 커밋을 확인하세요.
API 변경사항
materialIcon
함수를 지원 중단하고autoMirror
매개변수를 사용하는 오버로드로 대체했습니다. 추가했습니다. (Ia338d)
버그 수정 - 큰 콘텐츠에 대해 탐색 항목의 높이를 자동으로 증가 (0c4ecc, b/272336962)
버전 1.6.0-alpha07
2023년 10월 4일
androidx.compose.material:material-*:1.6.0-alpha07
이 출시되었습니다. 버전 1.6.0-alpha07에 포함된 커밋을 확인하세요.
- 종속 항목 업데이트
버전 1.6.0-alpha06
2023년 9월 20일
androidx.compose.material:material-*:1.6.0-alpha06
이 출시되었습니다. 버전 1.6.0-alpha06에 포함된 커밋을 확인하세요.
동작 브레이킹 체인지
BottomSheetScaffold
에서 창 관련 기능을 삭제했습니다.BottomSheetScaffold
를 창 컴포저블에 래핑하여 이전 기능을 실행합니다. 예를 보려면BottomSheetScaffoldWithDrawerSample
를 참고하세요. 추가했습니다. (I1dcc8)
API 변경사항
- Scaffold가 측정 중에 또는 배치 중에 하위 요소를 측정해야 하는지 제어하는 임시 플래그를 도입했습니다. 기본적으로 측정으로 측정됩니다. 새로운 동작에 문제가 발생한 경우 문제를 신고해 주세요. 추가했습니다. (If6e3b)
버전 1.6.0-alpha05
2023년 9월 6일
androidx.compose.material:material-*:1.6.0-alpha05
이 출시되었습니다. 버전 1.6.0-alpha05에 포함된 커밋을 확인하세요.
새로운 기능
- 오른쪽에서 왼쪽 레이아웃에서 렌더링될 때 자동 미러링된 아이콘에 대한 지원을 추가했습니다. 이제 Material-icons-core 및 Material-icons-extended 모듈의 아이콘이 아이콘이 허용하는 경우 자동 미러링을 지원하기 위한 추가 아이콘 집합을 제공합니다. 새로운 세트는
Icons.AutoMirrored.Filled...
등의 접두사가 붙으며 RTL 레이아웃에서 자동으로 미러링되는 아이콘을 보유합니다. 자동으로 미러링될 수 있고 또는 자동으로 미러링되어야 하는 아이콘 목록은 머티리얼 아이콘 목록을 참고하세요.
API 변경사항
- 오른쪽에서 왼쪽 레이아웃에서 렌더링될 때 자동 미러링된 아이콘에 대한 지원을 추가했습니다. 이제 Material-icons-core 및 Material-icons-extended 모듈의 아이콘이 아이콘이 허용하는 경우 자동 미러링을 지원하기 위한 추가 아이콘 집합을 제공합니다. 새로운 세트는
Icons.AutoMirrored.Filled...
등의 접두사가 붙으며 RTL 레이아웃에서 자동으로 미러링되는 아이콘을 보유합니다. 자동으로 미러링될 수 있고 또는 자동으로 미러링되어야 하는 아이콘 목록은 머티리얼 아이콘 목록을 참고하세요. 이러한 아이콘에 대해 이전에 제공된 아이콘 속성은 이제 지원 중단된 것으로 표시되고 이전에 도움이 되는 대체 차단 제안을 제공합니다. RTL에서 아이콘을 미러링하는 것에 특별한 처리가 없는 경우 새로운 아이콘 집합으로 이전하는 것이 좋습니다. 예를 들어Icons.Filled.ArrowBack
는Icons.AutoMirrored.Filled.ArrowBack
로 리팩터링해야 합니다. 추가했습니다. (I4b511)
버전 1.6.0-alpha04
2023년 8월 23일
androidx.compose.material:material-*:1.6.0-alpha04
이 출시되었습니다. 버전 1.6.0-alpha04에 포함된 커밋을 확인하세요.
버그 수정
LookaheadScope
내의 Scaffold 내에서Subcomposition
를 사용하는 일부 구성요소 (예:BottomSheetScaffold
)가 크기를 너무 일찍 읽으려고 시도하는 문제를 수정했습니다. 추가했습니다. (If2c5d)- x 오프셋이 로컬 레이아웃 방향에만 종속되고 메뉴가 화면 하단 근처에 있을 때 y 오프셋이 더 이상 반전되지 않도록
DropdownMenu
의offset
계산이 수정되었습니다. (Iccc74, b/294103942) BottomSheetScaffold
의 레이아웃 내부를 최적화하고LookaheadLayout
내부의BottomSheetScaffold
관련 잠재적인 문제를 수정했습니다. 추가했습니다. (Ic0afa)
버전 1.6.0-alpha03
2023년 8월 9일
androidx.compose.material:material-*:1.6.0-alpha03
이 출시되었습니다. 버전 1.6.0-alpha03에 포함된 커밋을 확인하세요.
API 변경사항
- 이제 Material2 구성요소에는 Android에서 더 넓은 화면 기능을 지원하기 위해
windowInsets
를 전달하는 별도의 API가 있습니다. Material3 구성요소와 달리 Material2 구성요소는 기본적으로 인셋을 지원하지 않으며 값은 수동으로 전달해야 합니다. 자세한 내용은 해당 샘플을 참고하세요. 추가했습니다. (I655e8)
버전 1.6.0-alpha02
2023년 7월 26일
androidx.compose.material:material-*:1.6.0-alpha02
이 출시되었습니다. 버전 1.6.0-alpha02에 포함된 커밋을 확인하세요.
API 변경사항
- 밀도 종속 항목을 구성요소 수준으로 이동합니다. 이는
SwipeToDismiss
구성요소와 시트 기반 구성요소에 적용됩니다. 밀도가 매개변수인 경우 제공된 새 오버로드를 사용하세요. 추가했습니다. (I1846e) - 컴포저블에 허용되는 입력을 지정하기 위한 추가 주석입니다. (I51109)
- 호환성 억제에 주석을 달도록 API 파일을 업데이트했습니다. (I8e87a, b/287516207)
FabPosition
의 새로운 Start 정렬을 추가했습니다. (Ib7aea, b/170592777)- Material 2의
TextFieldColorsWithIcons
를 지원 중단하고TextFieldColors
로 대체했습니다.leadingIconColor
또는trailingIconColor
를 재정의할 때는interactionSource
로 오버로드도 재정의합니다. (Id57ed, b/199377790)
버전 1.6.0-alpha01
2023년 6월 21일
androidx.compose.material:material-*:1.6.0-alpha01
이 출시되었습니다. 버전 1.6.0-alpha01에 포함된 커밋을 확인하세요.
동작 변경사항
- 이제 Material 2 서체에서
includeFontPadding
가 기본적으로false
입니다. 기본 행 높이 스타일도Trim.None
및Alignment.Center
로 변경되었으며 명시적인lineHeight
(sp)가Typography
의TextStyle
에 추가되었습니다. 이러한 값을 맞춤설정하려면 API 문서를 참고하고 변경사항에 대한 자세한 설명은 블로그 게시물을 참고하세요. 추가합니다. (Icabc3, I3f801, I04c03)
API 변경사항
- Material의
Swipeable
API가 지원 중단되었습니다. 단순 사용 사례와 복잡한 사용 사례에 모두 최적화된 Foundation의AnchoredDraggable
API를 참고하세요. 추가했습니다. (I732e0)
버그 수정
- 이제
BottomSheetState
,ModalBottomSheetState
,BottomDrawerState
가 현재 고정된 앵커와 스와이프 방향에서 가장 가까운 앵커 사이의 진행률을 나타내는 진행률 속성을 노출합니다. (I1b317, b/271169225, b/276375124, b/276776071, b/270066861)
버전 1.5
버전 1.5.4
2023년 10월 18일
androidx.compose.material:material-*:1.5.4
이 출시되었습니다. 버전 1.5.4에 포함된 커밋을 확인하세요.
버전 1.5.3
2023년 10월 4일
androidx.compose.material:material-*:1.5.3
이 출시되었습니다. 이 버전에는 변경사항이 없습니다.
버전 1.5.2
2023년 9월 27일
androidx.compose.material:material-*:1.5.2
이 출시되었습니다. 버전 1.5.2에 포함된 커밋을 확인하세요.
버전 1.5.1
2023년 9월 6일
androidx.compose.material:material-*:1.5.1
은 변경사항 없이 출시되었습니다. 버전 1.5.1에 포함된 커밋을 확인하세요.
버전 1.5.0
2023년 8월 9일
androidx.compose.material:material-*:1.5.0
이 출시되었습니다. 버전 1.5.0에 포함된 커밋을 확인하세요.
1.4.0 이후 중요 변경사항
API 변경사항
BottomSheetScaffold
에 스와이프할 수 있는 1 API의 변경사항을 통합했습니다.BottomSheetState
의confirmStateChange
매개변수 이름이confirmValueChange
로 변경되었습니다. 이제progress
가 부동 소수점 값으로 노출됩니다.animateTo
및snapTo
는 내부용입니다. 대신expand()
및collapse()
를 사용하세요.direction
및overflow
가 삭제되었습니다.offset
를requireOffset()
로 대체했습니다. I323b4)- Drawer에서
snapTo
함수를 비실험용 API로 표시합니다. (Ib9c18, b/261425368) - 원형 진행률 표시기용 트랙 색상 매개변수와 원형 및 선형 진행률 표시기용 획 한도 매개변수를 추가했습니다. (Ie668c, b/216325962, b/222964817)
ModalBottomSheetState
,ModalBottomSheetState.Saver
,rememberModalBottomSheetState
의confirmStateChange
를confirmValueChange
로 이름을 바꾸었습니다. (Ib48d1)Modifier.minimumInteractiveComponentSize
를 추가합니다. 이 메서드는 요소가 더 작게 측정되는 경우 터치 상호작용을 구별하기 위해 최소 48.dp의 크기를 예약하는 데 사용할 수 있습니다. (I33f58, b/258495559)ModalBottomSheetLayout
의 Swipeable API에 변경사항이 통합되었습니다.ModalBottomSheetState
의 animateTo가 더 이상animationSpec
매개변수를 사용하지 않으며 노출된 오프셋이 이제 null을 허용합니다.requireOffset
를 사용하여 오프셋을 요구합니다. 추가했습니다. (Ia2e79)@JvmDefaultWithCompatibility
주석을 추가합니다. (I8f206)ModalDrawer. DrawerState
의animateTo
에 있는 스와이프할 수 있는 API의 통합 변경사항이 열기 및 닫기 메서드로 대체되었으며 이제 오프셋이 null을 허용합니다.requireOffset
를 사용하여 오프셋을 요구합니다. 추가했습니다. (I3de9e)- 동작이 스크롤 이벤트가 될 가능성이 있는 경우 누르기가 올바르게 지연되도록 창 및 시트를 업데이트했습니다.
- material 및 material3 텍스트
TextField
및OutlinedTextField
에minLines
매개변수를 추가했습니다. 이를 통해 구성요소의 최소 높이를 줄 수로 설정할 수 있습니다. (I4af1d)
버그 수정
pullRefresh
에서 속도를 사용하지 않아 오버스크롤이 표시되는 문제를 수정했습니다. 또한 사용 속도에 부동 소수점 수를 반환하도록Modifier.pullRefresh
에서onRelease
람다의 API 서명을 변경했습니다.(I7db65, b/266874741)- 이제
BottomSheetState
,ModalBottomSheetState
,BottomDrawerState
가 현재 고정된 앵커와 스와이프 방향에서 가장 가까운 앵커 사이의 진행률을 나타내는 진행률 속성을 노출합니다. (I1b317, b/271169225, b/276375124, b/276776071, b/270066861) - 작업이 대화상자 너비에 맞게 서로 겹쳐져 있을 때 확인 작업 아래에
AlertDialog
닫기 작업이 표시되도록 수정했습니다. 이 수정사항은 Material Design 사양에 맞게 구현을 조정합니다. 추가했습니다. (I029de, b/235454277) gesturesEnabled
가 false로 설정된 경우BottomSheetScaffold
는 더 이상 중첩 스크롤에 참여하지 않습니다. 추가했습니다. (I634f3, b/215403277)- 슬롯에 빈 콘텐츠가 제공될 때
BottomSheetScaffold
가 비정상 종료되는 버그를 수정했습니다. 추가했습니다. (Ib24a5, b/235588730) - 클릭/포인터 이벤트를 가로채는
PullRefreshIndicator
를 수정합니다. (2494256, b/271777421) - 방향 변경 시 극단적인 케이스에서
ModalBottomSheetLayout
가 비정상 종료되는 문제를 수정했습니다. 이제 시트 콘텐츠 안팎의 레이아웃 애니메이션 (예:Modifier.animateContentSize
)이 원활하게 작동합니다. 추가했습니다. (I2f981, b/266780234)
버전 1.5.0-rc01
2023년 7월 26일
androidx.compose.material:material-*:1.5.0-rc01
이 출시되었습니다. 버전 1.5.0-rc01에 포함된 커밋을 확인하세요.
버전 1.5.0-beta03
2023년 6월 28일
androidx.compose.material:material-*:1.5.0-beta03
이 출시되었습니다. 버전 1.5.0-beta03에 포함된 커밋을 확인하세요.
버그 수정
- 이제
BottomSheetState
,ModalBottomSheetState
,BottomDrawerState
가 현재 고정된 앵커와 스와이프 방향에서 가장 가까운 앵커 사이의 진행률을 나타내는 진행률 속성을 노출합니다. (I1b317, b/271169225, b/276375124, b/276776071, b/270066861)
버전 1.5.0-beta02
2023년 6월 7일
androidx.compose.material:material-*:1.5.0-beta02
이 출시되었습니다. 버전 1.5.0-beta02에 포함된 커밋을 확인하세요.
버전 1.5.0-beta01
2023년 5월 24일
androidx.compose.material:material-*:1.5.0-beta01
이 출시되었습니다. 버전 1.5.0-beta01에 포함된 커밋을 확인하세요.
API 변경사항
DrawerState
및BottomDrawerState
의 오프셋은 더 이상 null을 허용하지 않습니다. 대신Float.NaN
를 반환하여 오프셋이 없음을 나타냅니다. 추가했습니다. (Ie9855)- 표시된 메뉴 항목의 세로 스크롤 상태를 제어하기 위해
DropdownMenu
또는ExposedDropdownMenu
를 구성할 때ScrollState
를 전달하는 옵션을 추가했습니다. 추가했습니다. (Idb009, b/185304441) - 사용자가 더 많은 추천 하단 시트에 이를 구성할 수 있도록
ModalBottomSheetLayout
동작 사용 설정/사용 중지 지원을 추가합니다. (I40af0) - 텍스트 색상을 효율적으로 애니메이션하거나 설정할 수 있도록
BasicText
에 색상 매개변수를 추가했습니다. 추가했습니다. (Iffd88, b/246961787) - 시맨틱 속성
isContainer
의 이름을isTraversalGroup
로 바꿨습니다. (I121f6)
버그 수정
- 작업이 대화상자 너비에 맞게 서로 겹쳐져 있을 때 확인 작업 아래에
AlertDialog
닫기 작업이 표시되도록 수정했습니다. 이 수정사항은 Material Design 사양에 맞게 구현을 조정합니다. 추가했습니다. (I029de, b/235454277)
버전 1.5.0-alpha04
2023년 5월 10일
androidx.compose.material:material-*:1.5.0-alpha04
이 출시되었습니다. 버전 1.5.0-alpha04에 포함된 커밋을 확인하세요.
API 변경사항
- 밀도 종속 항목을 구성요소 수준으로 이동합니다. 이는
BottomDrawer
,ModalBottomSheetLayout
,BottomSheetScaffold
,Switch
,ModalDrawer
구성요소에 적용됩니다. 밀도가 매개변수인 경우 제공된 새 오버로드를 사용하세요. 추가했습니다. (I8fbd8)
버전 1.5.0-alpha03
2023년 4월 19일
androidx.compose.material:material-*:1.5.0-alpha03
이 출시되었습니다. 버전 1.5.0-alpha03에 포함된 커밋을 확인하세요.
API 변경사항
- 새
SwipeableV2
API를 사용하도록BottomDrawer
내부 요소를 업데이트합니다. 따라서 이제BottomDrawerState
에는 클래스 수준에서 정의된 API만 있으므로SwipeableState
에서 메서드/속성을 상속하지 않습니다. 내부SwipeableV2State
가 있는 컴포지션을 사용하고 있습니다. 이제 Offset은 null을 허용하는 부동 소수점 속성입니다. currentValue 및 targetValue 속성을 통해 현재 값과 스와이프 타겟 값에 계속 액세스할 수 있습니다. 열기/펼치기/닫기와 같은 이전 클래스 수준 메서드와isOpen/isClosed
와 같은 속성은 계속 지원됩니다. (Iad40c, b/178529942, b/220676296)
버그 수정
- Switch 구성요소의 내부를 업데이트했습니다. 이제 스위치는 드래그할 때 가장 가까운 (타겟 상태) 미리보기를 표시합니다. 추가했습니다. (Id90d4)
BottomSheetScaffold
의 애니메이션 시트 콘텐츠 (예: 시트 콘텐츠의Modifier.animateContentSize
)가 최적화되었으며 이제 원활하게 작동합니다. 추가했습니다. (Ia913c, b/270518202, b/254446195)gesturesEnabled
가false
로 설정된 경우BottomSheetScaffold
는 더 이상 중첩 스크롤에 참여하지 않습니다. 추가했습니다. (I634f3, b/215403277)
버전 1.5.0-alpha02
2023년 4월 5일
androidx.compose.material:material-*:1.5.0-alpha02
이 출시되었습니다. 버전 1.5.0-alpha02에 포함된 커밋을 확인하세요.
버그 수정
- 슬롯에 빈 콘텐츠가 제공될 때
BottomSheetScaffold
가 비정상 종료되는 버그를 수정했습니다. 추가했습니다. (Ib24a5, b/235588730) - 클릭 / 포인터 이벤트를 가로채는
PullRefreshIndicator
을 수정했습니다. (2494256, b/271777421)
버전 1.5.0-alpha01
2023년 3월 22일
androidx.compose.material:material-*:1.5.0-alpha01
이 출시되었습니다. 버전 1.5.0-alpha01에 포함된 커밋을 확인하세요.
버그 수정
- 칩 그룹 리플로우 샘플을 추가합니다. 한 줄 칩 그룹 샘플의 하위 칩 사이의 가로 패딩을 사양과 일치하도록 업데이트합니다. 추가했습니다. (I3b155)
- 방향 변경 시 극단적인 케이스에서
ModalBottomSheetLayout
가 비정상 종료되는 문제를 수정했습니다. 이제 시트 콘텐츠 안팎의 레이아웃 애니메이션 (예:Modifier.animateContentSize
)이 원활하게 작동합니다. 추가했습니다. (I2f981, b/266780234)
버전 1.4
버전 1.4.3
2023년 5월 3일
androidx.compose.material:material-*:1.4.3
이 변경사항 없이 출시되었습니다 (버전 범프만 해당).
버전 1.4.2
2023년 4월 19일
androidx.compose.material:material-*:1.4.2
이 출시되었습니다. 버전 1.4.2에 포함된 커밋을 확인하세요.
버전 1.4.1
2023년 4월 5일
androidx.compose.material:material-*:1.4.1
이 출시되었습니다. 버전 1.4.1에 포함된 커밋을 확인하세요.
버전 1.4.0
2023년 3월 22일
androidx.compose.material:material-*:1.4.0
이 출시되었습니다. 버전 1.4.0에 포함된 커밋을 확인하세요.
1.3.0 이후 중요 변경사항
API 변경사항
Modifier.minimumInteractiveComponentSize
를 추가합니다. 이 메서드는 요소가 더 작게 측정되는 경우 터치 상호작용을 구별하기 위해 최소 48.dp의 크기를 예약하는 데 사용할 수 있습니다. (I33f58, b/258495559)ModalDrawer
의 Swipeable API에 변경사항이 통합되었습니다.DrawerState
의animateTo
가 open 및 close 메서드로 대체되었으며 이제 오프셋이 null을 허용합니다.requireOffset
를 사용하여 오프셋을 요구합니다. 추가했습니다. (I3de9e)- material 및 material3 텍스트
TextField
및OutlinedTextField
에minLines
매개변수를 추가했습니다. 이를 통해 구성요소의 최소 높이를 줄 수로 설정할 수 있습니다. (I4af1d) BasicText
및BasicTextField
에minLines
매개변수를 추가했습니다. 이를 통해 행 수를 기준으로 이러한 컴포저블의 최소 높이를 설정할 수 있습니다. (I24294, b/122476634)
버전 1.4.0-rc01
2023년 3월 8일
androidx.compose.material:material-*:1.4.0-rc01
은 변경사항 없이 출시되었습니다. 버전 1.4.0-rc01에 포함된 커밋을 확인하세요.
버전 1.4.0-beta02
2023년 2월 22일
androidx.compose.material:material-*:1.4.0-beta02
가 출시되었습니다. 버전 1.4.0-beta02에 포함된 커밋을 확인하세요.
API 변경사항
BottomSheetScaffold
의 Swipeable API에 변경사항이 통합되었습니다.BottomSheetState
의confirmStateChange
매개변수 이름이confirmValueChange
로 변경되었습니다. 이제progress
가 부동 소수점 값으로 노출됩니다.animateTo
및snapTo
는 내부용입니다. 대신expand()
및collapse()
를 사용하세요.direction
및overflow
가 삭제되었습니다.offset
를requireOffset()
로 대체했습니다. 추가했습니다. (I323b4)
버그 수정
- 클릭 가능하고 선택 가능한 노출 영역에서 시맨틱 역할을 삭제하고 수정자.시맨틱스를 사용하여 역할을 설정하는 데 이 역할을 사용하는 구성요소를 업데이트했습니다. (Ibb4ba)
- 채워진
desktop_mac
,directions
,kitchen
아이콘을 조정하는 확장된 Material 아이콘을 일부 업데이트했습니다. 추가했습니다. (I65f5e)
버전 1.4.0-beta01
2023년 2월 8일
androidx.compose.material:material-*:1.4.0-beta01
이 출시되었습니다. 버전 1.4.0-beta01에 포함된 커밋을 확인하세요.
API 변경사항
pullRefresh
에서 속도를 사용하지 않아 오버스크롤이 표시되는 문제를 수정했습니다. 또한 사용 속도에 부동 소수점 수를 반환하도록Modifier.pullRefresh
에서onRelease
람다의 API 서명을 변경했습니다.(I7db65, b/266874741)- 속성 getter
LocalMinimuTouchTargetEnforcement
를 복원하고 지원 중단으로 표시한 후LocalMinimumInteractiveComponentEnforcement
로 리디렉션했습니다. (I60dd5)
버전 1.4.0-alpha05
2023년 1월 25일
androidx.compose.material:material-*:1.4.0-alpha05
가 출시되었습니다. 버전 1.4.0-alpha05에 포함된 커밋을 확인하세요.
버그 수정
ModalBottomSheetLayout's HalfExpanded
상태가 잘못 계산되고 시트가 플로팅되는 것으로 표시되는 문제가 해결되었습니다. (I8c615, b/265610459)- 일부 상황에서 숨김 상태에서 표시 상태로 전환될 때 시트가 비정상 종료되는
ModalBottomSheetLayout
의 버그를 수정했습니다. (Ia9265, b/265444789)
버전 1.4.0-alpha04
2023년 1월 11일
androidx.compose.material:material-*:1.4.0-alpha04
가 출시되었습니다. 버전 1.4.0-alpha04에 포함된 커밋을 확인하세요.
API 변경사항
- Surface에
IsContainer
시맨틱 속성을 추가했습니다. 이 속성은 나중에 노출 영역과 같은 요소의 시맨틱 의미를 기준으로 순회 순서를 결정하는 데에 사용됩니다. (I63379) - Drawer에서
snapTo
함수를 비실험용 API로 표시합니다. (Ib9c18, b/261425368) - 원형 진행률 표시기용 트랙 색상 매개변수와 원형 및 선형 진행률 표시기용 획 한도 매개변수를 추가했습니다. (Ie668c, b/216325962, b/222964817)
ModalBottomSheetState
,ModalBottomSheetState.Saver
,rememberModalBottomSheetState
의confirmStateChange
를confirmValueChange
로 이름을 바꾸었습니다. (Ib48d1)- 지원 중단된 숨겨진 함수의 반환 유형 null 허용 여부를 더 추가했습니다. (Ibf7b0)
Modifier.minimumInteractiveComponentSize
를 추가합니다. 이 메서드는 요소가 더 작게 측정되는 경우 터치 상호작용을 구별하기 위해 최소 48.dp의 크기를 예약하는 데 사용할 수 있습니다. (I33f58, b/258495559)ModalBottomSheetLayout
의 Swipeable API에 변경사항이 통합되었습니다.ModalBottomSheetState
의animateTo
는 더 이상animationSpec
매개변수를 사용하지 않으며 노출된offset
은 이제 null을 허용합니다.offset
을 요구하려면requireOffset
을 사용합니다. (Ia2e79)
버그 수정
- 이제
ModalBottomSheetLayout
시트의 최대 너비가 640dp입니다. (I71a4f, b/234927577) rememberPullRefreshState
가 시간이 지남에 따라refreshThreshold
및refreshingOffset
을 업데이트하지 않는 문제를 수정했습니다. (Ifed10, b/263159832)- 이제 진행률 표시기의 진행률이 예상 범위로 올바르게 제한됩니다. (I8a7eb, b/262262727)
ModalBottomSheetState
가 아직 앵커를 수신하지 않은 경우snapTo
또는animateTo
가 호출될 때 예외가 발생하는 대신 애니메이션 없이currentValue
를 업데이트합니다. (I2c91b)- Material 2
FilterChip
구현에서 사용 설정된 상태를 수정했습니다. (Id326a, b/261329817) - 세로 모드에서 가로 모드로 회전할 때
ModalBottomSheetLayout
이HalfExpanded
이면 비정상 종료되는 버그를 수정했습니다. 예를 들어 구성을 확인하여 올바른initialValue
를 전달하고 있는지 확인하세요. (Ie8df7, b/182882364) - 시트 콘텐츠가 비어 있는 경우
ModalBottomSheetLayout
이 비정상 종료되는 문제를 수정했습니다. 이제ModalBottomSheetLayout
에서 빈 시트 콘텐츠를 허용합니다. 시트 콘텐츠가 비어 있는 경우 숨김 상태만 가능합니다. (Ic2288, b/200980998, b/216693030)
알려진 문제
androidx.compose.foundation:1.4.0-alpha03
에서androidx.compose.foundation:1.4.0-alpha04
으로 업데이트할 때java.lang.NoSuchFieldError
오류가 발생할 수 있습니다. 이 문제는 여기에서 처음으로 신고되었습니다. 수정사항이 제출되었으며, 다음번 Compose 업데이트에서 사용할 수 있습니다. 이 문제를 해결하려면androidx.compose.material
및androidx.compose.material3
라이브러리를 최신 버전(1.1.0-alpha04)으로 업데이트하거나androidx.compose.foundation
을 1.4.0-alpha03으로 다운그레이드하세요.
버전 1.4.0-alpha03
2022년 12월 7일
androidx.compose.material:material-*:1.4.0-alpha03
이 출시되었습니다. 버전 1.4.0-alpha03에 포함된 커밋을 확인하세요.
API 변경사항
@JvmDefaultWithCompatibility
주석을 추가합니다. (I8f206)Swipeable
API의 변경사항이ModalDrawer
에 통합되었습니다.DrawerState
의animateTo
가open
및close
메서드로 대체되었으며 이제 오프셋이 null을 허용합니다. 오프셋을 요구하려면requireOffset
을 사용하세요. (I3de9e)- 상위 스크롤 정보를 쿼리할 수 있는 Modifier API를 추가했습니다. (I2ba9d, b/203141462).
- 동작이 스크롤 이벤트가 될 가능성이 있는 경우 누르기 상호작용이 올바르게 지연되도록
Clickable
을 수정했습니다. Clickables
가Scrollable ViewGroup
내에서 사용될 때 물결 효과가 올바르게 지연되지 않는 문제를 수정했습니다.- 동작이 스크롤 이벤트가 될 가능성이 있는 경우 누르기가 올바르게 지연되도록 창 및 시트를 업데이트했습니다.
버그 수정
- 새로고침 상태가 true로 변경되지 않으면
onRefresh
가 호출된 후PullRefreshIndicator
가 멈추는 문제를 수정했습니다. (Ie2416, b/248274004)
종속 항목 업데이트
- 이제 Compose UI 및 Compose Material이 Lifecycle 2.5.1에 종속됩니다. (I05ab0, b/258038814)
버전 1.4.0-alpha02
2022년 11월 9일
androidx.compose.material:material-*:1.4.0-alpha02
가 출시되었습니다. 버전 1.4.0-alpha02에 포함된 커밋을 확인하세요.
API 변경사항
- 이제
awaitFirstDown
및waitForUpOrCancellation
이 더 나은 유연성을 위해PointerEventPass
를 허용합니다. (I7579a, b/212091796) - material 및 material3 텍스트
TextField
및OutlinedTextField
에minLines
매개변수를 추가했습니다. 이를 통해 구성요소의 최소 줄 수(높이)를 설정할 수 있습니다. (I4af1d) minLines
매개변수를BasicTex
t 및BasicTextField
에 추가했습니다. 이를 통해 이러한 컴포저블의 최소 줄 수(높이)를 설정할 수 있습니다. (I24294, b/122476634)
버전 1.4.0-alpha01
2022년 10월 24일
androidx.compose.material:material-*:1.4.0-alpha01
이 출시되었습니다. 버전 1.4.0-alpha01에 포함된 커밋을 확인하세요.
API 변경사항
- 동작 감지기용 메서드
awaitEachGesture()
가 새로 추가되었습니다. 이 메서드는forEachGesture()
와 유사하게 작동하지만, 반복과 반복 사이에 이벤트가 손실되지 않도록 동작 루프가 전적으로AwaitPointerEventScope
내에서 작동합니다. forEachGesture()
로 인해 동작 간에 이벤트가 손실될 수 있으므로 이 메서드가 지원 중단되고awaitEachGesture()
로 대체되었습니다. (Iffc3f, b/251260206)
버전 1.3
버전 1.3.1
2022년 11월 9일
androidx.compose.material:material-*:1.3.1
이 출시되었습니다. 버전 1.3.1에 포함된 커밋을 확인하세요.
버전 1.3.0
2022년 10월 24일
androidx.compose.material:material-*:1.3.0
이 출시되었습니다. 버전 1.3.0에 포함된 커밋을 확인하세요.
1.2.0 이후 중요 변경사항
동작 브레이킹 체인지
- 대화상자 및 팝업에서 지원되는 최대 높이가 8dp로 줄었습니다.
API 변경사항
버전 1.3.0-rc01
2022년 10월 5일
androidx.compose.material:material-*:1.3.0-rc01
이 출시되었습니다. 버전 1.3.0-rc01에 포함된 커밋을 확인하세요.
버전 1.3.0-beta03
2022년 9월 21일
androidx.compose.material:material-*:1.3.0-beta03
이 출시되었습니다. 버전 1.3.0-beta03에 포함된 커밋을 확인하세요.
API 변경사항
- Compose에 당겨서 새로고침 구성요소를 추가합니다. (I29168)
버전 1.3.0-beta02
2022년 9월 7일
androidx.compose.material:material-*:1.3.0-beta02
가 출시되었습니다. 버전 1.3.0-beta02에 포함된 커밋을 확인하세요.
1.3.0-beta01 이후 변경사항 없음
버전 1.3.0-beta01
2022년 8월 24일
androidx.compose.material:material-*:1.3.0-beta01
이 출시되었습니다. 버전 1.3.0-beta01에 포함된 커밋을 확인하세요.
동작 브레이킹 체인지
대화상자 및 팝업에서 지원되는 최대 높이가 8dp로 줄었습니다.
Compose 대화상자 및 팝업에서 지원되는 최대 높이가 30dp에서 8dp로 줄었습니다. 이 변경사항은 머티리얼과 UI 맞춤 대화상자 및 팝업에 모두 영향을 미칩니다. 이 변경사항의 목적은 Android S 미만 버전에서의 접근성 버그를 완화하고, 이러한 창 내의 접근성 서비스가 대화상자나 팝업 내부의 콘텐츠와 상호작용할 수 있도록 보장하는 것입니다.
높이가 8dp보다 높은 수준으로 설정된 맞춤 대화상자나 팝업 구현을 만드는 경우에만 이번 변경사항의 영향을 받습니다. 대화상자 또는 팝업의 높이를 낮춰 보세요. 이 새로운 동작을 선택 해제해야 하는 경우 원하는 높이로 설정된 자체 대화상자 또는 팝업을 포크하는 것을 고려해 보세요. 접근성에 부정적인 영향을 미칠 수 있으며 접근성 서비스에서 대화상자나 팝업의 하단 부분을 조작하고 읽을 수 있도록 하는 것은 개발자의 책임이므로 권장되지 않습니다.
버전 1.3.0-alpha03
2022년 8월 10일
androidx.compose.material:material-*:1.3.0-alpha03
이 출시되었습니다. 버전 1.3.0-alpha03에 포함된 커밋을 확인하세요.
버전 1.3.0-alpha02
2022년 7월 27일
androidx.compose.material:material-*:1.3.0-alpha02
가 출시되었습니다. 버전 1.3.0-alpha02에 포함된 커밋을 확인하세요.
외부 기여
- Scaffold에서
FloatingActionButton
의AnimatedVisibility
문제를 수정했습니다. (I3a0ae, b/224005027)
버전 1.3.0-alpha01
2022년 6월 29일
androidx.compose.material:material-*:1.3.0-alpha01
이 출시되었습니다. 버전 1.3.0-alpha01에 포함된 커밋을 확인하세요.
API 변경사항
- 매개변수 이름을 여러 값에서
RangeSlider
의 값으로 변경합니다. (I3b79a)
버그 수정
- 더 의미 있는 콘텐츠 설명을 제공하기 위해 배지 샘플을 업데이트합니다. (I10b9d)
버전 1.2
버전 1.2.1
2022년 8월 10일
androidx.compose.material:material-*:1.2.1
이 출시되었습니다. 버전 1.2.1에 포함된 커밋을 확인하세요.
버전 1.2.0
2022년 7월 27일
androidx.compose.material:material-*:1.2.0
이 출시되었습니다. 버전 1.2.0에 포함된 커밋을 확인하세요.
버전 1.2.0-rc03
2022년 6월 29일
androidx.compose.material:material-*:1.2.0-rc03
이 출시되었습니다. 버전 1.2.0-rc03에 포함된 커밋을 확인하세요.
- 1.2.0-rc02 이후 변경사항 없음
버전 1.2.0-rc02
2022년 6월 22일
androidx.compose.material:material-*:1.2.0-rc02
가 출시되었습니다. 버전 1.2.0-rc02에 포함된 커밋을 확인하세요.
버전 1.2.0-rc01
2022년 6월 15일
androidx.compose.material:material-*:1.2.0-rc01
이 출시되었습니다. 버전 1.2.0-rc01에 포함된 커밋을 확인하세요.
API 변경사항
- Compose 라이브러리의 인터페이스가 이제 jdk8 기본 인터페이스 메서드를 사용하여 빌드됩니다. (I5bcf1)
버그 수정
- 선행 아이콘 탭이 있는 배지를 업데이트하여 아이콘이 아닌 배지를 라벨에 추가합니다. (I90993)
버전 1.2.0-beta03
2022년 6월 1일
androidx.compose.material:material-*:1.2.0-beta03
이 출시되었습니다. 버전 1.2.0-beta03에 포함된 커밋을 확인하세요.
버그 수정
BottomSheetScaffold
가 상단 앱 바의 그림자 위에 그리는 버그를 수정했습니다. 이제BottomSheetScaffold
는 스낵바를 배치할 때 시트의 상태도 고려합니다. 시트가 접힌 상태에서는 스낵바가 시트 및 FAB 위에 배치되며 확장된 상태에서는 시트의 하단에 고정됩니다. (Ia80b5, b/187771422)
버전 1.2.0-beta02
2022년 5월 18일
androidx.compose.material:material-*:1.2.0-beta02
가 출시되었습니다. 버전 1.2.0-beta02에 포함된 커밋을 확인하세요.
버전 1.2.0-beta01
2022년 5월 11일
androidx.compose.material:material-*:1.2.0-beta01
이 출시되었습니다. 버전 1.2.0-beta01에 포함된 커밋을 확인하세요.
새로운 기능
- 이 출시는 1.2의 첫 번째 베타 버전입니다.
API 변경사항
OutlinedTextField
의 테두리 획을 그리는TextFieldDefaults.BorderStroke
컴포저블의 이름이TextFieldDefaults.BorderBox
로 바뀌었습니다. (I5f295)
버전 1.2.0-alpha08
2022년 4월 20일
androidx.compose.material:material-*:1.2.0-alpha08
이 출시되었습니다. 버전 1.2.0-alpha08에 포함된 커밋을 확인하세요.
API 변경사항
PointerInputChange
에서 부분 소비(아래쪽 OR 위치)를 지원 중단했습니다.consume()
을 사용하여 변경사항을 완전히 사용할 수 있습니다.isConsumed
를 사용하여 다른 사용자가 이전에 변경사항을 사용했는지 확인할 수 있습니다.- 이제
PointerInputChange::copy()
가 항상 얕은 복사본을 만듭니다. 즉, 사본 중 하나가 소비되면PointerInputChange
의 사본이 사용됩니다. 결합되지 않은PointerInputChange
를 만들려면 생성자를 대신 사용하세요. (Ie6be4, b/225669674)
버전 1.2.0-alpha07
2022년 4월 6일
androidx.compose.material:material-*:1.2.0-alpha07
이 출시되었습니다. 버전 1.2.0-alpha07에 포함된 커밋을 확인하세요.
버전 1.2.0-alpha06
2022년 3월 23일
androidx.compose.material:material-*:1.2.0-alpha06
이 출시되었습니다. 버전 1.2.0-alpha06에 포함된 커밋을 확인하세요.
API 변경사항
- Surface API의 변경사항을 따르도록 클릭 가능한 Card API를 업데이트했습니다. (I56bcb)
- 선택 및 전환할 수 있는 Surface를 위한 오버로드된 함수가 추가된 Material 2 Surface API로 업데이트되었습니다. (Ifcca5)
버전 1.2.0-alpha05
2022년 3월 9일
androidx.compose.material:material-*:1.2.0-alpha05
가 출시되었습니다. 버전 1.2.0-alpha05에 포함된 커밋을 확인하세요.
API 변경사항
- 이제
LazyVerticalGrid
및LazyHorizontalGrid
가 안정적입니다. (I307c0) LazyVerticalGrid/LazyHorizontalGrid
및 모든 관련 API를 .grid 하위 패키지로 이동했습니다. 가져오기를 androidx.compose.foundation.lazy에서 androidx.compose.foundation.lazy.grid로 업데이트하세요. (I2d446, b/219942574)WindowInsetsControllerCompat
의 뷰에만 의존하는 이전 변경사항을 되돌렸으며 일부 창 플래그를 관리하는 데 필요한 창이 다시 필요합니다. 올바른 창이 사용되도록(예: 뷰가 대화상자에 있는 경우)ViewCompat.getWindowInsetsController
를 지원 중단하고WindowCompat.getInsetsController
로 대체했습니다. (I660ae, b/219572936)- 이제 Text:
includeFontPadding
이 기본적으로 사용 중지되어 있습니다.includeFontPadding=false
의 결과로 발생하는 클리핑 문제가 처리되며 세로로 긴 스크립트의 경우 클리핑이 발생하지 않습니다. (I31c84, b/171394808) - 교차 축 크기를 정의하는 새
LazyVerticalGrid
API를 추가했습니다. (I17723)
버전 1.2.0-alpha04
2022년 2월 23일
androidx.compose.material:material-*:1.2.0-alpha04
가 출시되었습니다. 버전 1.2.0-alpha04에 포함된 커밋을 확인하세요.
API 변경사항
Add support for filter chips
(I39a6e, b/192585545)TextFieldDecorationBox
및OutlinedTextFieldDecorationBox
를 추가했습니다. 이를BasicTextField
와 함께 사용하면 Material Design 텍스트 필드를 기반으로 한 맞춤 텍스트 필드를 빌드할 수 있으며 더 많은 맞춤설정 옵션이 제공됩니다.- 텍스트 필드의 가로 및 세로 패딩을 조정하는 방법을 제공합니다. (I8c9f1, b/203764564, b/191543915, b/189971673, b/183136600, b/179882597, b/168003617)
구성 가능한 함수가 사용 목적으로 설계되지 않은 Applier를 타겟팅하도록 호출되면 컴파일 시간 보고를 허용하는
ComposableTarget
,ComposableTargetMarker
및ComposableOpenTarget
을 추가했습니다.대부분의 경우 Compose 컴파일러 플러그인에서 주석을 추론할 수 있으므로 이러한 주석을 직접 사용할 일은 거의 없습니다. 추론할 수 없는 경우는 맞춤 Applier, 구성 가능한 추상 함수(예: 인터페이스 메서드), 구성 가능한 람다인 필드나 전역 변수(로컬 변수 및 매개변수가 추론됨)를 생성 및 사용하는 경우 또는
ComposeNode
나 구성 가능한 관련 함수를 사용하는 경우입니다.맞춤 Applier의 경우
ComposeNode
또는ReusableComposeNode
를 호출하는 구성 가능한 함수는 함수와 구성 가능한 람다 매개변수 유형에CompoableTarget
주석을 추가해야 합니다. 하지만ComposableTarget
을 직접 사용하는 대신ComposableTargetMarker
주석이 달린 주석을 만들어 표시된 주석을 사용하는 것이 좋습니다.ComposableTargetMarker
로 표시된 구성 가능한 주석은 applier 매개변수로 속성 클래스의 정규화된 이름을 갖는ComposbleTarget
과 동일합니다.ComposableTargetMarker
를 사용하는 예는anroidx.compose.ui.UiComposable
을 참고하세요. (I38f11)
버전 1.2.0-alpha03
2022년 2월 9일
androidx.compose.material:material-*:1.2.0-alpha03
이 출시되었습니다. 버전 1.2.0-alpha03에 포함된 커밋을 확인하세요.
버그 수정
- 칩 그룹 샘플을 추가합니다. (I97080, b/192585545)
버전 1.2.0-alpha02
2022년 1월 26일
androidx.compose.material:material-*:1.2.0-alpha02
가 출시되었습니다. 버전 1.2.0-alpha02에 포함된 커밋을 확인하세요.
API 변경사항
- 복잡한 로직 없이 기존 메서드의 오버로드인 메서드에
NonRestartableComposable
을 추가했습니다. 이렇게 하면 호출된 내부 함수에서 반복되는 매개변수 전체를 대상으로 하는 컴파일러 생성 메모이제이션 검사(동일)가 줄어듭니다. (I90490) - 작업 칩 지원을 추가합니다. (I07100, b/192585545)
버전 1.2.0-alpha01
2022년 1월 12일
androidx.compose.material:material-*:1.2.0-alpha01
이 출시되었습니다. 버전 1.2.0-alpha01에 포함된 커밋을 확인하세요.
종속 항목 업데이트
- 이제 Kotlin
1.6.10
에 종속됩니다.
외부 기여
- 이제
ModalBottomSheetState
에isSkipHalfExpanded
플래그가 포함됩니다. 이 플래그는 생성자를 통해 설정하거나 나중에ModalBottomSheetState
의isSkipHalfExpanded
속성을true
로 설정하여 업데이트할 수 있습니다.isSkipHalfExpanded
의 값을 업데이트하면 시트가 다시 구성됩니다. (I18b86, b/186669820)
버전 1.1
버전 1.1.1
2022년 2월 23일
androidx.compose.material:material-*:1.1.1
이 출시되었습니다. 버전 1.1.1에 포함된 커밋을 확인하세요.
버그 수정
androidx.compose.ui.platform.RenderNodeLayer.updateDisplayList
에서 발생하는NullPointerException
을 수정합니다. (aosp/1947059, b/206677462)- Android에서 클립보드를 읽는 동안 클립보드 콘텐츠로 인해 발생하는 비정상 종료 문제를 해결했습니다. (I06020, b/197769306)
LazyVerticalGrid
의 RTL을 수정했습니다. (aosp/1931080, b/207510535)
버전 1.1.0
2022년 2월 9일
androidx.compose.material:material-*:1.1.0
이 출시되었습니다. 버전 1.1.0에 포함된 커밋을 확인하세요.
1.0.0 이후 중요 변경사항
- Android 12 오버스크롤 효과의 안정화 버전 지원
- 터치 영역 크기 조정 개선
- Compose 1.0의 경우 Material 구성요소는 Material 접근성 가이드라인 터치 영역 크기에 맞게 레이아웃 공간을 확장합니다. 예를 들어 Button의 크기를 더 작게 설정하더라도 버튼 터치 영역은 최소 48x48dp로 확장됩니다. 이렇게 하면 Compose Material이 Material Design 구성요소의 동작과 동일하게 정렬되어 뷰와 Compose를 함께 사용할 때 일관되게 동작합니다. 또한 이러한 변경을 통해 Compose Material 구성요소를 사용하여 UI를 만들 때 터치 영역 접근성에 관한 최소 요구사항이 충족됩니다.
- Navigation Rail의 공개 버전 지원
- 다수의 이전 실험용 API의 공개 버전 전환
- 최신 버전의 Kotlin 지원
버전 1.1.0-rc03
2022년 1월 26일
androidx.compose.material:material-*:1.1.0-rc03
이 출시되었습니다. 버전 1.1.0-rc03에 포함된 커밋을 확인하세요.
동작 변경사항
Compose 1.0의 경우 Material 구성요소는 Material 접근성 가이드라인 터치 영역 크기에 맞게 레이아웃 공간을 확장합니다. 예를 들어 Button의 크기를 더 작게 설정하더라도 버튼 터치 영역은 최소 48x48dp로 확장됩니다. 이렇게 하면 Compose Material이 Material Design 구성요소의 동작과 동일하게 정렬되어 뷰와 Compose를 함께 사용할 때 일관되게 동작합니다. 또한 이러한 변경을 통해 Compose Material 구성요소를 사용하여 UI를 만들 때 터치 영역 접근성에 관한 최소 요구사항이 충족됩니다.
버그 수정
- 최소 터치 영역 수정자를 검사할 때 Layout Inspector의 디버그 정보를 더 자세히 추가했습니다. (aosp/1955036)
버전 1.1.0-rc01
2021년 12월 15일
androidx.compose.material:material-*:1.1.0-rc01
이 출시되었습니다. 버전 1.1.0-rc01에 포함된 커밋을 확인하세요.
버그 수정
Checkbox
에 적용되는 모서리 반지름을 수정했습니다. (I38b03, b/175198975, b/202309440)
버전 1.1.0-beta04
2021년 12월 1일
androidx.compose.material:material-*:1.1.0-beta04
가 출시되었습니다. 버전 1.1.0-beta04에 포함된 커밋을 확인하세요.
새로운 기능
- Kotlin
1.6.0
과 호환되도록 업데이트되었습니다.
버전 1.1.0-beta03
2021년 11월 17일
androidx.compose.material:material-*:1.1.0-beta03
이 출시되었습니다. 버전 1.1.0-beta03에 포함된 커밋을 확인하세요.
버전 1.1.0-beta02
2021년 11월 3일
androidx.compose.material:material-*:1.1.0-beta02
가 출시되었습니다. 버전 1.1.0-beta02에 포함된 커밋을 확인하세요.
버그 수정
- 물결 효과와 기타 표시가 다운 이벤트를 위해 항상 지연되는 대신 이제 Modifier.scrollable() 컨테이너 내부에 있는 경우에만 지연됩니다. (Ibefe0, b/203141462)
버전 1.1.0-beta01
2021년 10월 27일
androidx.compose.material:material-*:1.1.0-beta01
이 출시되었습니다. 버전 1.1.0-beta01에 포함된 커밋을 확인하세요.
새로운 기능
- 이제 물결 효과에서 마우스 오버 및 포커스 상태를 지원하므로 버튼과 같은 구성요소에 마우스 오버/포커스를 적용하면 정확한 상태 오버레이가 표시됩니다.
버전 1.1.0-alpha06
2021년 10월 13일
androidx.compose.material:material-*:1.1.0-alpha06
이 출시되었습니다. 버전 1.1.0-alpha06에 포함된 커밋을 확인하세요.
API 변경사항
- Layout에 하위 요소가 없는 오버로드가 추가되었으며 효율성이 개선되었습니다. (Ib0d9a)
ExposedDropdownMenuBox
에 기반하여 내부에TextField
및DropdownMenu
와 함께ExposedDropdownMenu
가 구현되었습니다. (If60b2)dismissOnOutsideClick
이PopupProperties
에 추가되었으며 지원 중단된dismissOnClickOutside
를 대체합니다. 새 속성은 클릭 위치와 앵커 경계를 수신하고, onDismissRequest의 호출 여부를 더욱 세밀하게 제어합니다. 예를 들어 이 속성은 앵커에 적용된 터치와 관련해 앵커 해제를 방지하는 데 유용할 수 있습니다.updateAndroidWindowManagerFlags
가PopupProperties
에 추가되었습니다. 이 요소는 팝업에 통해 Android WindowManager에 전달된 플래그를 하위 수준으로 제어합니다. 람다의 매개변수는 PopupProperties 값에서 계산된 플래그가 되고, 이 플래그는 결과적으로 WindowManager 플래그가 됩니다. (예: 포커스 가능) 람다의 결과는 Android WindowManager에 전달되는 최종 플래그입니다. 기본적으로 updateAndroidWindowManagerFlags는 매개변수에서 계산된 플래그를 그대로 둡니다. 이 API는 팝업에 매우 특정한 동작 요구사항이 있는 경우에만 주의해서 사용해야 합니다. (I6e9f9)
버전 1.1.0-alpha05
2021년 9월 29일
androidx.compose.material:material-*:1.1.0-alpha05
가 출시되었습니다. 버전 1.1.0-alpha05에 포함된 커밋을 확인하세요.
API 변경사항
- 액세스 가능한 터치 영역이 없는 머티리얼 구성요소에 최소 터치 영역 크기를 추가합니다. 이렇게 하면 터치 영역이 충분히 커지도록 구성요소 주위에 추가 공간이 확보되므로, 이러한 구성요소의 크기가 시각적 크기라고 가정하고 터치 영역 크기를 고려하지 않는 기존 UI가 변경될 수도 있습니다. 실험용
LocalMinimumTouchTargetEnforcement
컴포지션 로컬을 사용하여 계층 구조에서 이 동작을 사용 중지할 수 있지만, 이는 새로운 최소 크기에 맞춰 기존 UI를 업데이트하는 중에 일시적인 이스케이프 해치로만 사용되어야 합니다. (I9b966, b/149691127, b/171509422) - 실험용 TextFieldColorsWithIcons 인터페이스를 추가했습니다. TextFieldColors를 확장하여 leadingColor 및 trailingColor에 InteractionSource를 제공합니다. 이렇게 하면 포커스 상태에 따라 TextField의 모양을 수정할 수 있습니다. (I66923, b/198402662)
버전 1.1.0-alpha04
2021년 9월 15일
androidx.compose.material:material-*:1.1.0-alpha04
가 출시되었습니다. 버전 1.1.0-alpha04에 포함된 커밋을 확인하세요.
API 변경사항
performGesture
및GestureScope
가 지원 중단되고performTouchInput
및TouchInjectionScope
로 대체되었습니다. (Ia5f3f, b/190493367)- 개발자가 터치 영역이 접근성 최소 수준을 충족하는지 확인할 수 있도록 최소 터치 영역 크기를 포함하는
touchBoundsInRoot
를SemanticsNode
에 추가했습니다. (I2e14b, b/197751214)
버그 수정
- 클립이 최소 터치 영역의 목표치를 충족할 수 있도록 클립 영역을 넘어 터치 영역 경계로 확장하는 것을 허용합니다. (I43e10, b/171509422)
- 디스플레이 밀도에 상관없이 단일 픽셀 구분선 그리기를 지원하기 위해 두께 매개변수에서
Dp.Hairline
코드를 준수하기 위해Divider
컴포저블을 업데이트했습니다. (I16ffb, b/196840810)
버전 1.1.0-alpha03
2021년 9월 1일
androidx.compose.material:material-*:1.1.0-alpha03
이 출시되었습니다. 버전 1.1.0-alpha03에 포함된 커밋을 확인하세요.
새로운 기능
- Kotlin
1.5.30
에 종속되도록 Compose1.1.0-alpha03
을 업데이트했습니다. (I74545)
API 변경사항
- 잘린 경계를 가져오기 위한 테스트 메서드를 추가했습니다. (I6b28e)
- 접근성을 보장하기 위해 시맨틱 및 포인터 입력에 사용할 최소 터치 영역 크기를 ViewConfiguration에 추가했습니다. (Ie861c)
버전 1.1.0-alpha02
2021년 8월 18일
androidx.compose.material:material-*:1.1.0-alpha02
가 출시되었습니다. 버전 1.1.0-alpha02에 포함된 커밋을 확인하세요.
외부 기여
- 스와이프 오프셋이 앵커의 반올림 오차 내에 있는 경우 발생하는 SwipeableState의 동작을 수정했습니다. (I03d39, b/191993377)
버전 1.1.0-alpha01
2021년 8월 4일
androidx.compose.material:material-*:1.1.0-alpha01
이 출시되었습니다. 버전 1.1.0-alpha01에 포함된 커밋을 확인하세요.
API 변경사항
- 선택적 FilterQuality 매개변수를 사용하기 위해 소스 및 대상 직사각형을 사용하는
DrawScope#drawImage
메서드를 업데이트했습니다. 이 기능은 픽셀 기반 아트용으로 확장할 때 모자이크로 표현하도록 의도된 픽셀 아트에 유용합니다. 선택적 FilterQuality 매개변수도 사용할 수 있도록 BitmapPainter와 Image 컴포저블을 업데이트했습니다. (Ie4fb0, b/180311607) - BadgeBox의 이름을 BadgedBox로 바꾸고, Badge 컴포저블을 허용하도록 매개변수를 변경했습니다. BadgedBox의 일반적인 배지 콘텐츠인 Badge 구성요소를 추가했습니다. (I639c6)
- NavigationRail 구성요소를 추가했습니다. 사용법 정보는 문서와 샘플을 참고하세요. (I8de77)
버그 수정
- 하단에 정렬된 NavigationRail 샘플 및 Catalog 앱 데모를 추가했습니다. (I3cffc)
- 대화상자가 이제 플랫폼 크기 조정 동작을 따릅니다. 이 동작을 재정의하려면 usePlatformDefaultWidth를 false로 설정합니다. (Iffaed, b/192682388)
- 카탈로그 앱에 탐색 레일 데모를 추가했습니다. (I04960)
- 카탈로그 앱에 배지 데모를 추가했습니다. (If285d)
버전 1.0
버전 1.0.5
2021년 11월 3일
androidx.compose.material:material-*:1.0.5
가 출시되었습니다. 버전 1.0.5에 포함된 커밋을 확인하세요.
버그 수정
- derivedStateOf 인스턴스를 추적할 때 발생하는 비정상 종료 문제를 수정했습니다. (aosp/1792247)
버전 1.0.4
2021년 10월 13일
androidx.compose.material:material-*:1.0.4
가 출시되었습니다. 버전 1.0.4에 포함된 커밋을 확인하세요.
종속 항목 업데이트
- Kotlin
1.5.31
에 종속되도록 업데이트했습니다.
버전 1.0.3
2021년 9월 29일
androidx.compose.material:material-*:1.0.3
이 출시되었습니다. 버전 1.0.3에 포함된 커밋을 확인하세요.
종속 항목 업데이트
- Kotlin
1.5.30
에 종속되도록 업데이트했습니다.
버전 1.0.2
2021년 9월 1일
androidx.compose.material:material-*:1.0.2
가 출시되었습니다. 버전 1.0.2에 포함된 커밋을 확인하세요.
Compose 1.0.2
출시를 지원하도록 업데이트되었습니다. Compose 1.0.2
는 여전히 Kotlin 1.5.21
과 호환됩니다.
버전 1.0.1
2021년 8월 4일
androidx.compose.material:material-*:1.0.1
이 출시되었습니다. 버전 1.0.1에 포함된 커밋을 확인하세요.
종속 항목 업데이트
- Kotlin
1.5.21
에 종속되도록 업데이트했습니다.
버전 1.0.0
2021년 7월 28일
androidx.compose.material:material-*:1.0.0
이 출시되었습니다. 버전 1.0.0에 포함된 커밋을 확인하세요.
1.0.0의 주요 기능
Compose의 첫 번째 안정화 버전입니다. 자세한 내용은 공식 Compose 버전 블로그를 참고하세요.
알려진 문제
Android 스튜디오 Bumblebee Canary 4 또는 AGP
7.1.0-alpha04
/7.1.0-alpha05
를 사용하는 경우 다음과 같은 비정상 종료가 발생할 수 있습니다.java.lang.AbstractMethodError: abstract method "void androidx.lifecycle.DefaultLifecycleObserver.onCreate(androidx.lifecycle.LifecycleOwner)"
이 문제를 해결하려면
build.gradle
파일에서 minSdkVersion을 24 이상으로 일시적으로 늘리세요. 이 문제는 Android 스튜디오 Bumblebee 향후 버전 및 AGP7.1
버전에서 해결될 예정입니다. (b/194289155)
버전 1.0.0-rc02
2021년 7월 14일
androidx.compose.material:material-*:1.0.0-rc02
가 출시되었습니다. 버전 1.0.0-rc02에 포함된 커밋을 확인하세요.
버그 수정
- 대화상자가 이제 플랫폼 크기 조정 동작을 따릅니다. 이 동작을 재정의하려면
usePlatformDefaultWidth
를 false로 설정합니다. (Iffaed, b/192682388)
버전 1.0.0-rc01
2021년 7월 1일
androidx.compose.material:material-*:1.0.0-rc01
이 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.
API 변경사항
BadgeBox
구성요소를 추가했습니다. 사용법 정보는 문서와 샘플을 참고하세요. (I5e284)PopupProperties
의useDefaultMaxWidth
이름이usePlatformDefaultWidth
로 바뀌었습니다. (I05710)- 이제 대화상자에서 전체 화면 너비를 사용할 수 있습니다. (I83929, b/190810877)
- 실험용 범위 슬라이더 구현을 추가했습니다. (I2f4b3)
버그 수정
- Material Design 사양에 맞추기 위해, 잘못된 입력이 포함된 OutlinedTextField는 라벨이 자리표시자로 사용된 경우 라벨에 오류 색상 사용을 중지했습니다. 텍스트 필드에 입력 텍스트가 없고 텍스트 필드가 포커스가 없는 경우에도 마찬가지입니다. 이 변경으로
TextFieldColors.labelColor()
함수의error:Boolean
매개변수 의미도 변경되었습니다. 즉, 이제 입력이 유효하지 않더라도 라벨이 자리표시자로 사용되면false
가 반환됩니다. (I45f78)
버전 1.0.0-beta09
2021년 6월 16일
androidx.compose.material:material-*:1.0.0-beta09
가 출시되었습니다. 버전 1.0.0-beta09에 포함된 커밋을 확인하세요.
API 변경사항
- 테두리 모양을 맞춤설정할 수 있도록 OutlinedTextField에 Shape 매개변수를 추가했습니다. (I8f39e, b/181322957)
- TextOverflow가 인라인 클래스로 변경됩니다. (I433af)
버그 수정
- BottomDrawer, BackdropScaffold, ModalBottomSheetLayout의 스크림이 사라지고 Color.Unspecified가 전달됩니다. (I2d899, b/182063309)
추가된 프로필 규칙
이번 출시에서는 다음 Compose 모듈에 프로필 규칙이 추가됩니다. (I14ed6)
- androidx.compose.animation
- androidx.compose.animation-core
- androidx.compose.foundation
- androidx.compose.foundation-layout
- androidx.compose.material
- androidx.compose.material-ripple
- androidx.compose.runtime
- androidx.compose.ui
- androidx.compose.ui.geometry
- androidx.compose.ui.graphics
- androidx.compose.ui.text
- androidx.compose.ui.text
- androidx.compose.ui.unit
- androidx.compose.ui.util
프로필 규칙이란 무엇인가요?
라이브러리의 프로필 규칙은
src/main
또는 이에 상응하는 디렉터리에 있는 텍스트 파일baseline-prof.txt
에 지정됩니다. 이 파일에서는 줄별로 규칙을 지정합니다. 이때 규칙은 라이브러리의 메서드 또는 클래스와의 일치를 확인하는 패턴을 말합니다. 규칙의 문법은adb shell profman --dump-classes-and-methods ...
를 사용할 때 사용되며 사람이 읽을 수 있는 ART 프로필 형식의 상위 집합입니다. 규칙의 형식은 메서드 또는 클래스를 타겟팅하는 두 가지 형식 중 하나입니다.메서드 규칙의 패턴은 다음과 같습니다.
<FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>
클래스 규칙의 패턴은 다음과 같습니다.
<CLASS_DESCRIPTOR>
여기에서
<FLAGS>
는 이 메서드의 플래그를 'Hot', 'Startup' 또는 'Post Startup'으로 지정해야 하는지를 나타내는 문자H
,S
,P
중 하나 이상으로 구성됩니다.<CLASS_DESCRIPTOR>
는 타겟팅된 메서드가 속한 클래스의 설명자입니다. 예를 들어androidx.compose.runtime.SlotTable
클래스는Landroidx/compose/runtime/SlotTable;
의 설명자를 포함합니다.<METHOD_SIGNATURE>
는 메서드의 서명이며 이름, 매개변수 유형, 메서드의 반환 유형을 포함합니다. 예를 들어LayoutNode
의fun isPlaced(): Boolean
메서드는 서명이isPlaced()Z
입니다.이러한 패턴에는 단일 규칙이 여러 메서드나 클래스를 포괄하도록 와일드 카드(
**
,*
,?
)가 포함될 수 있습니다.
규칙의 기능은 무엇인가요?
H
플래그는 'Hot' 메서드임을 나타내며, 이러한 메서드는 미리 컴파일해야 합니다.S
플래그는 시작 시 호출되는 메서드임을 나타내며, 컴파일 비용을 발생시키지 않고 시작 시 메서드를 해석하지 않으려면 이러한 메서드를 미리 컴파일해야 합니다.P
플래그는 시작 후에 호출되는 메서드임을 나타냅니다.이 파일에 있는 클래스는 시작 중에 사용된다는 사실을 나타내며, 클래스 로드 비용을 발생시키지 않으려면 클래스를 힙에 미리 할당해야 합니다.
어떤 방식으로 작동하나요?
- 라이브러리는 이러한 규칙을 정의할 수 있고 규칙은 AAR 아티팩트에 패키징됩니다. 그런 다음 아티팩트가 포함된 APK가 빌드되면 규칙이 서로 병합되고 병합된 규칙은 APK와 관련된 압축 바이너리 ART 프로필을 빌드하는 데 사용됩니다. 그러면 APK가 기기에 설치된 경우 ART에서 이 프로필을 활용해 애플리케이션의 특정 하위 집합을 미리 컴파일하여 애플리케이션 성능 특히, 첫 번째 실행 성능을 높일 수 있습니다. 디버그 가능한 애플리케이션에는 영향을 주지 않습니다.
버전 1.0.0-beta08
2021년 6월 2일
androidx.compose.material:material-*:1.0.0-beta08
이 출시되었습니다. 버전 1.0.0-beta08에 포함된 커밋을 확인하세요.
새로운 기능
동작 중단 API 변경
- 동작 중단: 이제 카드가 클릭수를 사용하므로
Card(Modifier.clickable)
을 통해 추가된 클릭수가 노옵스(no-ops)가 됩니다. onClick을 허용하는 카드의 새 실험용 오버로드를 사용하세요. (Ia8744, b/183775620)- 클릭수와 기타 클릭 가능한 기능(표시, interactionSource, 사용 설정/사용 중지)을 처리하는 새 카드 오버로드를 추가했습니다. 클릭 불가능한 일반 카드를
Modifier.clickable
과 함께 사용할 수 없었습니다. 이러한 경우 카드가 물결 효과 표시를 자르지 않기 때문입니다.
- 클릭수와 기타 클릭 가능한 기능(표시, interactionSource, 사용 설정/사용 중지)을 처리하는 새 카드 오버로드를 추가했습니다. 클릭 불가능한 일반 카드를
- 동작 중단: 이제 노출 영역이 클릭수를 사용하므로
Surface(Modifier.clickable)
을 통해 추가된 클릭수가 노옵스(no-ops)가 됩니다. onClick을 허용하는 노출 영역의 새 실험용 오버로드를 사용하세요. (I73e6c, b/183775620)- 클릭수와 기타 클릭 가능한 기능(표시, interactionSource, 사용 설정/사용 중지)을 처리하는 새 노출 영역 오버로드를 추가했습니다. 클릭 불가능한 일반 노출 영역을
Modifier.clickable
과 함께 사용할 수 없었습니다. 이러한 경우 노출 영역이 물결 효과 표시를 자르지 않기 때문입니다.
- 클릭수와 기타 클릭 가능한 기능(표시, interactionSource, 사용 설정/사용 중지)을 처리하는 새 노출 영역 오버로드를 추가했습니다. 클릭 불가능한 일반 노출 영역을
API 변경사항
FabPosition
이 향후 잠재적 확장을 지원하려고 enum에서 인라인 클래스로 변환되었습니다. (I030fb)- 새로운 enum 값이 추가될 때 구문이 완전하지 않은 경우 발생하는 문제를 피하도록 인라인 클래스의 enum 사용법을 리팩터링했습니다. (I2b5eb)
- 스크롤/드래그하는 동안 물결 효과가 표시되지 않도록 클릭할 수 있거나 전환할 수 있는 항목에 탭 시간 제한을 추가합니다. (Ia2704, b/168524931)
- ContentDescription 및 Text 시맨틱 속성이 더 이상 단일 값이 아니라 목록입니다. 이렇게 하면 연결하지 않고 그대로 병합할 수 있습니다. 이러한 변경사항을 활용하는 더 나은 테스트 API도 제공됩니다. (Ica6bf, b/184825850)
Modifier.focusModifier()
가 지원 중단되었으며Modifier.focusTarget()
으로 대체되었습니다. (I6c860)FocusState
enum을FocusState
인터페이스로 대체했습니다. (Iccc1a, b/187055290)- 이제 View 지원 물결 효과 구현이 안정적이므로
LocalRippleNativeRendering
을 삭제했습니다. (I7fab3, b/188569367)
버그 수정
- 모든 수정자를 적용한 후 레이아웃 좌표가 아닌 수정자 체인의 이 수정자 좌표를 보고하도록
Modifier.onGloballyPositioned()
를 변경했습니다. 즉, 이제 수정자의 순서가 보고되는 좌표에 영향을 미칩니다. (Ieb67d, b/177926591) - 기존 Compose Material 카탈로그의 README를 추가했습니다. (If9191)
버전 1.0.0-beta07
2021년 5월 18일
androidx.compose.material:material-*:1.0.0-beta07
이 출시되었습니다. 버전 1.0.0-beta07에 포함된 커밋을 확인하세요.
API 변경사항
- 이제 Navigation Compose에서 경로 지원을 위해 확장 메서드를 사용할 필요가 없습니다. (I22beb, b/172823546)
버전 1.0.0-beta06
2021년 5월 5일
androidx.compose.material:material-*:1.0.0-beta06
이 출시되었습니다. 버전 1.0.0-beta06에 포함된 커밋을 확인하세요.
API 변경사항
- Android 기기에서 내부적으로
RippleDrawable
을 사용하도록 물결 효과를 이전했습니다. 즉, 물결 효과 애니메이션이 RenderThread에서 발생하므로 화면 간 이동할 때와 같이 UI 스레드가 로드 중일 때도 원활하게 작동합니다. 이로 인해 물결 효과의 API 노출 영역이 변경되지는 않지만 이러한 변경으로 인해 동작이 변경될 수 있습니다. 이전을 돕기 위해LocalRippleNativeRendering
을 추가했습니다.false
값을 이 CompositionLocal에 제공하여 CompositionLocalProvider 내부의 기존 물결 효과 구현을 대체합니다. API는 일시적이며 앞으로 삭제될 예정인 API이므로 이 API를 사용해야 하는 문제가 발생하면 버그를 신고하세요. (I902f8, b/168777351, b/183019123) - 접근성 서비스 모음과 항목을 표시할 수 있는 CollectionInfo 및 CollectionItemInfo 접근성 API를 추가했습니다. (Id54ef, b/180479017)
- 잘못된 입력이 포함된 노드를 표시할 수 있는 접근성 API
error
를 추가했습니다. (I12997, b/180584804, b/182142737)
버그 수정
- https://github.com/google/accompanist/pull/365에서 Compose Material 카탈로그 인셋 구현을 업데이트했습니다. (I25dc3)
- 가중치(fill = false)가 있는 행 및 열 하위 요소는 더 이상 상위 요소가 전체 사용 가능한 기본 축 공간을 채우도록 하지 않습니다. (Ied94d, b/186012444, b/184355105)
버전 1.0.0-beta05
2021년 4월 21일
androidx.compose.material:material-*:1.0.0-beta05
가 출시되었습니다. 버전 1.0.0-beta05에 포함된 커밋을 확인하세요.
버그 수정
- 기존 Compose Material 카탈로그에 구성요소 타일 이미지, 테마 선택 도구, 더 구체적인 메뉴 URL을 추가했습니다. (I9b58e)
버전 1.0.0-beta04
2021년 4월 7일
androidx.compose.material:material-*:1.0.0-beta04
가 출시되었습니다. 버전 1.0.0-beta04에 포함된 커밋을 확인하세요.
API 변경사항
- API 변경:
DrawerState
상태가 더 이상 실험용 SwipeableState를 확장하지 않습니다.- API 변경: 이제
BottomDrawerState
가 이미 실험용인 BottomDrawer 구성요소와 일치하도록 실험용으로 표시됩니다. (I81114, b/181656094)
- API 변경: 이제
SoftwareKeyboardController
의hideSoftwareKeyboard
와showSoftwareKeyboard
의 이름을 각각hide()
와show()
로 바꿉니다.- LocalSoftwareKeyboardController에 전체 CompositionLocal 인터페이스를 제공하여 설정 가능하도록 합니다(특히 테스트에서 유용함). (I579a6)
- LiveRegion 접근성 API를 추가했습니다. 노드가 라이브 영역으로 표시되면 접근성 서비스가 사용자에게 자동으로 변경사항을 알립니다. (Idcf6f, b/172590946)
버그 수정
- Compose Material 카탈로그 구현을 기존 모듈에 추가했습니다. 현재 누락: 구성요소 타일 이미지, 테마 선택 도구(후속 변경에서 추가 예정) (Ie7a94)
버전 1.0.0-beta03
2021년 3월 24일
androidx.compose.material:material-*:1.0.0-beta03
이 출시되었습니다. 버전 1.0.0-beta03에 포함된 커밋을 확인하세요.
API 변경사항
DefaultMonotonicFrameClock
이 지원 중단되었습니다. 이제MonotonicFrameClock
없이withFrameNanos
또는Recomposer.runRecomposeAndApplyChanges
를 호출하면IllegalStateException
이 발생합니다. (I4eb0d)- 탭에 아이콘과 인라인 텍스트를 표시할 수 있도록 새로운 API
LeadingIconTab
을 추가했습니다. (I23267)
외부 기여
- [조시 울프 작성] 이제
BottomDrawer
가 창 슬롯의 콘텐츠를 래핑합니다. 상위 요소의 높이가 무한한 경우BottomDrawer
에서IllegalStateException
을 발생시키지 않습니다. 이제 하단 창은 상위 요소 크기의 50%보다 작은 경우 펼침 상태로 열립니다.BottomDrawerState
및ModalBottomSheetLayoutState
관련 문서가 업데이트되었습니다. 이제BottomDrawerState#isOpen
은 열림 또는 펼침 상태인 경우 true를 반환합니다. (I87241)
버전 1.0.0-beta02
2021년 3월 10일
androidx.compose.material:material-*:1.0.0-beta02
가 출시되었습니다. 버전 1.0.0-beta02에 포함된 커밋을 확인하세요.
API 변경사항
- TextField의 이전
SoftwareKeyboardController
인터페이스를 대체하는 새로운LocalSoftwareKeyboardController
컴포지션 로컬 API를 추가했습니다. (I5951e, b/168778053)
버그 수정
- 실험용 API의 공개 사용에 제한을 적용합니다. (I6aa29, b/174531520)
- TopAppBar 및 BottomAppBar의 기본 가로 정렬을 Row와 일치하는 Start로 변경했습니다. (Ib2dc7)
- 현재 기존 통합 테스트 데모에 중첩된 Compose Material 카탈로그의 새 모듈 및 자리표시자 UI를 추가했습니다. (Idfcb3)
androidx.compose.ui:ui
가 더 이상 AppCompat 또는 Fragment에 종속되지 않습니다. 애플리케이션에서 ComposeView를 사용하면서 Fragment나 AppCompat를 사용한다면 AppCompat 1.3 이상/Fragment 1.3 이상을 사용해야 합니다. 이러한 버전은 ComposeView에 필요한 수명 주기 및 저장된 상태 소유자를 정확하게 설정하는 데 필요합니다. (I1d6fa, b/161814404)
버전 1.0.0-beta01
2021년 2월 24일
androidx.compose.material:material-*:1.0.0-beta01
이 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.
Compose 1.0.0 베타의 첫 번째 버전입니다.
API 변경사항
- 크기 수정자의 이름이 변경되었습니다. Modifier.width/height/size의 이름이 requiredWidth/requiredHeight/requiredSize로, Modifier.preferredWidth/preferredHeight/preferredSize의 이름이 width/height/size로 변경되었습니다. (I5b414)
- imageResource 및 vectorResource는 이제 ImageBitmap 및 ImageVector 컴패니언의 확장 함수입니다. load{Image,Vector,Font}Resource 함수가 삭제되었습니다. (I89130)
- 내장 기능에 맞게 크기를 조정하는 수정자는 더 이상 실험용이 아닙니다. (I15744)
- dp 어설션을 삭제했습니다. (I798d2)
- 모든 텍스트 필드에서 SoftwareKeyboardController 콜백을 삭제했으며 곧 새 API로 대체할 예정입니다. (Iae869, b/168778053)
- 이제 Switch, Checkbox 및 RadioButton 작업 람다가 null을 허용합니다. Checkbox-in-clickable-row 샘플이 이 기능을 사용하도록 업데이트되었습니다. (If601b, b/171819073)
InteractionState
를[Mutable]InteractionSource
로 대체했습니다.- 인터페이스는 상호작용 이벤트를 방출/수집해야 합니다.
Button
및Modifier.clickable()
등의 구성요소에interactionState = remember { InteractionState() }
를 전달하는 대신interactionSource = remember { MutableInteractionSource() }
를 사용합니다.Interaction.Pressed in interactionState
대신 InteractionSource에서 InteractionSource.collectIsPressedAsState()와 같은 확장 함수를 사용해야 합니다.- 복잡한 사용 사례의 경우 InteractionSource.interactions를 사용하여 상호작용 스트림을 관찰할 수 있습니다. 자세한 내용은 InteractionSource 도움말과 샘플을 참고하세요.
- (I85965, b/152525426, b/171913923, b/171710801, b/174852378)
- CompositionLocals에서 AccessibilityMananger 인터페이스 및 LocalAccessibilityMananger를 추가합니다. (I53520)
- 지원 중단된 LayoutCoordinates 메서드를 삭제했습니다. positionInParent 및 boundsInParent의 속성 대신 함수를 사용합니다. (I580ed, b/169874631, b/175142755)
- 이제 슬라이더가 사용/사용 중지 상태를 지원합니다. (I6d56b, b/179793072)
- CoreTextField와 같은 하위 수준의 텍스트 구성요소의 입력 세션을 위한 새로운 TextInputSession을 만들었습니다. (I8817f, b/177662148)
- AnimationEndReason.Interrupted를 삭제했습니다. 애니메이션이 중단되면 CancellationException이 발생합니다. (I2cbbc, b/179695417)
@ExperimentalRippleApi
를 삭제하고RippleAlpha
를 인터페이스 대신 속성이 포함된 클래스가 되도록 변경했습니다. (I6df7c)- TextFieldColors 인터페이스를 추가했습니다. 이 인터페이스에는 다양한 상태의 TextField 및 OutlinedTextField에 사용되는 여러 색상이 표시됩니다. 기본 구현은 TextFieldDefaults.textFieldColors 및 TextFieldDefaults.outlinedTextFieldColors를 참고하세요.
- TextField 및 OutlinedTextField 내부의 isErrorValue 매개변수의 이름을 isError로 변경했습니다. (I831f9, b/171305338, b/168004067)
- 접근성을 위해 Tabs 또는 RadioButtons 모음을 표시할 수 있는 selectionGroup 수정자를 추가합니다. (Ie5c29)
LazyListState.animateScrollToItem 추가
이 메서드는 목록의 특정 항목으로 매끄럽게 스크롤합니다. (I4bfd7)
ScrollableState.smoothScrollBy()
이름이animateScrollBy()
로,LazyListState.snapToItemIndex()
이름이scrollToItem()
로,ScrollState.smoothScrollTo()
이름이animateScrollTo()
로 바뀌었습니다. (I35ded)이제
@ReadOnlyComposable
로 표시된 모든 컴포저블은 다른@ReadOnlyComposables
만 호출할 수 있도록 컴파일 시간 유효성 검사 대상이 됩니다. (I58961)TargetAnimation API가 삭제되었습니다. (If47d1, b/177457083)
이제 Modifier.verticalScroll()/horizontalScroll()의 스크롤 위치가 Ints로 표시됩니다. (I81298)
smoothScrollBy 및 scrollBy 메서드의 패키지를
androidx.compose.foundation.gestures.*
로 변경했습니다. (I3f7c1, b/175294473)FlingConfig의 이름이 FlingBehavior로 바뀌었으며 이제 사전 정의된 감쇠가 아닌 정지 애니메이션 맞춤설정을 허용합니다. (I02b86, b/175294473)
크기 수정자의 이름이 변경되었습니다. Modifier.width/height/size의 이름이 requiredWidth/requiredHeight/requiredSize로, Modifier.preferredWidth/preferredHeight/preferredSize의 이름이 width/height/size로 변경되었습니다. (I5b414)
defaultMinSizeConstraints의 이름이 defaultMinSize로 변경되었습니다. (I4eaae)
방향이 기본 패키지로 이동했습니다. VelocirtTracker가 ui.gesture에서 ui.input.pointer로 이동했습니다. (Iff4a8, b/175294473)
이제 drawerState.open() 및 drawerState.close()는 정지 함수입니다. rememberCoroutineScope()를 사용하여 컴포지션의 범위를 가져와 호출합니다. (I16f60, b/175294473)
제공자의 이름이 CompositionLocalProvider로 바뀌었습니다.
- 컴포지션 생성자가 더 이상 키 매개변수를 허용하지 않으며 지원 중단되었습니다.
- currentCompositeKeyHash가 최상위 컴포저블 함수가 아닌 최상위 컴포저블 속성으로 전환되었습니다.
- CompositionData 및 CompositionGroup이 androidx.compose.runtime.tooling 네임스페이스로 이동했습니다.
- ComposableLambda는 구체적인 클래스가 아닌 일종의 인터페이스가 되었으며 더 이상 유형 매개변수를 갖지 않습니다.
- ComposableLambdaN은 구체적인 클래스가 아닌 일종의 인터페이스가 되었으며 더 이상 유형 매개변수를 갖지 않습니다.
- snapshotFlow 함수가 androidx.compose.runtime 네임스페이스로 이동했습니다.
- SnapshotMutationPolicy의 병합 메서드가 더 이상 실험용이 아닙니다.
@TestOnly
최상위 clearRoots 함수가 삭제되었습니다. 더 이상 필요하지 않습니다.- keySourceInfoOf 및 resetSourceInfo 함수가 삭제되었습니다. 더 이상 필요하지 않습니다.
- Composer.collectKeySourceInformation이 삭제되었습니다. 더 이상 필요하지 않습니다.
- isJoinedKey, joinedKeyLeft 및 joinedKeyRight 메서드가 삭제되었습니다. 더 이상 필요하지 않습니다.
- 다양한 최상위 API가 여러 파일로 이동되고 재구성되었습니다. Kotlin의 파일 클래스 의미 체계로 인해 바이너리 호환성이 중단되지만 소스 호환성은 중단되지 않습니다. 따라서 대부분의 사용자에게 문제가 되지 않습니다.
- (I99b7d, b/177245490)
Modifier.scrollable이 재구성되었습니다. 이제 ScrollableController 클래스 대신 Scrollable 인터페이스가 사용됩니다. (I4f5a5, b/174485541, b/175294473)
이제 Modifier.draggable에서 간단한 람다 대신 DraggableState를 허용합니다.
rememberDraggableState { delta -> }
를 통해 상태를 만들어 이전과 같은 동작을 가져올 수 있습니다. (Ica70f, b/175294473)이제 ZoomableController.smoothScaleBy 및 ZoomableController.stopAnimation이 정지 함수입니다. (I7f970, b/177457083)
이전에 지원 중단된 일부 API를 삭제했습니다. (Ice5da, b/178633932)
다음과 같이 Material API가 변경되었습니다.
- 기본 패딩을 맞춤설정할 수 있도록 contentPadding 매개변수를 Top/BottomAppBar에 추가했습니다.
- 필수 매개변수가 선택 매개변수 앞에 와야 한다는 API 지침을 따르기 위해 BackdropScaffold의 매개변수를 재정렬했습니다.
- BottomNavigationItem의
icon
매개변수를selected
및onClick
다음으로 이동했습니다. - BottomNavigationItem의
alwaysShowLabels
매개변수 이름을alwaysShowLabel
로 변경했습니다. - 몇몇 구성요소의
bodyContent
매개변수 이름을 단순하게content
로 변경했습니다. ButtonDefaults.buttonColors()
의 매개변수를 재정렬했습니다. 매개변수의 유형이 변경되지는 않았으므로 이로 인한 코드 오류는 발생하지 않습니다. 이름이 지정된 매개변수를 사용하거나 수동으로 정렬을 업데이트하세요. 그러지 않으면 코드가 이전과 동일하게 작동하지 않습니다.darkColors()
에secondaryVariant
매개변수를 추가했습니다. 이 색상은 일반적으로 어두운 테마의secondary
와 동일하지만 일관성 및 세부 맞춤설정을 위해 추가되었습니다.- 공개 API 노출 영역에서 ElevationDefaults 및 animateElevation()을 삭제했습니다. 자주 사용되지 않거나 유용하지 않기 때문입니다.
Slider
의onValueChangeEnd
이름을onValueChangeFinished
로 바꾸고 null을 허용하도록 설정했습니다.- 일관성을 위해
Snackbar
의text
매개변수 이름을content
로 변경했습니다. - 기본 패딩의 맞춤설정이 가능하도록
DropdownMenuItem
에contentPadding
매개변수를 추가했고,content
를RowScope
의 확장 프로그램으로 만들었습니다. ModalDrawerLayout
의 이름을ModalDrawer
로 변경했습니다.BottomDrawerLayout
의 이름을BottomDrawer
로 변경했습니다.- (I1cc66)
이제 BasicTextField에서 색상 대신 브러시를 허용하여 맞춤설정을 개선합니다. (I83a36)
imageResource 및 vectorResource는 이제 ImageBitmap 및 ImageVector 컴패니언의 확장 함수입니다. load{Image,Vector,Font}Resource 함수가 삭제되었습니다. (I89130)
Indication#createIndication()을 Indication#rememberUpdatedIndication(InteractionState)으로 변경하고 IndicationInstance#drawIndication()에서 InteractionState 매개변수를 삭제했습니다. IndicationInstance는 그리기 시각적 효과만 담당해야 하며 InteractionState 변경에 관한 응답으로 이뤄지는 애니메이션 실행/상태 작성은 담당하지 않습니다. 이러한 애니메이션과 상태 쓰기는 대신
rememberUpdatedIndication()
내에서 이뤄져야 합니다.Modifier.indication
의indication
매개변수도 필수 매개변수로 변경되었습니다. (Ic1764, b/152525426)
버그 수정
- TextField의 이전 SoftwareKeyboardController 인터페이스를 대체하기 위한 새로운 LocalSoftwareKeyboardController 컴포지션 로컬 API를 추가했습니다. (I658b6, b/168778053)
버전 1.0.0-alpha12
2021년 2월 10일
androidx.compose.material:material-*:1.0.0-alpha12
가 출시되었습니다. 버전 1.0.0-alpha12에 포함된 커밋을 확인하세요.
API 변경사항
- 이제 Modifier.pointerInput에 새 종속 항목으로 인해 포인터 입력 감지 코루틴이 다시 시작되어야 할 때를 나타내는 기억 키가 필요합니다. (I849cd)
- BottomDrawerLayout 및 ListItem이 @ExperimentalMaterialApi로 표시되었습니다. (Id766e)
- PaddingValues.Absolute가 추가되었으며 PaddingValues를 허용하는 API에서 사용할 수 있습니다. (Ia5f30)
- onImeActionPerformed가 지원 중단됩니다. 대신 KeyboardActions를 사용하세요. (If0bbd, b/179071523)
- ImageBitmap 및 ImageVector와 이름 지정 규칙을 더 잘 맞추기 위해 ImagePainter의 이름을 VectorPainter와 유사한 BitmapPainter로 바꾸었습니다. (Iba381, b/174565889)
- Animatable.snapTo 및 Animatable.stop은 이제 정지 함수입니다. (If4288)
- ComponentActivity.setContent를 androidx.activity:activity-compose 모듈의 androidx.activity.compose.setContent로 이동했습니다. (Icf416)
- 거의 사용하지 않는 여러 클래스의 디스트럭처링 메서드와 copy() 메서드를 삭제했습니다. (I26702, b/178659281)
- ModalBottomSheetState 내부에서 halfExpand() 및 expand()를 만듭니다. (Ic914e)
- Indication#createInstance를 @Composable로 변경했으며, () -> Indication이 아닌 Indication을 포함하도록 LocalIndication을 변경했습니다. (I5eeea, b/157150564)
- 당분간만 AlertDialog 및 DropdownMenu를 Android로 이동합니다. 기본 Popup을 구성하기 위해 PopupProperties 매개변수를 DropdownMenu에 추가했습니다. (I9c443)
- loadFontResource가 지원 중단됩니다. 대신 fontResource를 사용하세요. imageResource, loadImageResource, vectorResource, loadVectorResource는 지원 중단됩니다. 대신 painterResource를 사용하세요. (I6b809)
- DropdownMenu에서
toggle
및toggleModifier
매개변수를 삭제하고dropdownModifier
,dropdownOffset
,dropdownContent
의 이름을 각각modifier
,offset
,content
로 바꾸었습니다. 이제 DropdownMenu가Popup
과 일관되게 동작하며, 여기서 상위 요소 레이아웃이 메뉴의 위치에 사용됩니다. 대부분의 경우toggle
을DropdownMenu
의 동위가 되도록 이동하고Box
에서 둘 다 래핑할 수 있습니다. 이 API 사용에 관한 자세한 내용은 도움말의 업데이트된 샘플을 참고하세요. (I884fb) - toIntPx()의 이름을 roundToPx()로 바꾸었습니다. (I9b7e4, b/173502290)
- IntBounds의 이름을 IntRect로 바꾸고 API를 개선했습니다. (I1f6ff)
- 확장 및 축소 의미 체계 작업을 추가했습니다. ModalBottomSheetState에 expand 및 halfExpand를 추가했습니다. (Ib5064)
- Modifier.dragGestureFilter가 지원 중단되었습니다. 대신
Modifier.pointerInput { detectDragGestures (...)}
를 사용하세요. 또는, 하나의 축 드래그에 Modifier.draggable을 사용합니다. (I0ba93, b/175294473) - Ambients의 이름을 Ambient와 일치하도록 CompositionLocal로 바꾸었습니다. Ambients에서 AmbientFoo라고 했던 이름은 이제 CompositionLocals에서 LocalFoo가 됩니다. (I2d55d)
- Selection은 foundation으로 이동했습니다. (I7892b)
- 이전의
state { 0 }
컴포저블을 삭제하고remember { mutableStateOf(0) }
과 같은 사용을 촉진하는 것과 마찬가지로savedInstanceState { 0 }
컴포저블을 삭제할 예정입니다. 대신rememberSaveable { mutableStateOf(0) }
을 사용해야 하며 이 방식은 MutableState 내에서 사용한 유형을 Bundle에 저장할 수 있다면 자동으로 저장하고 복원합니다. 이전에 맞춤 Saver 객체를 전달했다면 이제stateSaver
매개변수가 있는 rememberSaveable의 새 오버로드를 사용해야 합니다. 사용법은 다음과 같습니다.val holder = rememberSaveable(stateSaver = HolderSaver) { mutableStateOf(Holder(0)) }
(Ib4c26, b/177338004) - 접근성을 위해 미확정 진행률 표시줄을 표시하는 ProgressBarRangeInfo.Indeterminate를 추가했습니다. (I6fe05)
@ComposableContract가 지원 중단되고 추가로 3가지 특정 주석으로 대체되었습니다.
@ComposableContract(restartable = false)
가@NonRestartableComposable
로 변경되었습니다.@ComposableContract(readonly = true)
가@ReadOnlyComposable
로 변경되었습니다.@ComposableContract(preventCapture = true)
가@DisallowComposableCalls
로 변경되었습니다.@ComposableContract(tracked = true)
가 삭제되었습니다.- (I60a9d)
emptyContent()
와(@Composable () -> Unit).orEmpty()
유틸리티는 더 이상 성능에 긍정적인 영향이나 가치가 없으므로 지원 중단되었습니다. (I0484d)rememberSavedInstanceState()가 rememberSaveable()로 이름이 바뀌었으며 androidx.compose.runtime.saveable 패키지로 이동했습니다. (I1366e, b/177338004)
Saver, listSaver(), mapSaver(), autoSaver가 androidx.compose.runtime.savedinstancestate에서 androidx.compose.runtime.saveable로 이동했습니다. (I77fe6)
RTL 방향에서 도형의 자동 미러링을 지원하기 위해 RounderCornerShape, CutCornerShape, CornerBasedShape의 매개변수 이름을 left/right에서 start/end로 바꾸었습니다. 자동 미러링을 사용하지 않는 경우를 위해 AbsoluteRounderCornerShape과 AbsoluteCutCornerShape을 도입했습니다. (I61040, b/152756983)
탭의
text
및icon
매개변수와 BottomNavigationItem의label
매개변수가 null을 허용하고, 이러한 매개변수가 제공되거나 제공되지 않을 때 구성요소의 동작을 더욱 효과적으로 전달하도록 변경되었습니다. 구성요소의 동작이 구성요소의 크기와 레이아웃에 영향을 주기 때문입니다. 텍스트/아이콘/라벨을 표현하기 위해emptyContent()
를 전달하고 있다면 대신null
을 사용해야 합니다. (I57ed4)contentColorFor 색상 매개변수의 이름을 backgroundColor로 변경했습니다. (I5bb67)
TabDefaults를 지원 중단하고 TabRowDefaults로 대체했습니다. (I0f189)
소스 콘텐츠의 RGB 값을 수정하는 데 사용할 수 있는 ColorMatrix API를 도입했습니다. ColorFilter API가 인스턴스가 되고 PathEffect 구현과 일치하도록 리팩터링했습니다. (Ica1e8)
이제 AnimatedValue/Float가 지원 중단되었습니다. 대신 Animatable을 사용하세요. (I71345, b/177457083)
SemanticsProperties.PaneTitle API를 추가합니다. (I20d5a)
사용 설정된 매개변수를 Tab 및 BottomNavigationItem에 추가하여 클릭 가능하지 않도록 했습니다. API에서 레이아웃 요구사항을 더 잘 나타내기 위해 BottomNavigationItem을 RowScope.BottomNavigationItem으로 변경했습니다. (Id683d)
tapGestureFilter, doubleTapGestureFilter, longPressGestureFilter 및 pressIndicaitonGestureFilter가 지원 중단되었습니다. 대신 detectTapGestures 함수와 함께 Modifier.clickable 또는 Modifier.pointerInput을 사용합니다. (I6baf9, b/175294473)
layoutDirection 매개변수를 Shape의 createOutline에 추가합니다. 이렇게 하면 도형을 인식하는 레이아웃 방향을 만들 수 있습니다. (I57c20, b/152756983)
Recomposer.current()
를 삭제했습니다. [Abstract]ComposeView는 이제 지연 생성되고 창으로 범위가 지정되며 창의 ViewTreeLifecycleOwner에서 구동하는 Recomposer를 기본값으로 설정합니다. Recomposition 및 withFrameNanos 기반 애니메이션 틱은 호스트 수명 주기가 중지된 동안 일시중지됩니다. (I38e11)
버그 수정
- 이제 아이콘이 적용되는 크기 수정자를 고려하여 크기에 맞게 확장합니다. 예를 들어
Icon(.., modifier = Modifier.size(50.dp)
은 이제 50x50dp 공간에 그려집니다. (Ib2ba9, b/178796190)
버전 1.0.0-alpha11
2021년 1월 28일
androidx.compose.material:material-*:1.0.0-alpha11
이 출시되었습니다. 버전 1.0.0-alpha11에 포함된 커밋을 확인하세요.
API 변경사항
- 일부 Material API를 더 이상
@Experimental
이 되지 않도록 홍보합니다. (I5d20e) - 콘텐츠 설명 매개변수를 이미지 및 아이콘에 추가했습니다. 접근성 서비스에 설명을 제공하는 데 사용됩니다. (I2ac4c)
- Material 스테이트풀(Stateful) 매개변수 인터페이스를
State<T>
를 반환하는 @Composable 함수를 포함하도록 변경합니다. Animatable을 State로 더 쉽게 변환하도록Animatable.asState()
를 추가합니다. 또한 animateElevation을 Animatable의 정지 확장이 되도록 변경합니다. (If613c) - Snackbar, SnackbarHost, SnackbarHostState가 더 이상
@ExperimentalMaterialAPI
가 아닙니다. (Id1fb5) - Typography, Shapes, TabPosition을 더 이상 데이터 클래스가 되지 않도록 변경합니다. 생성된 것을 대체하도록 Typography 및 Shapes의 복사 기능을 추가합니다. (I40037)
- 이전에 지원 중단된 일부 Material API를 삭제했습니다. (Ifaa25)
버그 수정
- onCommit, onDispose, onActive를 지원 중단하고 SideEffect 및 DisposableEffect API로 대체했습니다. (If760e)
- TransitionDefinition 기반 Transition을 지원 중단했습니다. (I0ac57)
- 이제 updateTransition의 초기 State가 지원됩니다. (Ifd51d)
- WithConstraints를 BoxWithConstraints로 재작업하여 foundation.layout으로 이동했습니다. (I9420b, b/173387208)
비정지 scrollBy를 지원 중단하고 비정지 scrollTo를 삭제합니다.
이제 정지 함수를 사용하여 스크롤을 제어하고 스크롤이 완료될 때까지 기다리는 것이 좋습니다. 이 전환의 일환으로 비정지 버전의 이러한 함수를 지원 중단하고 삭제합니다. (Ie9ced)
비정지 smoothScrollBy를 지원 중단합니다. 이제 정지 함수를 사용하여 스크롤을 제어하고 스크롤이 완료될 때까지 기다리는 것이 좋습니다. 이 전환의 일환으로 비정지 버전의 이러한 함수를 지원 중단합니다. (I12880)
ComposeTestRule
을 확장하고ComposeTestRule
에서 삭제된setContent
를 정의하는ComposeContentTestRule
을 도입했습니다.ComposeTestRule
을 반환하고 Activity를 실행하지 않는createEmptyComposeRule()
팩토리 메서드를 추가했습니다. 테스트하는 동안 Activity를 실행하려면 이 메서드를 사용하세요(예:ActivityScenario.launch
사용). (I9d782, b/174472899)Button 및 FloatingActionButton에 사용된 물결 효과를 더 이상 AmbientIndication을 통해 새 Indication을 제공하여 맞춤설정할 수 없습니다. 이 방법은 이러한 구성요소를 맞춤설정하는 방법으로 의도된 적이 없고 이제 이러한 구성요소 또한 다른 Material 구성요소와 일관되게 처리됩니다. 애플리케이션 전체에서 물결 효과를 맞춤설정하려면 RippleTheme을 참고하세요. (I546c5)
animateAsState가 이제 animateFooAsState이고 여기서 Foo는 애니메이션되는 변수의 유형(예: Float, Dp, Offset 등)입니다. (Ie7e25)
BasicTextField에서
decorationBox
라는 새 매개변수를 수신했습니다. 이를 통해 아이콘, 자리표시자, 라벨, 텍스트 필드와 같은 장식을 추가하고 조회 대상 영역을 늘릴 수 있습니다. (I16996)머티리얼 텍스트 필드의 너비를 280dp 미만으로 설정할 수 없게 만드는 버그를 수정했습니다. (I78373)
canDrag 매개변수를 Modifier.draggable에서 삭제했습니다. (Ic4bec, b/175294473)
displaySize는 사용하면 안 되므로 삭제합니다. 최소한 onRoot() 크기나 창 크기를 사용하는 것이 일반적으로 더 좋습니다. (I62db4)
이제 Surface에 여러 레이아웃 하위 요소를 포함할 수 있습니다. (I66a92, b/144488459)
invalidate 및 compositionReference()를 지원 중단하고 currentRecomposeScope 및 rememberCompositionReference로 각각 대체했습니다. (I583a8)
전역 좌표가 아닌 창 기준 좌표를 사용하도록 PopupPositionProvider를 변경합니다. parentGlobalBounds를 anchorBounds로 이름을 바꾸고 windowGlobalBounds는
windowSize: IntSize
가 되도록 변경합니다. (I2994a)Duration과 Uptime이 Long 밀리초로 대체되며 이 단계에서는 이러한 클래스의 포인터 입력 종속 항목을 삭제합니다. (Ia33b2, b/175142755, b/177420019)
FlingConfig를 허용하는 AnimatedFloat.fling을 삭제했습니다. 대신 정지 Animatable.animateDecay를 사용하세요. (I4659b, b/177457083)
이제 컴포지션 외부에서 clickable, toggleable, selectable을 만들 수 있습니다. (I0a130, b/172938345, b/175294473)
이징을 기능 인터페이스로 변경했습니다. (Ib14e5)
ScrollableColumn/Row를 지원 중단했습니다. 스크롤 콘텐츠가 많을 때 ScrollableColumn을 사용하는 것은 LazyColumn에 비해 효율성이 떨어집니다. LazyColumn을 사용하면 표시된 요소만 구성/측정하고 그릴 수 있기 때문입니다. 사용자가 비효율적인 방법을 선택하는 것을 방지하기 위해 ScrollableColumn과 ScrollableRow를 지원 중단하고 대신 LazyColumn과 LazyRow의 사용을 권장하기로 했습니다. 사용자는 여전히 지연 동작이 필요하지 않다고 판단하고 다음과 같이 직접 수정자를 사용할 수 있습니다. Column(Modifier.verticalScroll(rememberScrollState())) (Ib976b, b/170468083)
items(count: Int)
는 LazyColumn/LazyRow/LazyVerticalGrid 범위의 새로운 팩토리 메서드입니다.items(items: List)
및itemsIndexed(items: List)
는 이제 확장 함수이므로 사용할 때 직접 가져와야 합니다.items(items: Array)
와itemsIndexed(Array)
는 배열의 새 확장 오버로드입니다. (I803fc, b/175562574)실험용 monotonicFrameAnimationClockOf 메서드를 삭제했습니다. (Ib753f, b/170708374)
전역 좌표 메서드를 지원 중단하고 창 기반 좌표 메서드를 새로 만들었습니다. (Iee284)
검사가 사용 설정되어 있을 때 그래픽 레이어 수정자를 추가하는 Modifier.toolingGraphicsLayer를 추가했습니다. (I315df)
이제 FocusRequester.createRefs는 변경될 수 있으므로 실험용으로 표시됩니다. (I2d898, b/177000821)
SemanticsPropertyReceiver.hidden이 invisibleToUser로 이름이 변경되었으며 @ExperimentalComposeUiApi로 표시되었습니다. AccessibilityRangeInfo가 ProgressBarRangeInfo로, stateDescriptionRange가 progressBarRangeInfo로 이름이 변경되었습니다. AccessibilityScrollState가 ScrollAxisRange로, horizontalAccessibilityScrollState가 horizontalScrollAxisRange로, verticalAccessibilityScrollState가 verticalScrollAxisRange로 이름이 변경되었습니다. (Id3148)
테스트에서 TestCoroutineDispatcher를 활용합니다. (I532b6)
벡터 그래픽의 루트에 적용된 색조 조정 파싱을 지원하도록 벡터 그래픽 API를 업데이트했습니다. (Id9d53, b/177210509)
버전 1.0.0-alpha10
2021년 1월 13일
androidx.compose.material:material-*:1.0.0-alpha10
이 출시되었습니다. 버전 1.0.0-alpha10에 포함된 커밋을 확인하세요.
API 변경사항
- 구성요소 부분과 수학 연산을 포함하도록 속도를 수정했습니다. (Ib0447)
- 유사한 실험용 API 주석과 일치하도록
@ExperimentalTesting
에서@ExperimentalTestApi
로 이름을 바꿨습니다. (Ia4502, b/171464963) - Position의 이름을 DpOffset으로 바꿨고 getDistance()를 삭제했습니다. (Ib2dfd)
- Color.useOrElse()의 이름을 Color.takeOrElse()로 바꿨습니다. (Ifdcf5)
- 기본 Strings.kt에 토글을 추가합니다. (I4a5b7, b/172366489)
- FlowRow 및 FlowColumn이 지원 중단되었습니다. 대신 맞춤 레이아웃을 사용하세요. (I09027)
- Modifier.focus()와 Modifier.focusRequester()가 지원 중단되었습니다. 대신 Modifier.focusModifier()와 Modifier.focusReference()를 사용하세요. (I75a48, b/175160751, b/175160532, b/175077829)
- nativeClass를 모듈로 이동하여 내부 클래스로 만들었습니다. equals 구현에서 'is MyClass'를 대신 사용하도록 nativeClass 사용을 업데이트했습니다. (I4f734)
버그 수정
- 사용 중지된 텍스트 필드 및 읽기 전용 텍스트 필드의 지원을 추가했습니다. (I35279, b/171040474, b/166478534)
animate()
가 이제T
대신State<T>
를 반환하는animateAsState()
로 대체되었습니다. 상태 값이 판독되는 지점까지 무효화 범위를 좁힐 수 있으므로 성능이 향상됩니다. (Ib179e)- Semantics role API를 추가하고 역할을 클릭 가능하고 선택 가능하며 전환 가능한 SemanticsModifier에 매개변수로 추가합니다. 슬라이더에서도 사용할 수 있도록 Modifier.progressSemantics를 변경했습니다. (I216cd)
버전 1.0.0-alpha09
2020년 12월 16일
androidx.compose.material:material-*:1.0.0-alpha09
가 출시되었습니다. 버전 1.0.0-alpha09에 포함된 커밋을 확인하세요.
API 변경사항
- settle 애니메이션을 수동으로 트리거하고 Modifier.swipeable을 드래그하는 API를 추가했습니다. (Iaa17a, b/162408885)
- ButtonConstants와 같은 *Constants 객체를 ButtonDefaults와 같이 Defaults로 끝나도록 이름을 바꿨습니다. 이러한 새 객체의 속성에서 불필요한
default
접두사도 삭제합니다. (Ibb915, b/159982740) Compose는 구성 가능한 호출을 실행할 수 있는 속성 getter를 지원합니다. 이에 대한 지원은 중단되지 않지만 속성 getter를 @Composable로 선언하기 위한 문법을 변경 중입니다.
이전에는 속성 자체에 주석을 달아 이 작업을 실행했으나 이제 해당 구문이 지원 중단됩니다.
@Composable val someProperty: Int get() = ...
이제 이 작업을 위한 올바른 구문은 속성의 getter에 주석을 다는 것입니다.
val someProperty: Int @Composable get() = ...
한동안은 두 구문 모두 작동하지만 시간이 지나면 지원 중단되는 이전 구문에서 컴파일 오류가 발생합니다. (Id9197)
나머지 Material 라이브러리 없이도 양방향 구성요소를 빌드할 수 있도록 물결 효과 API가 포함된
androidx.compose.material:material-ripple
라이브러리를 추가했습니다. rememberRippleIndication을 지원 중단하고 rememberRipple로 대체했습니다. (Ibdf11)
버그 수정
- 오프셋 수정자의 람다가 이제 Float 대신 IntOffset을 반환합니다. (Ic9ee5, b/174137212, b/174146755)
그리기 환경의 크기 조절 정보를 사용할 수 있을 때 셰이더 인스턴스를 느리게 만들도록 ShaderBrush를 리팩터링했습니다. 이는 맞춤 DrawModifier 구현을 구현하지 않고도 구성 시간에 컴포저블의 전체 그리기 경계를 차지하는 그라데이션을 정의하는 데 유용합니다.
그라데이션 함수 생성자 API를 지원 중단했으며 Gradient 객체의 팩토리 메서드로 대체했습니다. (I511fc, b/173066799)
Modifier.focusObserver를 지원 중단했습니다. 대신 Modifier.onFocusChanged나 Modifier.onFocusEvent를 사용하세요. (I30f17, b/168511863, b/168511484)
LazyColumnFor, LazyRowFor, LazyColumnForIndexed, LazyRowForIndexed를 지원 중단했습니다. 대신 LazyColumn과 LazyRow를 사용하세요. (I5b48c)
Dp.VectorConverter, Position.VectorConverter 등을 animation-core로 이동하고 이전 VectorConveters를 지원 중단했습니다. (If0c4b)
Autofill API는 이제 실험용 API이며 필수 선택 항목입니다. (I0a1ec)
FocusRequester 인스턴스를 만들기 위해 디스트럭처링 선언을 추가했습니다. (I35d84, b/174817008)
accessibilityLabel의 이름을 contentDescription으로 바꿨습니다. accessibilityValue의 이름을 stateDescription으로 바꿨습니다. (I250f2)
InfiniteRepeatableSpec을 생성하기 위한 새로운 infiniteRepeatable 함수를 도입했습니다. (I668e5)
DropdownMenus의 배치 동작을 Material 사양에 따라 약간 변경했습니다. (I34c72, b/168594123)
TextFields를 위한 InteractionState 지원을 추가했습니다. (I61d91)
하위 요소의 의미 체계를 지우고 새 의미 체계를 설정하는 Modifier.clearAndSetSemantics를 추가했습니다. (I277ca)
ContentDrawScope를 DrawScope와 함께 있도록 ui-graphics 모듈로 이동했습니다. (Iee043, b/173832789)
버전 1.0.0-alpha08
2020년 12월 2일
androidx.compose.material:material:1.0.0-alpha08
, androidx.compose.material:material-icons-core:1.0.0-alpha08
및 androidx.compose.material:material-icons-extended:1.0.0-alpha08
이 출시되었습니다. 버전 1.0.0-alpha08에 포함된 커밋을 확인하세요.
API 변경사항
- 이제 MaterialTheme이 선택 핸들과 선택 배경에 맞는 올바른 색상을 설정합니다. 머티리얼이 아닌 앱에서는 직접 AmbientTextSelectionColors를 사용하여 선택 옵션으로 사용되는 색상을 맞춤설정할 수 있습니다. (I1e6f4, b/139320372, b/139320907)
- Compose 가이드라인과의 일관성을 확인하기 위해 컴포저블 람다 매개변수 이름 지정 및 위치에 관한 린트 검사를 추가했습니다.
또한 린트 검사와 지침에 따라 후행 람다의 이름으로
children
을 사용하는 일부 API를content
로 이전했습니다. (Iec48e) - VectorAsset의 이름을 ImageVector로 바꿨습니다. API 위원회 가이드라인에 따라 ImageVector의 내부 클래스가 되도록 VectorAsset을 Builder로 이동하고 이름을 바꿨습니다. 호환성을 위해 VectorAssetBuilder의 typealias를 ImageVector.Builder 링크에 추가했습니다. (Icfdc8)
- ImageAsset 및 관련 메서드의 이름을 ImageBitmap으로 바꿨습니다. (Ia2d99)
- 기초 의미 체계 속성을 UI로 이동했습니다. (I6f05c)
fun RippleIndication()
을 지원 중단하고 다른 API와의 일관성을 위해rememberRippleIndication()
으로 대체했습니다. (Id8e2c)- BasicTextField, TextField, OutlinedTextField에 singeLine 매개변수를 추가했습니다. 이 매개변수를 true로 설정하면 텍스트 필드가 수평으로 스크롤 가능한 단일 줄이 됩니다. (I57004, b/168187755)
버그 수정
- 의미 체계 작업 닫기를 추가했습니다. (I2b706)
- DrawModifier API를 androidx.compose.ui 패키지에서 androidx.compose.ui.draw 패키지로 이동했습니다. 지원 중단된 API에서 현재 API로 이전하는 데 도움이 되는 typealiases/helper 메서드를 포함하도록 DrawModifierDeprecated.kt 파일을 만들었습니다. (Id6044, b/173834241)
- Modifier.drawLayer의 이름을 Modifier.graphicsLayer로 바꿨습니다. API 의견에 따라 관련 클래스도 GraphicsLayer로 업데이트했습니다. (I0bd29, b/173834241)
- SubcomposeLayout 선언에서
<T>
를 삭제했습니다. 이제 유형을 지정하지 않고 사용할 수 있습니다. (Ib60c8) - drawLayer의 편의성을 위해 Modifier.scale/rotate API를 추가했습니다.
Modifier.drawOpacity
의 이름을Modifier.alpha
로 바꿨습니다.Modifier.drawShadow
의 이름을Modifier.shadow
로 바꿨습니다. (I264ca, b/173208140)
- Box 정렬 매개변수의 이름을 contentAlignment로 바꿨습니다. (I2c957)
- offsetPx 수정자의 이름을 offset으로 바꿨습니다. offsetPx 수정자는 이제 State 대신 람다 매개변수를 사용합니다. (Ic3021, b/173594846)
- SweepGradientShader 및 SweepGradientBrush API를 도입했습니다. (Ia22c1)
- 구성 가능한 함수에 수정자 매개변수 린트 검사를 추가했습니다. 이 린트 검사에서는 Compose 가이드라인과의 일관성을 위해 매개변수의 이름 지정, 반환 유형, 기본값 및 순서를 확인합니다. (If493b)
- TextFieldValue API를 업데이트했습니다.
- TextFieldValue.composition을 읽기 전용으로 만들었습니다.
- 잘못된 선택 범위로 발생한 예외를 삭제했습니다. (I4a675, b/172239032)
- 새
Modifier.drawLayer()
오버로드를 추가했습니다. 이 오버로드는 상태 변경이 발생할 때 재구성 및 재배열을 건너뛸 수 있는 방식으로 레이어 매개변수를 정의하는 새로운 GraphicsLayerScope에서 람다 블록을 사용합니다. 이제 로직을 LayoutModifier의placeable.placeWithLayer()
메서드로 이전하기 위한 준비로 DrawLayerModifier를 내부로 이동했습니다. (I15e9f, b/173030831) - 접미사로
Ambient
라는 이름을 사용하는 Ambient가 지원 중단되고 다른 Ambient 및 Compose API 가이드라인에 따라 Ambient를 접두사로 사용하는 새로운 속성으로 대체됩니다. (I33440) - 수정자 팩토리가
@Composable
로 표시되는 대신androidx.compose.ui.composed {}
를 내부적으로 사용하는지 확인하기 위한 린트 검사를 추가했습니다. (I3c4bc) - 의미 체계 인수 mergeAllDescendants의 이름을 mergeDescendants로 바꿨습니다. (Ib6250)
- 테스트의 시간 제어(TestAnimationClock 및 사용)가 이제 실험용입니다. (I6ef86, b/171378521)
- 이전 ui-test 모듈 및 해당 스텁을 삭제했습니다. (I3a7cb)
- 다른 단위와의 일관성을 위해 TextUnit.Inherit의 이름을 TextUnit.Unspecified로 바꿨습니다. (Ifce19)
- 정렬 인터페이스가 업데이트되어 정상 작동합니다. (I46a07, b/172311734)
- id를 LayoutIdParentData의 layoutId로 이름을 바꿨습니다. Measurable.id를 Measurable.layoutId로 이름을 바꿨습니다. (Iadbcb, b/172449643)
버전 1.0.0-alpha07
2020년 11월 11일
androidx.compose.material:material:1.0.0-alpha07
, androidx.compose.material:material-icons-core:1.0.0-alpha07
및 androidx.compose.material:material-icons-extended:1.0.0-alpha07
가 출시되었습니다. 버전 1.0.0-alpha07에 포함된 커밋을 확인하세요.
API 변경사항
- Emphasis를 지원 중단하고 AmbientContentAlpha로 대체했습니다. AmbientContentAlpha는 AmbientContentColor가 기본 콘텐츠 색상을 나타내는 방식과 유사하게 계층 구조 일부의 기본 콘텐츠 알파를 나타내는 더 간단한 추상화입니다. 이제 Text와 Icon이 기본적으로 AmbientContentAlpha의 현재 값을 사용하고 수동으로
color.copy(alpha = AmbientContentAlpha.current)
를 실행하여 구성요소에 동일한 효과를 적용할 수 있습니다. ProvideEmphasis를 사용하는 대신 AmbientContentAlpha를 통해 값을 직접 제공할 수 있고 ContentAlpha의 새 기본 수준을 사용하여 이전 EmphasisLevels를 대체할 수 있습니다. (Idf03e, b/159017896) - androidx.compose.material.AmbientContentColor를 추가하여 androidx.compose.foundation.AmbientContentColor를 대체합니다. (I84f7b, b/172067770)
- androidx.compose.material.Text를 추가하여 상위 수준의 테마 지정 가능한 Text 구성요소로 androidx.compose.foundation.Text를 대체합니다. 테마에서 색상/텍스트 스타일을 사용하지 않는 기본 텍스트 구성요소의 경우 BasicText를 사용하세요. (Ie6ae0)
- TextFields에 maxLines가 추가되었습니다. (Ib2a5b)
- keyboardOptions를 허용하도록 TextFields를 업데이트했습니다. (Ida7f3)
- 이제 Surface가 고도 오버레이를 계산할 때 절대 (총) 고도를 사용하므로 다른 Surface에 중첩된 Surface는 결합된 고도를 사용하여 오버레이를 그립니다. (I7bd2b, b/171031040)
버그 수정
captureToBitmap
을captureToImage
로 이동했습니다. (I86385)- 기본 AmbientTextStyle, ProvideTextStyle, AmbientContentColor가 지원 중단되었습니다. 대신 Material 라이브러리에서 제공되는 새 버전을 사용하세요. 비 Material 애플리케이션의 경우 자체 구성요소에 사용할 수 있는 고유 디자인 시스템별 테마 설정 앰비언트를 만들어야 합니다. (I74acc, b/172067770)
- foundation.Text가 지원 중단되고 material.Text로 대체되었습니다. 테마의 값을 사용하지 않는 비독단적인 기본 텍스트 API는 androidx.compose.foundation.BasicText를 참고하세요. (If64cb)
- KeyboardOptions의 이름을 ImeOptions로 바꿨습니다. (I82f36)
- KeyboardType 및 ImeAction을 KeyboardOptions로 이동했습니다. (I910ce)
- BaseTextField가 지원 중단되었습니다. BasicTextField를 대신 사용하세요. (I896eb)
- ExperimentalSubcomposeLayoutApi 주석을 삭제했습니다. 이제 @OptIn을 추가하지 않고도 SubcomposeLayout을 사용할 수 있습니다. (I708ad)
- FirstBaseline 및 LastBaseline을 androidx.compose.ui.layout 패키지로 이동했습니다. (Ied2e7)
- ColorFilter 없이도 제공된 애셋 또는 페인터를 그리는 가능한 색조 색상으로 Color.Unspecified를 사용하도록 Icon API를 업데이트했습니다. 이전에는 Color.Unspecified를 사용한 색조 조정을 투명한 색으로 지정해 무시하려고 했습니다. 결과적으로 아무것도 렌더링되지 않습니다. (I049e2, b/171624632)
- relativePaddingFrom의 이름이 paddingFrom으로 바뀌었습니다. 레이아웃 경계에서 텍스트 기준선까지의 거리를 쉽게 지정할 수 있도록 paddingFromBaseline 수정자를 추가했습니다. (I0440a, b/170633813)
- SideEffect 및 DisposableEffect API와 일관성을 유지하기 위해 LaunchedTask의 이름을 LaunchedEffect로 바꿨습니다. 제목 매개변수가 없는 LaunchedEffect는 권장사항을 따르도록 장려하기 위해 허용되지 않습니다. (Ifd3d4)
- MeasureResult를 MeasureScope 외부로 이동했습니다. (Ibf96d, b/171184002)
- 여러 레이아웃 관련 기호를 androidx.compose.ui에서 androidx.compose.layout.ui로 이동했습니다. (I0fa98, b/170475424)
버전 1.0.0-alpha06
2020년 10월 28일
androidx.compose.material:material:1.0.0-alpha06
, androidx.compose.material:material-icons-core:1.0.0-alpha06
및 androidx.compose.material:material-icons-extended:1.0.0-alpha06
가 출시되었습니다. 버전 1.0.0-alpha06에 포함된 커밋을 확인하세요.
API 변경사항
- androidx.compose.foundation.Icon을 androidx.compose.material.Icon으로 이동했습니다. Material 라이브러리를 사용하지 않으려는 경우 이미지 구성요소/Modifier.paint()를 Painter와 함께 사용할 수도 있습니다. (I9f622)
- FloatingActionButtonElevation을 추가하여 다양한 상태의 FAB에 사용되는 고도를 나타냅니다. 기본 구현은 FloatingActionButtonConstants.defaultElevation()을 참고하세요. (I2d4f5)
- SwitchColors 인터페이스를 추가하여 다양한 상태의 Switch에 사용되는 색상을 나타냅니다. 이러한 색상을 맞춤설정하려면 SwitchConstants.defaultColors를 참고하세요. (I93805)
- ButtonElevation 및 ButtonColors 인터페이스를 추가하여 다양한 상태의 버튼에 사용되는 고도와 색상을 나타냅니다. 이러한 매개변수를 맞춤설정하려면 ButtonConstants의 기본 함수를 참고하세요. (Ic5b7b)
- RadioButtonColors 인터페이스를 추가하여 다양한 상태의 RadioButton에 사용되는 색상을 나타냅니다. 다양한 상태에서 사용되는 색상을 맞춤설정하려면 RadioButtonConstants.defaultColors()를 참고하세요. (I74130)
- CheckboxColors 인터페이스를 추가하여 다양한 상태의 체크박스에 사용되는 색상을 나타냅니다. 다양한 상태에서 사용되는 색상을 맞춤설정하려면 CheckboxConstants.defaultColors()를 참고하세요. (I7dbdb)
버그 수정
- Material 구성요소가 더 이상 고도를 zIndex로 설정하지 않습니다. 즉, 동일한 상위 요소 내에서 그림자 크기가 큰 하위 요소가 그림자 크기가 작은 하위 요소 위에 자동으로 그려지지 않습니다. 그래도 이러한 동작이 필요하면 필요에 따라 Modifier.zIndex()를 수동으로 설정하세요. (I70417, b/170623932)
- 컴포저블 API에서 내부적으로 'remember'를 활용하여 컴포지션에서 데이터 유지를 더 잘 나타내도록 VectorPainter를 지원 중단하고 rememberVectorPainter로 대체했습니다. (Ifda43)
- ComposeTestRule에서 전환을 사용 설정하여 ComposeTestRule에서 깜박이는 커서를 사용 설정하는 옵션을 삭제했습니다. (If0de3)
- CoreTextField에 한 줄 키보드 옵션을 추가했습니다. (I72e6d)
- Compose 전체에서 사용되는 방식을 더 잘 표현하도록 Radius API의 이름을 CornerRadius로 바꿨습니다. 음의 모서리 반지름이 0으로 고정되어 있음을 나타내도록 문서를 업데이트했습니다. (I130c7, b/168762961)
- DrawScope 및 ContentDrawScope를 추상 클래스가 아닌 인터페이스가 되도록 리팩터링했습니다.
- DrawScope의 CanvasDrawScope 구현을 생성했습니다.
- CanvasScope를 대신 사용하도록 DrawScope의 구현을 리팩터링했습니다.
- DrawScope의 종속 항목을 래핑하도록 DrawContext를 생성했습니다.
- DrawScope에서 지원 중단된 메서드를 삭제했습니다. (I56f5e)
- Box가 인라인 함수로 생성되었습니다. (Ibce0c, b/155056091)
버전 1.0.0-alpha05
2020년 10월 14일
androidx.compose.material:material:1.0.0-alpha05
, androidx.compose.material:material-icons-core:1.0.0-alpha05
및 androidx.compose.material:material-icons-extended:1.0.0-alpha05
가 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.
API 변경사항
- 이제 팝업 및 대화상자는 상위 Window에서 FLAG_SECURE를 상속합니다. 또한, 이를 명시적으로 구성하는 옵션이 추가되었습니다. (I64966, b/143778148, b/143778149)
- 현재 Modifier.swipeable은 기본적으로 56.dp 상태 임계값을 포함합니다 (Iab825, b/168610267)
- ScaffoldState에서 @Stable.drawerGesturesEnabled로 표시된 모든 scaffold 상태가 Scaffold 자체로 이동했습니다. (I36645, b/168297016)
- Scaffold 람다 매개변수에서 null을 허용하는 유형을 삭제합니다. emptyContent()를 사용하여 지정된 매개변수의 어떤 콘텐츠도 나타낼 수 없습니다. (I2b318, b/157633857, b/158551084)
contentColor() 및 currentTextStyle() API를 지원 중단하고 각각 AmbientContentColor 및 AmbientTextStyle 앰비언트로 대체합니다. 다른 앰비언트와 마찬가지로 앰비언트 속성에서
.current
를 사용하여 현재 값에 액세스할 수 있습니다. 이러한 변경은 일관성을 유지하고 여러 가지 방법을 사용하여 동일한 결과를 얻는 것을 피하기 위해 이루어졌습니다. 또한, 목적을 더 잘 나타내도록 앰비언트 속성 일부의 이름을 다음과 같이 바꿉니다.- ContentColorAmbient -> AmbientContentColor
- TextStyleAmbient -> AmbientTextStyle
- IndicationAmbient -> AmbientIndication
- EmphasisAmbient -> AmbientEmphasisLevels
- RippleThemeAmbient -> AmbientRippleTheme (I37b6d)
AmbientElevationOverlay를 추가하여 어두운 테마의 Surfaces에 적용된 기본 고도 오버레이를 맞춤설정/사용 중지할 수 있습니다. (I5b74d)
버그 수정
- 인라인 클래스의 센티널 값을 표준화하는 과정의 일환으로 다른 인라인 클래스와의 일관성을 위해 Color.Unset의 이름을 Color.Unspecified로 바꿉니다. (I97611, b/169797763)
- TextOverflow.None이 도입되었습니다. 오버플로가 None이면 Text에서 더 이상 오버플로를 처리하지 않으며 LayoutNode에 실제 크기를 보고합니다. (I175c9, b/158830170)
- launchInComposition의 이름이 Compose API 가이드라인에 맞게 LaunchedTask로 바뀌었습니다. (I99a8e)
- OnPositionedModifier 이름이 OnGloballyPositionedModifier로 바뀌고 onPositioned()의 이름이 onGloballyPositioned()로 바뀝니다. (I587e8, b/169083903)
버전 1.0.0-alpha04
2020년 10월 1일
androidx.compose.material:material:1.0.0-alpha04
, androidx.compose.material:material-icons-core:1.0.0-alpha04
및 androidx.compose.material:material-icons-extended:1.0.0-alpha04
가 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.
API 변경사항
- 상태를 끌어 올리고 상태를 읽고 제어할 수 있도록 스테이트풀(Stateful) Material 구성요소에 InteractionState 매개변수를 노출합니다. (Iaca5f, b/168025711, b/167164434)
- RadioButton 및 TriStateCheckbox의
*color
매개변수가 변경되어 각 상태에 사용된 색상을 완전히 맞춤설정하고 원하는 경우 상태 간에 색상 애니메이션 방식을 변경할 수 있습니다. 자세한 내용은 CheckboxConstants 및 RadioButtonConstants에서 새로운 animateDefault* 색상 함수를 참고하세요. (I1c532) - rememberBackdropState 이름을 rememberBackdropScaffoldState로 변경했으며 애니메이션 클록에 추가 매개변수를 추가했습니다. BackdropScaffold의 backdropScaffoldState 매개변수의 이름을 scaffoldState로 변경했습니다. BackgroundConstants 이름을 BackgroundScaffoldConstants로 변경했습니다. (Ib644d)
- 실험용 BottomSheetScaffold 구성요소를 추가했습니다. (Ie02f0, b/148996320)
- 실험용 ModalBottomSheetLayout 구성요소를 추가했습니다. (Ic209e, b/148996320)
- ButtonConstants/FloatingActionButtonConstants.defaultAnimatedElevation 이름을 defaultElevation으로 변경했으며, 이제 AnimatedValue 대신 Dp 값을 반환합니다. (I5f3ed)
버그 수정
- 여러 Graphics API를 업데이트했습니다.
- DrawScope 및 DrawTransform에서 별도의 x/y 좌표 float 매개변수 대신 피벗 좌표를 나타내는 단일 오프셋 매개변수를 사용하도록 배율 및 회전 변환 API를 업데이트했습니다.
- Rect.expandToInclude 및 Rect.join 메서드를 삭제했습니다.
- elliptical 외에도 oval을 나타내도록 Radius 문서를 업데이트했습니다.
- 인라인 Radius 클래스의 공개 생성자를 직접 호출하는 것이 아니라 함수 생성자를 통해 Radius 객체를 인스턴스화해야 한다고 나타내는 문서를 추가했습니다.
- topRight, bottomRight, bottomCenter 등을 쿼리하도록 RoundRect API를 삭제했습니다.
- Rect.shift를 지원 중단하고 Rect.translate로 대체했습니다.
- RoundRect.grow 및 Rect.shrink API를 삭제했습니다.
- RoundRect.outerRect의 이름을 Rect.boundingRect로 변경했습니다.
- RoundRect.middleRect/tallMiddleRect/wideMiddleRect 및 Rect.isStadium 메서드를 삭제했습니다.
- RoundRect.longestSide의 이름을 RoundRect.maxDimension으로 변경했습니다.
- RoundRect.shortestSide의 이름을 RoundRect.minDimension으로 변경했습니다.
- RoundRect.center를 함수가 아닌 속성으로 변경했습니다.
- x/y 반경 값에 개별 매개변수 대신 Radius 속성을 사용하도록 RoundRect 생성자를 업데이트했습니다.
- 0,0에 원점이 있는 직사각형이라고 가정한 Size API를 삭제했습니다.
- Radius에 소멸 API를 추가했습니다.
- 대신 다양한 RoundRect 확장 함수를 속성이 되도록 이전했습니다.
- (I8f5c7, b/168762961)
- foundation.Box가 지원 중단되었습니다. 대신 foundation.layout.Box를 사용하세요. (Ie5950, b/167680279)
- 스택의 이름이 Box로 변경되었습니다. 이전의 기존 Box는 지원 중단되고 compose.foundation.layout의 새 Box로 대체됩니다. 새 Box의 동작은 하위 요소가 여러 개인 경우 하위 요소를 겹겹이 쌓는 것입니다. 이는 Column과 유사하게 동작했던 이전 Box와 다릅니다. (I94893, b/167680279)
- Box 장식 매개변수가 지원 중단되었습니다. Box에 장식/패딩을 적용하려면 대신 수정자를 사용합니다(Modifier.background, Modifier.border, Modifier.padding). (Ibae92, b/167680279)
- 여러 Graphics API를 업데이트했습니다.
- 변환이 콜백 내에서만 적용되고 콜백이 호출된 후에는 삭제된다고 나타내도록 DrawScope API를 범위가 지정된 변환 메서드로 업데이트했습니다.
- 둥근 직사각형 대신 Path를 참조하도록 clipPath 문서를 업데이트했습니다.
- clipPath의 오른쪽 매개변수 문서에서 간격을 수정했습니다.
- DrawScope.drawCanvas의 이름을 drawIntoCanvas로 변경하고 크기 매개변수를 삭제했습니다.
- 인셋 메서드의 dx/dy 매개변수 이름을 수평 및 수직으로 변경했습니다.
- 4개 경계에 모두 동일한 인셋 값을 제공하는 인셋 오버로드를 추가했습니다.
- 인셋이 모든 네 면에 적용된다고 나타내는 인셋 메서드에 관한 문서를 삭제했습니다.
- Rect 클래스 문서를 업데이트했습니다.
- kdoc 스타일과 일치하도록 Rect 매개변수의 주석을 업데이트했습니다.
- Rect.join 및 Rect.expandToInclude를 삭제했습니다.
- Rect.translate(offset)의 오버로드를 만들고 Rect.shift를 지원 중단했습니다.
- (If086a, b/167737376)
- 레이아웃 범위 콘텐츠의 정적 가져오기(예: RowScope의 alignWithSiblings)를 방지했습니다. 대신 명시적인 대체 범위를 사용해야 합니다.
with(RowScope) { Modifier.alignWithSiblings(FirstBaseline) }
(I216be, b/166760797)
버전 1.0.0-alpha03
2020년 9월 16일
androidx.compose.material:material:1.0.0-alpha03
, androidx.compose.material:material-icons-core:1.0.0-alpha03
및 androidx.compose.material:material-icons-extended:1.0.0-alpha03
가 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.
API 변경사항
BottomNavigationItem
의onSelect
매개변수 이름이onClick
으로 바뀌었습니다. (I91925, b/161809324)- BottomNavigationItem 및 Tab에 InteractionState 매개변수를 추가하여 이 상태를 호이스팅하고 구성요소가 다양한 상태에서 표시되는 방식을 조정할 수 있게 합니다. (Ia3e9e, b/168025711)
- 버튼에서
disabledBackgroundColor
및disabledContentColor
매개변수를 삭제합니다. 대신 ButtonConstants 내에서 새로운 기본 색상 함수를 사용해야 합니다. contentColor/backgroundColor를 이미 명시적으로 설정한 경우, 이러한 기본 함수를 사용하고 전체/일부 매개변수를 맞춤설정하여 사용 설정된 상태 및 사용 중지된 상태의 색상을 덮어쓰지 않도록 해야 합니다. (If9b52) - Textfield의 배경 색상에 더 이상 투명도 알파를 암시적으로 적용하지 않습니다. 대신, backgroundColor 매개변수를 통해 제공되는 모든 색상이 직접 적용됩니다. (Iecee9, b/167951441)
- InnerPadding이 PaddingValues로 이름이 바뀌었습니다. (I195f1, b/167389171)
Modifier.swipeable
의resistanceFactorAtMin
및resistanceFactorAtMax
매개변수가 단일 저항 매개변수로 대체되었습니다.SwipeableConstants
에 새로운defaultResistanceConfig
메서드가 추가되었습니다. (I54238)- Button 및 FloatingActionButton에 대한 애니메이션 스테이트풀(Stateful) 고도 지원을 추가합니다. 이제 고도에서 기본 상태와 눌림 상태 사이에 애니메이션을 적용합니다. 상태 간의 고도를 맞춤설정하려면 모든 경우에 flat Dp 값을 설정하는 대신
ButtonConstants.defaultAnimatedElevation()
및FloatingActionButtonConstants.defaultAnimatedElevation()
을 사용합니다. (I37925) - TextField 및 OutlinedTextField 내의 라벨이 선택적 매개변수가 되었습니다. (I267f6, b/162234081)
버그 수정
onNode
또는waitForIdle
과 같은 전역 테스트 함수는 이제 지원 중단되었습니다. ComposeTestRule에 정의된 새로운 함수로 이전하세요. (I7f45a)- DpConstraints 및 DpConstraints를 사용하는 API가 지원 중단되었습니다. (I90cdb, b/167389835)
- widthIn의 minWidth와 maxWidth 매개변수의 이름이 min과 max로 바뀌었습니다. preferredWidthIn, heightIn 및 preferredHeightIn도 마찬가지입니다. (I0e5e1, b/167389544)
- 앞으로 스크롤하거나 뒤로 스크롤하는 시맨틱 작업을 삭제합니다. AccessibilityRangeInfo에 단계가 추가되었습니다. (Ia47b0)
- 레이아웃 API에서 중력 사용에 관한 이름이 align 또는 alignment로 일관성 있게 바뀌었습니다. (I2421a, b/164077038)
- 현재 전역 메서드가 지원 중단될 예정이므로 onNode 및 다른 전역 메서드가 ComposeTestRule에 추가되었습니다. (Ieae36)
createAndroidComposeRule
및AndroidInputDispatcher
가androidx.ui.test.android
에서androidx.ui.test
로 이동했습니다. (Idef08, b/164060572)
버전 1.0.0-alpha02
2020년 9월 2일
androidx.compose.material:material:1.0.0-alpha02
, androidx.compose.material:material-icons-core:1.0.0-alpha02
및 androidx.compose.material:material-icons-extended:1.0.0-alpha02
가 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.
API 변경사항
- 실험용 BackdropScaffold 구성요소가 추가되었습니다. (Iad908)
버그 수정
- Matrix4가 Matrix로 대체되었습니다. vectormath 패키지의 다른 모든 부분이 삭제되었습니다. (Ibd665, b/160140398)
버전 1.0.0-alpha01
2020년 8월 26일
androidx.compose.material:material:1.0.0-alpha01
, androidx.compose.material:material-icons-core:1.0.0-alpha01
및 androidx.compose.material:material-icons-extended:1.0.0-alpha01
가 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.
알려진 문제
머티리얼 TextField
의 첫 번째 문자는 백스페이스를 사용하여 삭제할 수 없습니다. (b/165956313)
버전 0.1.0-dev
버전 0.1.0-dev17
2020년 8월 19일
androidx.compose.material:material:0.1.0-dev17
, androidx.compose.material:material-icons-core:0.1.0-dev17
및 androidx.compose.material:material-icons-extended:0.1.0-dev17
가 출시되었습니다. 버전 0.1.0-dev17에 포함된 커밋을 확인하세요.
API 변경사항
- 이전에 지원 중단된 RadioGroup 및 RadioGroupItem을 삭제했습니다. 대신 Row 및 RadioBotton을 사용해야 합니다. (I381b7, b/163806637)
- TextField에서 onFocusChanged 콜백을 삭제했습니다. 대신 Modifier.focusObserver를 사용해야 합니다. (I51089, b/161297615)
- Modifier.drawBorder가 지원 중단되었습니다. 대신 Modifier.border를 사용하세요. Border 데이터 클래스를 BorderStroke로 대체했습니다. (I4257d, b/158160576)
- SwipeableState에서 일부 속성의 이름을 바꿨습니다(swipeTarget -> targetValue, swipeProgress -> progress, swipeDirection -> direction). SwipeableState를 생성하기 위한 rememberSwipeableState 함수를 추가했습니다. (I2fc9c, b/163129614, b/163132293)
- 위치 지정 및 적절한 큐 추가가 포함된 스낵바 지원을 추가했습니다.
SnackbarHostState.showSnackbar
정지 함수를 통해 액세스할 수 있습니다. 또한 다음 변경사항에 유의하세요.- SnackbarHost 구성요소를 추가했습니다. 이 구성요소는 상태를 기반으로 스낵바를 호스팅하며 스낵바 간 전환을 담당합니다.
- SnackbarHostState를 추가하여 스낵바 및 스낵바 호스트를 제어할 수 있으며 ScaffoldState에서 이를 분리하였습니다.
scaffoldState.snackbarHostState
를 통해서도 이 상태에 액세스할 수 있습니다. - snackbarHostState와 스낵바 자체 간의 공통 인터페이스를 지원하기 위해 스낵바 오버로드를 추가했습니다. (I79aaa)
- 사용 설정된 매개변수를 IconButton에 추가하고 IconToggleButton의 매개변수를 재정렬했습니다. (I0a941, b/161809385, b/161807956)
- 문자열 기반 API가 있는 ListItem 버전을 삭제했습니다. 대신 슬롯 버전을 사용해야 합니다. (Ib8f57, b/161804681)
- 지원 중단된 FilledTextField 구성요소를 삭제했습니다. 채워진 텍스트 입력란의 Material Design 구현을 얻으려면 대신 TextField를 사용하세요. (I5e889)
- AlertDialog는 이제 버튼에 FlowRow를 사용합니다. (I00ec1, b/161809319, b/143682374)
- 경계를 지나 스와이프할 때 저항의 양을 변경할 수 있도록 Modifier.swipeable에 매개변수를 추가했습니다. [min/max]Value 매개변수를 삭제했습니다. (I93d98)
- LinearProgressIndicator에 backgroundColor 매개변수를 추가하고 CircularProgressIndicator에서 내부 패딩을 삭제했습니다. 값 사이의 진행률을 애니메이션으로 표시할 때 기본 AnimationSpec으로 사용할 수 있는 새로운 ProgressIndicatorConstants.DefaultProgressAnimationSpec을 추가했습니다. (If38b5, b/161809914, b/161804677)
- Modifier.swipeable에 선택적 매개변수 velocityThreshold를 추가했습니다. (I698ba)
- bottomBarSize, fabSize 등을 ScaffoldState에서 더 이상 사용할 수 없습니다. 크기를 알고 싶은 구성요소에는 Modifier.onPosition을 대신 사용해야 합니다. contentColor 및 수정자 매개변수를 Scaffold에 추가했습니다. (Ic6f7b, b/161811485, b/157174382)
- 다른 API와의 일관성을 위해 Tab에서 일부 매개변수의 이름을 변경하고 재정렬합니다. (Ia2d12, b/161807532)
- TabRow를 TabRow 및 ScrollableTabRow로 분할하며 TabRow에서 isScrollable을 삭제합니다. 또한 ScrollableTabRow의 edgePadding을 노출하여 탭 앞/뒤의 여유 공간을 제어할 수 있습니다. (I583e8, b/161809544)
TabRow
객체를 삭제하고 TabConstants로 대체했습니다. TabRow.TabPosition을 최상위 수준(TabPosition)으로 이동하였으며 indicatorContainer의 이름을indicator
로 변경했습니다. 업데이트된 API 및 기본값 사용 방법에 관한 자세한 내용은 샘플 및 문서를 참조하세요. (I54d45, b/161809544)- Modifier.swipeable의 임계값 매개변수를 수정했습니다. 이제 한 쌍의 상태(T 유형)를 사용하여 이러한 상태 간의 임계값을 ThresholdConfig 형식으로 반환합니다. 매개변수 dismissThresholds를 SwipeToDismiss에 추가했습니다. 이는 람다(DismissDirection) -> ThresholdConfig입니다. (Ie1080)
- 슬라이더에 세분화된 맞춤설정을 위한 색상이 추가되었습니다. (I73e64, b/161810475)
- 카드의 색상 매개변수 이름을 backgroundColor로 바꿨습니다. (I01fc1, b/161809546)
- 이제 스낵바에 맞춤설정 가능한 배경 및 콘텐츠 색상이 있습니다. (I238f2, b/161804381)
- modifier, backgroundColor, contentColor 및 scrimColor 맞춤설정 매개변수를 Drawer에 추가했습니다. (I23655, b/161804378)
state { ... }
컴포저블이 이제 지원 중단되고 명확성을 위해 명시적remember { mutableStateOf(...) }
호출로 대체됩니다. 이렇게 하면 전체 API 노출 영역 및 상태 관리를 위한 개념 수가 감소하고 클래스 속성 위임을 위한by mutableStateOf()
패턴과 일치합니다. (Ia5727)- 버튼의 패딩 매개변수 이름을 contentPadding으로 바꿨습니다. (Id252e, b/161809394)
- 실험용 머티리얼 구성요소인 SwipeToDismiss를 추가했습니다. (I129e5)
버그 수정
onChildPositioned
및OnChildPositionedModifier
가 삭제되었습니다. 개발자는 하위 레이아웃에서onPositioned
및OnPositionedModifier
를 대신 사용해야 합니다. (I4522e, b/162109766)- SemanticsPropertyKey에 mergePolicy 람다를 추가했습니다. 이는 mergeAllDescendants 의미 체계 병합을 위한 맞춤 정책을 정의하는 데 사용할 수 있습니다. 기본 정책은 상위 값이 이미 있다면 상위 값을 사용하고 상위 값이 없으면 하위 값을 사용하는 것입니다. (Iaf6c4, b/161979921)
- IntSize는 이제 인라인 클래스입니다. (I2bf42)
PlacementScope.placeAbsolute()
의 이름이PlacementScope.place()
로 변경되었으며 이전PlacementScope.place()
의 이름은PlacementScope.placeRelative()
로 변경되었습니다. 따라서PlacementScope.place()
메서드는 더 이상 RTL 컨텍스트의 위치를 자동으로 미러링하지 않습니다. 이를 원한다면PlacementScope.placeRelative()
를 대신 사용해야 합니다. (I873ac, b/162916675)- PxBounds가 지원 중단되고 Rect로 대체되었습니다. PxBounds의 모든 사용이 Rect로 업데이트되었으며 이전을 지원하기 위해 적절한 지원 중단/주석으로 대체가 추가되었습니다. (I37038, b/162627058)
- Compose 이름 지정 패턴에 더 잘 맞게 RRect의 이름을 RoundRect로 변경했습니다. RRect와 유사한 함수 생성자를 만들었으며 RRect 함수 생성자는 지원 중단되었습니다. (I5d325)
버전 0.1.0-dev16
2020년 8월 5일
androidx.compose.material:material:0.1.0-dev16
, androidx.compose.material:material-icons-core:0.1.0-dev16
및 androidx.compose.material:material-icons-extended:0.1.0-dev16
가 출시되었습니다. 버전 0.1.0-dev16에 포함된 커밋을 확인하세요.
API 변경사항
- Colors는 인터페이스가 아닌 최종 클래스입니다. 맞춤 구현을 확장하고 제공하는 대신 맞춤 테마 객체를 위한 새 앰비언트를 생성하고 MaterialTheme이 내부적으로 작동하는 방식과 유사하게 구성요소의 새 앰비언트를 통해 테마 객체에 액세스해야 합니다. (Ibae84)
- Material 색상 시스템에 더 잘 매핑하고 ColorPalette가 구체적으로 Material 색상 시스템을 구현하는 것이 아니라 '일반적인' 테마 설정 객체인 것처럼 혼동하게 되는 경우를 없애기 위해 ColorPalette 이름을 Colors로 바꾸었습니다. 또한 lightColorPalette 및 darkColorPalette가 각각 lightColors 및 darkColors로 이름이 변경되었습니다. (I9e976, b/161812111)
- BottomNavigationItem의 매개변수 이름을
text
에서label
로,onSelected
에서onSelect
로,activeColor
에서selectedContentColor
로,inactiveColor
에서unselectedContentColor
로 바꾸고 가이드라인과 일치하도록 매개변수 순서를 업데이트했습니다. (Icb605, b/161809324) Modifier.stateDraggable
이 완전히 재작업되고 Modifier.swipeable로 이름이 바뀌었습니다. 새로운 SwipeableState 클래스가 도입되었으며 DrawerState 및 BottomDrawerState가 이 클래스에서 상속하도록 리팩터링되었습니다. [Modal/Bottom]DrawerLayout은 더 이상 onStateChange 매개변수를 사용하지 않습니다. (I72332, b/148023068)- foundation.shape.corner 패키지가 foundation.share로 평면화되었습니다. (I46491, b/161887429)
- ExperimentalMaterialApi 주석을 추가했습니다. RippleTheme을 실험용으로 표시했습니다. (Ic5fa0, b/161784800)
- Material FilledTextField는 TextField로 이름이 바뀌었으며 기본 TextField는 BaseTextField로 이름이 바뀌어 원하는 가장 간단한 API를 쉽게 찾고 사용할 수 있습니다. (Ia6242, b/155482676)
버그 수정
- OnChildPositioned가 지원 중단되었습니다. 대신 하위 요소에서 OnPositioned를 사용해야 합니다. (I87f95, b/162109766)
- 광범위한 API 수정사항을 처리했습니다. (I077bc)
- 사용하지 않는 OffsetBase 인터페이스를 삭제했습니다.
- 일관된 API 노출 영역을 갖도록 Offset 및 IntOffset 클래스를 정렬했습니다.
- Offset API와 일치하도록 IntOffset.Origin의 이름을 IntOffset.Zero로 바꿨습니다.
- 소비자가 자체 캔버스 인스턴스를 만들 수 있도록 지원하기 위해 캔버스 인터페이스에서 nativeCanvas 메서드를 이동했습니다.
- lateinit 대신 null이 아닌 매개변수가 되도록 DrawScope를 리팩터링하고 필드의 비 null 허용 여부를 보장하기 위해 스터브 EmptyCanvas 클래스를 만들었습니다.
- ClipOp enum의 이름을 파스칼 표기법으로 바꿨습니다.
- FilterQuality enum의 이름을 파스칼 표기법으로 바꿨습니다.
- StrokeJoin enum의 이름을 파스칼 표기법으로 바꿨습니다.
- PointMode enum의 이름을 파스칼 표기법으로 바꿨습니다.
- PaintingStyle enum의 이름을 파스칼 표기법으로 바꿨습니다.
- PathFillType enum의 이름을 파스칼 표기법으로 바꿨습니다.
- StrokeCap enum의 이름을 파스칼 표기법으로 바꿨습니다.
- lateinit 매개변수를 더 이상 사용하지 않도록 DrawCache 구현을 업데이트했습니다.
- fillPaint 및 strokePaint 내부 매개변수에 지연 위임을 더 이상 사용하지 않도록 DrawScope를 업데이트했습니다.
- 적은 오버헤드로 Box 사용을 방지하기 위해 이미지 컴포저블을 업데이트했습니다.
- @Immutable 주석을 포함하도록 Outline 클래스를 업데이트했습니다.
- 각 경로 명령에 대해 @Immutable 주석을 포함하도록 PathNode를 업데이트했습니다.
- 동등성에 대한 중복 조건부 검사를 삭제하도록(Compose가 사전에 처리하므로) 벡터 하위 구성을 업데이트했습니다.
- Rect 컴패니언 생성자 메서드를 지원 중단하고 함수 생성자로 대체했습니다.
- @Immutable 및 @Stable API를 사용하여 Brush 클래스 및 함수 생성자를 업데이트했습니다.
- VertexMode enum을 파스칼 표기법으로 업데이트했습니다.
- 페인트의 stroke 매개변수가 변경된 경우 이 매개변수를 조건부로 덮어쓰도록 DrawScope selectPaint 메서드를 업데이트했습니다.
- 디스트럭처링 API를 추가하고 UnspecifiedSize를 Unspecified로 바꾸기 위해 Size를 업데이트했으며 사용하지 않는 메서드를 삭제했습니다.
- 대화상자를 UI로 이동합니다. (I47fa6)
SemanticsNodeInteraction.performPartialGesture
를 삭제했습니다. 대신SemanticsNodeInteraction.performGesture
를 사용해야 합니다. (Id9b62)SemanticsNodeInteraction.getBoundsInRoot()
이름을SemanticsNodeInteraction.getUnclippedBoundsInRoot()
로 바꿨습니다. (Icafdf, b/161336532)- 오른쪽에서 왼쪽 지원을 위한 API가 업데이트되었습니다. LayoutDirectionAmbient가 추가되어 레이아웃 방향을 읽고 변경하는 데 사용할 수 있습니다. Modifier.rtl 및 Modifier.ltr이 삭제되었습니다. (I080b3)
- Modifier.deternimateProgress 이름을 Modifier.progressSemantics로 바꿨습니다. (I9c0b4)
- Material.io/icons에 추가된 최신 아이콘으로 material-icons-extended를 업데이트합니다. (I4b1d3)
- transitionDefinition에 T 유형을 명시적으로 지정해야 합니다. (I1aded)
- Modifier.plus가 지원 중단되었습니다. 대신 Modifier.then을 사용해야 합니다. 'then'에는 더 강력한 순서 지정 신호가 있지만 체인을 끊어 읽기가 더 어렵게 만드는
Modifier.padding().background() + anotherModifier
입력도 금지합니다. (Iedd58, b/161529964) - AndroidComposeTestRule 이름을 createAndroidComposeRule로 바꿨습니다. (I70aaf)
- isFocused() 및 isNotFocused() SemanticsMatcher가 추가됩니다. (I0b760)
- 테스트에서 사용해서는 안 되는
BaseGestureScope.globalBounds
가 삭제되었습니다. 상호작용하고 있는 노드에 로컬인 좌표를 대신 사용하세요. (Ie9b08) - 잘라낸 디스플레이에서 팝업 위치가 수정되었습니다. (Idd7dd)
- Modifier.drawBackground 이름을 Modifier.background로 바꿨습니다. (I13677)
버전 0.1.0-dev15
2020년 7월 22일
androidx.compose.material:material:0.1.0-dev15
, androidx.compose.material:material-icons-core:0.1.0-dev15
및 androidx.compose.material:material-icons-extended:0.1.0-dev15
가 출시되었습니다. 버전 0.1.0-dev15에 포함된 커밋을 확인하세요.
종속 항목 업데이트
- Compose의
0.1.0-dev15
버전을 사용하려면 위의 종속 항목 선언에 표시된 새로운 코드 스니펫에 따라 종속 항목을 업데이트해야 합니다.
API 변경사항
이제
@Model
주석이 지원 중단됩니다. state 및 mutableStateOf를 대안으로 사용합니다. 이번 지원 중단은 여러 신중한 논의 끝에 결정되었습니다.근거
근거에는 다음이 포함되지만 이에 국한되지는 않습니다.
- 교육이 필요한 API 노출 영역 및 개념이 감소합니다.
- 다른 유사한 툴킷(Swift UI, React, Flutter)과 더욱 원활하게 호환됩니다.
- 되돌릴 수 있는 결정입니다. 나중에 언제든지
@Model
을 가져올 수 있습니다. @Model
을 처리해야 할 작업으로 구성하는 데 있어서 발생하는 특수한 사용 및 답변하기 어려운 질문을 삭제합니다.@Model
데이터 클래스, 등호, 해시코드 등- 일부 속성은 '관찰'되고 나머지는 관찰되지 않게 하려면 어떻게 해야 하나요?
- 관찰에서 사용할 구조 동등성과 참조 동등성을 각각 지정하려면 어떻게 해야 하나요?
- 시스템에서 '매직'을 줄입니다. 즉, 시스템이 실제보다 더 영리하다고(예를 들어, 목록을 식별하는 방법을 알고 있다고) 가정할 가능성을 줄입니다.
- 관찰의 세부사항을 더 직관적으로 파악할 수 있습니다.
- 클래스의 변수에서 속성으로의 리팩터링 가능성을 개선합니다.
- 잠재적으로 State별로 수동 최적화할 가능성이 생깁니다.
- 나머지 생태계와 더 원활하게 호환되고 불변 또는 '변경 가능한 상태를 허용'하는 데 모호성을 줄입니다.
이전 참고사항
@Model
의 거의 모든 기존 사용법은 두 가지 방법 중 하나로 상당히 쉽게 변환됩니다. 아래 예에서는 속성이 두 개인@Model
클래스가 호환 가능하게 사용됨을 보여줍니다.@Model class Position( var x: Int, var y: Int ) @Composable fun Example() { var p = remember { Position(0, 0) } PositionChanger( position=p, onXChange={ p.x = it } onYChange={ p.y = it } ) }
대안 1:
State<OriginalClass>
사용 및 사본 생성이 접근 방식은 Kotlin의 데이터 클래스를 사용하면 더 쉽습니다. 기본적으로 모든 이전
var
속성을 데이터 클래스의val
속성으로 만들고remember
대신state
를 사용한 다음 데이터 클래스copy(...)
편의 메서드를 사용하여 상태 값을 원본을 복제한 사본에 할당합니다.데이터 클래스의 유일한 변형이
State
인스턴스가 만들어진 동일한 범위에서 실행된 경우에만 이 접근 방식이 효과가 있다는 데 유의해야 합니다. 데이터 클래스가 사용 범위 밖에서 내부적으로 자신을 변형하고 이를 관찰하는 데 의존하고 있다면 다음 접근 방식을 사용하는 것이 좋습니다.data class Position( val x: Int, val y: Int ) @Composable fun Example() { var p by state { Position(0, 0) } PositionChanger( position=p, onXChange={ p = p.copy(x=it) } onYChange={ p = p.copy(y=it) } ) }
대안 2: mutableStateOf 및 속성 위임 사용
이 접근 방식은 Kotlin의 속성 위임과 개발자가 MutableState 인스턴스를 구성 밖에서 만들도록 허용하는
mutableStateOf
API를 사용하면 더 쉽습니다. 기본적으로 원래 클래스의 모든var
속성을 속성 위임으로mutableStateOf
가 있는var
속성으로 교체합니다. 이렇게 하면 클래스 사용법이 전혀 변경되지 않고 클래스의 내부 구현만 변경되는 이점이 있습니다. 그러나 각 속성이 이제 개별적으로 관찰/구독되므로 동작은 원래 예와 완전히 동일하지는 않습니다. 따라서 리팩터링 후에 확인하는 재구성 범위가 더 좁아질 수 있는데 이는 좋은 현상입니다.class Position(x: Int, y: Int) { var x by mutableStateOf(x) var y by mutableStateOf(y) } // source of Example is identical to original @Composable fun Example() { var p = remember { Position(0, 0) } PositionChanger( position=p, onXChange={ p.x = it } onYChange={ p.y = it } ) }
(I409e8, b/152050010, b/146362815, b/146342522, b/143413369, b/135715219, b/143263925, b/139653744)
텍스트 필드의 onFocusChange 콜백 이름을 onFocusChanged로 바꿨습니다. (Ida4a1)
앵커 사이에 기준점을 지정하기 위해 stateDraggable에 thresholds 매개변수를 추가했습니다. 이는 하단 창에서 56dp 임계값을 설정하는 데 사용되었습니다. 또한, 이제 BottomDrawerLayout에서 별도의 BottomDrawerState enum을 사용합니다. (I533fa)
이전에 지원 중단된 Modifier.ripple을 삭제합니다. 이제 clickable이 ripple을 기본 표시로 사용하므로(애플리케이션에 MaterialTheme{} 세트가 있는 경우) 대부분의 경우 clickable을 사용하여 자유롭게 ripple 표시를 가져올 수 있습니다. ripple의 색상/크기/제한 매개변수를 맞춤설정해야 한다면 수동으로 RippleIndication을 만들어 표시 매개변수로 clickable에 전달하면 됩니다. (I663b2, b/155375067)
지원 중단된 FilledTextField 컴포저블 재정의를 삭제했습니다. (I7f8f8)
Button 객체(Button 함수에서 사용되는 기본값 포함)의 이름이 ButtonConstants로 바뀌었습니다. (I7c5f7, b/159687878)
이제 버튼의 콘텐츠 슬롯이 행처럼 작동합니다. 이는 텍스트가 있는 아이콘이 필요한 경우 유용합니다. 작성 방법은 Button의 샘플을 참고하세요. (I0ff10, b/158677863)
RadioGroup 및 RadioGroupItem이 지원 중단되었습니다. 디자인에 따라 radioButton 선택의 적절한 세트를 만들도록 Modifier.selectable, Row, Column과 함께 Box를 사용합니다. (I7f5cf, b/149528535)
Material Outlined Textfield를 추가했습니다. (I1a518)
androidx.ui.foundation.TextFieldValue 및 androidx.ui.input.EditorValue는 지원 중단되었습니다. 이 유형을 사용하는 TextField, FilledTextField, CoreTextField 컴포저블도 지원 중단되었습니다. 대신 androidx.ui.input.TextFieldValue를 사용하세요. (I4066d, b/155211005)
TabRow.TabPosition에는 IntPx가 아닌 Dp 위치가 포함되지 않습니다. (I34a07, b/158577776)
IntPx 사용을 Int로 대체했습니다. IntPxPosition은 IntOffset으로 대체했습니다. IntPxSize를 IntSize로 대체했습니다. (Ib7b44)
크기 정보를 표시하는 데 사용되는 클래스의 수를 통합하려면 PxSize 대신 Size 클래스 사용을 표준화합니다. 이렇게 하면 인라인 클래스의 이점을 제공하여 부동 소수점으로 표시된 너비와 높이를 나타내는 long-pack 2 부동 소수점 값을 활용할 수 있습니다. (Ic0191)
Modifier.ripple을 지원 중단합니다. 이제 clickable이 ripple을 기본 표시로 사용하므로(애플리케이션에 MaterialTheme{} 세트가 있는 경우) 대부분의 경우 clickable을 사용하여 자유롭게 ripple 표시를 가져올 수 있습니다. ripple의 색상/크기/제한 매개변수를 맞춤설정해야 한다면 수동으로 RippleIndication을 만들어 표시 매개변수로 clickable에 전달하면 됩니다. (I101cd, b/155375067)
Scaffold API가 재작업되었습니다. 이름이 바뀐 매개변수는 거의 없고 더 나은 맞춤설정을 위해 새 매개변수가 추가되었습니다. Fab, TopBar 및 BottomBar의 크기를 쿼리하는 getter를 추가했습니다. (I0e7ce)
Material Design 메뉴 구현인 ui-material에 DropdownMenu 구성요소를 추가했습니다. (I9bb3d)
SoftwareKeyboardController를 사용하여 소프트웨어 키보드를 수동으로 표시하거나 숨길 수 있습니다. (Ifb9d6, b/155427736)
Modifier.indication을 기본 패키지에 추가했습니다. 이 패키지를 사용하여 상호작용 가능한 맞춤 요소에 누르기/드래그/기타 표시를 나타낼 수 있습니다. (I8425f, b/155287131)
CanvasScope 구현이 통합되어 이제 DrawScope와 ContentDrawScope만 있습니다. CanvasScope 이름을 DrawScope로 바꿨습니다. DrawScope는 Density 인터페이스를 구현하고 LayoutDirection을 제공하도록 업데이트되었으며 ContentDrawScope의 DrawScope 서브클래스는 삭제되었습니다. RTL 속성을 수동으로 제공하지 않아도 이미 DrawScope에서 제공하므로 Painter와 PainterModifier가 더 이상 RTL 속성을 자체적으로 유지하지 않도록 업데이트되었습니다. (I1798e)
Emphasis.emphasize() 이름이 Emphasis.applyEmphasis()로 바뀌었습니다. (Iceebe)
사용 중지된 버튼은 Material Design 사양을 시각적으로 따릅니다. (I47dcb, b/155076924)
FilledTextField는 IME 작업, 시각적 변환 및 키보드 유형 지원을 받습니다. (I1f9cf, b/155075201)
획 크기를 맞춤설정하도록 strokeWidth 매개변수가 CircularProgressIndicator에 추가되었습니다. LinearProgressIndicator의 획 크기(높이)를 변경하려면 Modifier.preferredHeight() 또는 다른 크기 수정자를 사용하면 됩니다. (Icea16, b/154919081)
획 크기를 맞춤설정하도록 strokeWidth 매개변수가 CircularProgressIndicator에 추가되었습니다. LinearProgressIndicator의 획 크기(높이)를 변경하려면 Modifier.preferredHeight() 또는 다른 크기 수정자를 사용하면 됩니다. (Icea16, b/154919081)
FilledTextField의 후행 및 선행 아이콘과 오류 상태 처리를 위한 슬롯 API를 추가했습니다. (Ic12e0)
FAB 및 확장 FAB의 기본 색상이 MaterialTheme.colors.secondary로 변경되었습니다. (I3b9b9, b/154118816)
API의 모든 null을 허용하는 Color 사용을 null을 허용하지 않는 것으로 대체했습니다. null 대신 Color.Unset을 사용하세요(Iabaa7).
EdgeInsets 이름을 InnerPadding으로 바꿨습니다. Material Buttons의 innerPadding 매개변수 이름을 padding으로 바꿨습니다. (I66165)
슬라이더가 이제 스테이트리스(Stateless)입니다. 사용자는 다른 컨트롤의 경우처럼 직접 상태를 전달하고 업데이트해야 합니다. (Ia00aa)
StaticDrawer가 삭제되었습니다. StaticDrawer가 필요한 경우, 대신 머티리얼 사양에 지정된 너비로 Box를 사용하세요. (I244a7)
채워진 텍스트 입력란의 Material Design 구현을 추가했습니다. (Ic75cd)
ListItem에 수정자 매개변수를 추가하고 후행 람다 본문의 순위를 올리기 위해 매개변수를 재정렬했습니다. (I66e21)
글꼴 모음이 설정되지 않은 TextStyle이 제공된 경우 여기에 사용될 기본 글꼴 모음을 지정하도록 Typography에 defaultFontFamily 생성자 매개변수를 추가합니다. (I89d07)
API 노출 영역에서 Material 데이터 테이블을 일시적으로 삭제했습니다. (Iaea61)
Divider 컴포저블의 매개변수 이름을 바꿨습니다. (Ic4373)
하위 요소 (Ia6d19)
MaterialTheme.emphasisLevels를 삭제하고 대신 강조 수준을 가져오도록 EmphasisAmbient.current를 사용합니다. (Ib5e40)
도형 테마 설정 시스템이 Material Design 사양에 따라 업데이트됩니다. 이제 대부분의 구성요소에 사용되는 소형, 중형, 대형 도형을 제공할 수 있습니다. (Ifb4d1)
MaterialTheme.colors(), MaterialTheme.typography()와 같은 MaterialTheme API를 함수가 아닌 속성으로 변경했습니다. 기존 호출에서 괄호를 삭제했습니다. 동작 변경사항은 없습니다. (I3565a)
프리미티브 대신 구성 가능한 람다를 허용하도록 FloatingActionButton API를 리팩터링했습니다. 사용량 정보는 업데이트된 샘플을 참고하세요. (I00622)
Checkbox, Switch 및 Toggleable에
enabled
매개변수를 추가합니다. (I41c16)물결 효과는 이제 수정자입니다. Clickable이 아직 전환되지 않은 동안 권장되는 사용법은
Clickable(onClick = { ... }, modifier = ripple())
입니다. (Ie5200, b/151331852, b/150060763)Surface 및 Card는 androidx.ui.material.surface에서 androidx.ui.material로 이동했습니다. (I88a6d, b/150863888)
이제 Button, FloatingActionButton, Clickable에 별도의
enabled
매개변수가 있습니다. Button의 일부 매개변수가 이름이 변경되거나 재정렬되었습니다. (I54b5a)Image 데이터와 레이아웃에 참여하고 콘텐츠를 그리는 데 사용되는 예정된 Image 컴포저블 사이의 차이를 더 잘 구분하기 위해 Image 이름을 ImageAsset으로 바꿨습니다. _Body:기존 Android 애플리케이션 개발을 Compose 프레임워크와 결합하는 데 유용한 ImageAsset 인스턴스를 만들 수 있도록 android.graphics.Bitmap에 asImageAsset()이라는 확장 메서드를 만들었습니다. (Id5bbd)
String 매개변수가 있는 Snackbar API를 삭제했으며 대신 구성 가능한 람다를 허용하는 오버로드를 사용합니다. 사용법 정보는 업데이트된 샘플을 참고하세요. (I55f80)
text
및icon
람다를 허용하도록 Tab API를 리팩터링했습니다. (Ia057e)BottomNavigation 구성요소를 추가했습니다. 사용법 정보는 문서와 샘플을 참고하세요. (I731a0)
Icon, IconButton, IconToggleButton을 추가하고 AppBarIcon을 삭제했습니다. 기존의 AppBarIcon 사용을 IconButton으로 직접 대체할 수 있으며 이제 터치 타겟이 올바르게 지정됩니다. 사용법 정보는 샘플을 참고하고 이러한 구성요소와 함께 직접 사용할 수 있도록 제공되는 머티리얼 아이콘을 확인하려면 Icons를 참고하세요. (I96849)
ButtonStyle을 고유 함수로 대체했으며 텍스트(문자열) 오버로드를 삭제했습니다. 사용량 정보는 업데이트된 샘플을 참고하세요. (If63ab, b/146478620, b/146482131)
Border
수정자의 이름을DrawBorder
로 바꿨습니다. (I8ffcc)LayoutCoordinate에 더 이상 위치 속성이 없습니다. 위치 속성은 LayoutModifier, 회전 또는 크기 조정을 고려할 때 의미가 없습니다. 대신 개발자는 parentCoordinates 및 childToLocal()을 사용하여 LayoutCoordinate 간의 변환을 계산해야 합니다.
LayoutCoordinates는 크기 속성으로 PxSize가 아닌 IntPxSize를 사용합니다. Layout은 레이아웃에 정수 픽셀 크기를 사용하므로 모든 레이아웃 크기에 부동 소수점 값이 아닌 정수를 사용해야 합니다. (I9367b)
ambients API에 브레이킹 체인지가 있습니다. 자세한 내용은 로그와
Ambient<T>
문서를 참고하세요.(I4c7ee, b/143769776)Scaffold 머티리얼 구성요소가 추가되었습니다. Scaffold를 구현합니다. (I7731b)
DrawBorder를 Border 수정자로 대체했습니다. (Id335a)
버그 수정
- FocusModifier는 지원 중단되고 Modifier.focus, Modifier.focusRequester, Modifier.focusObserver로 대체되었습니다. FocusState 및 FocusDetailedState는 지원 중단되고 FocusState2로 대체되었습니다. (I46919, b/160822875, b/160922136)
- VerticalScroller와 HorizontalScroller는 지원 중단되었습니다. 열/행 동작 및 매개변수를 사용하는 내장 환경에는 ScrollableColumn과 ScrollableRow를 사용하고, 개발자의 자체 요소에는 Modifier.verticalScroll 및 Modifier.horizontalScroll을 사용하세요. 마찬가지로, ScrollerPosition이 지원 중단되고 ScrollState로 대체되었습니다. (I400ce, b/157225838, b/149460415, b/154105299)
- Modifier.draggable 및 Modifier.scrollable API는 다시 작동합니다. DragDirection은 삭제되고 Orientation으로 대체되었습니다. 스크롤에 필요한 상태가 간소화되었습니다. ScrollableState의 이름이 ScrollableController로 바뀌었습니다. (Iab63c, b/149460415)
runOnIdleCompose
이름을runOnIdle
로 바꿨습니다. (I83607)- 이제 단일 값 의미 체계 속성에 호출 스타일이 사용됩니다. 예를 들어 'semantics { hidden = true }'는 이제 'semantics { hidden() }'으로 작성됩니다. (Ic1afd, b/145951226, b/145955412)
- 여러 테스트 API의 이름이 더 직관적으로 바뀌었습니다. 모든 findXYZ API의 이름이 onNodeXYZ로 바뀌었습니다. 모든 doXYZ API의 이름이 performXYZ로 바뀌었습니다. (I7f164)
- TransitionState를 하위 요소에 전달하는 대신 TransitionState를 반환하도록 Transition API가 변경되었습니다. 이렇게 하면, API와 animate() API의 일관성이 더 높아집니다. (I24e38)
- 레이아웃에서 정수 픽셀 경계를 표현하는 IntBounds 단위 클래스가 추가되었습니다. 이 기능을 사용하도록 PopupPositionProvider API를 업데이트했습니다. (I0d8d0, b/159596546)
- 테스트 찾기에 새 옵션 플래그인 useUnmergedTree가 추가되었습니다. (I2ce48)
- 더 이상 사용되지 않는 크기 테스트 API를 삭제했습니다. (Iba0a0)
- NativeShader 클래스를 래핑했던 Shader 인라인 클래스를 삭제하고 NativeShader 이름을 Shader로 바꿨습니다. 래핑된 Shader 인라인 클래스는 API 노출 영역에 중요한 항목을 추가하지 않았으며 인라인 클래스이므로 NativeShader 클래스를 직접 사용하면 됩니다. (I25e4d)
- 이제 팝업, 대화상자 및 메뉴는 상황별 MaterialTheme를 상속합니다. (Ia3665, b/156527485)
- 이제 머티리얼의 DropdownMenu에서 스크롤이 가능합니다. (Ide699)
- Layout() 함수의 측정 블록에서 레이아웃 방향 매개변수를 삭제했습니다. 하지만 레이아웃 방향은 측정 범위 객체를 통해 콜백 내에서 사용할 수 있습니다. (Ic7d9d)
- 정적 애니메이션 사양 개념을 명확하게 하려면 최상위 API에서 AnimationBuilder 대신 AnimationSpec을 사용하세요. -트윈, 스프링과 같은 AnimationSpec을 만들기 위한 람다 요구사항을 삭제하여 전환 DSL을 개선합니다. 대신 생성자 매개변수가 직접 사용됩니다. -빌더에 의존하는 대신 생성자를 열어 AnimationSpec의 사용 편의성이 전반적으로 향상됩니다. -KeyFrames와 Tween의 재생 시간과 지연이 Int로 변경됩니다. 이를 통해 불필요한 유형 변환 및 메서드 오버로드가 사라집니다(Long과 Int를 모두 지원하는 경우). (Ica0b4)
- 이제
enabled
가 거짓으로 설정되면 스위치가 사용 중지 상태로 표시됩니다. (If4624, b/155941869, b/159331694) - Modifier.tag는 Modifier.testTag와 혼동을 피하고자 Modifier.layoutId로 이름이 바뀌었습니다. (I995f0)
- 이제 Placeable#get(AlignmentLine)에서 반환된 정렬 행 Int 위치는 null이 아닙니다. 쿼리된 정렬 행이 없으면 AlignmentLine.Unspecified가 반환됩니다. (I896c5, b/158134875)
Radius 클래스를 인라인 클래스로 리팩터링했습니다. y축의 반경이 필수 x축 반경 매개변수의 반경과 일치하도록 컴패니언 생성 메서드가 삭제되고 기본 매개변수가 있는 함수 생성자로 대체되었습니다.
x축 및 y축 반경에 2개의 별도 부동 소수점 값 대신 단일 반경 매개변수를 사용하도록 DrawScope.drawRoundRect를 업데이트했습니다. (I46d1b)
위치 정보를 나타내는 데 사용되는 클래스 수를 통합하려면 PxPosition 대신 Offset 클래스 사용을 표준화합니다. 이렇게 하면, 인라인 클래스의 이점을 제공하여 부동 소수점으로 표시된 x 및 y 오프셋을 나타내는 long-pack 2 부동 소수점 값을 활용할 수 있습니다. (I3ad98)
여러 컴포즈 클래스에서 Px 클래스가 더 이상 대규모 리팩터링 작업의 일부로 사용되지 않습니다. 픽셀 매개변수에는 Dp 유형과 기본 유형만 사용됩니다. Px 클래스 전체를 삭제했습니다. (I3ff33)
Toggleable 구성요소가 지원 중단되었습니다. 대신 Modifier.toggleable을 사용하세요. (I35220, b/157642842)
대규모 리팩터링 작업의 일환으로 여러 컴포즈 클래스에서 Px 클래스가 더 이상 사용되지 않습니다. 픽셀 매개변수에는 Dp 유형과 기본 유형만 사용됩니다. (I086f4)
여러 컴포즈 클래스에서 Px 클래스가 더 이상 대규모 리팩터링 작업의 일부로 사용되지 않습니다. 픽셀 매개변수에는 Dp 유형과 기본 유형만 사용됩니다. (Id3434)
여러 컴포즈 클래스에서 Px 클래스가 더 이상 대규모 리팩터링 작업의 일부로 사용되지 않습니다. 픽셀 매개변수에는 Dp 유형과 기본 유형만 사용됩니다. (I97a5a)
DropdownMenuItems에 onClick이 호출되지 않는 문제를 수정했습니다. (I3998b, b/157673259)
MutuallyExclusiveSetItem이 지원 중단되었습니다. 대신 Modifier.selectable을 사용하세요. (I02b47, b/157642842)
이제 TestTag는 지원 중단됩니다. 대신 Modifier.testTag를 사용하세요. (If5110, b/157173105)
TextField의 커서에 깜박이는 애니메이션이 있습니다. (Id10a7)
여러 컴포즈 클래스에서 Px 클래스가 더 이상 대규모 리팩터링 작업의 일부로 사용되지 않습니다. 픽셀 매개변수에는 Dp 유형과 기본 유형만 사용됩니다. (I19d02)
이제 VerticalScroller에서 즉시 Column을 제공합니다. 이제 HorizontalScroller에서 즉시 Row를 제공합니다. (Ieca5d, b/157020670)
여러 컴포즈 클래스에서 Px 클래스가 더 이상 대규모 리팩터링 작업의 일부로 사용되지 않습니다. 픽셀 매개변수에는 Dp 유형과 기본 유형만 사용됩니다. (Iede0b)
상위 수준 구성요소에 사용할 수 있도록 Modifier.semantics의 지원 중단이 해제되었습니다. (I4cfdc)
DrawLayer 수정자 API가 변경되었습니다. outlineShape 이름이 shape으로 바뀌었으며 기본값으로 RectangleShape을 사용하고 이제 null이면 안 됩니다. clipToOutline 이름은 clip으로 바뀌었으며, clipToBounds는 RectangleShape을 사용하면 clip == true와 동일하므로 삭제되었습니다. (I7ef11, b/155075735)
캔버스를 노출하여 CanvasScope를 대신 노출하는 상위 수준 Compose API를 업데이트했습니다. 따라서 소비자가 자체 Paint 객체를 유지하지 않아도 됩니다. 캔버스에 계속 액세스해야 하는 소비자의 경우 콜백을 제공하여 기본 캔버스에서 그리기 명령어를 실행하는 drawCanvas 확장 메서드를 사용하면 됩니다. (I80afd)
AlignmentLineOffset 컴포저블이 지원 중단되었습니다. relativePaddingFrom() 수정자를 대신 사용하세요. CenterAlignmentLine 컴포저블을 삭제했습니다. (I60107)
람다 API 후행 WithConstraints가 변경되었습니다. 이제 두 매개변수 대신 제약 조건 및 layoutDirection 외에도 Dp에서 minWidth, maxWidth, minHeight 및 maxHeight 속성을 제공하는 수신기 범위가 있습니다. (I91b9a, b/149979702)
상응하는 수신 제약 조건이 지정되지 않은 경우에만(최소 제약 조건은 0, 최대 제약 조건은 무한대) 크기 제약 조건을 래핑된 레이아웃으로 설정하는 defaultMinSizeConstraints 레이아웃 수정자를 추가했습니다. (I311ea, b/150460257)
FocusManagerAmbient가 삭제되었습니다. 포커스를 가져오려면 FocusModifier.requestFocus를 사용합니다. (Ic4826)
상태를 추적하지 않는 선언적 그리기 API 표면을 노출하기 위해 Canvas 객체를 래핑하는 CanvasScope API를 만들었습니다. 변환은 자체 수신기 범위 내에 포함되며 크기 정보도 상응하는 인셋 경계로 범위가 지정됩니다. 소비자가 그리기 작업을 구성하기 위해 자체 Paint 상태 객체를 유지할 필요는 없습니다.
선언적 그래픽 데모를 포함하기 위해 CanvasScopeSample을 추가하고 데모 앱을 업데이트했습니다. (Ifd86d)
커서 색상 맞춤설정이 TextField에 추가됩니다. (I6e33f)
이제 TextField와 함께 사용되는 TextFieldValue가
var text by savedInstanceState(saver = TextFieldValue.Saver) { TextFieldValue() }
와 같이 사용되면 활동 재생성에도 유지될 수 있습니다(I5c3ce, b/155075724).LayoutModifier2 이름을 LayoutModifier로 바꿨습니다. (Id29f3)
지원 중단된 LayoutModifier 인터페이스를 삭제했습니다. (I2a9d6)
포커스 하위 시스템과 통합하기 위해 CoreTextField/TextField focusIdentifier 매개변수를 FocusNode로 대체했습니다. (I7ea48)
이제 Layout 및 LayoutModifier2의 내장 기능 측정 함수에 IntrinsicMeasureScope 수신기가 있으며, 이는 내장 기능 쿼리 API에 암시적으로 전파된 레이아웃 방향을 제공합니다. (Id9945)
동일한 상위 요소 레이아웃 내에서 하위 요소의 그리기 순서를 제어하기 위해 새로운 Modifier.zIndex()가 추가되었습니다. DrawLayerModifier의 elevation 속성 이름은 shadowElevation으로 바뀌고 더 이상 그리기 순서를 제어하지 않습니다. DrawShadow의 매개변수 순서가 변경되었습니다. 첫 번째 매개변수는 elevation이고 두 번째 매개변수인 shape은 RectangleShape을 기본값으로 사용합니다. (I20150, b/152417501)
RectangleShape을 androidx.ui.foundation.shape.*에서 androidx.ui.graphics.*로 이동했습니다. (Ia74d5, b/154507984)
TextField API 업데이트: onFocus 및 onBlur 콜백이 매개변수가 있는 단일 onFocusChange(불리언) 콜백으로 병합되었습니다. (I66cd3)
Row와 Column에 각각 verticalGravity 및 horizontalGravity 매개변수를 추가했습니다. (I7dc5a)
임의의 Alignment가 아닌 세로 또는 가로 Alignment를 예상하도록 wrapContentWidth 및 wrapContentHeight를 업데이트했습니다. 중력 수정자가 세로 또는 가로 Alignment를 허용하도록 업데이트되었습니다. 맞춤 연속 Alignment를 지원하기 위해 Row, Column, Stack이 업데이트되었습니다. (Ib0728)
ImageAsset에서 픽셀 정보 쿼리를 지원하는 PixelMap API를 만들었습니다. (I69ad6)
ProvideContentColor를 삭제했습니다. 대신
Providers
와 함께 ContentColorAmbient를 사용하세요. (Iee942)ui-text-compose 모듈의 이름이 ui-text로 바뀌었습니다. 이제 ui-text에는 CoreText 및 CoreTextField 컴포저블이 포함됩니다. (Ib7d47)
ui-text 모듈 이름이 ui-text-core로 바뀌었습니다. (I57dec)
ui-framework/CoreText, CoreTextField 컴포저블이 ui-text-compose 아래로 이동했습니다. 프로젝트에 ui-text-compose를 포함하는 것이 좋습니다. (I32042)
다음과 같이 DrawModifier API를 개선합니다.
- draw()의 수신기 범위를 ContentDrawScope으로 설정했습니다.
- draw()의 모든 매개변수를 삭제했습니다.
- DrawScope는 이전 CanvasScope와 동일한 인터페이스를 사용합니다.
- ContentDrawScope에 drawContent() 메서드가 있습니다. (Ibaced, b/152919067)
이제
runOnIdleCompose
및runOnUiThread
는 ComposeTestRule의 메서드가 아닌 전역 함수입니다. (Icbe8f)[변경 가능] 주 속성 위임 연산자가 Kotlin 1.4 속성 위임 최적화를 지원하기 위해 확장 프로그램으로 이동했습니다.
by state { ... }
또는by mutableStateOf(...)
를 계속 사용하려면 호출자가 가져오기를 추가해야 합니다. (I5312c)LayoutCoordinates에 positionInParent 및 boundsInParent를 추가했습니다. (Icacdd, b/152735784)
ColoredRect가 지원 중단되었습니다. 대신 Box(Modifier.preferredSize(width, height).drawBackground(color))를 사용하세요. (I499fa, b/152753731)
LayoutResult 이름을 MeasureResult로 바꿨습니다. (Id8c68)
레이아웃 수정자를 정의하는 새 API인 LayoutModifier2를 추가했으며, LayoutModifier를 지원 중단했습니다. (If32ac)
수정자와 연산자를 팩토리 확장 함수로 대체했습니다.(I225e4)
Draggable을 수정자로 이동했습니다. (Id9b16, b/151959544)
ParentData 컴포저블이 지원 중단되었습니다. ParentDataModifier 인터페이스를 구현하는 수정자를 만들거나, 측정 블록 내에서 인식되도록 레이아웃 하위 요소에 태그만 지정하면 되는 경우에는 LayoutTag 수정자를 사용해야 합니다. (I51368, b/150953183)
Center 컴포저블을 지원 중단했습니다. LayoutSize.Fill + LayoutAlign.Center 수정자로 대체되거나 적절한 수정자가 적용된 Box 또는 Stack 컴포저블 중 하나로 대체됩니다. (Idf5e0)
기존의 벡터 그래픽용 하위 구성 API를 대체하는 VectorPainter API를 추가했습니다. 하위 구성의 결과는 DrawModifier가 아닌 VectorPainter 객체입니다. 이전의 DrawVector 컴포저블을 지원 중단하고 VectorPainter로 대체했습니다.
Image(Painter) API 이름을 PaintBox(Painter)로 바꿨습니다. Image 컴포저블과 같이 동작하는 Vector 컴포저블을 만들었습니다(ImageAsset 대신 VectorAsset을 사용하는 경우 제외). (I9af9a, b/149030271)
LayoutFlexible을 LayoutWeight로 이름을 변경했습니다. 채우기 위해 긴 매개변수의 이름을 변경했습니다. (If4738)
RepaintBoundary를 삭제하고 DrawLayerModifier로 대체했습니다. (I00aa4)
일반적인 구성 가능한 함수인 DrawVector를 레이아웃의 배경으로 벡터를 그리는 수정자인 drawVector()를 반환하는 기능으로 변경했습니다. (I7b8e0)
불투명도 구성 가능한 함수를 drawOpacity 수정자로 대체했습니다. (I5fb62)
구성 가능한 함수 Clip을 수정자 drawClip()으로 대체합니다. DrawClipToBounds는 사각형으로 레이어 경계에 맞춰 잘라내야 하는 경우에만 사용하는 편리한 수정자입니다. (If28eb)
DrawShadow 구성 가능한 함수를 drawShadow() 수정자로 대체했습니다. 이제 그림자가 LayerModifier의 일부로 그려집니다. (I0317a)
Layout의 RenderNode를 추가할 수 있는 수정자인 LayerModifier를 추가했습니다. 자르기, 불투명도, 회전, 크기 조정, 그림자를 설정할 수 있습니다. RepaintBoundary를 대체합니다. (I7100d, b/150774014)
androidx.compose.ViewComposer가 androidx.ui.node.UiComposer로 이동했습니다. androidx.compose.Emittable은 삭제되었습니다. 이 항목은 ComponentNode와 중복되었습니다. androidx.compose.ViewAdapters는 삭제되었습니다. 더 이상 지원되지 않는 사용 사례입니다. Compose.composeInto가 지원 중단되었습니다. 대신
setContent
또는setViewContent
를 사용하세요. Compose.disposeComposition이 지원 중단되었습니다. 대신setContent
에서 반환되는Composition
에서dispose
메서드를 사용하세요. androidx.compose.Compose.subcomposeInto는 androidx.ui.core.subcomposeInto로 이동했습니다. ComponentNode#emitInsertAt의 이름이 ComponentNode#insertAt으로 바뀌었습니다. ComponentNode#emitRemoveAt의 이름이 ComponentNode#removeAt으로 바뀌었습니다. ComponentNode#emitMode의 이름이 ComponentNode#move로 바뀌었습니다. (Idef00)지정된 ImageAsset을 화면에 그리는 것 외에 크기 조정/레이아웃도 처리하는 Image 컴포저블을 만들었습니다. 이 컴포저블은 또한 고유의 크기를 고려하면서도 주어진 고정 크기나 최소 크기를 지원하며 임의의 Painter 인스턴스 그리기를 지원합니다. (Ibcc8f)
Wrap 컴포저블을 지원 중단했습니다. LayoutAlign 수정자나 Stack 컴포저블로 대체할 수 있습니다. (Ib237f)
withConstraints에 LayoutDirection 매개변수가 있습니다.(I6d6f7)
레이아웃 방향을 상위 요소 레이아웃 노드에서 하위 요소로 전파되도록 만들었습니다. 레이아웃 방향 수정자를 추가했습니다. (I3d955)
스택 구성요소가 오른쪽에서 왼쪽 방향을 지원합니다. (Ic9e00)
DrawShape 컴포저블이 삭제되었습니다. 대신 DrawBackground 수정자를 사용하세요. (I7ceb2)
LayoutPadding 수정자의 오른쪽에서 왼쪽 방향을 지원합니다. (I9e8da)
표시되는 항목만 작성하고 배치하는 스크롤 목록 구성요소인 AdapterList를 추가했습니다. 현재 알려진 문제는 이 기능이 세로 모드에만 가능하고 하위 요소에서 발생하는 모든 변경 사례를 완전히 처리하지는 않는다는 점입니다. (Ib351b)
ComposeFlags.COMPOSER_PARAM
플래그를true
가 되도록 업데이트했습니다. 이는 Compose 플러그인의 코드 생성 전략을 변경합니다. 높은 수준에서 이는 @Composable 함수가 추가 합성 매개변수와 함께 생성되어 후속 @Composable 호출로 전달되도록 합니다. 이는 실행을 적절히 관리하기 위한 런타임을 확보하기 위함입니다. 그러나 이 기능은 중요한 바이너리 브레이킹 체인지이므로 승인된 모든 Compose 사용 시 소스 수준의 호환성을 유지해야 합니다. (I7971c)Canvas 구성요소를 추가했습니다. 크기(사용자가 제공함)를 일부 차지하는 이 컴포저블은 CanvasScope를 사용한 그리기를 허용합니다. (I0d622)
Density와 DensityScope를 하나의 인터페이스로 병합했습니다. 이제 ambientDensity() 대신 DensityAmbient.current를 사용할 수 있으며 withDensity(density) 대신 with(density)를 사용하면 됩니다. (I11cb1)
providedAlignmentLines를 Map이 아닌 Set으로 만들고 LayoutCoordinates에서 값을 검색하는 대신 get() 연산자를 구현하도록 LayoutCoordinates를 변경했습니다. 이에 따라 수정자별로 새 컬렉션을 만들지 않고도 수정자가 세트에서 하나 이상의 값을 더 쉽게 수정할 수 있습니다. (I0245a)
이제 스크롤러가 네이티브 Android 플링 모션 동작을 표시합니다. (I922af, b/147493715)
제약 조건의 API 노출 영역 개선 (I0fd15)