Wear Compose Material 3
Update Terbaru | Rilis Stabil | Kandidat Rilis | Rilis Beta | Rilis Alfa |
---|---|---|---|---|
4 Juni 2025 | - | - | 1.5.0-beta03 | - |
Mendeklarasikan dependensi
Untuk menambahkan dependensi pada Wear, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.
Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle
bagi aplikasi atau modul Anda:
Groovy
dependencies { implementation "androidx.wear.compose:compose-foundation:1.5.0-beta03" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material3:1.5.0-beta03" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.5.0-beta03" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03") // 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-beta03") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material3:1.5.0-beta03") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.5.0-beta03") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03") // 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. }
Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.
Masukan
Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.
Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.
Wear Compose Material3 Versi 1.5
Versi 1.5.0-beta03
4 Juni 2025
androidx.wear.compose:compose-*:1.5.0-beta03
dirilis. Versi 1.5.0-beta03 berisi commit ini.
Perubahan API
OpenOnPhoneDialog
kini hanya mengumumkan teks pesan di bawah TalkBack, dan melewati semantik ikon.OpenOnPhoneDialogDefaults
telah diperbarui untuk menghapus parametericonContentDescription
dancontentDescription
dariicon()
. Selain itu,ConfirmationDialogDefaults
kini memiliki parameter pengubah pada composableSuccessIcon
danFailureIcon
. (Id2ae2)
Perbaikan Bug
- Mengubah urutan penerapan efek parameter
SurfaceTransformation
. Sebelumnya, transformasi yang diterapkan ke komponen Wear Material3 dilakukan sebagai berikut: pelukis latar belakang, transformasi penampung, transformasi konten. Sekarang, 2 yang pertama terbalik, dan kita menerapkan pengubah yang diteruskan di antara keduanya, sehingga terpengaruh oleh transformasi penampung. Hal ini memperbaiki kasus seperti menggunakan efek shimmer placeholder dengan elemen di TLC menggunakan parameter transformasi. (I786cf) RevealState.Saver
ditambahkan untuk digunakan memulihkan statusSwipeToReveal
saat aktivitas atau proses dibuat ulang. FungsirememberRevealState
kini menggunakan Penghemat ini secara default. (Ie0ecb)- Tombol tindakan utama dan sekunder
SwipeToReveal
harus ditetapkan secara default keButtonDefault.Height
(memperbaiki bug saat tombol ini mengisi tinggi maksimum untuk tombol yang lebih tinggi). (Ibfba1) - Mengubah
SwipeToReveal
untuk mereset komponen terakhir yang berinteraksi, saat gestur geser ke kanan dilakukan. (Ia8450) SwipeToReveal
diubah untuk menetapkan statusRevealing
saat posisi akhir geser berada di antara anchor yang ditampilkan dan yang ditampilkan, dan lebih dekat ke anchor yang Ditampilkan. (If4458)- Sekarang konten
ButtonGroup
dibalik dengan benar dalam tata letak RTL (Ib378d) AnimatedText
kini mendukung arah teks RTL (I4533c)TransformingLazyColumn
kini mengubah ukuran item dengan benar saat item bawah dihapus (Idacab)TransformingLazyColumn
kini hanya melakukan satu pengukuran, yang meningkatkan performa dengan mengurangi waktu frame. (I501a1)
Versi 1.5.0-beta02
20 Mei 2025
androidx.wear.compose:compose-*:1.5.0-beta02
dirilis. Versi 1.5.0-beta02 berisi commit ini.
Perbaikan Bug
- Memperbarui profil dasar pengukuran untuk library foundation, material, & material3. (I53f06)
- Memperbaiki bug di
TransformingLazyColumn
, saat item diubah ukurannya saat item bawah dihapus. (Idacab) - Memperbaiki bug pada
TransformingLazyColumn
, saat daftar macet di bagian atas atau bawah daftar. (I49d00) OpenOnPhoneDialog
di TalkBack harus mengumumkan teks melengkung, bukan deskripsi konten ikon. (I4efe8)- Memperbaiki bug di
SwipeToReveal
yang akan melaporkan anchor yang salah diRevealState.currentValue
saathasPartiallyRevealedState
ditetapkan ke salah. (I9c7cf) - Tombol urungkan
SwipeToReveal
kini menjadiButtonDefaults.Height
secara default. (I1f6c8) - Performa
BasicSwipeToDismissBox
telah ditingkatkan dengan menghilangkan penggunaan Kanvas untuk menggambar scrim. (I68f2c) - Memperbaiki bug aksesibilitas di penggeser, saat persentase yang diumumkan tidak cocok dengan nilai setelah update (I91146)
- Memperbaiki bug pada penerapan
placeholderShimmer
. (Iee39b - Performa
TransformingLazyColumn
telah ditingkatkan, dengan mengoptimalkan penghitunganScrollProgress
sebesar 30%. (I4c4cb)
Versi 1.5.0-beta01
7 Mei 2025
androidx.wear.compose:compose-*:1.5.0-beta01
dirilis. Versi 1.5.0-beta01 berisi commit ini.
Rilis Compose untuk Wear OS 1.5.0-beta01 menunjukkan bahwa rilis library ini sudah berfitur lengkap dan API dikunci (kecuali jika ditandai sebagai eksperimental).
Wear Compose 1.5.0-beta01 menyertakan library Wear Compose Material3, yang mendukung sistem desain UI baru yang disebut Material 3 Ekspresif. Sebaiknya upgrade dari Material ke Material3 untuk menggunakan desain visual baru di aplikasi, dan mendapatkan manfaat dari komponen baru sebagai berikut:
MaterialTheme
untuk skema warna, tipografi, dan bentuk yang diperbarui dan diperluas untuk memberikan kedalaman dan variasi pada desain Anda.- Penerapan Tema Warna Dinamis yang otomatis menghasilkan skema warna untuk aplikasi Anda agar cocok dengan warna tampilan jam.
- Komponen baru secara otomatis beradaptasi dengan ukuran layar yang lebih besar secara default
- Shape Morphing - komponen tombol bulat seperti
IconButton
,TextButton
,IconToggleButton
, danTextToggleButton
mendukung variasi yang dianimasikan saat ditekan atau dicentang. EdgeButton
- tombol baru yang menempel di tepi dengan bentuk khusus yang dirancang untuk bagian bawah layar.- Scaffold - memperkenalkan
AppScaffold
danScreenScaffold
untuk menata struktur layar dan mengoordinasikan animasiScrollIndicator
danTimeText
. - Tombol - banyak tombol berbentuk elips didukung dengan penampung satu slot yang fleksibel dan variasi multi-slot untuk tombol dengan ikon dan label.
CheckboxButton
danSwitchButton
disediakan saat tombol tombol diperlukan, sedangkanRadioButton
adalah tombol pilihan yang tersedia (variasi 'Pisahkan' dari tombol tombol dan tombol pilihan juga disediakan). ButtonGroup
- menerapkan grup tombol ekspresif dalam baris yang berubah bentuk saat disentuh.- Variasi
AlertDialog
mendukung tombol ok/batal atauEdgeButton
. ConfirmationDialog
tersedia untuk menampilkan pesan dengan waktu tunggu, yang mendukung animasi khusus untuk variasi sukses, gagal, dan buka di ponsel.- Pemilih - Variasi
TimePicker
danDatePicker
didukung serta komponen Pemilih danPickerGroup
untuk mem-build layar pemilih Anda sendiri. ProgressIndicators
- indikator progres melingkar dan linear didukung (CircularProgressIndicator
memiliki variasi tersegmentasi dan tidak ditentukan).- Kartu - sejumlah variasi kartu tersedia, termasuk
TitleCard
yang menawarkan tata letak tertentu untuk kartu dengan slot judul, waktu, subtitel, atau konten.TitleCard
juga dapat diberi latar belakang gambar untuk memperkuat makna informasi dalam kartu. - Pengatur halaman - Komponen
HorizontalPagerScaffold
,VerticalPagerScaffold
, danAnimatedPage
mengoordinasikan animasiHorizontalPageIndicator
danVerticalPagerIndicator
.HorizontalPager
danVerticalPager
dirilis di library Wear Compose Foundation. - Placeholder - menggambar bentuk kerangka di atas komponen, untuk situasi saat tidak ada konten sementara yang tersedia.
- Penggeser dan Stepper - penggeser dan stepper memungkinkan pengguna membuat pilihan dari rentang nilai. Penggeser lebih ringkas dan dapat disegmentasikan, sedangkan Stepper adalah komponen layar penuh yang biasanya disambungkan dengan
StepperLevelIndicator
. SwipeToReveal
- digunakan untuk menambahkan tindakan tambahan ke composable saat digeser dari kanan ke kiri.
Selain itu, Wear Compose Foundation 1.5.0-beta01 menyertakan komponen baru berikut:
TransformingLazyColumn
- daftar scroll vertikal lambat yang mendukung animasi penskalaan dan perubahan bentuk- Grup Fokus Hierarkis - digunakan untuk menganotasi composable dalam aplikasi, untuk melacak bagian aktif komposisi dan mengoordinasikan fokus.
- Pager - Komponen
HorizontalPager
danVerticalPager
, yang dibuat pada komponen Compose Foundation dengan peningkatan khusus Wear untuk meningkatkan performa dan kepatuhan terhadap panduan Wear OS.
Perubahan API
- Memperbarui Hierarchical Focus API - mengganti nama
Modifier.hierarchicalFocus
menjadiModifier.hierarchicalFocusGroup
dan menghapus parameter callback; menghapus overloadModifier.hierarchicalFocusRequester
dengan parameterFocusRequester
; membuatCompositionLocal
,LocalScreenIsActive
baru sehingga komponen dapat menginformasikan dan memeriksa layar mana yang aktif. (I5ff7c). - Tidak lagi menggunakan
SwipeToReveal
dari Wear Compose Foundation dan menggunakanSwipeToReveal
API di Wear Compose Material dan Wear Compose Material3. Ganti imporSwipeToReveal
Wear Foundation dengan impor Wear Compose Material/ Wear Compose Material3 untuk terus menggunakan API. (Ia147d). - Dependensi
SwipeToReveal
Wear Compose Material3 di Foundation dipindahkan ke paket material3, misalnyaRevealValue
,RevealDirection
,RevealActionType
,RevealState
,rememberRevealState
. Developer harus mengubah impor class dan fungsi ini dariandroidx.wear.compose.foundation
menjadiandroidx.wear.compose.material3
. (I640e6). - Memperbarui Wear Compose Material3
SwipeToReveal
API sebagai berikut: menambahkan parameterprimaryAction
,onFullSwipe
,secondaryAction
,undoPrimaryAction
,undoSecondaryAction
, danhasPartiallyRevealedState
ke composableSwipeToReveal
; menghapus kemampuan untuk menyesuaikanpositionalThreshold
dananimationSpec
dariRevealState
; menghapuslastActionType
,revealThreshold
, dan lebar dariRevealState
; mengubah konstruktorRevealState
untuk menerimaRevealDirection
, bukan anchor; menghapus fungsicreateRevealAnchors
, anchor, danbidirectionalAnchors
; fungsiSwipeToRevealScope
primaryAction
,secondaryAction
,undoPrimaryAction
, danundoSecondaryAction
diganti namanya menjadiPrimaryActionButton
,SecondaryActionButton
,UndoActionButton
, dan dibuat menjadi fungsi Composable; menandaiRevealActionType
sebagai internal. (I885d0). SwipeToReveal
API yang diperbarui lebih lanjut sebagai berikut: mengganti namaonFullSwipe
menjadionSwipePrimaryAction
; mengganti namaSwipeToRevealNonAnchoredSample
untuk menunjukkan penggunaan parameterhasPartiallyRevealedState
; menghapusactionButtonHeight
, karena default-nya adalah tinggi default Tombol dan tinggi yang lebih besar dapat ditetapkan menggunakan pengubah; menghapusSmallActionButtonHeight
dariSwipeToRevealDefaults
; membuat parameter nilai di konstruktorRevealValue
danRevealDirection
bersifat pribadi. (I465ce).
Perbaikan Bug
- Memperbaiki penanganan
EdgeButton
ScreenScaffold
sehingga, setelah itemTransformingLazyColumn
dihapus,EdgeButton
akan dianimasikan ke tempatnya. (I6d366). - Memperbarui dependensi Wear Compose pada library Compose ke versi 1.8.0. (I2ef3f).
- Memperbarui gerakan
CircularProgressIndicator
yang tidak ditentukan sehingga tidak lagi mengalami regresi untuk sementara. (Ieddb1). - Memperbaiki bug
SwipeDismissableNavHost
- fokus tidak beralih dengan benar setelah menggeser kembali, sehingga menyebabkan input putar gagal (ini untuk API 36+, yang menggunakan kembali prediktif). (Ieddb1). - Dokumentasi yang diubah untuk Hierarchical Focus API (Idf2ff).
- Memperbarui dokumentasi untuk Tombol dan Kartu untuk menyatakan cara
containerPainter
dandisabledContainerPainter
mengganticontainerColor
dandisabledContainerColor
(I4a453). - Mengembalikan perubahan ke
TimeText
di rilis sebelumnya yang memindahkanBroadcastReceiver
ke thread pekerja, karena menyebabkan masalah bagi aplikasi yang mengelola threading-nya sendiri selama navigasi. (I34d02). - Memperbarui contoh Pemilih untuk menghapus panggilan remember yang tidak perlu dan sebagai gantinya menggunakan
rememberUpdatedState
di Pemilih untuk mengingat fungsi lambdacontentDescription
terbaru. (Icb5b1). - Memperbarui gaya teks di
TimePicker
danDatePicker
sehingga perubahan font tidak lagi menyebabkan pemotongan. (I26194). ListHeader
danListSubHeader
kini mengubah perataan teks default menjadi rata tengah dan rata awal. (I78339).- Memperbarui contoh dan demo Swipe to Reveal Foundation dan Material untuk mengumumkan tindakan aksesibilitas kustom (tindakan kustom harus ditambahkan sebagai semantik pada konten, bukan pada composable
SwipeToReveal
itu sendiri). (Ie92a3). - Memperbarui
MaxLines
default yang ditetapkan pada kontenEdgeButton
sesuai dengan ukurannya - sekarang menjadi 1 untuk ekstra kecil, 2 untuk kecil dan sedang, dan 3 untuk besar. (Ie35f6). - Menyederhanakan
LocalReduceMotion
sehingga observer hanya didaftarkan satu kali, untuk meningkatkan performa. (Ib1979). - Meminimalkan jumlah gambar ulang di
ScrollIndicator
, untuk meningkatkan performa. (Ia7a67). - Memperbaiki bug di
TransformingLazyColumn
, saat item atas yang terlihat dalam daftar tidak diskalakan dengan benar saat EdgeButton mencapai tingginya yang penuh. (I30580).
Wear Compose Material3 Versi 1.0
Versi 1.0.0-alpha37
23 April 2025
androidx.wear.compose:compose-material3:1.0.0-alpha37
dirilis. Versi 1.0.0-alpha37 berisi commit ini.
Perubahan API
- Menghapus
scrollTransform
dari platform API publik. Gunakan kombinasi pengubahtransformedHeight
dangraphicsLayer
jika Anda perlu mendapatkan fungsi yang sama. (Ie181d) - Mengganti composable
ImageButton
danImageCard
dengan overloadButton
danCard/TitleCard
. Mengganti namaimageButtonColors
menjadibuttonWithContainerPainterColors
, danimageCardColors
menjadicardWithContainerPainterColors
. MenambahkanButtonDefaults.scrimBrush
danCardDefaults.scrimBrush
publik. Mengganti nama tombolimageBackgroundGradientStartColor
danimageBackgroundGradientEndColor
menjadiscrimGradientStartColor
danscrimGradientEndColor
. Mengganti namaCardDefaults.ImageContentPadding
menjadiCardDefaults.CardWithContainerPainterContentPadding
(I7b8b6) Picker
danPickerGroup
kini menggunakancontentDescription
sebagai lambda untuk menghindari rekomposisi yang tidak perlu. (I002dd)
Perbaikan Bug
- Memperbaiki masalah saat
CircularProgressIndicator
yang tidak ditentukan akan bergoyang selama animasi jika lebar tidak sama dengan tinggi. (I76bfe) - Memperbaiki masalah tata letak tombol tepi pada ukuran yang tidak valid. Sekarang mencegah pembaruan tata letak tombol tepi saat tingginya NaN. (I32b93)
- Meningkatkan sudut sapuan maksimum di
OpenOnPhoneDialog
sehingga teks 'Periksa ponsel Anda' default tidak terpotong dengan ukuran font terbesar. (I90af9)
Versi 1.0.0-alpha36
9 April 2025
androidx.wear.compose:compose-material3:1.0.0-alpha36
dirilis. Versi 1.0.0-alpha36 berisi commit ini.
Perubahan API
- Mengganti
ButtonDefaults.imageBackgroundButtonColors
denganImageButton
,ButtonDefaults.imageButtonColors
,ButtonDefaults.containerPainter
, danButtonDefaults.disabledContainerPainter
. Dan perubahan serupa untuk Kartu. Painter dihapus dariButtonColors
danCardColors
. (I8c6a1) - Memperbarui placeholder untuk menyederhanakan API. Sekarang kita menyediakan dua Pengubah,
Modifier.placeholderShimmer
untuk menerapkan efek shimmer di tingkat komponen, danModifier.placeholder
untuk menerapkan mask di atas konten yang tidak dimuat (Iaee7a)
Perbaikan Bug
- Mengintegrasikan overscroll ke dalam
ScrollIndicator
. (Icfb7f) - Atasi latar belakang kosong dan dialog yang tidak ada saat meluncurkan dialog material3. (Ice597)
- Memperbaiki masalah di
FadingExpandingLabel
saat teks mencakup beberapa baris. (I04eb7) - Memperbarui padding antara label utama dan sekunder pada tombol. (I99b7b)
ArcLarge
telah dikurangi dari20sp
menjadi18sp
, dan spasi huruf padaArcLarge
danArcSmall
telah diperbarui.ConfirmationDialog
/OpenOnPhoneDialog
kini menggunakanArcLarge
default, bukan menggantinya dengan18sp
. (Id39a8)
Update Dependensi
- Library ini kini menargetkan tingkat bahasa Kotlin 2.0 dan memerlukan KGP 2.0.0 atau yang lebih baru. (Idb6b5)
Versi 1.0.0-alpha35
26 Maret 2025
androidx.wear.compose:compose-material3:1.0.0-alpha35
dirilis. Versi 1.0.0-alpha35 berisi commit ini.
Perubahan API
AlertDialog
padding atas kini dikurangi secara default saat ikon disediakan - hal ini akan memanfaatkan ukuran layar yang tersedia dengan sebaik mungkin. (Ief06c)PagerScaffoldDefaults.FadeOutAnimation
diganti namanya menjadiPagerScaffoldDefaults.FadeOutAnimationSpec
. Parameter halaman diAnimatedPage
telah diganti namanya menjadipageIndex
. (I701f2)- Memperbarui penamaan untuk
SurfaceTransformation
TransformingLazyColumn
-applyTransformation
yang dibagi menjadiapplyContainerTransformation
danapplyContentTransformation
, serta mengganti namacreateBackgroundPainter
menjadicreateContainerPainter
. Pembaruan penamaan lebih lanjut keTransformationSpec
danResponsiveTransformationSpec
. (I1c534) AppScaffold backgroundColor
diganti namanya menjadicontainerColor
. (I4e63f)
Perbaikan Bug
- Memperbaiki masalah di
FadingExpandingLabel
saat teks tidak selalu diperluas dengan benar. (I0e773) ArcLarge
telah dikurangi dari 20sp menjadi 18sp, dan spasi huruf diArcLarge
danArcSmall
telah diperbarui.ConfirmationDialog/OpenOnPhoneDialog
kini menggunakanArcLarge
default, bukan menggantinya menjadi 18sp. (Id39a8)- Memperbarui animasi judul untuk
DatePicker
danTimePicker
, sehingga animasi memudar dan muncul berfungsi sebagai satu animasi Spring. (I68963) - Mengoptimalkan
PagerScaffold
dengan menghindari pembacaancurrentPageOffsetFraction
dalam composableAnimatedPage
. (I433ef) - Semua skala huruf telah diperbarui agar memiliki angka proporsional secara default, karena hal tersebut dianggap sebagai kasus penggunaan yang paling sering dan menetapkan secara default ke tabel menyebabkan terlalu banyak spasi di antara pasangan angka tertentu.
TimePicker
danDatePicker
terus menerapkanFontFeatureSetting=tnum
untuk angka tabel. (I88929) - Memperbaiki fokus input RSB awal untuk
TimePicker
danDatePicker
. (I1c773) - Memperbarui teks default di
OpenOnPhoneDialog
menjadi "Periksa ponsel Anda". (I00a3f) - Memperbarui bobot untuk
ArcLarge
danArcMedium
dari 600 menjadi 599 untuk mengatasi masalah saat bobot 600 diperlakukan sebagai tebal (I2a51d) - Perbarui padding
SwipeToReveal
antara konten dan tombol tindakan, serta padding antara ikon dan teks tombol tindakan. (Ic46cb)
Versi 1.0.0-alpha34
12 Maret 2025
androidx.wear.compose:compose-material3:1.0.0-alpha34
dirilis. Versi 1.0.0-alpha34 berisi commit ini.
Perubahan API
PagerScaffold
tidak lagi memunculkan komponenPager
- sebagai gantinya, komponen ini harus disediakan melalui Composablecontent
.AnimatedPage
dansnapWithSpringFlingBehaviour
kini bersifat publik dan dapat digunakan bersama dengan Wear FoundationPager
untuk mencapai perilakuPagerScaffold
M3 sebelumnya. (Lihat contoh yang diperbarui). (Ia4724)- Memperbarui
PagerState
, menghapus Compose FoundationPagerState
sebagai class dasar dan menambahkan properticurrentPage
,currentPageOffsetFraction
, danpageCount
. Memperbarui antarmukaGestureInclusion
, mengganti nama metode menjadiignoreGestureStart
. (I4ae07) - Parameter sudut sapuan
LevelIndicator
kini dianotasikan denganFloatRange(0, 360)
(I7e636) - Kami telah menambahkan
CurvedModifier.clearAndSetSemantics
untuk menyediakan cara agar semantik melengkung dapat dinonaktifkan.CurvedText
terus menetapkan deskripsi konten secara default ke teks, tetapitimeTextCurvedText
dantimeTextSeparator
kini tidak mengumumkan kontennya. (I4b568) - Menambahkan parameter warna latar belakang dan konten default ke
AppScaffold
. (I56652) - Penanganan default gestur geser
HorizontalPager
telah diganti namanya menjadiPagerDefaults.gestureInclusion
. Perilaku default sekarang hanya mengabaikan gestur geser yang dimulai di tepi kiri halaman pertama, dan hanya saat Talkback dinonaktifkan. Dalam kasus lain, perilaku defaultnya adalah gestur geser tidak akan diabaikan oleh pager, sehingga tidak akan tersedia untuk pengendali geser-untuk-menutup. (Iee486) - Menambahkan parameter
SurfaceTransformation
ke komponen header tombol, kartu, dan daftar, sehingga komponen tersebut dapat menerapkan transformasi konten dan latar belakang yang berbeda saat digunakan dalam penampung yang mengubah tampilan item berdasarkan posisinya, sepertiTransformingLazyColumn
. (Iabe3f) - Kami telah memperbarui properti 'public const val' di Wear Compose Material3 API menjadi 'public val', untuk menghindari nilai yang disisipkan. (Ib0f32)
- Menambahkan dukungan untuk zona geser tepi ke
SwipeToReveal
. Perilaku default FoundationSwipeToReveal
kini tidak mengizinkan geser saat gestur dimulai dari tepi. Perilaku defaultSwipeToReveal’
Material3 kini tidak mengizinkan geser saat gestur dimulai dari tepi, saatSwipeDirection
disetel ke satu arah. (I32ef0) - Menambahkan composable
FadingExpandingLabel
, yang memungkinkannya memudar dalam teks dengan animasi baris demi baris. (Ic60fa) TransformingLazyColumn
kini menggunakancontentPadding
kosong secara default, bukan menempatkan item pertama dan terakhir ke tengah. (I77ab7)- Menghapus
rememberRevealState
SwipeToReveal
dari library Wear Compose Material3. (I8c0e0)
Perbaikan Bug
- Library Wear Compose telah diupdate ke compiler Kotlin 2.0. (I2de79)
- Dukungan untuk
ScrollIndicator
danPageIndicator
non-bulat telah dihapus dari Material3. Dukungan layar persegi juga tidak lagi menjadi bagian dari persyaratan Wear OS. Lihat Panduan memulai untuk mengetahui informasi selengkapnya. (I9a852) CurvedTextStyle
yang digunakan diConfirmationDialogDefaults
danOpenOnPhoneDialogDefaults
telah diperbarui untuk menggunakan tipografiArcLarge
dengan ukuran18sp
dan spasi huruf1.8sp
. (Ic9ced)Card
,ListHeader
,RadioButton
,CheckboxButton
,SwitchButton
tidak lagi membatasi tinggi kontennya secara default. Jika perlu, gunakanModifier.height(IntrinsicSize.Min)
untuk memulihkan perilaku sebelumnya jika diperlukan. (I80bb8)- Kami telah memperbarui warna
TimeText
danScrollIndicator
default untuk menyertakan lebih banyak tone abu-abu, karena penggunaanOnBackground
(putih) secara langsung memiliki terlalu banyak bobot visual saat bersaing dengan konten lain di layar seperti judul. (I8b36f) - Kami telah mengurangi waktu tunggu untuk menganimasikan
TimeText
danScrollIndicator
dalam komponen scaffold menjadi 2 detik. (I52021) - Kami telah memperbarui gerakan Dialog sehingga skala latar belakang Dialog disinkronkan dengan menggeser untuk menutup. (I925a9)
- Menambahkan demo
SwipeToReveal
M3 menggunakan pengubahedgeSwipeToDismiss
. (I02b07) - Kami telah menambahkan judul ke
DatePicker
danTimePicker
di bagian TalkBack sehingga pengguna diberi tahu untuk men-scroll guna menetapkan tanggal/waktu. (Id738d) AnimatedText
kini mengikuti setelan kurangi gerakan. (Ib6578)- Pengoptimalan untuk menggunakan
AppScaffold
untuk konten Dialog tampilan telah ditingkatkan agar beberapa dialog dapat ditampilkan di atas satu sama lain (I1209c)
Versi 1.0.0-alpha33
26 Februari 2025
androidx.wear.compose:compose-material3:1.0.0-alpha33
dirilis. Versi 1.0.0-alpha33 berisi commit ini.
Perubahan API
- Kami telah menghapus parameter label dari
primaryAction
dansecondaryAction
SwipeToRevealScope
. Semantik tindakan kustom harus ditambahkan ke konten komponenSwipeToReveal
secara langsung oleh developer. (Ia67f3) - Kami telah menghapus awalan 'Button' dari ukuran, gaya teks, dan fungsi warna di
IconToggleButtonDefaults
danTextToggleButtonDefaults
(I5471d) - Kami telah menghapus
LocalMinimumInteractiveComponentEnforcement
eksperimental (I4ad8a) - Kami telah mengganti DSL
PickerGroupScope
dengan composable. Dengan demikian, kami menghapus metodepickerGroupItem
dariPickerGroupScope
, dan menambahkan@Composable PickerGroupItem
yang harus digunakan untuk menambahkan Picker kePickerGroup
. Kami juga memperbarui jenis parameter 'content'PickerGroup
menjadi@Composable PickerGroupScope.() -> Unit
. (Ic6aec) - Kami telah menambahkan overload
LevelIndicator
untuk nilai pecahan dan menambahkan awalan Stepper ke overload yang menyertakan parameter rentang (yang cocok untuk digunakan dengan komponen Stepper). (If4234) - Kami telah menambahkan
TransformationSpec
TransformingLazyColumn
ke API, yang memungkinkan definisi transformasi yang tepat terjadi pada item saat di-scroll melalui TLC. (I21856) - Kami telah memperbarui
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
, danTextToggleButtonShapes
agar konsisten dengan class compose/material3 (I5a081) - Kami telah menambahkan parameter
overscrollEffect
keScalingLazyColumn
,TransformingLazyColumn
, danScreenScaffold
. (I0cee8) - Kami telah mengganti nama parameter
swipeDirection
menjadirevealDirection
dirememberRevealState
. (I7472f) - Wear Pager kini memiliki
PagerScope
-nya sendiri, bukan menggunakanPagerScope
Compose. (I9195b) - Kami telah menghapus composable
LinearProgressIndicatorContent
. GunakanLinearProgressIndicator
secara langsung agar perubahan pada nilai dianimasikan secara default. (I2c4ad) - Kami telah menghapus composable
CircularProgressIndicatorStatic
dan menambahkan fungsiDrawScope
publikdrawCircularProgressIndicator
dengan fungsi yang sama. GunakanCircularProgressIndicator
secara langsung sehingga perubahan dianimasikan secara default, tetapi build composable Anda sendiri daridrawCircularProgressIndicator
jika animasi kustom diperlukan. (Ie762f) - Kami telah mengurutkan ulang parameter di
DrawScope.drawCircularProgressIndicator
untuk memindahkan parametertargetProgress
ke atas. (I8ab92) - API
OpenOnPhoneDialog
telah diperbarui agar lebih jelas dan konsisten dengan Dialog lainnya. Parametershow
diganti namanya menjadivisible
dancurvedText
kini disediakan oleh pemanggil, bukan memiliki nilai default. (Idec2d) - Kami telah mengganti nama
openOnPhoneCurvedText
menjadiopenOnPhoneDialogCurvedText
(I65bdd) - Kami telah menambahkan
ScrollIndicatorColors
untuk memberikan warna kustom keScrollIndicator
. (I9eb8c) - Mengizinkan konfigurasi warna yang digunakan untuk menggambar latar belakang di belakang
TimeText
. (I9f5d9) - Memperbarui tipografi
ArcLarge
,ArcMedium
, danArcSmall
menjadiCurvedTextStyle
(Iffc41) - Kami telah menghapus
ScreenScaffoldDefaults.contentPaddingWithEdgeButton
. (Ia923e) - Kami telah menambahkan
errorDim
keColorScheme
, untuk error prioritas tinggi atau tindakan darurat seperti notifikasi keselamatan, overlay dialog yang gagal, atau tombol berhenti. (I70998)
Perbaikan Bug
- Kami telah menyematkan
wear.compose.material3
keandroidx.core.core
versi 1.15.0 (I132e9) - Kami telah meningkatkan performa Dialog dengan menggunakan
AppScaffold
untuk melapisi dialog di atas konten layar lainnya (I1b9a4) - Mengurangi padding vertikal internal
EdgeButton
. (I1a5bb) - Kami telah menambahkan semantik Tombol ke tombol Penggeser. (I80cc6)
Versi 1.0.0-alpha32
29 Januari 2025
androidx.wear.compose:compose-material3:1.0.0-alpha32
dirilis. Versi 1.0.0-alpha32 berisi commit ini.
Perubahan API
- Di
CurvedTextStyle
, kita telah membagi spasi huruf menjadi spasi huruf searah jarum jam dan spasi huruf berlawanan arah jarum jam. Hal ini diperlukan karena huruf searah jarum jam menyebar dari dasar garis, sedangkan huruf berlawanan arah jarum jam berkumpul (sehingga diperlukan spasi huruf yang lebih besar) (I4b848) - Kami telah memperbarui
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
, danTextToggleButtonShapes
untuk meningkatkan konsistensi di seluruh library Material3. Perubahan ini juga memperkenalkan penyimpanan dalam cache bentuk untuk mengurangi jumlah alokasi. (I049fc) - Kami telah menghapus parameter
pressedShapeCornerSizeFraction
dari metodevariantAnimatedShape
diIconToggleButton
danTextToggleButton
(I58a65) - Kami memperkenalkan peningkatan pada rendering teks melengkung (termasuk
TimeText
) yang tidak kompatibel dengan layar non-bulat. Dukungan layar non-bulat juga tidak lagi menjadi bagian dari persyaratan Wear OS. Lihat Panduan memulai untuk mengetahui informasi selengkapnya. (I1cc1c) - Kami telah memperbarui
ButtonGroupScope
ButtonGroup
, menggantiButtonGroupItem
berbasis DSL denganModifier.weight
,Modifier.minWidth
, danModifier.enlargeOnPress
. (I16c3c) - Di
ButtonGroup
API, kami telah memperbaruiButtonGroupScope
berbasis pengubah baru:enlargeOnPress
kini disebutanimateWidth
, dan memerlukanInteractionSource
, bukanMutableInteractionSource
karena tidak perlu memutasinya. Kami juga telah menambahkan konstanta publikButtonGroupDefaults.DefaultMinWidth
, lebar minimum default tombol diButtonGroup
. (Ie27ec) - Kami telah memperbarui
ListHeaderDefaults.contentColor
agar dimulai dengan huruf kecil karena merupakan properti composable (I125a5) - Kami telah menambahkan parameter deskripsi konten ke
SliderDefaults.DecreaseIcon
danSliderDefaults.IncreaseIcon
, dengan nilai default yang sesuai (I2e1a7) - Kami telah mengganti nama parameter
spacing
diPicker
danPickerGroup
menjadiverticalSpacing
(Ib75cc) - Kami telah menghapus
ConfirmationDialogDefaults.successText
danfailureText
karena diharapkan pemanggilConfirmationDialog
akan memberikan string dengan lebih banyak konteks. Mengganti namaconfirmationCurvedText
menjadiconfirmationDialogCurvedText
. Terakhir, ganti nama parametershow
Dialog menjadi terlihat agar konsisten dengan update terbaru lainnya pada dialog. (I10074) IconButton
mengganti namadisabledImageOpacity
menjadiDisabledImageOpacity
. (I5f94a)
Perbaikan Bug
- Kami telah memperbaiki bug dalam animasi
EdgeButton
sehingga ukuran yang benar digunakan di setiap frame (Id3b58) - Memperbaiki masalah terkait
animateContentSize
yang tidak berfungsi denganButton
. (Ib18a0) - Kami telah mengubah skala jenis Judul Besar agar memiliki ukuran font
18dp
(Ic9d52) - Kami telah memperbarui spasi
AlertDialog
dan ukuran ikon (Iac28c) - Kami telah memperbaiki inkonsistensi pada titik henti sementara layar besar (layar pada dan di atas 225 dp adalah layar besar) (I36474)
- Memperbaiki bug minor dalam pemosisian tombol (I952c2)
Versi 1.0.0-alpha31
15 Januari 2025
androidx.wear.compose:compose-material3:1.0.0-alpha31
dirilis. Versi 1.0.0-alpha31 berisi commit ini.
Perubahan API
- Kami telah mengupdate semua library Wear Compose ke mode 'API eksplisit'. (Iebf9f)
- Kami telah mengupdate
ScreenScaffold
danEdgeButton
API, sehingga lebih mudah untuk menentukan padding konten di layar yang menyertakanEdgeButton
. Di API baru,size
EdgeButton
hanya diteruskan keEdgeButton
, danScreenScaffold
menggunakan parameteredgeButtonSpacing
untuk spasi antaraEdgeButton
dan konten daftar. (I424fd) - Di
DatePicker
, kami telah mengganti nama parameterminDate
menjadimaxDate
, danminValidDate
menjadimaxValidDate
. DiDatePickerColors
, kami telah mengganti nama parameterselectedPickerContentColor
menjadiactivePickerContentColor
, danunselectedPickerContentColor
menjadiinactivePickerContentColor
(Iba17b) - Kami telah memperbarui default
ArcProgressIndicator
menjadistrokeWidth=6dp
dan merekomendasikandiameter = 81.24%
untuk tinggi layar (I6f248) - Kami telah memperbarui Confirmation API untuk mencerminkan penggunaannya sebagai dialog. Composable kini disebut
ConfirmationDialog
, dengan pembaruan terkait penamaan warna dan class default. Kami juga telah mengganti nama parametershow
menjadivisible
untuk kompatibilitas dengan API animasi Compose lainnya. Selain itu, kami telah menyediakanConfirmationDialogContent
,SuccessConfirmationDialogContent
,FailureConfirmationDialogContent
untuk situasi saat developer perlu menyesuaikan animasi dialog pengantar/penutup. (Iaeb33) - Kami telah memperbarui
CircularProgressIndicatorContent
keCircularProgressIndicatorStatic
(variasiCircularProgressIndicator
yang tidak dianimasikan) sehingga sekarang dapat digunakan untuk mem-buildCircularProgressIndicator
dengan animasi kustom. (I1346f) - Kami telah memperbaiki urutan parameter di
ArcProgressIndicator
, dengan menempatkan parameter pengubah terlebih dahulu (I4656a) - Meningkatkan
SwipeToReveal
API untuk menerima parameter slot teks untuk label tindakan (kecuali tindakan sekunder) dan menghapus parameter label dari tindakan undo (I5b3db)
Perbaikan Bug
- Kami telah memperbaiki bug yang menyebabkan haptik
LongPress
dipicu lebih dari sekali diButton
,Card
,IconButton
,TextButton
(Ia8b0f) - Perubahan pada UX
AlertDialog
- di perangkat layar besar, tombol konfirmasi dan tutup kini lebih kecil. Jarak di bawah tombol konfirmasi dan tutup juga diperbesar. (I4f066) - Kami telah mengubah spesifikasi animasi label tombol tindakan komponen
SwipeToReveal
. (Ib87fb) - Mengubah
SwipeToReveal
untuk meluaskan penampung bersamaan dengan teks yang ditampilkan. (I44cf8) - Meningkatkan
SwipeToReveal
untuk melakukan respons haptik saat geser melewati nilai minimum tempat tindakan utama dilakukan. (I23efe) - Kami telah memperbarui
SwipeToReveal
untuk menampilkan elipsis pada tambahan teks secara default, untuk tindakan utama dan urungkan. (I71f5a) - Kami telah memperbaiki masalah yang menyebabkan jitter pada animasi
ButtonGroup
. (I63f8f) - Kami telah menambahkan semantik teks ke
AnimatedText
(I6063c) - Dialog kini mereset penskalaan latar belakang saat dialog dihapus dari komposisi (tanpa perbaikan ini, layar peluncuran mungkin dibiarkan dalam status yang diperkecil) (Id24ac)
- Kami telah menambahkan animasi morph bentuk ke tombol di komponen Stepper (Id6ed3)
Versi 1.0.0-alpha30
11 Desember 2024
androidx.wear.compose:compose-material3:1.0.0-alpha30
dirilis. Versi 1.0.0-alpha30 berisi commit ini.
Perubahan API
- Pengubah
scrollTransform
untukTransformingLazyColumn
difaktorkan ulang yang memicu perubahan API. (I0c6dc) - Kami telah memperbarui
IconToggleButtonShapes
danTextToggleButtonShapes
agar memiliki dua parameter bentuk yang berbeda, yaituuncheckedPressed
dancheckedPressed
(I85dbd) - Opsi bulan/hari yang tidak valid kini terlihat di
DatePicker
, denganinvalidPickerContentColor
baru, saat menggunakanminDate
ataumaxDate
. (If4541) - Kami telah mengupdate
Stepper
API untuk menyediakan slotincreaseIcon
dandecreaseIcon
- konten untuk slot ini dapat dibuat seperti biasa dari composable Ikon. (Id35da) - Kami telah memperbarui
dynamicColorScheme
dengan menghapus parameterdefaultColorScheme
opsional dan sekarang menampilkanColorScheme
nullable. Ini berarti pemanggil harus secara eksplisit menangani kasus penggantian jika skema warna dinamis tidak disediakan. (I6d62e) - Kami telah memperbarui ukuran ikon di
ButtonDefaults
untuk digunakan denganCompactButton
.CompactButton
yang hanya berisi ikon harus menggunakanButtonDefaults.SmallIconSize = 24.dp
, sedangkanCompactButton
yang berisi ikon dan teks harus menggunakanButtonDefaults.ExtraSmallIconSize = 20.dp
. SebaiknyaCompactButton
menggabungkan kontennya (bukan mengisi lebar maksimum) dan contoh telah diperbarui untuk menunjukkannya. (I0582c) - Kami telah menambahkan
EdgeButtonDefaults
dengan ukuran ikon yang direkomendasikan untuk 4EdgeButtonSizes
yang berbeda. Selain itu, memperbarui tata letakEdgeButton
sehingga memiliki padding bawah yang sedikit lebih besar daripada padding atas, yang meningkatkan tampilan untuk konten Ikon dan Teks. (Id772a) - Kami telah menambahkan gerakan ke
LinearProgressIndicator
dan mengeksposLinearProgressIndicatorContent
yang menyediakan konten visual tanpa animasi. (Idee99) - Kami telah menambahkan composable
CircularProgressIndicatorContent
baru untuk menampilkan konten visualCircularProgressIndicator
tanpa animasi. (Ie33d4) TransformingLazyColumn
baru menyediakan komposisiLocalTransformingLazyColumnItemScope
lokal yang kini digunakanCard
,Button
, danListHeader
untuk berubah secara otomatis saat ditempatkan di dalamTransformingLazyColumn
. Pemanggil dapat menonaktifkan perubahan otomatis menggunakan wrapperTransformExclusion
baru. (I1652f)- Kami telah memperbarui jenis
ButtonDefaults.shape
menjadiRoundedCornerShape
(Iccdf2)
Perbaikan Bug
- Kami telah memperbaiki bug untuk mengikuti alfa yang ada di latar belakang untuk
TimeText
(I1eb60) - Kami telah menetapkan
TextMotion
keAnimated
secara default dalam tipografi, untuk menghindari jitter teks karena menyematkan glyph huruf ke batas piksel selama operasi penskalaan. (I626fa) - Kami telah memperbarui tampilan
ScrollIndicator
dengan meningkatkan lebar dan ukuran celah, untuk meningkatkan visibilitas. (Ied7cb) - Kami telah memperbaiki bug pada
Modifier.scrollTransform
saat menambahkan/menghapus/memindahkan item. (I6830f) - Kami telah memperbaiki masalah animasi tombol bulat untuk ketukan singkat (sebelumnya, durasi animasi minimum tidak selalu diamati). (I757a7)
- Kami telah memperbarui sudut sapuan untuk
LevelIndicator
menjadi 20% (yaitu 72 derajat). (Idde5c) - Kami telah memperbaiki posisi
ScrollIndicator
saatScalingLazyColumn
digunakan denganAutoCenteringParams
. (I387dd) - Kami telah memperbarui warna dan tipografi untuk
ListHeader
danListSubHeader
. Juga warna untuk kontrol tombol diCheckboxButton
danSwitchButton
. (I39817) - Kami telah memperbaiki posisi
ScrollIndicator
diLazyColumn
danScalingLazyColumn
denganContentPadding
. (I2bc51) - Kami telah memperbaiki bug yang terlihat di animasi progres
OpenOnPhoneDialog
dengan menggunakanCircularProgressIndicatorContent
baru. (I3e443) - Kami telah memperbarui
HorizontalPagerScaffold
danVerticalPagerScaffold
untuk menonaktifkan animasi saat mengurangi gerakan diaktifkan (Iaaf68) - Kami telah menerapkan animasi terpisah untuk indikator progres melingkar saat progres mencapai lebih dari 100%. (I47135)
- Kami telah memperbaiki bug yang menyebabkan
EdgeButton
dapat digambar dengan bentuk yang salah di komponen Pager (I91db9)
Versi 1.0.0-alpha29
13 November 2024
androidx.wear.compose:compose-material3:1.0.0-alpha29
dirilis. Versi 1.0.0-alpha29 berisi commit ini.
Perubahan API
- Kami telah memperbarui
TimeText
untuk menyediakan konten default yang menampilkan waktu. (Id23b3) - Kami telah menyederhanakan
ScrollInfoProvider
untukPagerState
dengan menghapus parameterorientation
, yang tidak lagi diperlukan. Perilaku barunya adalah agarTimeText
tetap berada di tempat untuk paging horizontal dan vertikal. (I71767) LocalHapticFeedback
kini menyediakan implementasiHapticFeedback
default saat Vibrator API menunjukkan bahwa haptic didukung. Berikut ini telah ditambahkan keHapticFeedbackType
-Confirm
,ContextClick
,GestureEnd
,GestureThresholdActivate
,Reject
,SegmentFrequentTick
,SegmentTick
,ToggleOn
,ToggleOff
,VirtualKey
. Komponen Wear Compose yang dapat diklik lama sepertiButton
,IconButton
,TextButton
, danCard
kini menjalankan hapticLONG_PRESS
saat pengendali klik lama telah disediakan. (I5083d)
Perbaikan Bug
- Kami telah memperbarui gerakan untuk Konfirmasi. (I04bff)
- Kami telah mengupdate dependensi API minimum ke 1.7.4 untuk library Compose. (I88b46)
- Gerakan baru telah ditambahkan untuk dialog
OpenOnPhone
. (I1e10a) - Kami telah memperbaiki bug di
LevelIndicator
sehingga kini ditampilkan dengan benar dengan level nol. (Ie95a4) - Kami telah memperbarui animasi
HorizontalPageIndicator
danVerticalPageIndicator
. (I5c8f3) - Kami telah menambahkan animasi shrink-to-dot ke
ArcProgressIndicator
yang tidak ditentukan. (I9fd51)
Versi 1.0.0-alpha28
30 Oktober 2024
androidx.wear.compose:compose-material3:1.0.0-alpha28
dirilis. Versi 1.0.0-alpha28 berisi commit ini.
Perubahan API
- Kami telah menambahkan variasi busur pada indikator progres melingkar tidak tentu (I2efc1)
- Kami telah mempublikasikan composable
AlertDialogContent
danDialog
yang membentukAlertDialog
API, sehingga Anda dapat menambahkan penyesuaian jika diperlukan (seperti menyesuaikan animasiAlertDialog
sambil mempertahankan tata letak konten yang direkomendasikan). Selain itu, kami telah menambahkan parameterModifier
danColor
ke anggotaEdgeButton
,ConfirmButton
, danDismissButton
dariAlertDialogDefaults
. (I4eb71) - Kami telah mengupdate
Placeholder
API sebagai berikut: mengganti namaPlaceholderState.startPlaceholderAnimation
menjadiPlaceholderState.animatePlaceholder
,PlaceholderState.isShowContent
menjadiPlaceholderState.isHidden
, danPlaceholderDefaults.shape
menjadiPlaceholderDefaults.Shape
; mengganti nama parameterpainter
dipainterWithPlaceholderOverlayBackgroundBrush
menjadioriginalPainter
; mengubah visibilitasPlaceholderState.placeholderProgression
dari publik menjadi internal dan mengganti namanya menjadiplaceholderShimmerProgression
; menambahkan konstanta durasi animasi placeholder kePlaceholderDefaults
. (Ie5a59) - Kami telah memperbarui
EdgeButton
API sebagai berikut: mengganti nama parameter diScreenScaffold
daribottomButton
menjadiedgeButton
; menjadikanEdgeButtonSize
sebagai class nilai. (Ieef15) - Kami telah mengubah visibilitas
copy()
menjadi publik di class Warna wear material3 (I0287f)
Perbaikan Bug
- Menambahkan durasi animasi minimum untuk
IconToggleButton
danTextToggleButton
saat diklik (Ieb333) - Menambahkan durasi minimum pada animasi bentuk
IconButton
danTextButton
(Iebcee) - Memperbaiki status opsi ulangi
DatePicker
. (I3587c) - Menambahkan gerakan untuk dialog Notifikasi dan Konfirmasi. (I173b1)
Versi 1.0.0-alpha27
16 Oktober 2024
androidx.wear.compose:compose-material3:1.0.0-alpha27
dirilis. Versi 1.0.0-alpha27 berisi commit ini.
Perubahan API
- Kami telah memperbarui
ScreenScaffold
danScrollIndicator
setelah mengganti nama Wear Compose FoundationLazyColumn
menjadiTransformingLazyColumn
. (I0608b) - Parameter
preferredHeight
EdgeButton
telah diganti namanya menjadibuttonSize
dan nilainya hanya dapat dipilih dari 4 konstanta dalam class nilaiEdgeButtonSize
yang baru diperkenalkan. (Icdd70) - Kami telah mengubah penamaan
ListSubheader
menjadiListSubHeader
dan menambahkan nilai default yang dapat diakses secara publik untukListHeader
danListSubHeader
. (I96730) - Kami telah menambahkan komponen
HorizontalPagerScaffold
danVerticalPagerScaffold
baru untuk Wear yang menyediakan animasi dan koordinasi baru antara komponen teks waktu dan indikator halaman. (Iff7d0) - Kami telah menambahkan dukungan dari alat rotasi ke
HorizontalPagerScaffold
danVerticalPagerScaffold
, sehingga pengguna dapat menavigasi pager menggunakan perangkat input dari alat rotasi. (I9770d) - Kami telah membuat perubahan
MotionScheme
API untuk menyederhanakan penggunaan dan meningkatkan konsistensi. Menghapus fungsi remember yang disematkan dan memindahkan Skema Gerakan bawaan ke objek pendamping MotionScheme khusus. Mengganti namastandardMotionScheme
danexpressiveMotionScheme
menjadi standar dan ekspresif. (I5fd45) - Kami telah menambahkan dukungan untuk skema warna dinamis berdasarkan warna sistem. (I073e9)
- Kami telah memperbarui Stepper ke spesifikasi UX terbaru. (I622bb)
Perbaikan Bug
- Kami telah memperbarui tipografi dan padding untuk komponen Kartu. (I3ae48)
- Kami telah mengubah padding di
AlertDialog
antara tombol Konfirmasi/Tutup dan konten lainnya dari 8dp menjadi 12dp sesuai dengan spesifikasi UX (Ie55f0) - Kami telah memperbarui opasitas warna untuk komponen Penggeser. (Idb383)
Versi 1.0.0-alpha26
2 Oktober 2024
androidx.wear.compose:compose-material3:1.0.0-alpha26
dirilis. Versi 1.0.0-alpha26 berisi commit ini.
Perubahan API
- Kami telah memperbarui API dan tampilan
HorizontalPageIndicator
serta menambahkanVerticalPageIndicator
untuk digunakan denganVerticalPager
(Ic9309) AlertDialog
kini mendukung kemampuan untuk menghapus tombol bawah default dari variasi tumpukan tombol, untuk tata letak kustom yang tidak memerlukan EdgeButton. (I34fa9)- Kami telah menambahkan komponen
SwipeToReveal
untuk Wear Material 3 (Ic38b2) - Kami telah menambahkan dukungan untuk geser dua arah di
SwipeToReveal
, untuk kasus yang jarang terjadi saat layar saat ini tidak mendukung geser untuk menutup. Setelan defaultnya masih geser untuk menampilkan hanya pada geser dari kanan ke kiri dan sebaiknya ikuti perilaku default untuk menghindari konflik dengan geser untuk menutup. (Ifac04) - Kami telah mengganti nama parameter
buttonHeight
EdgeButton
menjadipreferredHeight
. (I4fab3) - Versi Kotlin telah diupdate ke 1.9 (I1a14c)
- Kami telah mengganti nama
OpenOnPhoneDialogDefaults.Icon
menjadiOpenOnPhoneDialogDefaults.OpenOnPhoneIcon
untuk menghindari bentrok denganIcon
(I0f391) - Kami telah menambahkan dukungan untuk
ScrollIndicator
diLazyColumn
. (Ia546a) - Kami telah memperbarui nilai default untuk
TextToggleButton
danIconToggleButton
. (I7aaa9) - Kami telah menyederhanakan
Picker
danPickerGroup
API. (Id0653) - Kami telah menambahkan
CardDefaults.Shape
danCardDefaults.Height
, yang (sebagai token) bersifat pribadi bagi developer yang menggunakan library. (I1594a, b/347649765) - Kami telah mengganti nama parameter progres untuk indikator progres melingkar yang tersegmentasi biner menjadi
segmentValue
. (Ib72d9) - Kami telah memperbarui warna dan tata letak untuk Penggeser. (Ic3eec)
Perbaikan Bug
- Kami telah memperbarui animasi ikon
openOnPhone
(I66f85) - Sekarang kami menggunakan ikon Simbol Google di
Slider
,TimePicker
, danDatePicker
. (I46c7c) - Kami telah memperbarui padding di
Confirmation
danOpenOnPhoneDialog
. (Iaa82e)
Versi 1.0.0-alpha25
18 September 2024
androidx.wear.compose:compose-material3:1.0.0-alpha25
dirilis. Versi 1.0.0-alpha25 berisi commit ini.
Perubahan API
- Kami telah menambahkan indikator progres melingkar Tidak Tentu. (I427a7)
- Kami telah menambahkan dukungan untuk tambahan progres (>100% progres) untuk
CircularProgressIndicator
danSegmentedCircularProgressIndicator
. Jika progres melebihi 1,0, hal ini akan ditunjukkan dengan warnaoverflowTrack
baru. (Iaaa3d) IconToggleButton
danTextToggleButton
bulat kini mendukung variasi animasi bentuk baru, dengan berbagai bentuk yang mewakili status dicentang, tidak dicentang, dan ditekan. Variasi bentuk animasi sebelumnya untuk status yang baru saja ditekan akan terus didukung. (I29f03)- Kami telah menghapus dukungan untuk menggunakan
EdgeButton
denganColumn
, karena perlu menentukan tinggiEdgeButton
secara eksplisit diScreenScaffold
. (Ie353d) - Kami telah menambahkan dukungan untuk
LazyColumn
Wear Compose denganScreenScaffold
kami (dan menambahkan implementasiScrollInfoProvider
untukLazyColumnState
). (Ib8d29) - Kami telah menggabungkan
LocalTextMaxLines
,LocalTextAlign
,LocalTextOverflow
menjadi satu komposisiLocalTextConfiguration
lokal untuk memberikan solusi yang lebih skalabel ke depannya. (I5edbc) - Kami telah menambahkan arc-large sebagai jenis huruf tambahan, yang dikhususkan untuk string teks header singkat di bagian paling atas atau bawah layar, seperti dalam overlay Konfirmasi. (I60e3e)
- Kami telah menambahkan setelan default ke Tombol untuk ukuran ikon besar dan ekstra besar yang direkomendasikan serta padding konten. (I84675)
Perbaikan Bug
- Kami telah memperbarui warna untuk
IconButton
danTextButton
. (I48324) - Kami telah mengubah overload Tombol dasar agar sejajar di tengah secara vertikal untuk konsistensi dengan overload lainnya. Untuk memulihkan perilaku sebelumnya, gunakan
Modifier.align
dariRowScope
. (I66e57)
Versi 1.0.0-alpha24
4 September 2024
androidx.wear.compose:compose-material3:1.0.0-alpha24
dirilis. Versi 1.0.0-alpha24 berisi commit ini.
Perubahan API
- Kami telah menambahkan skema Gerakan ke tema Material3. Ini akan digunakan oleh komponen di seluruh library untuk menerapkan spesifikasi animasi seperti pegas untuk gerakan ekspresif. (I54ff3)
- Kami telah menambahkan komponen
AppScaffold
danScreenScaffold
ke library Material3, yang mencakup fungsi untuk mengoordinasikan pelapisan dan transisiTimeText
danScrollIndicator
.AppScaffold
menyediakan komponen scaffold level teratas yang berada di atas semua layar. Dengan demikian, menambahkanTimeText
keAppScaffold
memungkinkannya tetap berada di tempat saat menggeser antarlayar. Layar itu sendiri dapat mengganti atau menyembunyikan teks waktu.ScreenScaffold
menyediakan slot untukScrollIndicator
dan secara otomatis menganimasikan indikator scroll saat men-scroll, termasuk waktu tunggu untuk menyembunyikan indikator scroll setelah tidak ada aktivitas. (I047d6) - Kami telah menambahkan
ScrollIndicator
yang menampilkan desain Material3 baru. Ikon ini memiliki ukuran thumbnail tetap berdasarkan konten daftar awal, untuk menghindari variasi ukuran saat konten lambat dimuat ke dalam daftar. (Ic228d) - Kami telah mengubah
ScrollAway
API sehinggaScreenStage
adalah class nilai, bukan class enum, untuk memungkinkan tahap tambahan ditambahkan sesuai kebutuhan ke depannya. (I48c93) - Kami telah menambahkan
EdgeButton
, tombol khusus Wear yang unik dengan bentuk yang mengikuti lengkungan bagian bawah layar (I16369) - Kami telah menambahkan slot baru ke
ScreenScaffold
untuk tombol bawah (sepertiEdgeButton
), yang akan ditampilkan dan diubah ukurannya bergantung pada konten scroll (I032eb) - Kami telah menambahkan
Modifier.scrollTransform
danModifier.targetMorphingHeight
untuk menambahkan efek gerakan Material3 ke item diLazyColumn
. (Ie229a) - Kami telah menambahkan
SegmentedCircularProgressIndicator
sebagai variasi padaCircularProgressIndicator
. Variasi tersegmentasi menampilkan satu nilai progres di semua segmen atau menampilkan setiap segmen sebagai aktif/nonaktif. (I6e059) - Kami telah menambahkan
LinearProgressIndicator
sebagai alternatif untukCircularProgressIndicator
yang ada. (I89182) - Kami telah menambahkan
AlertDialog
, yang menyediakan tata letak untuk menampilkan perintah penting kepada pengguna. Variasi disertakan untuk sepasang tombol konfirmasi/tutup atau satu tombol bawah (biasanya EdgeButton) di bawah kelompok opsi. Kedua variasi tersebut memiliki slot untuk ikon, judul, dan teks tambahan guna memberikan detail lebih lanjut. (Ieb873) - Kami telah menambahkan
OpenOnPhoneDialog
, yang harus digunakan untuk menunjukkan tindakan yang akan dilanjutkan di ponsel pengguna.OpenOnPhoneDialog
ditutup setelah waktu tunggu yang ditentukan. (I978fd) - Kami telah menambahkan
Confirmation
, komponen dialog yang memiliki slot untuk ikon dan teks melengkung atau linear. Variasi tertentu disediakan untuk pesan berhasil/gagal. Konfirmasi akan otomatis ditutup setelah waktu tunggu. (Ib43e8) - Kami telah menambahkan latar belakang ke
TimeText
untuk mengurangi masalah saat konten pokok danTimeText
tumpang-tindih, serta mengaburkan waktu. (Ia11fd) - Kita telah menambahkan
LevelIndicator
, yang menampilkan nilai setelan seperti volume, dan dapat digunakan dengan komponenStepper
yang ada untuk membuat layar volume.LevelIndicator
mirip denganScrollIndicator
, tetapi ditampilkan di sisi lain layar dan memiliki lebar goresan yang lebih lebar serta warna indikator yang berbeda secara default. (I8a4ac) - Kami telah menambahkan
TimePicker
, dengan tata letak untuk waktu 24 jam (dengan atau tanpa detik), atau waktu 12 jam dengan pilihan am/pm. (Ia5124) - Kami telah menambahkan
DatePicker
, dengan konfigurasi untuk pengurutan kolom (yaitu hari-bulan-tahun, bulan-hari-tahun, atau tahun-bulan-hari) dan tanggal min/maks opsional. (Ibf13b) - Kami telah menambahkan parameter bobot ke fungsi
text
TimeText
. Jika TimeText terdiri dari lebih dari satu elemen teks, hal ini memungkinkan kontrol atas cara ruang didistribusikan. (I36700) - Kami telah menambahkan
RadioButton
danSplitRadioButton
- komponen ini menyederhanakan API sebelumnya dengan menggabungkan (Split)SelectableButton
dan kontrol radio turunan (If7ae8) - Kami telah menambahkan
CheckboxButton
danSplitCheckboxButton
- komponen ini menyederhanakan API sebelumnya dengan menggabungkan (Split)ToggleButton
dan kontrol Checkbox turunan (Ia8f70) - Kami telah menambahkan
SwitchButton
danSplitSwitchButton
- komponen ini menyederhanakan API sebelumnya dengan menggabungkan(Split)ToggleButton
dan kontrol Tombol turunan (I0d349) - Kami telah memperbarui dokumentasi
AnimatedText
untuk menjelaskan perilaku overshooting. (Iff30a) - Kami telah menambahkan
ButtonGroup
untuk menggabungkan 2 atau 3 tombol sehingga penekanan tombol menghasilkan animasi yang terkoordinasi. (Ie27db) - Kami telah menambahkan animasi bentuk opsional untuk
IconButton
danTextButton
saat ditekan. (Iffca5) - Kami telah menambahkan variasi warna tambahan,
FilledVariant
, keButton
,IconButton
,TextButton
,CompactButton
, danEdgeButton
(I65fc3) - Kami telah menambahkan parameter
forcedSize
keImageWithScrimPainter
, sehingga latar belakang gambar Tombol kini mempertahankan ukuran komponennya secara default. MenetapkanforcedSize = null
akan mengadopsiPainter.instrinsicSize
. (Ic57af) - Kami telah menambahkan klik lama ke Tombol (Ib613d)
- Dukungan klik lama juga telah ditambahkan ke
IconButton
danTextButton
. (I38891) - Dukungan klik lama telah ditambahkan ke Kartu. (I305d5)
- Kami telah menambahkan
LocalTextMaxLines
,LocalTextAlign
,LocalTextOverflow
sebagaiCompositionLocals
dan menggunakannya sebagai parameter default diText
. Lokal komposisi kini dapat digunakan oleh komponen sepertiCheckboxButton
,SwitchButton
,RadioButton
untuk menerapkan panduan UX, tetapi parameter dapat diganti oleh developer jika diperlukan. (Iab841) - Kami telah menambahkan
Placeholder
untuk membantu menyamarkan konten komponen seperti tombol & kartu hingga data dimuat. (I1a532) - Kami telah menambahkan
IconToggleButtonColors
danTextToggleButtonColors
untuk menggantikanToggleButtonColors
yang sekarang telah dihapus. (Ie0bf1)
Perbaikan Bug
- Kami telah memperbarui
Button
,FilledTonalButton
,OutlinedButton
,ChildButton
,CompactButton
untuk menggunakanCompositionLocals
LocalTextMaxLines
,LocalTextAlign
,LocalTextOverflow
baru untuk menerapkan panduan UX - parameter ini dapat diganti oleh developer di Text secara langsung jika diperlukan (Ie51f7) - Kami telah mengubah lebar goresan default
LevelIndicator
menjadi6dp
untuk membedakannya denganScrollIndicator
yang memiliki lebar goresan4dp
. (If6f63) - Kami telah memperbaiki masalah di
TimeText
sehingga sudut sapuan yang lebih besar didukung. (Ie489f) - Memperbaiki masalah selama rekomposisi
EdgeButton
. (I4cdca) - Memperbaiki tata letak tombol tombol terpisah saat padding konten yang disesuaikan disediakan. (Ia33d3)
- Membulatkan nilai progres kecil hingga setidaknya lebar garis indikator progres. (I3bd84)
Versi 1.0.0-alpha23
14 Mei 2024
androidx.wear.compose:compose-material3:1.0.0-alpha23
dirilis. Versi 1.0.0-alpha23 berisi commit ini.
Perubahan API
- Kami telah mengupdate
ToggleButton
danRadioButton
API sehingga warna yang dinonaktifkan dapat dikonfigurasi. (If13a7) - Kami telah menambahkan
CircularProgressIndicator
baru untuk Material3. (Ib3bd7)
Perbaikan Bug
- Kami telah memperbaiki bug yang menyebabkan tombol yang dapat dipilih mengumumkan ketuk dua kali untuk beralih saat sudah dipilih. (I7ed88)
Versi 1.0.0-alpha22
1 Mei 2024
androidx.wear.compose:compose-material3:1.0.0-alpha22
dirilis. Versi 1.0.0-alpha22 berisi commit ini.
Perubahan API
- Kami telah memperbarui
ColorScheme
Material3. (I7b2b8) - Kami telah memperbarui Tombol Material3 - serta beberapa perubahan warna, tanda centang kini cocok dengan yang digunakan untuk Kotak Centang. (Icac7b)
Perbaikan Bug
- Memperbarui semua demo integrasi untuk menggunakan pengubah
rotaryScrollable
baru. (I25090)
Versi 1.0.0-alpha21
17 April 2024
androidx.wear.compose:compose-material3:1.0.0-alpha21
dirilis. Versi 1.0.0-alpha21 berisi commit ini.
- Rilis ini dipicu karena masalah teknis dalam rilis sebelumnya yang menyebabkan jar sumber tidak ada. Tidak ada commit baru dalam rilis ini.
Versi 1.0.0-alpha20
3 April 2024
androidx.wear.compose:compose-material3:1.0.0-alpha20
dirilis. Versi 1.0.0-alpha20 berisi commit ini.
Perbaikan Bug
- Kami telah menyesuaikan alfa status fokus dan ditekan Ripple untuk kontras. (I59f0a)
- Kami telah menambahkan spasi antara label primer dan sekunder di
Button
,ToggleButton
, danRadioButton
, mengikuti perubahan terbaru pada gaya tipografi dan tinggi baris. (I2c0ba)
Versi 1.0.0-alpha19
6 Maret 2024
androidx.wear.compose:compose-material3:1.0.0-alpha19
dirilis. Versi 1.0.0-alpha19 berisi commit ini.
Perubahan API
- Kami telah menambahkan
TimeText
ke library Wear Compose Material3. Komponen ini menampilkan waktu saat ini (dan status tambahan) di bagian atas layar. Material3 API yang baru dan ringkas menghindari duplikasi antara konten linear dan melengkung. (I4d7c3) - Kami telah memperbarui nama parameter dari
onSelected
menjadionSelect
untukRadioButton
. (I1a971) - Buat token
RadioButton
danSplitRadioButton
, serta faktorkan ulang metode yang ada untuk mengurangi jumlah pencarianCompositionLocal
dengan menambahkan instance warna yang di-cache, dan membuat metodeRadioButtonColors
danSplitRadioButtonColors
bersifat internal. (I02b33)
Versi 1.0.0-alpha18
21 Februari 2024
androidx.wear.compose:compose-material3:1.0.0-alpha18
dirilis. Versi 1.0.0-alpha18 berisi commit berikut ini.
Perubahan API
- Kami telah memfaktorkan ulang pola default untuk
CardColors
,ToggleButtonColors
, danSplitToggleButtonColors
dengan membuat instance yang di-cache secara internal dan mengurangi penggunaanCompositionLocal
. (If3fec)
Versi 1.0.0-alpha17
7 Februari 2024
androidx.wear.compose:compose-material3:1.0.0-alpha17
dirilis. Versi 1.0.0-alpha17 berisi commit ini.
Perubahan API
- Kami telah memperbarui Button API untuk menggunakan
buttonColors
secara default dan menghapusfilledButtonColors
duplikat. (I4fe3b) - Kami telah memfaktorkan ulang pola default untuk
ButtonColors
,IconButtonColors
, danTextButtonColors
dengan membuat instance yang di-cache secara internal dan mengurangi penggunaanCompositionLocal
. (I5f51c) - Kami telah menghapus overhead
rememberUpdatedState
di class warna khusus Komponen dan menandai metode pengakses di dalam class warna sebagai internal. (If6571)
Perbaikan Bug
- Kami telah memperbarui
Modifier.minimumInteractiveComponentSize
untuk menggunakanModifier.node
. (Iba6b7)
Versi 1.0.0-alpha16
24 Januari 2024
androidx.wear.compose:compose-material3:1.0.0-alpha16
dirilis. Versi 1.0.0-alpha16 berisi commit berikut ini.
Fitur Baru
- Kami telah menambahkan
CompactButton
, yang dapat menggunakan warna isi, warna isi tone, dan warna garis batas yang sama dengan Tombol.(I05df0)
Perubahan API
- Kami telah menambahkan
RadioButton
/SplitRadioButton
sebagai penampung untuk kontrol pilihan, seperti kontrol Radio. Hal ini berbeda denganToggleButton
yang ada karenaRadioButton
dapat dipilih (dan beroperasi dalam grup pilihan) sedangkanToggleButton
dapat diaktifkan/dinonaktifkan (dan bersifat independen). (I61275) - Kami menghapus
LocalContentAlpha
dari library Wear Compose Material3 untuk konsistensi dengan library Compose Material3. (I49a0a) - Komponen material Wear dan material3 Wear yang mengekspos
MutableInteractionSource
di API-nya telah diupdate sehingga kini mengeksposMutableInteractionSource
nullable yang ditetapkan secara default ke null. Tidak ada perubahan semantik di sini: meneruskan null berarti Anda tidak ingin mengangkatMutableInteractionSource
, danMutableInteractionSource
akan dibuat di dalam komponen jika diperlukan. Mengubah ke null memungkinkan beberapa komponen tidak pernah mengalokasikanMutableInteractionSource
, dan memungkinkan komponen lain hanya membuat instance secara lambat saat diperlukan, yang meningkatkan performa di seluruh komponen ini. Jika Anda tidak menggunakanMutableInteractionSource
yang diteruskan ke komponen ini, sebaiknya teruskan null. Sebaiknya Anda juga membuat perubahan serupa di komponen Anda sendiri. (Ib90fc, b/298048146) - Menambahkan ripple API baru di library
wear:compose-material
danwear:compose-material3
yang menggantikanrememberRipple
yang tidak digunakan lagi. Juga menambahkanCompositionLocal
,LocalUseFallbackRippleImplementation
sementara, untuk mengembalikan komponen Material agar menggunakan APIrememberRipple/RippleTheme
yang tidak digunakan lagi. Ini akan dihapus dalam rilis stabil berikutnya, dan hanya dimaksudkan sebagai bantuan migrasi sementara untuk kasus saat Anda menyediakanRippleTheme
kustom. Lihat developer.android.com untuk mengetahui informasi migrasi dan informasi latar belakang selengkapnya tentang perubahan ini. (af92b21) - Kami telah melakukan peningkatan kecil pada API
HorizontalPageIndicator
dan dokumentasinya. (I60efc) - Kami telah memperbarui
ColorScheme
agar tidak dapat diubah, sehingga pembaruan warna satu per satu menjadi kurang efisien, tetapi penggunaan warna yang lebih umum menjadi lebih efisien. Alasan di balik perubahan ini adalah sebagian besar aplikasi tidak akan memperbarui setiap warna sebagai kasus penggunaan utama. Hal ini masih dapat dilakukan, tetapi akan merekomposisi lebih banyak dari sebelumnya, sehingga kami secara signifikan mengurangi jumlah langganan status melalui semua kode material dan akan memengaruhi biaya inisialisasi dan runtime dari kasus penggunaan yang lebih standar. (Ibc2d6) - Memperbarui
ToggleButton
danSplitToggleButton
API untuk memungkinkan warna yang dinonaktifkan disesuaikan. Selain itu, token Desain Material kini digunakan untuk nilai warna dan tipografi. (If087c) - Memperbarui warna latar belakang gambar Tombol untuk menggunakan token Desain Material. (Iba215)
- Kami telah mengubah komponen
Checkbox
,Switch
, danRadioButton
menjadi hanya tampilan, dengan menghapus penanganan klik. Komponen ini diharapkan akan digunakan di(Split)ToggleButton
yang menangani klik, sehingga komponen kini lebih jelas ditunjukkan sebagai hanya tampilan (dan tidak dimaksudkan untuk penggunaan mandiri di Wear). (I2322e)
Perbaikan Bug
- Kami telah menambahkan token untuk nilai gerakan durasi dan easing di Wear Compose Material 3. (I437cd)
- Kami telah memperbaiki bug di
ToggleButton
,SplitToggleButton
,Checkbox
,Switch
, danRadioButton
sehingga pengumuman aksesibilitas tidak diulang (sebelumnya, peran semantik diduplikasi). (Ica281) - Kami telah menghapus lapisan materialcore untuk
CompactButton
guna meningkatkan performa. (7902858)
Versi 1.0.0-alpha15
15 November 2023
androidx.wear.compose:compose-material3:1.0.0-alpha15
dirilis. Versi 1.0.0-alpha15 berisi commit ini.
Perubahan API
- Kami telah mengganti nama level Dasar
SwipeToDismissBox
menjadiBasicSwipeToDismissBox
. Hal ini membuat perbedaan lebih jelas antara komponen tingkat Foundation danSwipeToDismissBox
tingkat Material3. Yang terakhir mengambil warna dariMaterialTheme
untuk digunakan dalam scrim dan mendelegasikan implementasi yang tersisa keBasicSwipeToDismissBox
. (Ibecfc)
Perbaikan Bug
- Kami telah menghapus lapisan material-core untuk Tombol Material3 guna meningkatkan performa. (I55555)
Versi 1.0.0-alpha14
18 Oktober 2023
androidx.wear.compose:compose-material3:1.0.0-alpha14
dirilis. Versi 1.0.0-alpha14 berisi commit ini.
Perubahan API
- Kami telah menghapus parameter
indicatorStyle
dariHorizontalPageIndicator
Material3 - sebagai gantinya, parameter ini akan mengikuti bentuk layar perangkat (linear atau bulat). (I83728) - Kami telah memisahkan warna untuk
SplitToggleButton
dari warna untukToggleButton
, dengan menambahkan classSplitToggleButtonColors
baru. (I78bee)
Versi 1.0.0-alpha13
4 Oktober 2023
androidx.wear.compose:compose-material3:1.0.0-alpha13
dirilis. Versi 1.0.0-alpha013 berisi commit berikut ini.
Perubahan API
- Kami telah menambahkan kolom Subtitel opsional ke
TitleCard
. (Ifc45a) - Kami telah menambahkan token warna Desain Material untuk
TextButton
. (I769dc)
Versi 1.0.0-alpha12
20 September 2023
androidx.wear.compose:compose-material3:1.0.0-alpha12
dirilis. Versi 1.0.0-alpha12 berisi commit ini.
Perubahan API
- Kami telah memperbarui
IconButton
untuk menggunakan token Desain Material. (I3f137) - Kami telah memperbarui
IconToggleButton
untuk menggunakan token Desain Material. (I7d263) - Kami telah membuat konstruktor
CheckboxColors
,RadioButtonColors
,SwitchColors
menjadi publik. (I82b73)
Versi 1.0.0-alpha11
6 September 2023
androidx.wear.compose:compose-material3:1.0.0-alpha11
dirilis. Versi 1.0.0-alpha11 berisi commit ini.
Perbaikan Bug
- Kami memperbarui tipografi untuk Kartu Material3 menjadi
TitleMedium
. (I597bd) - Kami telah memperbarui tipografi dan perataan untuk
ListHeader
danListSubheader
Material3. (Ib5ceb)
Versi 1.0.0-alpha10
23 Agustus 2023
androidx.wear.compose:compose-material3:1.0.0-alpha10
dirilis. Versi 1.0.0-alpha10 berisi commit berikut.
Fitur Baru
- Tambahkan
HorizontalPageIndicator
di library Wear Material3. (Ifee99)
Perubahan API
- Perbarui kode Tombol untuk menggunakan token desain Material3. (I92fe4)
- Mendeklarasikan API Pengatur Langkah dan Penggeser Wear Material 3 sebagai eksperimental karena detail antarmuka pengguna masih dalam proses penyelesaian. (I84d54)
- Kami telah menghapus ukuran
ExtraSmall
dariTextButton
danTextToggleButton
bulat karena ukuran tersebut hanya berlaku untukIconButton
. (Ibc7d5)
Perbaikan Bug
- Kami telah memperbarui panduan tentang tipografi untuk TextToggleButton agar menggunakan LabelLarge untuk LargeButtonSize (Ib10fa)
- Kami telah memperbarui panduan tipografi untuk TextButton agar menggunakan LabelLarge untuk LargeButtonSize (I8f3a7)
- Kami telah menetapkan target sentuh minimum Kartu menjadi 48 dp untuk aksesibilitas. (Ieb9b1)
- Menambahkan AppCard dengan demo gambar, menghapus AppCard dengan demo Latar Belakang (Id735f)
- Memperbaiki bug pada tombol bulat saat pengubah tidak dirantai dengan benar. (I5e162)
Versi 1.0.0-alpha09
9 Agustus 2023
androidx.wear.compose:compose-material3:1.0.0-alpha09
dirilis. Versi 1.0.0-alpha09 berisi commit berikut ini.
Fitur Baru
- Kami telah menambahkan
ToggleButton
untuk material3 (I6bed6)
Perubahan API
- Kami telah mengaktifkan anotasi
FloatRange
sebagai batasan API , yang sebelumnya dinyatakan dalam komentar. (Icb401) - Kami telah memperbarui tipografi untuk Wear Material3 agar mematuhi pedoman Material3 terbaru. (I1bad6)
Perbaikan Bug
- Kami telah memperbarui warna untuk
Button
,IconButton
, danTextButton
agar sesuai dengan desain Material3. (Ib2495) - Kami telah memperbaiki visibilitas centang kotak dalam status nonaktif. (Ib25bf)
Versi 1.0.0-alpha08
26 Juli 2023
androidx.wear.compose:compose-material3:1.0.0-alpha08
dirilis. Versi 1.0.0-alpha08 berisi commit ini.
Fitur Baru
- Kami telah menambahkan kontrol pemilihan berikut untuk Material3 -
Switch
,Checkbox
,RadioButton
. (Ib918c) - Kami telah menambahkan
IconToggleButton
danTextToggleButton
ke Material3, tombol tombol lingkaran dengan satu slot untuk ikon dan teks. Untuk ukuranToggleButton
yang berbeda, sebaiknya gunakanModifier.touchTargetAwareSize
dengan ukuran yang disediakan di tombol tombol masing-masing. (I9f015) - Kami telah menambahkan
ListHeader
danListSubheader
ke komponen Material3. (Ibaefe) - Kami telah menambahkan
SwipeToDismissBox
Material3, yang memanggilSwipeToDismissBox
Foundation baru dan menyediakan nilai warna default dari temanya. (I275fb) - Kami telah menambahkan
InlineSlider
Material3 ke Wear Compose. Komponen ini memungkinkan pengguna membuat pilihan dari rentang nilai. Rentang pilihan ditampilkan sebagai panel antara nilai rentang minimum dan maksimum, yang memungkinkan pengguna memilih satu nilai.InlineSlider
ideal untuk menyesuaikan setelan seperti volume atau kecerahan. (I7085f)
Perubahan API
- Kami telah memperbarui Bentuk di tema Wear Material 3 untuk menggunakan
RoundedCornerShape
, bukan Bentuk. (Idb133) - Kami telah membuat konstanta tinggi untuk Tombol bersifat publik (Idbfde)
- Mengupdate file API untuk menganotasi penekanan kompatibilitas (I8e87a, b/287516207)
- Kami telah memperbarui
InlineSliderColors
di Wear Compose Material 3 agar memiliki konstruktor publik dan properti publik. (I6b632) - Kami telah memperbarui semua class warna di Wear Compose Material 3 agar memiliki konstruktor publik dan properti publik. (I17702)
- Kami telah membuat konstanta padding horizontal dan vertikal Button menjadi publik. (Ieeaf7)
Perbaikan Bug
- Tombol kini akan menyesuaikan tingginya untuk mengakomodasi konten yang telah bertambah karena font besar untuk aksesibilitas, jika diperlukan (Iaf302)
- Kami telah memperbarui sejumlah demo Tombol untuk mengatasi masalah aksesibilitas. (I61ce9)
Stepper
danInlineSlider
kini mendukung klik berulang pada penekanan lama sehingga Anda dapat dengan cepat menaikkan/menurunkan nilaiStepper
danInlineSlider
dengan menahan tombol + atau - (I27359)
Versi 1.0.0-alpha07
21 Juni 2023
androidx.wear.compose:compose-material3:1.0.0-alpha07
dirilis. Versi 1.0.0-alpha07 berisi commit ini.
Fitur Baru
- Kami telah menambahkan komponen
Stepper
ke library Compose untuk Wear OS Material 3. Ini mirip dengan versi Material sebelumnya, tetapi menghilangkan semantik rentang secara default, mengikuti masukan developer. Kami menyediakanModifier.rangeSemantics
kasus saat semantik rentang diperlukan. (Ic39fd) - Kami telah menambahkan
curvedText
ke library Compose untuk Wear OS Material 3. (Ia8ae3)
Perbaikan Bug
- Kami telah memperbarui
wear.compose.foundation
menjadi dependensi APIwear.compose.material3
(I72004, b/285404743)
Versi 1.0.0-alpha06
7 Juni 2023
androidx.wear.compose:compose-material3:1.0.0-alpha06
dirilis. Versi 1.0.0-alpha06 berisi commit ini.
Perbaikan Bug
- Kami telah memperbarui
TextButton
untuk menggunakan fungsi ekstensitoDisabledColor
untuk nilai alfa yang dinonaktifkan yang benar. (I814c8)
Versi 1.0.0-alpha05
24 Mei 2023
androidx.wear.compose:compose-material3:1.0.0-alpha05
dirilis. Versi 1.0.0-alpha05 berisi commit ini.
Fitur Baru
- Kami telah menambahkan
TextButton
ke Material3, tombol lingkaran dengan satu slot untuk teks. Untuk ukuranTextButton
yang berbeda, sebaiknya gunakanModifier.touchTargetAwareSize
danExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
, danLargeButtonSizeIcon
yang disediakan diTextButtonDefaults
.TextButton
default tidak memiliki batas dan latar belakang transparan untuk tindakan penekanan rendah. Untuk tindakan yang memerlukan penekanan tinggi, gunakanfilledTextButtonColors
; untuk penekanan sedang,TextButton
yang digarisbatasi, tetapkan batas keButtonDefaults.outlinedButtonBorder
; untuk posisi tengah antara garis batas dan terisi, gunakanfilledTonalTextButtonColors
. (I667e4) - Kami telah menambahkan
Card
,OutlinedCard
,AppCard
, danTitleCard
ke dalam library Wear Compose Material3.AppCard
danTitleCard
juga dapat diberi tampilan garis batas menggunakanCardDefaults.outlinedCardColors
danCardDefaults.outlinedCardBorder
(I80e72)
Perubahan API
- Kami telah memindahkan parameter label Tombol ke bagian akhir untuk mendukung sintaksis lambda akhir dan menghapus parameter peran (karena dapat diganti menggunakan
Modifier.semantics
). KonstruktorButtonColors
kini bersifat publik. (Ie1b6d)
Versi 1.0.0-alpha04
10 Mei 2023
androidx.wear.compose:compose-material3:1.0.0-alpha04
dirilis. Versi 1.0.0-alpha04 berisi commit ini.
Fitur Baru
- Kita telah menambahkan
IconButton
ke Material3, tombol lingkaran dengan satu slot untuk ikon/gambar. Ada empat variasi:IconButton
,FilledIconButton
,FilledTonalIconButton
, danOutlinedIconButton
. Untuk ukuranIconButton
yang berbeda, sebaiknya gunakanModifier.touchTargetAwareSize
danExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
, danLargeButtonSizeIcon
yang disediakan diIconButtonDefaults
. Kami juga menyediakanIconButtonDefaults.iconSizeFor
untuk menentukan ukuran ikon yang direkomendasikan untuk ukuran tombol tertentu. (I721d4)
Versi 1.0.0-alpha03
19 April 2023
androidx.wear.compose:compose-material3:1.0.0-alpha03
dirilis. Versi 1.0.0-alpha03 berisi commit ini.
Perubahan API
- Kami telah menambahkan komponen Tombol Material 3 - ini adalah tombol berbentuk stadion dan sebelumnya bernama Chip di library Material Wear Compose (telah diganti namanya menjadi Tombol untuk konsistensi dengan library Compose Material 3). Tombol default memiliki latar belakang yang terisi dan ada variasi tombol untuk
FilledTonal
(latar belakang yang diredam), Berbingkai (transparan dengan batas tipis), dan Turunan (latar belakang transparan dan tidak ada batas, digunakan untuk tindakan tambahan dengan jumlah keterlihatan terendah). Tombol bulat untuk konten ikon dan teks sederhana akan menyusul dalam rilis mendatang.(Ia6942)
Versi 1.0.0-alpha02
5 April 2023
androidx.wear.compose:compose-material3:1.0.0-alpha02
dirilis. Versi 1.0.0-alpha02 berisi commit ini.
Perbaikan Bug
- Kami telah menambahkan
DefaultTextStyle
ke Wear Compose Material 3 yang menetapkanPlatformTextStyle.includeFontPadding
ke true (setelan saat ini) secara default. Hal ini akan memungkinkan kita menyinkronkan penonaktifan padding font secara default dengan library Compose pada masa mendatang (lihat Memperbaiki padding font di Compose untuk latar belakang). (I7e461)
Versi 1.0.0-alpha01
22 Maret 2023
androidx.wear.compose:compose-material3:1.0.0-alpha01
dirilis. Versi 1.0.0-alpha01 berisi commit ini.
Fitur Baru
Material 3 adalah evolusi berikutnya dari Desain Material dan mencakup tema yang diperbarui serta komponen yang didesain ulang. Material 3 di Wear Compose dirancang agar selaras dengan library Compose Material 3 di Android. Rilis alfa pertama ini berisi implementasi awal dan fungsional dari hal berikut:
Kami akan terus mengembangkan Wear Material (
androidx.wear.compose:compose-material
) dan Wear Material 3 (androidx.wear.compose:compose-material3
) secara paralel. Rilis material3 mendatang akan memperluas kumpulan widget untuk menyertakan komponen umum lainnya dari Compose untuk Wear OS, seperti tombol, alat pilih, dan penggeser.Library Wear Material dan Wear Material 3 bersifat eksklusif dan tidak boleh dicampur dalam aplikasi yang sama, terutama karena keduanya mereferensikan tema yang berbeda yang akan menyebabkan inkonsistensi yang tidak terduga.