Wear Compose Material 3
최근 업데이트 | 안정화 버전 | 출시 후보 버전 | 베타 버전 | 알파 버전 |
---|---|---|---|---|
2025년 8월 27일 | 1.5.0 | - | - | - |
종속 항목 선언
Wear의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.
다음과 같이 앱 또는 모듈의 build.gradle
파일에 필요한 아티팩트의 종속 항목을 추가합니다.
Groovy
dependencies { implementation "androidx.wear.compose:compose-foundation:1.5.0" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material3:1.5.0" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.5.0" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0") // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material // or androidx.compose.material:material. // androidx.wear.compose:compose-material3 is designed as a replacement, // not an addition, to both of these other libraries. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material3, please raise a bug to let us know. }
Kotlin
dependencies { implementation("androidx.wear.compose:compose-foundation:1.5.0") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material3:1.5.0") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.5.0") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0") // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material // or androidx.compose.material:material. // androidx.wear.compose:compose-material3 is designed as a replacement, // not an addition, to both of these other libraries. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material3, please raise a bug to let us know. }
종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.
의견
제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.
자세한 내용은 Issue Tracker 문서를 참고하세요.
Wear Compose Material3 버전 1.5
버전 1.5.0
2025년 8월 27일
androidx.wear.compose:compose-*:1.5.0
이 출시되었습니다. 버전 1.5.0에는 이러한 커밋이 포함되어 있습니다.
1.4.0 이후 중요 변경사항
새로운 Material 3 Expressive 디자인 시스템을 지원하는 Wear Compose Material 3 라이브러리의 첫 번째 출시 이번 출시에는 다음이 포함됩니다.
MaterialTheme
및 동적 색상 테마를 업데이트했습니다.- 화면 구조를 배치하고
ScrollIndicator
,TimeText
,HorizontalPageIndicator
,VerticalPageIndicator
애니메이션을 조정하는 새로운AppScaffold, ScreenScaffold
,HorizontalPagerScaffold
,VerticalPagerScaffold
구성요소 IconButton
,TextButton
,IconToggleButton
,TextToggleButton
의 도형 변형으로, 누르거나 선택하면 애니메이션이 적용되는 변형이 있습니다.EdgeButton
: 화면 하단에 맞게 설계된 특수 모양이 있습니다.ButtonGroup
는 터치 시 모양이 변하는 행에 표현력이 풍부한 버튼 그룹을 구현합니다.- 추가 대화상자 콘텐츠를 위한 변형이 있는
AlertDialog
및ConfirmationDialog
TimePicker
및DatePicker
구성요소- 진행 상태 표시기에는
CircularProgressIndicator
(세그먼트 변형 포함),ArcProgressIndicator
,LinearProgressIndicator
이 있습니다.
또한 Wear Compose Foundation 1.5.0에는 다음이 포함되어 있습니다.
TransformingLazyColumn
: 확장 및 모핑 애니메이션을 지원하는 지연 로드되는 세로 스크롤 목록입니다.HorizontalPager
및VerticalPager
을 사용하여 Wear Compose Foundation에서 페이징 지원- 계층적 포커스 그룹 - 컴포지션의 활성 부분을 추적하고 포커스를 조정하기 위해 애플리케이션의 컴포저블에 주석을 다는 데 사용됩니다.
(Wear OS용 Material 3 Expressive)에 대해 자세히 알아보세요.
버전 1.5.0-rc02
2025년 8월 13일
androidx.wear.compose:compose-*:1.5.0-rc02
이 출시되었습니다. 버전 1.5.0-rc02에는 이러한 커밋이 포함되어 있습니다.
버그 수정
- 기간 (오전/오후)의 긴 국제화된 문자열로 인해 레이아웃이 깨질 수 있는
TimePicker
의 버그가 수정되었습니다. (I0fa81)
버전 1.5.0-rc01
2025년 7월 30일
androidx.wear.compose:compose-*:1.5.0-rc01
이 출시되었습니다. 버전 1.5.0-rc01에는 이 커밋이 포함되어 있습니다.
버그 수정
- 이제
TimePicker
은 사용자의 언어에 따라 완전히 작동하며DateFormat.getBestDateTimePattern
를 사용하여 선택기 및 구분 기호의 순서와 콘텐츠를 결정합니다. 이를 통해 CJK 언어의 잘못된 열 순서가 수정되고, 아랍어와 같은 언어의 RTL 레이아웃 문제가 해결되며, 현지화된 구분자가 사용되고, 로케일에 따라 0~11 및 1~12 시간 형식이 모두 지원됩니다 (I5d543). - 이제
DatePicker
는 숫자와 언어 형식이 혼합되는 것을 방지하기 위해 일부 언어(예: CJK)에서 숫자 월을 표시합니다(예: 2025 | 07 | 02 대신 2025 | 7月 | 02) 이 변경사항은 언어별로 연도에 언어적 접미사를 사용하는지 확인하는 휴리스틱을 적용하고, 사용하는 경우 일관성을 위해 월 형식을 텍스트 (MMM)에서 숫자 (MM)로 전환합니다. (Ia93fe) - 이제 선택기 구성요소의 제목에 대한 세로 공간이 일정해져 선택기 열이 선택될 때, 특히
Talkback
모드에서 시각적 이동이 방지됩니다. (I7f8b7) HorizontalPageIndicator
및VerticalPageIndicator
이 전체 화면으로 그려져 발생하는 접근성 버그가 수정되었습니다. 페이지 표시기가 더 이상 전체 화면이 아니며HorizontalPagerScaffold
또는VerticalPagerScaffold
와 함께 사용하면 자동으로 배치됩니다. 페이지로 나누기 스캐폴드를 사용하지 않는 경우HorizontalPageIndicator
이 있는modifier = Modifier.align(Alignment.BottomCenter)
와VerticalPageIndicator
이 있는modifier =Modifier.align(Alignment.CenterEnd)
를 사용하여 정렬을 명시적으로 지정합니다. (I3a0ad)- 이제
SwipeToReveal
의 스와이프 방향이 LTR 및 RTLLayoutDirections
모두에서 일관됩니다. (I6d427) - 작업의
SwipeToReveal
세로 가운데 정렬이 복원되었습니다.hasPartiallyRevealedState = true
인 경우 스크롤이 발생할 때 호출자가RevealState
을RevealValue.Covered
로 재설정해야 합니다. (I6473d) - 이제
SwipeDismissableNavHost
가 API 36부터 콘텐츠를 올바르게 클립합니다. (Ib9a44)
버전 1.5.0-beta06
2025년 7월 16일
androidx.wear.compose:compose-*:1.5.0-beta06
이 출시되었습니다. 버전 1.5.0-beta06에는 이러한 커밋이 포함되어 있습니다.
버그 수정
LazyColumn
또는ScalingLazyColumn
에reverseLayout = true
이 있는 경우EdgeButton
애니메이션 수정 (I46a1a)ScrollIndicator/PageIndicator
이 제공된 경우 터치하여 탐색이 Talkback에서 작동하지 않는ScreenScaffold
의 버그가 수정되었습니다. (I6dcee)- 이제
TransformingLazyColumn
를 사용하면 백그라운드 페인터에서TransformationSpec
가 제공하는itemHeight
값을 읽어TransformationSpec
에서 맞춤 변형이 가능합니다. (I6a599) IconToggleButton
와 일관성을 유지하기 위해IconButton
의 애니메이션 사용 설정/사용 중지 색상 전환 (Ife10a)- 애니메이션 적용 시 최소 점 크기로 눈에 띄게 점프하는 것을 방지하기 위해
CircularProgressIndicator
에서 최소 섹션 클램핑을 삭제했습니다. 이 변경사항에 따라drawCircularProgressIndicator
의targetProgress
매개변수가 이제 사용되지 않습니다. (I33309) - 이제 선택기에는 스크린 리더가 선택기의 접근성을 높이는 데 사용할 수 있는 시맨틱 역할
ValuePicker
이 있습니다. 또한 선택 도구에는 읽기 전용 모드에서 값을 조정하는 것과 그렇지 않은 경우 현재 값을 선택하는 것을 구분하는 업데이트된 접근성 클릭 라벨이 있습니다. (I33309)
버전 1.5.0-beta05
2025년 7월 2일
androidx.wear.compose:compose-*:1.5.0-beta05
이 출시되었습니다. 버전 1.5.0-beta05에는 이러한 커밋이 포함되어 있습니다.
버그 수정
Modifier.edgeSwipeToDismiss
사용을 명확히 하기 위해 문서를 업데이트했습니다. (I78cb5)- 지연 목록에서
SwipeToReveal
를 사용하여 여러 공개 항목이 표시될 수 있는 버그를 해결했습니다 (I1d4f6). - 이제
TransformingLazyColumn
의 컨테이너 모양이 콘텐츠가 잘리지 않도록 조정됩니다. (I9221a) - 시간/분/초 또는 년/월/일의
TimePicker
및DatePicker
라벨에 이제 스크린 리더용 헤딩 시맨틱스가 있습니다 (I77d8b). - 불확정
CircularProgressIndicator
(Iaf0bb)에서 루프 간 일시중지를 삭제했습니다. - 항목이 삭제될 때
TransformingLazyColumn
에서 발생하는 애니메이션 버그가 수정되었습니다. (I73034) - 항목이 삭제될 때
TransformingLazyColumn
에서 앵커 항목의 처리가 수정되었습니다. (I841a8) - 이제 자동 가운데 정렬이 사용 설정되고 선택된 (가운데 정렬된) 선택 도구가 변경되면
PickerGroup
가 선택 도구를 가로로 애니메이션 처리합니다. (Ic82c4)
버전 1.5.0-beta04
2025년 6월 18일
androidx.wear.compose:compose-*:1.5.0-beta04
이 출시되었습니다. 버전 1.5.0-beta04에는 이러한 커밋이 포함되어 있습니다.
버그 수정
- 화면에 맞는 콘텐츠가 이제 화면 상단에서 올바르게 정렬되는
TransformingLazyColumn
의 레이아웃 버그 수정 (I80115) EdgeButton
이 있는 목록의 맨 아래로 스크롤할 때 하단 항목의 크기가 잘못 조정되는TransformingLazyColumn
문제가 수정되었습니다. 이제 레이아웃을 복원할 때 스크롤 진행률이 경사하강법을 따릅니다. (Iea375)- 이제
TransformingLazyColumn
이 배경 페인터 내에서 항목 높이를 읽어 맞춤TransformationSpecs
이 모핑을 구현할 수 있습니다. (I022f0) - 이제
SwipeToReveal
이 표시된 작업을 올바르게 세로로 가운데에 배치합니다. (I4419b) - 화면에서 뷰와 Compose가 모두 사용되는 경우
SwipeToReveal
가 스와이프하여 닫기와 함께 올바르게 작동하지 않는 버그가 수정되었습니다. (I5dc0e) - 스크롤할 때
SwipeToReveal
작업이 세로 오프셋으로 그려지는 버그를 수정했습니다. (I29444) - 이제
AlertDialog
,ConfirmationDialog
,OpenOnPhoneDialog
,SwipeToReveal
에서 화면 크기의 백분율로 계산되는 패딩과 크기를 올림합니다. (I76367) - 이제
ButtonDefaults.outlinedButtonBorder
가 사용 설정/사용 중지 상태 변경에 따라 크기를 업데이트합니다(If2ddd). - 페이저와
ScreenScaffold
이 있는 복잡한 화면에서 발생하는EdgeButton
높이의 버그가 수정되었습니다. (I946e3) - 자리표시자 애니메이션이 중지될 수 있는 경합 상태가 수정되었습니다. (I53530)
- 캔버스에 그려
HorizontalPageIndicator
및VerticalPageIndicator
성능을 개선했습니다. (Ifae1e) - 윤곽선을 구성하는 점과 원 사이의 전환을 부드럽게 하기 위해 EdgeButton의 모양을 개선했습니다. (I7721e)
- 불필요한 재구성으로 인해 애니메이션이 중지되는
LevelIndicator
의 버그가 수정되었습니다. (I45d08)
버전 1.5.0-beta03
2025년 6월 4일
androidx.wear.compose:compose-*:1.5.0-beta03
이 출시되었습니다. 버전 1.5.0-beta03에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
OpenOnPhoneDialog
은 이제 TalkBack에서 메시지 텍스트만 공지하고 아이콘 시맨틱은 건너뜁니다.icon()
에서iconContentDescription
및contentDescription
매개변수를 삭제하도록OpenOnPhoneDialogDefaults
이 업데이트되었습니다. 또한 이제ConfirmationDialogDefaults
에SuccessIcon
및FailureIcon
컴포저블의 수정자 매개변수가 있습니다. (Id2ae2)
버그 수정
SurfaceTransformation
매개변수의 효과를 적용하는 순서가 변경되었습니다. 이전에는 Wear Material3 구성요소에 적용된 변환이 배경 페인터, 컨테이너 변환, 콘텐츠 변환 순으로 실행되었습니다. 이제 처음 두 개가 반전되고 그 사이에 전달된 수정자가 적용되므로 컨테이너 변환의 영향을 받습니다. 이렇게 하면 변환 매개변수를 사용하여 TLC의 요소와 함께 자리표시자 시머 효과를 사용하는 것과 같은 사례가 수정됩니다. (I786cf)- 활동 또는 프로세스가 다시 생성될 때
SwipeToReveal
의 상태를 복원하는 데 사용되는RevealState.Saver
가 추가되었습니다. 이제rememberRevealState
함수가 기본적으로 이 Saver를 사용합니다. (Ie0ecb) SwipeToReveal
기본 및 보조 작업 버튼은ButtonDefault.Height
으로 기본 설정되어야 합니다 (이러한 버튼이 더 큰 버튼의 최대 높이를 채우는 버그 수정). (Ibfba1)- 오른쪽으로 스와이프 동작이 실행될 때 마지막으로 상호작용한 구성요소를 재설정하도록
SwipeToReveal
을 변경했습니다. (Ia8450) SwipeToReveal
는 스와이프의 끝 위치가 표시 앵커와 표시된 앵커 사이에 있고 표시 앵커에 더 가까운 경우Revealing
상태로 변경되었습니다. (If4458)- 이제 RTL 레이아웃에서
ButtonGroup
의 콘텐츠가 올바르게 반전됩니다 (Ib378d). - 이제
AnimatedText
에서 RTL 텍스트 방향을 지원합니다. (I4533c) - 이제 하단 항목이 삭제되면
TransformingLazyColumn
에서 항목의 크기를 올바르게 조절합니다 (Idacab). TransformingLazyColumn
는 이제 측정 패스를 한 번만 실행하므로 프레임 시간을 줄여 성능이 향상됩니다. (I501a1)
버전 1.5.0-beta02
2025년 5월 20일
androidx.wear.compose:compose-*:1.5.0-beta02
이 출시되었습니다. 버전 1.5.0-beta02에는 이 커밋이 포함되어 있습니다.
버그 수정
- 기반, Material, Material3 라이브러리의 기준 프로필이 업데이트되었습니다. (I53f06)
- 하단 항목이 삭제될 때 항목의 크기가 조정되는
TransformingLazyColumn
의 버그가 수정되었습니다. (Idacab) - 목록이 목록의 상단 또는 하단에 멈추는 경우
TransformingLazyColumn
관련 버그를 수정했습니다. (I49d00) - TalkBack의
OpenOnPhoneDialog
는 아이콘 콘텐츠 설명이 아닌 곡선 텍스트를 공지해야 합니다. (I4efe8) hasPartiallyRevealedState
이 false로 설정된 경우RevealState.currentValue
에서 잘못된 앵커를 보고하는SwipeToReveal
의 버그가 수정되었습니다. (I9c7cf)- 이제
SwipeToReveal
실행취소 버튼이 기본적으로ButtonDefaults.Height
입니다. (I1f6c8) - 스크림을 그리는 데 Canvas를 사용하지 않아
BasicSwipeToDismissBox
성능이 개선되었습니다. (I68f2c) - 업데이트 후 공지된 비율이 값과 일치하지 않는 슬라이더의 접근성 버그를 수정했습니다 (I91146).
placeholderShimmer
구현의 버그가 수정되었습니다. (Iee39bScrollProgress
계산을 30% 최적화하여TransformingLazyColumn
성능이 개선되었습니다. (I4c4cb)
버전 1.5.0-beta01
2025년 5월 7일
androidx.wear.compose:compose-*:1.5.0-beta01
이 출시되었습니다. 버전 1.5.0-beta01에는 이러한 커밋이 포함되어 있습니다.
Wear OS용 Compose 1.5.0-beta01 버전은 이 라이브러리 버전의 기능이 완전하고 API가 잠겨 있음을 나타냅니다 (실험용으로 표시된 경우 제외).
Wear Compose 1.5.0-beta01에는 Material 3 Expressive라는 새로운 UI 디자인 시스템을 지원하는 Wear Compose Material3 라이브러리가 포함되어 있습니다. 앱에서 새로운 시각적 디자인을 채택하고 다음과 같은 새로운 구성요소를 활용하려면 Material에서 Material3로 업그레이드하는 것이 좋습니다.
MaterialTheme
를 사용하여 업데이트되고 확장된 색 구성표, 서체, 도형을 통해 디자인에 깊이와 다양성을 더하세요.- 시계 화면 색상과 일치하도록 앱의 색 구성표를 자동으로 생성하는 동적 색상 테마
- 새 구성요소는 기본적으로 더 큰 화면 크기에 자동으로 적응합니다.
- 도형 변형 -
IconButton
,TextButton
,IconToggleButton
,TextToggleButton
과 같은 원형 버튼 구성요소는 누르거나 선택할 때 애니메이션이 적용되는 변형을 지원합니다. EdgeButton
- 화면 하단에 맞게 설계된 특별한 모양의 새로운 가장자리 밀착형 버튼입니다.- 스캐폴드 - 화면 구조를 배치하고
ScrollIndicator
및TimeText
애니메이션을 조정하기 위해AppScaffold
및ScreenScaffold
도입 - 버튼: 아이콘과 라벨이 있는 버튼을 위한 유연한 단일 슬롯 컨테이너와 멀티 슬롯 변형을 통해 다양한 경기장 모양 버튼이 지원됩니다.
CheckboxButton
및SwitchButton
은 전환 버튼이 필요한 경우 제공되며RadioButton
은 사용 가능한 선택 버튼입니다(전환 버튼과 선택 버튼의 '분할' 변형도 제공됨). ButtonGroup
- 터치 시 모양이 변하는 표현력 있는 버튼 그룹을 한 줄로 구현합니다.AlertDialog
변형은 확인/취소 버튼 또는EdgeButton
을 지원합니다.ConfirmationDialog
는 제한 시간이 있는 메시지를 표시하는 데 사용할 수 있으며, 성공, 실패, 휴대전화에서 열기 변형을 위한 특수 애니메이션을 지원합니다.- 선택기 -
TimePicker
및DatePicker
변형이 지원되며, 자체 선택기 화면을 빌드하기 위한 선택기 및PickerGroup
구성요소도 지원됩니다. ProgressIndicators
- 원형 및 선형 진행률 표시기가 지원됩니다 (CircularProgressIndicator
에는 세그먼트 및 불확정 변형이 있음).- 카드 - 제목, 시간, 부제목 또는 콘텐츠 슬롯이 있는 카드를 위한 특정 레이아웃을 제공하는
TitleCard
를 비롯한 다양한 카드 변형을 사용할 수 있습니다.TitleCard
에 이미지 배경을 지정하여 카드에 표시된 정보의 의미를 강화할 수도 있습니다. - 페이지 표시기 -
HorizontalPagerScaffold
,VerticalPagerScaffold
,AnimatedPage
구성요소는HorizontalPageIndicator
및VerticalPagerIndicator
애니메이션을 조정합니다.HorizontalPager
및VerticalPager
이 Wear Compose Foundation 라이브러리에서 출시되었습니다. - 자리표시자 - 임시 콘텐츠를 사용할 수 없는 상황에서 구성요소 위에 스켈레톤 모양을 그립니다.
- 슬라이더와 스테퍼: 슬라이더와 스테퍼 모두 사용자가 값 범위에서 선택할 수 있습니다. 슬라이더는 더 콤팩트하고 세그먼트화할 수 있는 반면, 스텝퍼는 일반적으로
StepperLevelIndicator
와 페어링되는 전체 화면 구성요소입니다. SwipeToReveal
- 오른쪽에서 왼쪽으로 스와이프할 때 컴포저블에 추가 작업을 추가하는 데 사용됩니다.
또한 Wear Compose Foundation 1.5.0-beta01에는 다음과 같은 새로운 구성요소가 포함되어 있습니다.
TransformingLazyColumn
- 확장 및 모핑 애니메이션을 지원하는 지연 로드되는 세로 스크롤 목록- 계층적 포커스 그룹 - 컴포지션의 활성 부분을 추적하고 포커스를 조정하기 위해 애플리케이션의 컴포저블에 주석을 다는 데 사용됩니다.
- 페이저 - 성능을 개선하고 Wear OS 가이드라인을 준수하기 위해 Wear 관련 개선사항이 적용된 Compose Foundation 구성요소를 기반으로 빌드된
HorizontalPager
및VerticalPager
구성요소입니다.
API 변경사항
- 계층적 포커스 API 업데이트:
Modifier.hierarchicalFocus
를Modifier.hierarchicalFocusGroup
로 이름을 바꾸고 콜백 매개변수를 삭제했습니다.FocusRequester
매개변수를 사용하여Modifier.hierarchicalFocusRequester
의 오버로드를 삭제했습니다. 구성요소가 활성 화면을 알리고 확인할 수 있도록 새CompositionLocal
,LocalScreenIsActive
를 만들었습니다. (I5ff7c) - Wear Compose Material 및 Wear Compose Material3의
SwipeToReveal
API를 위해 Wear Compose Foundation의SwipeToReveal
를 지원 중단했습니다. API를 계속 사용하려면 Wear FoundationSwipeToReveal
가져오기를 Wear Compose Material/ Wear Compose Material3 가져오기로 대체하세요. (Ia147d) - Wear Compose Material3
SwipeToReveal
종속 항목이 Foundation에서 material3 패키지로 이동했습니다(예:RevealValue
,RevealDirection
,RevealActionType
,RevealState
,rememberRevealState
). 개발자는 이러한 클래스와 함수의 가져오기를androidx.wear.compose.foundation
에서androidx.wear.compose.material3
로 변경해야 합니다. (I640e6) - Wear Compose Material3
SwipeToReveal
API가 다음과 같이 업데이트되었습니다.SwipeToReveal
컴포저블에primaryAction
,onFullSwipe
,secondaryAction
,undoPrimaryAction
,undoSecondaryAction
,hasPartiallyRevealedState
매개변수가 추가되었고,RevealState
에서positionalThreshold
및animationSpec
를 맞춤설정하는 기능이 삭제되었으며,RevealState
에서lastActionType
,revealThreshold
, 너비가 삭제되었고,RevealState
생성자가 앵커 대신RevealDirection
를 허용하도록 변경되었으며,createRevealAnchors
, 앵커,bidirectionalAnchors
함수가 삭제되었고,SwipeToRevealScope
함수primaryAction
,secondaryAction
,undoPrimaryAction
,undoSecondaryAction
의 이름이PrimaryActionButton
,SecondaryActionButton
,UndoActionButton
로 변경되고 컴포저블 함수로 설정되었으며,RevealActionType
가 내부로 표시되었습니다. (I885d0) - 다음과 같이
SwipeToReveal
API가 추가로 업데이트되었습니다.onFullSwipe
이onSwipePrimaryAction
로 이름이 변경되었고,hasPartiallyRevealedState
매개변수 사용을 나타내기 위해SwipeToRevealNonAnchoredSample
의 이름이 변경되었으며, 기본값이 버튼의 기본 높이이고 수정자를 사용하여 더 큰 높이를 설정할 수 있으므로actionButtonHeight
가 삭제되었고,SwipeToRevealDefaults
에서SmallActionButtonHeight
가 삭제되었으며,RevealValue
및RevealDirection
생성자의 값 매개변수가 비공개로 설정되었습니다. (I465ce)
버그 수정
TransformingLazyColumn
항목이 삭제된 후EdgeButton
이 제자리로 애니메이션 처리되도록ScreenScaffold
의EdgeButton
처리를 수정했습니다. (I6d366)- Compose 라이브러리의 Wear Compose 종속 항목을 버전 1.8.0으로 업데이트했습니다. (I2ef3f)
- 일시적으로 회귀하지 않도록 불확정
CircularProgressIndicator
의 동작을 업데이트했습니다. (Ieddb1) SwipeDismissableNavHost
버그를 수정했습니다. 뒤로 스와이프한 후 포커스가 올바르게 전환되지 않아 회전식 입력이 실패했습니다 (예측 뒤로를 사용하는 API 36 이상). (Ieddb1)- 계층적 포커스 API 문서 수정 (Idf2ff)
containerPainter
및disabledContainerPainter
이containerColor
및disabledContainerColor
을 재정의하는 방법을 설명하도록 버튼 및 카드 관련 문서가 업데이트되었습니다 (I4a453).- 탐색 중에 자체 스레딩을 관리하는 앱에 문제를 일으켰기 때문에 이전 출시에서
BroadcastReceiver
를 작업자 스레드로 이동하는TimeText
변경사항이 되돌려졌습니다. (I34d02) - 불필요한 remember 호출을 삭제하고 대신 Picker에서
rememberUpdatedState
를 사용하여 최신contentDescription
람다 함수를 기억하도록 선택기 샘플을 업데이트했습니다. (Icb5b1) - 글꼴 변경으로 인해 더 이상 잘리지 않도록
TimePicker
및DatePicker
의 텍스트 스타일을 업데이트했습니다. (I26194) - 이제
ListHeader
및ListSubHeader
의 기본 텍스트 정렬이 각각 가운데 정렬 및 시작 정렬로 설정됩니다. (I78339) - 맞춤 접근성 작업을 알리도록 Foundation 및 Material 스와이프하여 표시 샘플과 데모를 업데이트했습니다. 맞춤 작업은
SwipeToReveal
컴포저블 자체가 아닌 콘텐츠에 시맨틱으로 추가해야 합니다. (Ie92a3) - 크기에 따라
EdgeButton
콘텐츠에 설정된 기본MaxLines
가 업데이트되었습니다. 이제 초소형은 1, 소형 및 중형은 2, 대형은 3입니다. (Ie35f6) - 성능을 개선하기 위해 관찰자가 한 번만 등록되도록
LocalReduceMotion
를 간소화했습니다. (Ib1979) - 성능 향상을 위해
ScrollIndicator
에서 다시 그리기 수를 최소화했습니다. (Ia7a67) - EdgeButton이 전체 높이에 도달했을 때 목록의 상단에 표시되는 항목이 올바르게 확장되지 않는
TransformingLazyColumn
의 버그를 수정했습니다. (I30580)
Wear Compose Material3 버전 1.0
버전 1.0.0-alpha37
2025년 4월 23일
androidx.wear.compose:compose-material3:1.0.0-alpha37
이 출시되었습니다. 버전 1.0.0-alpha37에는 이 커밋이 포함되어 있습니다.
API 변경사항
- 공개 API 노출 영역에서
scrollTransform
가 삭제되었습니다. 동일한 기능을 가져와야 하는 경우transformedHeight
및graphicsLayer
수정자를 함께 사용하세요. (Ie181d) ImageButton
및ImageCard
컴포저블을 각각Button
및Card/TitleCard
오버로드로 대체했습니다.imageButtonColors
의 이름이buttonWithContainerPainterColors
으로,imageCardColors
의 이름이cardWithContainerPainterColors
으로 변경되었습니다. 공개ButtonDefaults.scrimBrush
및CardDefaults.scrimBrush
추가 버튼imageBackgroundGradientStartColor
및imageBackgroundGradientEndColor
의 이름이scrimGradientStartColor
및scrimGradientEndColor
로 변경되었습니다.CardDefaults.ImageContentPadding
에서CardDefaults.CardWithContainerPainterContentPadding
으로 이름이 변경되었습니다. (I7b8b6)- 이제
Picker
및PickerGroup
는 불필요한 리컴포지션을 방지하기 위해contentDescription
를 람다로 사용합니다. (I002dd)
버그 수정
- 너비가 높이와 같지 않은 경우 애니메이션 중에 불확정
CircularProgressIndicator
이 흔들리는 문제가 수정되었습니다. (I76bfe) - 잘못된 크기에서 가장자리 버튼 레이아웃 문제가 수정되었습니다. 이제 높이가 NaN인 경우 가장자리 버튼의 레이아웃이 업데이트되지 않습니다. (I32b93)
- 기본 '휴대전화 확인' 텍스트가 가장 큰 글꼴 크기로 잘리지 않도록
OpenOnPhoneDialog
의 최대 스윕 각도를 늘렸습니다. (I90af9)
버전 1.0.0-alpha36
2025년 4월 9일
androidx.wear.compose:compose-material3:1.0.0-alpha36
이 출시되었습니다. 버전 1.0.0-alpha36에는 이 커밋이 포함되어 있습니다.
API 변경사항
ButtonDefaults.imageBackgroundButtonColors
을ImageButton
,ButtonDefaults.imageButtonColors
,ButtonDefaults.containerPainter
,ButtonDefaults.disabledContainerPainter
로 바꿨습니다. 카드에도 비슷한 변경사항이 적용됩니다. 화가가ButtonColors
및CardColors
에서 삭제됩니다. (I8c6a1)- API를 간소화하도록 자리표시자를 업데이트했습니다. 이제 구성요소 수준에서 반짝임 효과를 적용하는
Modifier.placeholderShimmer
와 로드되지 않은 콘텐츠 (Iaee7a) 위에 마스크를 적용하는Modifier.placeholder
의 두 가지 수정자가 제공됩니다.
버그 수정
- 오버스크롤을
ScrollIndicator
에 통합 (Icfb7f) - material3 대화상자를 실행할 때 빈 배경과 누락된 대화상자 문제 해결 (Ice597)
- 텍스트가 여러 줄에 걸쳐 있을 때
FadingExpandingLabel
의 문제가 수정되었습니다. (I04eb7) - 버튼의 기본 라벨과 보조 라벨 사이의 패딩이 업데이트되었습니다. (I99b7b)
ArcLarge
이(가)20sp
에서18sp
로 감소했으며ArcLarge
및ArcSmall
의 글자 간격이 업데이트되었습니다. 이제ConfirmationDialog
/OpenOnPhoneDialog
가18sp
으로 재정의하는 대신 기본ArcLarge
를 사용합니다. (Id39a8)
종속 항목 업데이트
- 이제 이 라이브러리는 Kotlin 2.0 언어 수준을 타겟팅하며 KGP 2.0.0 이상이 필요합니다. (Idb6b5)
버전 1.0.0-alpha35
2025년 3월 26일
androidx.wear.compose:compose-material3:1.0.0-alpha35
이 출시되었습니다. 버전 1.0.0-alpha35에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
AlertDialog
상단 패딩이 이제 아이콘이 제공될 때 기본적으로 감소합니다. 이렇게 하면 사용 가능한 화면 크기를 최대한 활용할 수 있습니다. (Ief06c)PagerScaffoldDefaults.FadeOutAnimation
에서PagerScaffoldDefaults.FadeOutAnimationSpec
로 이름을 바꿨습니다.AnimatedPage
의 페이지 매개변수 이름이pageIndex
로 변경되었습니다. (I701f2)TransformingLazyColumn
의SurfaceTransformation
~applyTransformation
분할을applyContainerTransformation
및applyContentTransformation
로 업데이트하고createBackgroundPainter
의 이름을createContainerPainter
로 변경했습니다.TransformationSpec
및ResponsiveTransformationSpec
의 이름 업데이트 추가 (I1c534)AppScaffold backgroundColor
의 이름이containerColor
로 변경되었습니다. (I4e63f)
버그 수정
- 텍스트가 항상 올바르게 확장되지 않는
FadingExpandingLabel
의 문제가 해결되었습니다. (I0e773) ArcLarge
이 20sp에서 18sp로 감소하고ArcLarge
및ArcSmall
의 글자 간격이 업데이트되었습니다. 이제ConfirmationDialog/OpenOnPhoneDialog
가 18sp로 재정의하는 대신 기본ArcLarge
을 사용합니다. (Id39a8)- 페이드 아웃 및 페이드 인 애니메이션이 하나의 스프링 애니메이션으로 작동하도록
DatePicker
및TimePicker
기반의 제목 애니메이션을 업데이트했습니다. (I68963) AnimatedPage
컴포저블에서currentPageOffsetFraction
읽기를 방지하여PagerScaffold
를 최적화했습니다. (I433ef)- 모든 서체 스케일은 기본적으로 비례 숫자를 갖도록 업데이트되었습니다. 이는 가장 빈번한 사용 사례로 간주되며 표 형식으로 기본 설정하면 특정 숫자 쌍 사이에 너무 많은 간격이 생기기 때문입니다.
TimePicker
및DatePicker
은 표 형식 숫자에는FontFeatureSetting=tnum
를 계속 적용합니다. (I88929) TimePicker
및DatePicker
의 초기 RSB 입력 포커스가 수정되었습니다. (I1c773)OpenOnPhoneDialog
의 기본 텍스트를 '휴대전화 확인'으로 업데이트했습니다. (I00a3f)- 가중치 600이 굵게 처리되는 문제를 해결하기 위해
ArcLarge
및ArcMedium
의 가중치를 600에서 599로 업데이트했습니다 (I2a51d). - 콘텐츠와 작업 버튼 사이의
SwipeToReveal
패딩과 작업 버튼의 아이콘과 텍스트 사이의 패딩을 업데이트합니다. (Ic46cb)
버전 1.0.0-alpha34
2025년 3월 12일
androidx.wear.compose:compose-material3:1.0.0-alpha34
이 출시되었습니다. 버전 1.0.0-alpha34에는 이 커밋이 포함되어 있습니다.
API 변경사항
PagerScaffold
는 더 이상Pager
구성요소를 내보내지 않습니다. 대신content
컴포저블을 통해 제공해야 합니다. 이제AnimatedPage
및snapWithSpringFlingBehaviour
이 공개되어 Wear FoundationPager
와 함께 사용하여 이전 M3PagerScaffold
동작을 달성할 수 있습니다. (업데이트된 샘플 참고) (Ia4724)PagerState
가 업데이트되어 Compose FoundationPagerState
가 기본 클래스로 삭제되고currentPage
,currentPageOffsetFraction
,pageCount
속성이 추가되었습니다.GestureInclusion
인터페이스를 업데이트하여 메서드 이름을ignoreGestureStart
로 변경했습니다. (I4ae07)LevelIndicator
스위프 각도 매개변수가 이제FloatRange(0, 360)
로 주석 처리됨 (I7e636)- 곡선 시맨틱을 사용 중지할 수 있는 수단을 제공하기 위해
CurvedModifier.clearAndSetSemantics
가 추가되었습니다.CurvedText
은 계속해서 콘텐츠 설명을 텍스트로 기본 설정하지만timeTextCurvedText
및timeTextSeparator
은 이제 콘텐츠를 알리지 않습니다. (I4b568) AppScaffold
에 배경 및 기본 콘텐츠 색상 매개변수를 추가했습니다. (I56652)HorizontalPager
의 스와이프 동작 기본 처리가PagerDefaults.gestureInclusion
로 이름이 변경되었습니다. 이제 기본 동작은 첫 번째 페이지의 왼쪽 가장자리에서 시작되는 스와이프 동작만 무시하며, Talkback이 사용 중지된 경우에만 무시합니다. 다른 경우에는 스와이프 동작이 페이지로에서 무시되지 않으므로 스와이프하여 닫기 핸들러에서 사용할 수 없습니다. (Iee486)TransformingLazyColumn
과 같이 위치에 따라 항목 모양을 변경하는 컨테이너에서 사용할 때 다양한 배경 및 콘텐츠 변환을 적용할 수 있도록 버튼, 카드, 목록 헤더 구성요소에SurfaceTransformation
매개변수를 추가했습니다. (Iabe3f)- 값이 인라인 처리되지 않도록 Wear Compose Material3 API의 'public const val' 속성을 'public val'로 업데이트했습니다. (Ib0f32)
SwipeToReveal
에 가장자리 스와이프 영역 지원을 추가했습니다. 이제 FoundationSwipeToReveal
의 기본 동작은 동작이 가장자리에서 시작될 때 스와이프를 허용하지 않는 것입니다. 이제 Material3SwipeToReveal’
의 기본 동작은SwipeDirection
이 단일 방향으로 설정된 경우 동작이 가장자리에서 시작될 때 스와이프를 허용하지 않는 것입니다. (I32ef0)- 애니메이션을 사용하여 텍스트를 한 줄씩 페이드 인할 수 있는
FadingExpandingLabel
컴포저블을 추가했습니다. (Ic60fa) - 이제
TransformingLazyColumn
은(는) 첫 번째 항목과 마지막 항목을 중앙에 배치하는 대신 기본적으로 빈contentPadding
을(를) 사용합니다. (I77ab7) - Wear Compose Material3 라이브러리에서
SwipeToReveal
의rememberRevealState
가 삭제되었습니다. (I8c0e0)
버그 수정
- Wear Compose 라이브러리가 Kotlin 2.0 컴파일러로 업데이트되었습니다. (I2de79)
- Material3에서 원형이 아닌
ScrollIndicator
및PageIndicator
지원이 삭제되었습니다. 또한 정사각형 화면 지원은 더 이상 Wear OS 요구사항에 포함되지 않습니다. 자세한 내용은 시작 가이드를 참고하세요. (I9a852) ConfirmationDialogDefaults
및OpenOnPhoneDialogDefaults
에 사용된CurvedTextStyle
가 크기18sp
및 문자 간격1.8sp
이 있는ArcLarge
서체를 사용하도록 업데이트되었습니다. (Ic9ced)Card
,ListHeader
,RadioButton
,CheckboxButton
,SwitchButton
은 더 이상 기본적으로 콘텐츠의 높이를 제한하지 않습니다. 필요한 경우Modifier.height(IntrinsicSize.Min)
를 사용하여 이전 동작을 복원합니다. (I80bb8)OnBackground
(흰색)를 직접 사용하면 제목과 같은 화면의 다른 콘텐츠와 경쟁할 때 시각적 가중치가 너무 커지기 때문에 기본TimeText
및ScrollIndicator
색상을 더 많은 회색조를 포함하도록 업데이트했습니다. (I8b36f)- 스캐폴드 구성요소에서
TimeText
및ScrollIndicator
애니메이션의 타임아웃을 2초로 줄였습니다. (I52021) - 대화상자의 배경 크기가 스와이프하여 닫기와 동기화되도록 대화상자의 동작을 업데이트했습니다. (I925a9)
edgeSwipeToDismiss
수정자를 사용하여 M3SwipeToReveal
데모 추가 (I02b07)- 사용자가 날짜/시간을 설정하기 위해 스크롤해야 한다는 것을 알 수 있도록 TalkBack의
DatePicker
및TimePicker
에 제목을 추가했습니다. (Id738d) - 이제
AnimatedText
가 동작 줄이기 설정을 따릅니다. (Ib6578) - 대화상자 콘텐츠를 표시하는 데
AppScaffold
를 사용하도록 최적화되어 여러 대화상자가 서로 위에 표시될 수 있습니다 (I1209c).
버전 1.0.0-alpha33
2025년 2월 26일
androidx.wear.compose:compose-material3:1.0.0-alpha33
이 출시되었습니다. 버전 1.0.0-alpha33에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
SwipeToRevealScope
의primaryAction
및secondaryAction
에서 라벨 매개변수가 삭제되었습니다. 맞춤 작업 의미 체계는 개발자가SwipeToReveal
구성요소의 콘텐츠에 직접 추가해야 합니다. (Ia67f3)IconToggleButtonDefaults
및TextToggleButtonDefaults
의 크기, 텍스트 스타일, 색상 함수에서 'Button' 접두사를 삭제했습니다 (I5471d).- 실험용
LocalMinimumInteractiveComponentEnforcement
를 삭제했습니다. (I4ad8a) PickerGroupScope
DSL이 컴포저블로 대체되었습니다. 따라서PickerGroupScope
에서pickerGroupItem
메서드를 삭제하고 대신PickerGroup
에 Picker를 추가하는 데 사용해야 하는@Composable PickerGroupItem
를 추가했습니다. 또한PickerGroup
'content' 매개변수의 유형을@Composable PickerGroupScope.() -> Unit
로 업데이트했습니다. (Ic6aec)- 분수 값에
LevelIndicator
오버로드를 추가하고 범위 매개변수를 포함하는 오버로드에 스테퍼 접두사를 추가했습니다 (스테퍼 구성요소와 함께 사용하기에 적합). (If4234) - TLC를 통해 스크롤될 때 항목에 발생하는 정확한 변환을 정의할 수 있는
TransformingLazyColumn
의TransformationSpec
가 API에 추가되었습니다. (I21856) - Compose/material3 클래스와 일치하도록
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
,TextToggleButtonShapes
를 업데이트했습니다 (I5a081). ScalingLazyColumn
,TransformingLazyColumn
,ScreenScaffold
에overscrollEffect
매개변수를 추가했습니다. (I0cee8)rememberRevealState
에서swipeDirection
매개변수의 이름을revealDirection
로 바꾸었습니다. (I7472f)- 이제 Wear Pager는 Compose
PagerScope
를 사용하는 대신 자체PagerScope
를 사용합니다. (I9195b) LinearProgressIndicatorContent
컴포저블이 삭제되었습니다. 값 변경이 기본적으로 애니메이션으로 처리되도록LinearProgressIndicator
을 직접 사용하세요. (I2c4ad)CircularProgressIndicatorStatic
컴포저블이 삭제되고 동일한 기능을 갖춘 공개DrawScope
함수drawCircularProgressIndicator
가 추가되었습니다. 변경사항이 기본적으로 애니메이션 처리되도록CircularProgressIndicator
를 직접 사용하되, 맞춤 애니메이션이 필요한 경우drawCircularProgressIndicator
에서 자체 컴포저블을 빌드하세요. (Ie762f)targetProgress
매개변수를 위로 이동하기 위해DrawScope.drawCircularProgressIndicator
의 매개변수를 재정렬했습니다. (I8ab92)- 명확성을 높이고 다른 대화상자와의 일관성을 높이기 위해
OpenOnPhoneDialog
API가 업데이트되었습니다.show
매개변수의 이름이visible
로 변경되었으며curvedText
는 이제 기본값이 아닌 호출자에 의해 제공됩니다. (Idec2d) openOnPhoneCurvedText
의 이름을openOnPhoneDialogCurvedText
로 변경했습니다. (I65bdd)ScrollIndicator
에 맞춤 색상을 제공하기 위해ScrollIndicatorColors
를 추가했습니다. (I9eb8c)TimeText
뒤에 배경을 그리는 데 사용되는 색상을 구성할 수 있도록 허용 (I9f5d9)ArcLarge
,ArcMedium
,ArcSmall
서체를CurvedTextStyle
로 업데이트했습니다. (Iffc41)ScreenScaffoldDefaults.contentPaddingWithEdgeButton
이 삭제되었습니다. (Ia923e)- 안전 알림, 실패한 대화상자 오버레이 또는 중지 버튼과 같은 높은 우선순위 오류나 긴급 조치를 위해
ColorScheme
에errorDim
를 추가했습니다. (I70998)
버그 수정
wear.compose.material3
가androidx.core.core
버전 1.15.0 (I132e9)에 고정되었습니다.AppScaffold
를 사용하여 다른 화면 콘텐츠 위에 대화상자를 배치하여 대화상자의 성능을 개선했습니다 (I1b9a4).EdgeButton
의 내부 세로 패딩이 감소했습니다. (I1a5bb)- 슬라이더 버튼에 버튼 시맨틱이 추가되었습니다. (I80cc6)
버전 1.0.0-alpha32
2025년 1월 29일
androidx.wear.compose:compose-material3:1.0.0-alpha32
이 출시되었습니다. 버전 1.0.0-alpha32에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
CurvedTextStyle
에서는 문자 간격을 시계 방향 문자 간격과 반시계 방향 문자 간격으로 분할했습니다. 시계 방향 글자는 기준선에서 펼쳐지는 반면 반시계 방향 글자는 안쪽으로 펼쳐지기 때문에 더 큰 글자 간격이 필요합니다(I4b848).- Material3 라이브러리 전반의 일관성을 개선하기 위해
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
,TextToggleButtonShapes
가 업데이트되었습니다. 이 변경사항은 할당 수를 줄이기 위해 모양 캐싱도 도입합니다. (I049fc) IconToggleButton
및TextToggleButton
(I58a65)의variantAnimatedShape
메서드에서pressedShapeCornerSizeFraction
매개변수가 삭제되었습니다.- 원형이 아닌 화면과 호환되지 않는 곡선 텍스트 렌더링 (
TimeText
포함)이 개선됩니다. 원형이 아닌 화면 지원도 더 이상 Wear OS 요구사항에 포함되지 않습니다. 자세한 내용은 시작 가이드를 참고하세요. (I1cc1c) - DSL 기반
ButtonGroupItem
를Modifier.weight
,Modifier.minWidth
,Modifier.enlargeOnPress
로 대체하여ButtonGroup
의ButtonGroupScope
를 업데이트했습니다. (I16c3c) ButtonGroup
API에서 새로운 수정자 기반ButtonGroupScope
를 업데이트했습니다. 이제enlargeOnPress
이animateWidth
로 호출되며, 이를 변경할 필요가 없으므로MutableInteractionSource
대신InteractionSource
를 사용합니다.ButtonGroup
의 버튼 기본 최소 너비인 공개 상수ButtonGroupDefaults.DefaultMinWidth
도 추가했습니다. (Ie27ec)ListHeaderDefaults.contentColor
가 컴포저블 속성이므로 소문자로 시작하도록 업데이트했습니다. (I125a5)- 적절한 기본값 (I2e1a7)과 함께 콘텐츠 설명 매개변수를
SliderDefaults.DecreaseIcon
및SliderDefaults.IncreaseIcon
에 추가했습니다. Picker
및PickerGroup
의spacing
매개변수를verticalSpacing
(Ib75cc)로 이름을 바꿨습니다.ConfirmationDialog
호출자가 더 많은 컨텍스트가 포함된 문자열을 제공할 것으로 예상되므로ConfirmationDialogDefaults.successText
및failureText
가 삭제되었습니다.confirmationCurvedText
의 이름도confirmationDialogCurvedText
로 변경했습니다. 마지막으로 대화상자의 최근 업데이트와의 일관성을 위해 대화상자show
매개변수의 이름을 visible로 바꿨습니다. (I10074)IconButton
에서disabledImageOpacity
의 이름을DisabledImageOpacity
로 바꿨습니다. (I5f94a)
버그 수정
- 각 프레임에서 올바른 크기가 사용되도록
EdgeButton
애니메이션의 버그를 수정했습니다 (Id3b58). animateContentSize
가Button
와 함께 작동하지 않는 문제를 수정했습니다. (Ib18a0)- 글꼴 크기가
18dp
(Ic9d52)인 Title Large 서체 스케일로 변경했습니다. AlertDialog
간격과 아이콘 크기를 업데이트했습니다 (Iac28c).- 대형 화면 중단점 (225dp 이상의 화면은 대형 화면임)의 불일치가 수정되었습니다(I36474).
- 버튼 위치의 사소한 버그 수정 (I952c2)
버전 1.0.0-alpha31
2025년 1월 15일
androidx.wear.compose:compose-material3:1.0.0-alpha31
이 출시되었습니다. 버전 1.0.0-alpha31에는 이 커밋이 포함되어 있습니다.
API 변경사항
- 모든 Wear Compose 라이브러리가 '명시적 API' 모드로 업데이트되었습니다. (Iebf9f)
EdgeButton
가 포함된 화면에서 콘텐츠 패딩을 더 쉽게 지정할 수 있도록ScreenScaffold
및EdgeButton
API가 업데이트되었습니다. 새 API에서EdgeButton
의size
은EdgeButton
에만 전달되고ScreenScaffold
는EdgeButton
과 목록 콘텐츠 사이의 간격을 위한edgeButtonSpacing
매개변수를 사용합니다. (I424fd)DatePicker
에서 매개변수minDate
을maxDate
로,minValidDate
을maxValidDate
로 이름을 바꿨습니다.DatePickerColors
에서 매개변수selectedPickerContentColor
의 이름을activePickerContentColor
로,unselectedPickerContentColor
의 이름을inactivePickerContentColor
로 변경했습니다. (Iba17b)ArcProgressIndicator
기본값을strokeWidth=6dp
로 업데이트하고 화면 높이의diameter = 81.24%
를 권장했습니다. (I6f248)- 대화상자로 사용되는 방식을 반영하도록 확인 API가 업데이트되었습니다. 이제 컴포저블의 이름이
ConfirmationDialog
로 변경되었으며 색상 및 기본 클래스의 이름도 업데이트되었습니다. 다른 Compose 애니메이션 API와의 호환성을 위해show
매개변수의 이름도visible
로 변경했습니다. 또한 개발자가 인트로/아웃트로 대화상자 애니메이션을 맞춤설정해야 하는 상황을 위해ConfirmationDialogContent
,SuccessConfirmationDialogContent
,FailureConfirmationDialogContent
를 제공합니다. (Iaeb33) - 이제 맞춤 애니메이션으로
CircularProgressIndicator
를 빌드할 수 있도록CircularProgressIndicatorContent
를CircularProgressIndicatorStatic
(CircularProgressIndicator
의 애니메이션이 적용되지 않은 변형)로 업데이트했습니다. (I1346f) ArcProgressIndicator
의 매개변수 순서를 수정하여 수정자 매개변수를 먼저 배치했습니다 (I4656a).- 작업 라벨 (보조 작업 제외)의 텍스트 슬롯 매개변수를 수신하고 실행취소 작업에서 라벨 매개변수를 삭제하도록
SwipeToReveal
API 개선 (I5b3db)
버그 수정
Button
,Card
,IconButton
,TextButton
에서LongPress
햅틱이 두 번 이상 트리거되는 버그를 수정했습니다. (Ia8b0f)AlertDialog
의 UX 변경사항: 대형 화면에서 확인 및 닫기 버튼이 이제 더 작아집니다. 확인 및 닫기 버튼 아래의 간격도 늘어났습니다. (I4f066)SwipeToReveal
구성요소의 작업 버튼 라벨 애니메이션 사양이 변경되었습니다. (Ib87fb)- 텍스트가 표시되는 동시에 컨테이너가 확장되도록
SwipeToReveal
를 변경했습니다. (I44cf8) - 기본 작업이 커밋되는 스와이프가 기준점을 통과할 때 햅틱 피드백을 실행하도록
SwipeToReveal
개선 (I23efe) - 기본 및 실행취소 작업의 텍스트 오버플로에 줄임표가 표시되도록
SwipeToReveal
가 업데이트되었습니다. (I71f5a) ButtonGroup
애니메이션에서 지터가 발생하는 문제를 수정했습니다. (I63f8f)AnimatedText
에 텍스트 의미 체계를 추가했습니다. (I6063c)- 이제 대화상자가 컴포지션에서 삭제되면 대화상자가 배경 크기 조정을 재설정합니다. 이 수정사항이 없으면 실행 화면이 축소된 상태로 남아 있을 수 있습니다. (Id24ac)
- 스테퍼 구성요소 (Id6ed3)의 버튼에 모양 모핑 애니메이션을 추가했습니다.
버전 1.0.0-alpha30
2024년 12월 11일
androidx.wear.compose:compose-material3:1.0.0-alpha30
이 출시되었습니다. 버전 1.0.0-alpha30에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
TransformingLazyColumn
의scrollTransform
수정자가 리팩터링되어 API 변경이 트리거되었습니다. (I0c6dc)IconToggleButtonShapes
및TextToggleButtonShapes
이 두 가지 다른 모양 매개변수uncheckedPressed
및checkedPressed
을 갖도록 업데이트했습니다. (I85dbd)- 이제
minDate
또는maxDate
를 사용할 때 잘못된 월/일 옵션이 새invalidPickerContentColor
와 함께DatePicker
에 표시됩니다. (If4541) Stepper
API가 업데이트되어increaseIcon
및decreaseIcon
슬롯이 제공됩니다. 이러한 슬롯의 콘텐츠는 Icon 컴포저블에서 평소와 같이 빌드할 수 있습니다. (Id35da)- 선택사항인
defaultColorScheme
매개변수를 삭제하고 이제 null 허용ColorScheme
를 반환하도록dynamicColorScheme
를 업데이트했습니다. 즉, 동적 색상 구성표가 제공되지 않는 경우 호출자가 대체 사례를 명시적으로 처리해야 합니다. (I6d62e) CompactButton
에서 사용할 수 있도록ButtonDefaults
의 아이콘 크기를 업데이트했습니다. 아이콘만 포함하는CompactButton
는ButtonDefaults.SmallIconSize = 24.dp
를 사용해야 하고 아이콘과 텍스트를 모두 포함하는CompactButton
는ButtonDefaults.ExtraSmallIconSize = 20.dp
를 사용해야 합니다.CompactButton
는 최대 너비를 채우는 대신 콘텐츠를 래핑하는 것이 좋습니다. 샘플이 이를 보여주도록 업데이트되었습니다. (I0582c)- 4가지
EdgeButtonSizes
에 권장되는 아이콘 크기가 포함된EdgeButtonDefaults
가 추가되었습니다. 또한 아이콘과 텍스트 콘텐츠의 모양을 개선하기 위해 상단 패딩보다 하단 패딩이 약간 더 큰EdgeButton
레이아웃을 업데이트했습니다. (Id772a) LinearProgressIndicator
에 동작을 추가하고 애니메이션이 없는 시각적 콘텐츠를 제공하는LinearProgressIndicatorContent
를 노출했습니다. (Idee99)- 애니메이션 없이
CircularProgressIndicator
의 시각적 콘텐츠를 표시하는 새로운CircularProgressIndicatorContent
컴포저블이 추가되었습니다. (Ie33d4) TransformingLazyColumn
는 이제 컴포지션 로컬LocalTransformingLazyColumnItemScope
를 제공하며,Card
,Button
,ListHeader
는 이제TransformingLazyColumn
내부에 배치될 때 자동으로 변환하는 데 이를 사용합니다. 호출자는 새로운TransformExclusion
래퍼를 사용하여 자동 모핑을 사용 중지할 수 있습니다. (I1652f)ButtonDefaults.shape
의 유형을RoundedCornerShape
로 업데이트했습니다. (Iccdf2)
버그 수정
TimeText
의 배경에서 기존 알파를 따르도록 버그를 수정했습니다. (I1eb60)- 확장 작업 중에 글자 글리프가 픽셀 경계에 스냅되어 텍스트가 흔들리는 것을 방지하기 위해 서체에서
TextMotion
을 기본적으로Animated
로 설정했습니다. (I626fa) - 가시성을 개선하기 위해 너비와 간격 크기를 늘려
ScrollIndicator
의 모양을 업데이트했습니다. (Ied7cb) - 항목을 추가/삭제/이동할 때
Modifier.scrollTransform
에서 발생하는 버그를 수정했습니다. (I6830f) - 짧은 탭의 원형 버튼 애니메이션 문제가 수정되었습니다 (이전에는 최소 애니메이션 지속 시간이 항상 준수되지 않았음). (I757a7)
LevelIndicator
의 스윕 각도가 20% (72도)로 업데이트되었습니다. (Idde5c)ScalingLazyColumn
이AutoCenteringParams
와 함께 사용될 때ScrollIndicator
위치가 수정되었습니다. (I387dd)ListHeader
및ListSubHeader
의 색상과 서체가 업데이트되었습니다.CheckboxButton
및SwitchButton
의 전환 버튼 색상도 포함됩니다. (I39817)ContentPadding
를 사용하여LazyColumn
및ScalingLazyColumn
에서ScrollIndicator
위치를 수정했습니다. (I2bc51)- 새로운
CircularProgressIndicatorContent
을 사용하여OpenOnPhoneDialog
진행률 애니메이션에서 나타나는 버그를 수정했습니다. (I3e443) - 동작 줄이기가 사용 설정된 경우 애니메이션을 사용 중지하도록
HorizontalPagerScaffold
및VerticalPagerScaffold
를 업데이트했습니다 (Iaaf68). - 진행률이 100%를 초과할 때 원형 진행률 표시기에 별도의 애니메이션을 구현했습니다. (I47135)
EdgeButton
가 Pager 구성요소에서 잘못된 모양으로 그려질 수 있는 버그를 수정했습니다 (I91db9).
버전 1.0.0-alpha29
2024년 11월 13일
androidx.wear.compose:compose-material3:1.0.0-alpha29
이 출시되었습니다. 버전 1.0.0-alpha29에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
- 시간을 표시하는 기본 콘텐츠를 제공하도록
TimeText
를 업데이트했습니다. (Id23b3) - 더 이상 필요하지 않은
orientation
매개변수를 삭제하여PagerState
의ScrollInfoProvider
를 간소화했습니다. 새 동작은TimeText
이 가로 및 세로 페이징 모두에서 제자리에 유지되는 것입니다. (I71767) - 이제
LocalHapticFeedback
는 진동기 API가 햅틱이 지원된다고 나타내는 경우 기본HapticFeedback
구현을 제공합니다.HapticFeedbackType
-Confirm
,ContextClick
,GestureEnd
,GestureThresholdActivate
,Reject
,SegmentFrequentTick
,SegmentTick
,ToggleOn
,ToggleOff
,VirtualKey
에 다음이 추가되었습니다. 이제Button
,IconButton
,TextButton
,Card
과 같은 Wear Compose 길게 클릭 가능한 구성요소는 길게 클릭 핸들러가 제공된 경우LONG_PRESS
햅틱을 실행합니다. (I5083d)
버그 수정
- 확인 모션이 업데이트되었습니다. (I04bff)
- Compose 라이브러리의 최소 API 종속 항목이 1.7.4로 업데이트되었습니다. (I88b46)
OpenOnPhone
대화상자에 새로운 동작이 추가되었습니다. (I1e10a)- 이제 수준이 0일 때 올바르게 표시되도록
LevelIndicator
의 버그를 수정했습니다. (Ie95a4) HorizontalPageIndicator
및VerticalPageIndicator
애니메이션을 업데이트했습니다. (I5c8f3)- 불확정
ArcProgressIndicator
에 점으로 축소 애니메이션을 추가했습니다. (I9fd51)
버전 1.0.0-alpha28
2024년 10월 30일
androidx.wear.compose:compose-material3:1.0.0-alpha28
이 출시되었습니다. 버전 1.0.0-alpha28에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
- 확실하지 않은 원형 진행 상태 표시기 (I2efc1)에 호 변형을 추가했습니다.
- 필요한 경우 맞춤설정을 추가할 수 있도록 (예: 권장 콘텐츠 레이아웃을 유지하면서
AlertDialog
애니메이션 맞춤설정)AlertDialog
API를 구성하는AlertDialogContent
및Dialog
컴포저블을 공개했습니다. 또한AlertDialogDefaults
의EdgeButton
,ConfirmButton
,DismissButton
멤버에Modifier
및Color
매개변수를 추가했습니다. (I4eb71) Placeholder
API가 다음과 같이 업데이트되었습니다.PlaceholderState.startPlaceholderAnimation
이PlaceholderState.animatePlaceholder
로,PlaceholderState.isShowContent
이PlaceholderState.isHidden
로,PlaceholderDefaults.shape
이PlaceholderDefaults.Shape
로 이름이 변경되었고,painterWithPlaceholderOverlayBackgroundBrush
의painter
매개변수가originalPainter
로 이름이 변경되었으며,PlaceholderState.placeholderProgression
의 공개 상태가 공개에서 내부로 변경되고placeholderShimmerProgression
로 이름이 변경되었으며,PlaceholderDefaults
에 자리표시자 애니메이션 지속 시간 상수가 추가되었습니다. (Ie5a59)EdgeButton
API가 다음과 같이 업데이트되었습니다.ScreenScaffold
의 매개변수 이름이bottomButton
에서edgeButton
로 변경되었고EdgeButtonSize
이 값 클래스로 설정되었습니다. (Ieef15)- 웨어 material3 색상 클래스 (I0287f)에서
copy()
의 공개 상태를 공개로 변경했습니다.
버그 수정
- 클릭 시
IconToggleButton
및TextToggleButton
의 최소 애니메이션 지속 시간 추가 (Ieb333) IconButton
및TextButton
모양 애니메이션에 최소 지속 시간을 추가했습니다 (Iebcee).DatePicker
의 반복 옵션 상태를 수정했습니다. (I3587c)- 알림 및 확인 대화상자에 동작이 추가되었습니다. (I173b1)
버전 1.0.0-alpha27
2024년 10월 16일
androidx.wear.compose:compose-material3:1.0.0-alpha27
이 출시되었습니다. 버전 1.0.0-alpha27에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
- Wear Compose Foundation
LazyColumn
의 이름이TransformingLazyColumn
로 변경됨에 따라ScreenScaffold
및ScrollIndicator
를 업데이트했습니다. (I0608b) EdgeButton
의preferredHeight
매개변수 이름이buttonSize
로 변경되었으며, 값은 새로 도입된EdgeButtonSize
값 클래스의 4개 상수 중에서만 선택할 수 있습니다. (Icdd70)ListSubheader
의 이름을ListSubHeader
로 변경하고ListHeader
및ListSubHeader
에 공개적으로 액세스할 수 있는 기본값을 추가했습니다. (I96730)- 시간 텍스트와 페이지 표시기 구성요소 간에 새로운 애니메이션과 조정을 제공하는 Wear용 새로운
HorizontalPagerScaffold
및VerticalPagerScaffold
구성요소를 추가했습니다. (Iff7d0) HorizontalPagerScaffold
및VerticalPagerScaffold
에 로터리 지원이 추가되어 사용자가 로터리 입력 장치를 사용하여 페이저를 탐색할 수 있습니다. (I9770d)- 사용을 간소화하고 일관성을 개선하기 위해
MotionScheme
API가 변경되었습니다. 인라인 처리된 remember 함수가 삭제되고 내장 모션 스킴이 전용 MotionScheme 컴패니언 객체로 이동되었습니다.standardMotionScheme
및expressiveMotionScheme
의 이름을 표준 및 표현으로 변경했습니다. (I5fd45) - 시스템 색상에 기반한 동적 색 구성표 지원을 추가했습니다. (I073e9)
- 최신 UX 사양에 맞게 Stepper를 업데이트했습니다. (I622bb)
버그 수정
- 카드 구성요소의 서체와 패딩이 업데이트되었습니다. (I3ae48)
- UX 사양에 따라
AlertDialog
에서 확인/닫기 버튼과 나머지 콘텐츠 사이의 패딩을 8dp에서 12dp로 변경했습니다 (Ie55f0). - 슬라이더 구성요소의 색상 불투명도가 업데이트되었습니다. (Idb383)
버전 1.0.0-alpha26
2024년 10월 2일
androidx.wear.compose:compose-material3:1.0.0-alpha26
이 출시되었습니다. 버전 1.0.0-alpha26에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
HorizontalPageIndicator
의 API와 모양을 업데이트하고VerticalPager
와 함께 사용할VerticalPageIndicator
를 추가했습니다. (Ic9309)- 이제
AlertDialog
은 EdgeButton이 필요하지 않은 맞춤 레이아웃의 경우 버튼 스택 변형에서 기본 하단 버튼을 생략하는 기능을 지원합니다. (I34fa9) - Wear Material 3에
SwipeToReveal
구성요소가 추가되었습니다 (Ic38b2). - 현재 화면에서 스와이프하여 닫기를 지원하지 않는 드문 경우를 위해
SwipeToReveal
에 양방향 스와이프 지원이 추가되었습니다. 기본값은 여전히 오른쪽에서 왼쪽으로 스와이프할 때만 스와이프하여 표시하는 것이며, 스와이프하여 닫기와 충돌하지 않도록 기본 동작을 따르는 것이 좋습니다. (Ifac04) EdgeButton
의buttonHeight
매개변수를preferredHeight
로 이름을 바꾸었습니다. (I4fab3)- Kotlin 버전이 1.9 (I1a14c)로 업데이트되었습니다.
Icon
와의 충돌을 방지하기 위해OpenOnPhoneDialogDefaults.Icon
의 이름을OpenOnPhoneDialogDefaults.OpenOnPhoneIcon
로 바꿨습니다. (I0f391)LazyColumn
에ScrollIndicator
지원을 추가했습니다. (Ia546a)TextToggleButton
및IconToggleButton
의 기본값이 업데이트되었습니다. (I7aaa9)Picker
및PickerGroup
API가 간소화되었습니다. (Id0653)CardDefaults.Shape
및CardDefaults.Height
가 추가되었습니다. 이러한 토큰은 라이브러리를 사용하는 개발자에게 비공개로 제공됩니다. (I1594a, b/347649765)- 이진 세그먼트 원형 진행률 표시기의 진행률 매개변수 이름을
segmentValue
로 변경했습니다. (Ib72d9) - 슬라이더의 색상과 레이아웃이 업데이트되었습니다. (Ic3eec)
버그 수정
openOnPhone
아이콘 애니메이션이 업데이트되었습니다 (I66f85).- 이제
Slider
,TimePicker
,DatePicker
에서 Google Symbols 아이콘을 사용합니다. (I46c7c) Confirmation
및OpenOnPhoneDialog
의 패딩이 업데이트되었습니다. (Iaa82e)
버전 1.0.0-alpha25
2024년 9월 18일
androidx.wear.compose:compose-material3:1.0.0-alpha25
이 출시되었습니다. 버전 1.0.0-alpha25에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
- 비확정 원형 진행률 표시기가 추가되었습니다. (I427a7)
CircularProgressIndicator
과SegmentedCircularProgressIndicator
모두에 진행률 오버플로(100% 초과 진행률) 지원을 추가했습니다. 진행률이 1.0을 초과하면 새로운overflowTrack
색상으로 표시됩니다. (Iaaa3d)- 원형
IconToggleButton
및TextToggleButton
에서는 이제 새로운 모양 애니메이션 변형을 지원합니다. 이 변형에서는 다양한 모양이 선택, 선택 해제, 눌림 상태를 나타냅니다. 방금 누른 상태의 이전 애니메이션 도형 변형은 계속 지원됩니다. (I29f03) ScreenScaffold
에서EdgeButton
높이를 명시적으로 지정해야 하므로Column
와 함께EdgeButton
를 사용하는 지원이 삭제되었습니다. (Ie353d)ScreenScaffold
을 사용하여 Wear ComposeLazyColumn
지원을 추가하고LazyColumnState
용ScrollInfoProvider
구현을 추가했습니다. (Ib8d29)- 앞으로 더 확장 가능한 솔루션을 제공하기 위해
LocalTextMaxLines
,LocalTextAlign
,LocalTextOverflow
를 단일LocalTextConfiguration
컴포지션 로컬로 결합했습니다. (I5edbc) - 확인 오버레이와 같이 화면의 맨 위 또는 맨 아래에 있는 짧은 헤더 텍스트 문자열에 사용되는 추가 타입 스케일로 arc-large가 추가되었습니다. (I60e3e)
- 권장되는 대형 및 초대형 아이콘 크기와 콘텐츠 패딩을 위해 버튼에 기본값이 추가되었습니다. (I84675)
버그 수정
IconButton
및TextButton
의 색상이 업데이트되었습니다. (I48324)- 다른 오버로드와의 일관성을 위해 기본 버튼 오버로드가 세로로 가운데 정렬되도록 변경했습니다. 이전 동작을 복원하려면
RowScope
의Modifier.align
를 사용하세요. (I66e57)
버전 1.0.0-alpha24
2024년 9월 4일
androidx.wear.compose:compose-material3:1.0.0-alpha24
이 출시되었습니다. 버전 1.0.0-alpha24에는 이 커밋이 포함되어 있습니다.
API 변경사항
- Material3 테마에 모션 스킴이 추가되었습니다. 이는 라이브러리 전반의 구성요소에서 표현력 있는 모션을 위한 스프링과 같은 애니메이션 사양을 적용하는 데 사용됩니다. (I54ff3)
- Material3 라이브러리에
TimeText
및ScrollIndicator
의 레이어링과 전환을 조정하는 기능을 포함하는AppScaffold
및ScreenScaffold
구성요소를 추가했습니다.AppScaffold
는 모든 화면 위에 있는 스캐폴드 구성요소의 최상위 수준을 제공합니다. 따라서AppScaffold
에TimeText
를 추가하면 화면 간에 스와이프하는 동안 제자리에 유지할 수 있습니다. 화면 자체에서 시간 텍스트를 재정의하거나 숨길 수 있습니다.ScreenScaffold
는ScrollIndicator
의 슬롯을 제공하고 스크롤 시 스크롤 표시기를 자동으로 애니메이션 처리하며, 비활성 상태 후 스크롤 표시기를 숨기는 제한 시간도 포함합니다. (I047d6) - 새로운 Material3 디자인이 적용된
ScrollIndicator
가 추가되었습니다. 지연 콘텐츠가 목록에 로드될 때 크기 변동을 방지하기 위해 초기 목록 콘텐츠를 기반으로 고정된 썸네일 크기가 있습니다. (Ic228d) - 필요에 따라 추가 단계를 추가할 수 있도록
ScreenStage
이 enum 클래스가 아닌 값 클래스가 되도록ScrollAway
API가 변경되었습니다. (I48c93) - 화면 하단의 곡률을 따르는 모양의 고유한 Wear 전용 버튼인
EdgeButton
가 추가되었습니다 (I16369). - 스크롤 콘텐츠에 따라 표시되고 크기가 조절되는 하단 버튼 (예:
EdgeButton
)을 위해ScreenScaffold
에 새로운 슬롯이 추가되었습니다 (I032eb). LazyColumn
의 항목에 Material3 모션 효과를 추가하기 위해Modifier.scrollTransform
및Modifier.targetMorphingHeight
가 추가되었습니다. (Ie229a)CircularProgressIndicator
의 변형으로SegmentedCircularProgressIndicator
를 추가했습니다. 분할된 변형은 모든 세그먼트에 단일 진행률 값을 표시하거나 각 세그먼트가 켜짐/꺼짐으로 표시됩니다. (I6e059)- 기존
CircularProgressIndicator
의 대안으로LinearProgressIndicator
이 추가되었습니다. (I89182) - 사용자에게 중요한 프롬프트를 표시하는 레이아웃을 제공하는
AlertDialog
가 추가되었습니다. 변형은 확인/닫기 버튼 쌍 또는 옵션 스택 아래의 단일 하단 버튼 (일반적으로 EdgeButton)에 포함됩니다. 두 변형 모두 아이콘, 제목, 추가 텍스트를 위한 슬롯이 있어 자세한 내용을 제공할 수 있습니다. (Ieb873) - 사용자의 휴대전화에서 계속될 작업을 나타내는 데 사용해야 하는
OpenOnPhoneDialog
가 추가되었습니다.OpenOnPhoneDialog
는 지정된 시간 제한이 지나면 닫힙니다. (I978fd) - 아이콘과 곡선 또는 선형 텍스트용 슬롯이 있는 대화상자 구성요소인
Confirmation
를 추가했습니다. 성공/실패 메시지에 대한 구체적인 변형이 제공됩니다. 확인은 시간이 초과되면 자동으로 닫힙니다. (Ib43e8) - 기본 콘텐츠와
TimeText
이 겹쳐 시간이 가려지는 문제를 완화하기 위해TimeText
에 배경을 추가했습니다. (Ia11fd) - 볼륨과 같은 설정 값을 표시하는
LevelIndicator
가 추가되었으며, 기존Stepper
구성요소와 함께 사용하여 볼륨 화면을 구성할 수 있습니다.LevelIndicator
는ScrollIndicator
와 유사하지만 화면의 반대쪽에 표시되고 기본적으로 획 너비가 더 넓고 표시기 색상이 다릅니다. (I8a4ac) - 24시간 형식 (초 포함 또는 미포함) 또는 오전/오후 선택이 있는 12시간 형식의 레이아웃이 있는
TimePicker
가 추가되었습니다. (Ia5124) - 열 순서 (예: 일-월-년, 월-일-년 또는 년-월-일) 및 선택적 최소/최대 날짜를 구성할 수 있는
DatePicker
가 추가되었습니다. (Ibf13b) TimeText
의text
함수에 가중치 매개변수를 추가했습니다. TimeText가 텍스트 요소 두 개 이상으로 구성된 경우 공백이 분배되는 방식을 제어할 수 있습니다. (I36700)RadioButton
및SplitRadioButton
이 추가되었습니다. 이러한 구성요소는 (분할)SelectableButton
와 하위 라디오 컨트롤 (If7ae8)을 결합하여 이전 API를 간소화합니다.CheckboxButton
및SplitCheckboxButton
가 추가되었습니다. 이러한 구성요소는 (분할)ToggleButton
와 하위 체크박스 컨트롤 (Ia8f70)을 모두 결합하여 이전 API를 간소화합니다.SwitchButton
및SplitSwitchButton
가 추가되었습니다. 이러한 구성요소는(Split)ToggleButton
와 하위 스위치 컨트롤 (I0d349)을 모두 결합하여 이전 API를 간소화합니다.- 오버슈팅 동작을 설명하기 위해
AnimatedText
문서를 업데이트했습니다. (Iff30a) - 버튼 누르기가 조정된 애니메이션을 생성하도록 2개 또는 3개의 버튼을 결합하는
ButtonGroup
가 추가되었습니다. (Ie27db) IconButton
및TextButton
을 누를 때 선택적 모양 애니메이션을 추가했습니다. (Iffca5)Button
,IconButton
,TextButton
,CompactButton
,EdgeButton
에FilledVariant
라는 색상 변형이 추가되었습니다. (I65fc3)ImageWithScrimPainter
에forcedSize
매개변수를 추가하여 이제 버튼 이미지 배경이 기본적으로 구성요소 크기를 유지합니다.forcedSize = null
를 설정하면 대신Painter.instrinsicSize
가 채택됩니다. (Ic57af)- 버튼에 길게 클릭이 추가되었습니다 (Ib613d).
- 길게 클릭 지원도
IconButton
및TextButton
에 추가되었습니다. (I38891) - 카드에 길게 클릭 지원이 추가되었습니다. (I305d5)
LocalTextMaxLines
,LocalTextAlign
,LocalTextOverflow
를CompositionLocals
로 추가하고Text
에서 매개변수 기본값으로 사용했습니다. 이제CheckboxButton
,SwitchButton
,RadioButton
와 같은 구성요소에서 컴포지션 로컬을 사용하여 UX 가이드라인을 구현할 수 있지만 필요한 경우 개발자가 매개변수를 재정의할 수 있습니다. (Iab841)- 데이터가 로드될 때까지 버튼 및 카드와 같은 구성요소의 콘텐츠를 마스킹하는 데 도움이 되도록
Placeholder
가 추가되었습니다. (I1a532) - 이제 삭제된
ToggleButtonColors
를 대체하기 위해IconToggleButtonColors
및TextToggleButtonColors
이 추가되었습니다. (Ie0bf1)
버그 수정
- 새로운
CompositionLocals
LocalTextMaxLines
,LocalTextAlign
,LocalTextOverflow
을 사용하여 UX 안내를 구현하도록Button
,FilledTonalButton
,OutlinedButton
,ChildButton
,CompactButton
이 업데이트되었습니다. 필요한 경우 개발자가 텍스트에서 직접 이러한 매개변수를 재정의할 수 있습니다 (Ie51f7). - 획 너비가
4dp
인ScrollIndicator
와 구분하기 위해LevelIndicator
의 기본 획 너비를6dp
로 변경했습니다. (If6f63) - 더 큰 스윕 각도가 지원되도록
TimeText
의 문제가 수정되었습니다. (Ie489f) EdgeButton
재구성 중 문제를 수정했습니다. (I4cdca)- 맞춤 콘텐츠 패딩이 제공될 때 분할 전환 버튼의 레이아웃이 수정되었습니다. (Ia33d3)
- 작은 진행률 값을 진행률 표시기의 선 너비 이상으로 올림 (I3bd84)
버전 1.0.0-alpha23
2024년 5월 14일
androidx.wear.compose:compose-material3:1.0.0-alpha23
이 출시되었습니다. 버전 1.0.0-alpha23에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
- 사용 중지된 색상을 구성할 수 있도록
ToggleButton
및RadioButton
API가 업데이트되었습니다. (If13a7) - Material3용
CircularProgressIndicator
를 새로 추가했습니다. (Ib3bd7)
버그 수정
- 선택 가능한 버튼이 이미 선택된 경우 전환하려면 두 번 탭하라고 알리는 버그를 수정했습니다. (I7ed88)
버전 1.0.0-alpha22
2024년 5월 1일
androidx.wear.compose:compose-material3:1.0.0-alpha22
이 출시되었습니다. 버전 1.0.0-alpha22에는 이 커밋이 포함되어 있습니다.
API 변경사항
- Material3
ColorScheme
가 업데이트되었습니다. (I7b2b8) - Material3 스위치가 업데이트되었습니다. 색상 변경 외에도 이제 체크박스에 사용되는 것과 일치하는 체크표시가 표시됩니다. (Icac7b)
버그 수정
- 새
rotaryScrollable
수정자를 사용하도록 모든 통합 데모를 업데이트합니다. (I25090)
버전 1.0.0-alpha21
2024년 4월 17일
androidx.wear.compose:compose-material3:1.0.0-alpha21
이 출시되었습니다. 버전 1.0.0-alpha21에는 이 커밋이 포함되어 있습니다.
- 이 버전은 이전 버전의 기술적 문제로 인해 소스 jar가 누락되어 트리거되었습니다. 이번 출시에는 새로운 커밋이 없습니다.
버전 1.0.0-alpha20
2024년 4월 3일
androidx.wear.compose:compose-material3:1.0.0-alpha20
이 출시되었습니다. 버전 1.0.0-alpha20에는 이 커밋이 포함되어 있습니다.
버그 수정
- 대비를 위해 리플 눌림 및 포커스 상태 알파를 조정했습니다. (I59f0a)
- 최신 서체 스타일 및 줄 높이 변경사항에 따라
Button
,ToggleButton
,RadioButton
에서 기본 라벨과 보조 라벨 사이에 간격을 추가했습니다. (I2c0ba)
버전 1.0.0-alpha19
2024년 3월 6일
androidx.wear.compose:compose-material3:1.0.0-alpha19
이 출시되었습니다. 버전 1.0.0-alpha19에는 이러한 커밋이 포함되어 있습니다.
API 변경사항
- Wear Compose Material3 라이브러리에
TimeText
를 추가했습니다. 이 구성요소는 화면 상단에 현재 시간 (및 추가 상태)을 표시합니다. 새로운 간결한 Material3 API는 선형 콘텐츠와 곡선 콘텐츠 간의 중복을 방지합니다. (I4d7c3) RadioButton
의 매개변수 이름이onSelected
에서onSelect
로 업데이트되었습니다. (I1a971)RadioButton
및SplitRadioButton
를 토큰화하고 색상의 캐시된 인스턴스를 추가하고RadioButtonColors
및SplitRadioButtonColors
의 메서드를 내부로 만들어CompositionLocal
조회의 양을 줄이도록 기존 메서드를 리팩터링합니다. (I02b33)
버전 1.0.0-alpha18
2024년 2월 21일
androidx.wear.compose:compose-material3:1.0.0-alpha18
이 출시되었습니다. 버전 1.0.0-alpha18에 포함된 커밋을 확인하세요.
API 변경사항
- 내부적으로 캐시된 인스턴스를 생성하고
CompositionLocal
사용을 줄여CardColors
,ToggleButtonColors
,SplitToggleButtonColors
의 기본값 패턴을 리팩터링했습니다. (If3fec)
버전 1.0.0-alpha17
2024년 2월 7일
androidx.wear.compose:compose-material3:1.0.0-alpha17
이 출시되었습니다. 버전 1.0.0-alpha17에 포함된 커밋을 확인하세요.
API 변경사항
- 기본적으로
buttonColors
를 사용하도록 Button API를 업데이트했으며 중복된filledButtonColors
를 삭제했습니다. (I4fe3b) - 내부적으로 캐시된 인스턴스를 생성하고
CompositionLocal
사용을 줄여ButtonColors
,IconButtonColors
,TextButtonColors
의 기본 패턴을 리팩터링했습니다. (I5f51c) - 구성요소별 색상 클래스에서
rememberUpdatedState
의 오버헤드를 삭제하고 색상 클래스 내의 접근자 메서드를 내부로 표시했습니다. (If6571)
버그 수정
Modifier.node
을 사용하도록Modifier.minimumInteractiveComponentSize
를 업데이트했습니다. (Iba6b7)
버전 1.0.0-alpha16
2024년 1월 24일
androidx.wear.compose:compose-material3:1.0.0-alpha16
이 출시되었습니다. 버전 1.0.0-alpha16에 포함된 커밋을 확인하세요.
새로운 기능
- 버튼과 동일한 채우기, 채우기 토널, 윤곽선 색상을 사용할 수 있는
CompactButton
가 추가되었습니다.(I05df0)
API 변경사항
- 라디오 컨트롤과 같은 선택 컨트롤의 컨테이너로
RadioButton
/SplitRadioButton
이 추가되었습니다.RadioButton
는 선택 가능하고 선택 그룹 내에서 작동하는 반면ToggleButton
는 전환 가능하고 독립적이라는 점에서 기존ToggleButton
와 다릅니다. (I61275) - Compose Material3 라이브러리와의 일관성을 위해 Wear Compose Material3 라이브러리에서
LocalContentAlpha
를 삭제합니다. (I49a0a) - API에서
MutableInteractionSource
를 노출하는 Wear Material 및 Wear Material3 구성요소가 이제 null로 기본 설정되는 null 허용MutableInteractionSource
를 노출하도록 업데이트되었습니다. 여기에는 시맨틱 변경사항이 없습니다. null을 전달하면MutableInteractionSource
를 호이스팅하지 않겠다는 의미이며 필요한 경우 구성요소 내에서 생성됩니다. null로 변경하면 일부 구성요소는MutableInteractionSource
를 할당하지 않고 다른 구성요소는 필요할 때만 인스턴스를 지연 생성할 수 있으므로 이러한 구성요소 전반에서 성능이 향상됩니다. 이러한 구성요소에 전달하는MutableInteractionSource
를 사용하지 않는 경우 null을 전달하는 것이 좋습니다. 자체 구성요소에서도 유사한 변경사항을 적용하는 것이 좋습니다. (Ib90fc, b/298048146) - 지원 중단된
rememberRipple
를 대체하는wear:compose-material
및wear:compose-material3
라이브러리에 새로운 리플 API를 추가합니다. 또한 지원 중단된rememberRipple/RippleTheme
API를 사용하도록 Material 구성요소를 되돌리는 임시CompositionLocal
,LocalUseFallbackRippleImplementation
를 추가합니다. 이 기능은 다음 안정화 버전에서 삭제되며 맞춤RippleTheme
를 제공하는 경우에만 임시 마이그레이션 지원으로 사용됩니다. 이 변경사항의 이전 정보와 자세한 배경 정보는 developer.android.com을 참고하세요. (af92b21) HorizontalPageIndicator
API와 관련 문서가 약간 개선되었습니다. (I60efc)ColorScheme
가 변경 불가능하도록 업데이트되어 개별 색상 업데이트는 덜 효율적이지만 더 일반적인 색상 사용은 더 효율적입니다. 이 변경사항의 이유는 대부분의 앱에서 개별 색상을 업데이트하는 것이 주요 사용 사례가 아니기 때문입니다. 이전과 마찬가지로 가능하지만 이전보다 더 많이 리컴포즈되므로 모든 Material 코드를 통해 상태 구독량이 크게 줄어들고 더 표준적인 사용 사례의 초기화 및 런타임 비용에 영향을 미칩니다. (Ibc2d6)- 사용 중지된 색상을 맞춤설정할 수 있도록
ToggleButton
및SplitToggleButton
API가 업데이트되었습니다. 또한 이제 Material Design 토큰이 색상 및 서체 값에 사용됩니다. (If087c) - Material Design 토큰을 사용하도록 버튼 이미지 배경색을 업데이트했습니다. (Iba215)
- 클릭 처리를 삭제하여
Checkbox
,Switch
,RadioButton
구성요소를 디스플레이 전용으로 변경했습니다. 이러한 구성요소는 클릭을 처리하는(Split)ToggleButton
에서 사용해야 하므로 이제 구성요소가 디스플레이 전용으로 더 명확하게 표시되며 Wear에서 독립형으로 사용하기 위한 것이 아닙니다. (I2322e)
버그 수정
- Wear Compose Material 3에 기간 및 이징의 동작 값 토큰이 추가되었습니다. (I437cd)
ToggleButton
,SplitToggleButton
,Checkbox
,Switch
,RadioButton
의 버그를 수정하여 접근성 알림이 반복되지 않도록 했습니다 (이전에는 시맨틱 역할이 중복됨). (Ica281)- 성능을 개선하기 위해
CompactButton
의 materialcore 레이어가 삭제되었습니다. (7902858)
버전 1.0.0-alpha15
2023년 11월 15일
androidx.wear.compose:compose-material3:1.0.0-alpha15
이 출시되었습니다. 버전 1.0.0-alpha15에 포함된 커밋을 확인하세요.
API 변경사항
- Foundation 수준
SwipeToDismissBox
의 이름을BasicSwipeToDismissBox
로 바꾸었습니다. 이렇게 하면 Foundation 수준 구성요소와 Material3 수준SwipeToDismissBox
간의 차이점이 더 명확해집니다. 후자는MaterialTheme
에서 스크림에 사용할 색상을 가져오고 나머지 구현을BasicSwipeToDismissBox
에 위임합니다. (Ibecfc)
버그 수정
- 성능을 개선하기 위해 Material3 버튼의 material-core 레이어가 삭제되었습니다. (I55555)
버전 1.0.0-alpha14
2023년 10월 18일
androidx.wear.compose:compose-material3:1.0.0-alpha14
이 출시되었습니다. 버전 1.0.0-alpha14에 포함된 커밋을 확인하세요.
API 변경사항
- Material3
HorizontalPageIndicator
에서indicatorStyle
매개변수가 삭제되었습니다. 대신 기기 화면 모양 (선형 또는 원형)을 따릅니다. (I83728) - 새로운
SplitToggleButtonColors
클래스를 추가하여SplitToggleButton
의 색상을ToggleButton
의 색상과 분리했습니다. (I78bee)
버전 1.0.0-alpha13
2023년 10월 4일
androidx.wear.compose:compose-material3:1.0.0-alpha13
이 출시되었습니다. 버전 1.0.0-alpha13에 포함된 커밋을 확인하세요.
API 변경사항
버전 1.0.0-alpha12
2023년 9월 20일
androidx.wear.compose:compose-material3:1.0.0-alpha12
이 출시되었습니다. 버전 1.0.0-alpha12에 포함된 커밋을 확인하세요.
API 변경사항
- Material Design 토큰을 사용하도록
IconButton
가 업데이트되었습니다. (I3f137) - Material Design 토큰을 사용하도록
IconToggleButton
가 업데이트되었습니다. (I7d263) CheckboxColors
,RadioButtonColors
,SwitchColors
의 생성자가 공개되었습니다. (I82b73)
버전 1.0.0-alpha11
2023년 9월 6일
androidx.wear.compose:compose-material3:1.0.0-alpha11
이 출시되었습니다. 버전 1.0.0-alpha11에 포함된 커밋을 확인하세요.
버그 수정
- Material3 카드 서체를
TitleMedium
로 업데이트했습니다. (I597bd) - Material3
ListHeader
및ListSubheader
의 서체와 정렬을 업데이트했습니다. (Ib5ceb)
버전 1.0.0-alpha10
2023년 8월 23일
androidx.wear.compose:compose-material3:1.0.0-alpha10
이 출시되었습니다. 버전 1.0.0-alpha10에 포함된 커밋을 확인하세요.
새로운 기능
- Wear Material3 라이브러리에
HorizontalPageIndicator
추가 (Ifee99)
API 변경사항
- Material3 디자인 토큰을 사용하도록 버튼 코드를 업데이트합니다. (I92fe4)
- 사용자 인터페이스 세부정보가 아직 최종 확정되지 않았으므로 Wear Material 3 Stepper 및 Slider API를 실험용으로 선언 (I84d54)
ExtraSmall
크기는IconButton
에만 적용되므로 라운드TextButton
및TextToggleButton
에서 삭제했습니다. (Ibc7d5)
버그 수정
- LargeButtonSize에 LabelLarge를 사용하도록 TextToggleButton의 서체에 관한 안내가 업데이트되었습니다. (Ib10fa)
- LargeButtonSize에 LabelLarge를 사용하도록 TextButton의 서체에 관한 안내가 업데이트되었습니다 (I8f3a7).
- 접근성을 위해 카드의 최소 터치 영역을 48dp로 설정했습니다. (Ieb9b1)
- 이미지가 있는 AppCard 데모를 추가하고 배경이 있는 AppCard 데모 삭제 (Id735f)
- 수정자가 올바르게 연결되지 않은 원형 버튼의 버그 수정 (I5e162)
버전 1.0.0-alpha09
2023년 8월 9일
androidx.wear.compose:compose-material3:1.0.0-alpha09
이 출시되었습니다. 버전 1.0.0-alpha09에 포함된 커밋을 확인하세요.
새로운 기능
- material3에
ToggleButton
가 추가되었습니다. (I6bed6)
API 변경사항
- 이전에 주석에 명시된
FloatRange
주석을 API 제약 조건으로 사용 설정했습니다. (Icb401) - 최신 Material3 가이드라인을 준수하도록 Wear Material3의 서체를 업데이트했습니다. (I1bad6)
버그 수정
- Material3 디자인에 따라
Button
,IconButton
,TextButton
의 색상이 업데이트되었습니다. (Ib2495) - 사용 중지된 상태에서 체크박스 선택 표시가 표시되지 않는 문제가 수정되었습니다. (Ib25bf)
버전 1.0.0-alpha08
2023년 7월 26일
androidx.wear.compose:compose-material3:1.0.0-alpha08
이 출시되었습니다. 버전 1.0.0-alpha08에 포함된 커밋을 확인하세요.
새로운 기능
- Material3용 선택 컨트롤(
Switch
,Checkbox
,RadioButton
)이 추가되었습니다. (Ib918c) - Material3에
IconToggleButton
와TextToggleButton
를 추가했습니다. 이는 각각 아이콘과 텍스트를 위한 단일 슬롯이 있는 원형 전환 버튼입니다.ToggleButton
의 크기가 다른 경우 각 전환 버튼에 제공된 크기로Modifier.touchTargetAwareSize
를 사용하는 것이 좋습니다. (I9f015) - Material3 구성요소에
ListHeader
및ListSubheader
가 추가되었습니다. (Ibaefe) - 새 Foundation
SwipeToDismissBox
를 호출하고 테마에서 기본 색상 값을 제공하는 Material3SwipeToDismissBox
가 추가되었습니다. (I275fb) - Wear Compose에 Material3
InlineSlider
가 추가되었습니다. 사용자가 값 범위에서 선택할 수 있습니다. 선택 범위는 해당 범위의 최솟값과 최댓값 사이의 막대로 표시되며, 사용자가 하나의 값을 선택할 수 있습니다.InlineSlider
는 볼륨이나 밝기 등의 설정을 조정하는 데 적합합니다. (I7085f)
API 변경사항
- Shape 대신
RoundedCornerShape
기반을 사용하도록 Wear Material 3 테마의 Shapes를 업데이트했습니다. (Idb133) - 버튼의 높이 상수를 공개로 설정했습니다 (Idbfde).
- 호환성 억제를 주석 처리하도록 API 파일을 업데이트했습니다. (I8e87a, b/287516207)
- Wear Compose Material 3의
InlineSliderColors
가 공개 생성자와 공개 속성을 갖도록 업데이트했습니다. (I6b632) - Wear Compose Material 3의 모든 색상 클래스가 공개 생성자와 공개 속성을 갖도록 업데이트했습니다. (I17702)
- 버튼 가로 및 세로 패딩 상수를 공개했습니다. (Ieeaf7)
버그 수정
- 이제 버튼은 접근성을 위한 큰 글꼴로 인해 콘텐츠가 커진 경우 필요에 따라 높이를 조정합니다 (Iaf302).
- 접근성 문제를 해결하기 위해 여러 버튼 데모가 업데이트되었습니다. (I61ce9)
- 이제
Stepper
및InlineSlider
에서 길게 누를 때 반복 클릭을 지원하므로 + 또는 - 버튼을 길게 눌러Stepper
및InlineSlider
값을 빠르게 늘리거나 줄일 수 있습니다 (I27359).
버전 1.0.0-alpha07
2023년 6월 21일
androidx.wear.compose:compose-material3:1.0.0-alpha07
이 출시되었습니다. 버전 1.0.0-alpha07에 포함된 커밋을 확인하세요.
새로운 기능
- Compose for Wear OS Material 3 라이브러리에
Stepper
구성요소를 추가했습니다. 이 버전은 이전 Material 버전과 유사하지만 개발자 의견에 따라 기본적으로 범위 시맨틱스가 생략됩니다. 범위 시맨틱이 필요한 사례를Modifier.rangeSemantics
제공합니다. (Ic39fd) - Compose for Wear OS Material 3 라이브러리에
curvedText
를 추가했습니다. (Ia8ae3)
버그 수정
wear.compose.foundation
이wear.compose.material3
의 API 종속 항목이 되도록 업데이트했습니다. (I72004, b/285404743)
버전 1.0.0-alpha06
2023년 6월 7일
androidx.wear.compose:compose-material3:1.0.0-alpha06
이 출시되었습니다. 버전 1.0.0-alpha06에 포함된 커밋을 확인하세요.
버그 수정
- 사용 중지된 올바른 알파 값을 위해
toDisabledColor
확장 함수를 사용하도록TextButton
를 업데이트했습니다. (I814c8)
버전 1.0.0-alpha05
2023년 5월 24일
androidx.wear.compose:compose-material3:1.0.0-alpha05
이 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.
새로운 기능
- 텍스트용 단일 슬롯이 있는 원형 버튼인
TextButton
이 Material3에 추가되었습니다.TextButton
의 다양한 크기에 대해서는TextButtonDefaults
에 제공된Modifier.touchTargetAwareSize
,ExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
,LargeButtonSizeIcon
를 사용하는 것이 좋습니다. 기본TextButton
에는 테두리가 없고 강조가 낮은 작업의 경우 배경이 투명합니다. 높은 강조가 필요한 작업에는filledTextButtonColors
을 사용하고, 중간 강조의 경우 윤곽선TextButton
을 사용하여 테두리를ButtonDefaults.outlinedButtonBorder
로 설정하며, 윤곽선과 채움 사이의 중간 지점에는filledTonalTextButtonColors
을 사용합니다. (I667e4) - Wear Compose Material3 라이브러리에
Card
,OutlinedCard
,AppCard
,TitleCard
가 추가되었습니다.AppCard
및TitleCard
에는CardDefaults.outlinedCardColors
및CardDefaults.outlinedCardBorder
를 사용하여 윤곽선이 표시된 모양을 부여할 수도 있습니다(I80e72).
API 변경사항
- 후행 람다 문법을 지원하기 위해 버튼 라벨 매개변수를 끝으로 이동하고 역할 매개변수를 삭제했습니다 (
Modifier.semantics
를 사용하여 재정의할 수 있으므로). 이제ButtonColors
생성자가 공개됩니다. (Ie1b6d)
버전 1.0.0-alpha04
2023년 5월 10일
androidx.wear.compose:compose-material3:1.0.0-alpha04
이 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.
새로운 기능
- Material3에 아이콘/이미지용 단일 슬롯이 있는 원형 버튼인
IconButton
가 추가되었습니다.IconButton
,FilledIconButton
,FilledTonalIconButton
,OutlinedIconButton
의 네 가지 변형이 있습니다.IconButton
의 다양한 크기에 대해서는IconButtonDefaults
에 제공된Modifier.touchTargetAwareSize
,ExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
,LargeButtonSizeIcon
를 사용하는 것이 좋습니다. 또한 지정된 버튼 크기에 권장되는 아이콘 크기를 결정하는IconButtonDefaults.iconSizeFor
도 제공합니다. (I721d4)
버전 1.0.0-alpha03
2023년 4월 19일
androidx.wear.compose:compose-material3:1.0.0-alpha03
이 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.
API 변경사항
- Material 3 버튼 구성요소가 추가되었습니다. 이 구성요소는 스타디움 모양의 버튼이며 이전에는 Wear Compose Material 라이브러리에서 칩이라고 불렸습니다 (Compose Material 3 라이브러리와의 일관성을 위해 버튼으로 이름이 변경됨). 기본 버튼은 배경이 채워져 있으며
FilledTonal
(배경이 음소거됨), 아웃라인 (얇은 테두리가 있는 투명), 하위 (투명한 배경과 테두리 없음, 가장 낮은 수준의 주목도를 가진 보조 작업에 사용됨) 버튼 변형이 있습니다. 간단한 아이콘 및 텍스트 콘텐츠용 라운드 버튼은 향후 출시에서 제공될 예정입니다.(Ia6942)
버전 1.0.0-alpha02
2023년 4월 5일
androidx.wear.compose:compose-material3:1.0.0-alpha02
이 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.
버그 수정
PlatformTextStyle.includeFontPadding
을 true (현재 설정)로 기본 설정하는DefaultTextStyle
을 Wear Compose Material 3에 추가했습니다. 이렇게 하면 향후 Compose 라이브러리와 기본적으로 글꼴 패딩을 사용 중지하는 것을 동기화할 수 있습니다 (Compose에서 배경의 글꼴 패딩 수정 참고). (I7e461)
버전 1.0.0-alpha01
2023년 3월 22일
androidx.wear.compose:compose-material3:1.0.0-alpha01
이 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.
새로운 기능
Material 3는 차세대 Material Design으로, 업데이트된 테마와 재설계된 구성요소가 포함되어 있습니다. Wear Compose의 Material 3는 Android의 Material 3 Compose 라이브러리와 일관되도록 설계되었습니다. 이 첫 번째 알파 버전에는 다음의 초기 기능 구현이 포함되어 있습니다.
Wear Material (
androidx.wear.compose:compose-material
)과 Wear Material 3 (androidx.wear.compose:compose-material3
)은 계속해서 동시에 개발될 예정입니다. 향후 Material3 출시에서는 버튼, 선택 도구, 슬라이더와 같은 Wear OS용 Compose의 다른 친숙한 구성요소를 포함하도록 위젯 세트가 확장됩니다.Wear Material 및 Wear Material 3 라이브러리는 상호 배타적이며 동일한 앱에서 혼합해서는 안 됩니다. 이는 주로 서로 다른 테마를 참조하여 예기치 않은 불일치가 발생하기 때문입니다.