Wear Compose Material 3
Update Terbaru | Rilis Stabil | Kandidat Rilis | Rilis Beta | Rilis Alfa |
---|---|---|---|---|
13 Agustus 2025 | - | 1.5.0-rc02 | - | - |
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-rc02" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material3:1.5.0-rc02" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.5.0-rc02" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-rc02") // 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-rc02") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material3:1.5.0-rc02") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.5.0-rc02") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-rc02") // 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-rc02
13 Agustus 2025
androidx.wear.compose:compose-*:1.5.0-rc02
dirilis. Versi 1.5.0-rc02 berisi commit ini.
Perbaikan Bug
- Memperbaiki bug di
TimePicker
yang menyebabkan string internasional yang panjang untuk periode (AM/PM) dapat merusak tata letak. (I0fa81)
Versi 1.5.0-rc01
30 Juli 2025
androidx.wear.compose:compose-*:1.5.0-rc01
dirilis. Versi 1.5.0-rc01 berisi commit ini.
Perbaikan Bug
TimePicker
kini sepenuhnya didasarkan pada lokalitas pengguna, menggunakanDateFormat.getBestDateTimePattern
untuk menentukan urutan dan konten pemilih serta pemisahnya. Perubahan ini memperbaiki urutan kolom yang salah untuk bahasa CJK, mengatasi masalah tata letak RTL dalam bahasa seperti Arab, menggunakan pemisah yang dilokalkan, dan mendukung format 0-11 dan 1-12 jam berdasarkan lokalitas (I5d543)DatePicker
kini menampilkan bulan numerik di beberapa lokalitas, seperti CJK, untuk menghindari pencampuran format numerik dan linguistik (misalnya, 2025 | 07 | 02, bukan 2025 | 7月 | 02). Perubahan ini menerapkan heuristik yang memeriksa apakah lokalitas menggunakan sufiks linguistik untuk tahun dan, jika ya, mengubah format bulan dari tekstual (MMM) menjadi numerik (MM) agar konsisten. (Ia93fe)- Ruang vertikal untuk judul di komponen Pemilih kini konstan, sehingga mencegah pergeseran yang terlihat saat kolom pemilih dipilih, terutama dalam mode
Talkback
. (I7f8b7) - Memperbaiki bug aksesibilitas yang disebabkan oleh
HorizontalPageIndicator
danVerticalPageIndicator
yang digambar dalam layar penuh. Indikator halaman tidak lagi ditampilkan dalam layar penuh, dan akan diposisikan secara otomatis saat digunakan denganHorizontalPagerScaffold
atauVerticalPagerScaffold
. Jika tidak menggunakan scaffold pager, tentukan perataan secara eksplisit menggunakanmodifier = Modifier.align(Alignment.BottomCenter)
denganHorizontalPageIndicator
danmodifier =Modifier.align(Alignment.CenterEnd)
denganVerticalPageIndicator
. (I3a0ad) - Arah geser di
SwipeToReveal
kini konsisten untukLayoutDirections
LTR dan RTL. (I6d427) - Mengaktifkan kembali penataan vertikal
SwipeToReveal
untuk tindakan. JikahasPartiallyRevealedState = true
,RevealState
harus direset keRevealValue.Covered
oleh pemanggil saat scrolling terjadi. (I6473d) SwipeDismissableNavHost
kini memangkas konten dengan benar untuk API 36 dan yang lebih baru. (Ib9a44)
Versi 1.5.0-beta06
16 Juli 2025
androidx.wear.compose:compose-*:1.5.0-beta06
dirilis. Versi 1.5.0-beta06 berisi commit ini.
Perbaikan Bug
- Memperbaiki animasi
EdgeButton
saatLazyColumn
atauScalingLazyColumn
memilikireverseLayout = true
. (I46a1a) - Memperbaiki bug di
ScreenScaffold
yang menyebabkan sentuh untuk menjelajahi tidak berfungsi di TalkBack jikaScrollIndicator/PageIndicator
disediakan. (I6dcee) TransformingLazyColumn
kini memungkinkan pengubahan bentuk kustom dariTransformationSpec
dengan membaca nilaiitemHeight
yang diberikan olehTransformationSpec
di painter latar belakang. (I6a599)- Transisi warna yang diaktifkan/dinonaktifkan untuk
IconButton
, agar konsisten denganIconToggleButton
. (Ife10a) - Menghapus penjepitan bagian minimum di
CircularProgressIndicator
untuk menghindari lompatan yang terlihat jelas ke ukuran titik minimum saat membuat animasi. Sebagai bagian dari perubahan ini, parametertargetProgress
didrawCircularProgressIndicator
kini tidak digunakan. (I33309) - Pemilih kini memiliki peran semantik
ValuePicker
yang dapat digunakan oleh pembaca layar untuk membuat pemilih lebih mudah diakses. Pemilih juga telah memperbarui label klik aksesibilitas yang membedakan antara menyesuaikan nilai dalam mode hanya baca dan memilih nilai saat ini. (I33309)
Versi 1.5.0-beta05
2 Juli 2025
androidx.wear.compose:compose-*:1.5.0-beta05
dirilis. Versi 1.5.0-beta05 berisi commit ini.
Perbaikan Bug
- Memperbarui dokumentasi untuk memperjelas penggunaan
Modifier.edgeSwipeToDismiss
(I78cb5) - Memperbaiki bug saat beberapa item yang ditampilkan dapat ditampilkan dengan
SwipeToReveal
dalam daftar lambat (I1d4f6) - Bentuk penampung di
TransformingLazyColumn
kini diskalakan untuk menghindari pemangkasan konten. (I9221a) - Label
TimePicker
danDatePicker
untuk jam/menit/detik atau tahun/bulan/hari kini memiliki semantik heading untuk pembaca layar (I77d8b) - Menghapus jeda antara loop dalam
CircularProgressIndicator
tidak ditentukan (Iaf0bb) - Memperbaiki bug animasi di
TransformingLazyColumn
saat item dihapus. (I73034) - Memperbaiki penanganan item penanda di
TransformingLazyColumn
saat item dihapus. (I841a8) PickerGroup
kini menganimasikan Pemilih secara horizontal saat pemusatan otomatis diaktifkan dan pemilih yang dipilih (dipusatkan) diubah. (Ic82c4)
Versi 1.5.0-beta04
18 Juni 2025
androidx.wear.compose:compose-*:1.5.0-beta04
dirilis. Versi 1.5.0-beta04 berisi commit ini.
Perbaikan Bug
- Memperbaiki bug tata letak di
TransformingLazyColumn
, di mana konten yang sesuai dengan layar kini disejajarkan dengan benar dari bagian atas layar (I80115) - Memperbaiki masalah pada
TransformingLazyColumn
saat item bawah diskalakan secara tidak benar saat men-scroll ke bagian paling bawah daftar denganEdgeButton
. Progres scroll kini mengikuti penurunan gradien saat memulihkan tata letak. (Iea375) TransformingLazyColumn
kini membaca tinggi item di dalam painter latar belakang, yang memungkinkanTransformationSpecs
kustom menerapkan pengubahan bentuk. (I022f0)SwipeToReveal
kini memusatkan tindakan yang ditampilkan secara vertikal dengan benar. (I4419b)- Memperbaiki bug di
SwipeToReveal
yang mencegahnya berfungsi dengan benar dengan swipe-to-dismiss jika tampilan dan compose digunakan di layar. (I5dc0e) - Memperbaiki bug saat tindakan
SwipeToReveal
digambar dengan offset vertikal saat men-scroll. (I29444) AlertDialog
,ConfirmationDialog
,OpenOnPhoneDialog
, danSwipeToReveal
kini membulatkan padding dan ukuran yang dihitung sebagai persentase ukuran layar. (I76367)ButtonDefaults.outlinedButtonBorder
kini memperbarui ukuran setelah perubahan status diaktifkan/dinonaktifkan(If2ddd)- Memperbaiki bug pada tinggi
EdgeButton
yang terjadi pada layar kompleks dengan Pager danScreenScaffold
. (I946e3) - Memperbaiki kondisi race yang dapat menyebabkan animasi Placeholder berhenti. (I53530)
- Meningkatkan performa
HorizontalPageIndicator
danVerticalPageIndicator
dengan menggambar ke Canvas. (Ifae1e) - Memperbaiki bentuk EdgeButton untuk memperlancar transisi antara elipsis dan lingkaran yang membentuk garis batas. (I7721e)
- Memperbaiki bug di
LevelIndicator
yang menyebabkan animasi berhenti, karena rekomposisi yang tidak perlu. (I45d08)
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 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 dibalik, dan kita menerapkan pengubah yang diteruskan di antaranya, sehingga terpengaruh oleh transformasi penampung. Hal ini memperbaiki kasus seperti penggunaan efek berkilau placeholder dengan elemen dalam TLC menggunakan parameter transformasi. (I786cf) RevealState.Saver
ditambahkan untuk digunakan dalam memulihkan statusSwipeToReveal
saat aktivitas atau proses dibuat ulang. FungsirememberRevealState
kini menggunakan Penghemat ini secara default. (Ie0ecb)- Tombol tindakan utama dan sekunder
SwipeToReveal
harus ditetapkan keButtonDefault.Height
secara default (memperbaiki bug yang menyebabkan 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 diselesaikan pada statusRevealing
saat posisi akhir geser berada di antara penahan yang menampilkan dan ditampilkan, dan lebih dekat ke penahan yang menampilkan. (If4458)- Sekarang, konten
ButtonGroup
dibalik dengan benar dalam tata letak RTL (Ib378d) AnimatedText
kini mendukung arah teks RTL (I4533c)TransformingLazyColumn
sekarang mengubah ukuran item dengan benar saat item bawah dihapus (Idacab)TransformingLazyColumn
kini hanya melakukan satu kali 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, dan material3. (I53f06)
- Memperbaiki bug di
TransformingLazyColumn
, saat item diubah ukurannya ketika item bawah dihapus. (Idacab) - Memperbaiki bug pada
TransformingLazyColumn
, saat daftar macet di bagian atas atau bawah daftar. (I49d00) OpenOnPhoneDialog
di bagian TalkBack akan mengumumkan teks melengkung, bukan deskripsi konten ikon. (I4efe8)- Memperbaiki bug di
SwipeToReveal
yang akan melaporkan penanda yang salah diRevealState.currentValue
saathasPartiallyRevealedState
disetel ke salah (false). (I9c7cf) - Tombol urungkan
SwipeToReveal
kiniButtonDefaults.Height
secara default. (I1f6c8) - Performa
BasicSwipeToDismissBox
telah ditingkatkan dengan menghilangkan penggunaan Canvas untuk menggambar scrim. (I68f2c) - Memperbaiki bug aksesibilitas di Penggeser, yang menyebabkan 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 1.5.0-beta01 Compose untuk Wear OS 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 menerapkan desain visual baru dalam aplikasi, dan untuk mendapatkan manfaat dari komponen baru sebagai berikut:
MaterialTheme
untuk skema warna, tipografi, dan bentuk yang diperbarui dan diperluas guna menghadirkan 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
- Perubahan Bentuk - 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 didesain untuk bagian bawah layar.- Scaffold - memperkenalkan
AppScaffold
danScreenScaffold
untuk menata struktur layar dan mengoordinasikan animasiScrollIndicator
danTimeText
. - Tombol - banyak tombol berbentuk elips yang didukung dengan penampung satu slot yang fleksibel dan variasi multi-slot untuk tombol dengan ikon dan label.
CheckboxButton
danSwitchButton
disediakan saat tombol aktif/nonaktif diperlukan, sedangkanRadioButton
adalah tombol pilihan yang tersedia (variasi 'Split' dari tombol aktif/nonaktif dan pilihan juga disediakan). ButtonGroup
- menerapkan grup tombol ekspresif dalam satu 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 berhasil, gagal, dan buka di ponsel.- Pemilih - Variasi
TimePicker
danDatePicker
didukung, serta komponen Pemilih danPickerGroup
untuk membuat layar pemilih Anda sendiri. ProgressIndicators
- indikator progres melingkar dan linear didukung (CircularProgressIndicator
memiliki variasi yang tersegmentasi dan tidak ditentukan).- Kartu - sejumlah variasi kartu tersedia, termasuk
TitleCard
yang menawarkan tata letak khusus untuk kartu dengan slot judul, waktu, subjudul, atau konten.TitleCard
juga dapat diberi latar belakang gambar untuk memperkuat makna informasi dalam kartu. - Penger - 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 dipasangkan 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 pengubahan bentuk- Grup Fokus Hierarkis - digunakan untuk menganotasi composable dalam aplikasi, untuk melacak bagian komposisi yang aktif dan mengoordinasikan fokus.
- Pagers - komponen
HorizontalPager
danVerticalPager
, yang dibangun di atas 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 kelebihan bebanModifier.hierarchicalFocusRequester
dengan parameterFocusRequester
; membuatCompositionLocal
,LocalScreenIsActive
baru sehingga komponen dapat memberi tahu dan memeriksa layar mana yang aktif. (I5ff7c). - Tidak lagi menggunakan
SwipeToReveal
dari Wear Compose Foundation dan beralih ke APISwipeToReveal
di Wear Compose Material dan Wear Compose Material3. Ganti impor Wear FoundationSwipeToReveal
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 dijadikan fungsi Composable; menandaiRevealActionType
sebagai internal. (I885d0). - Memperbarui lebih lanjut API
SwipeToReveal
sebagai berikut: mengganti namaonFullSwipe
menjadionSwipePrimaryAction
; mengganti namaSwipeToRevealNonAnchoredSample
untuk menunjukkan penggunaan parameterhasPartiallyRevealedState
; menghapusactionButtonHeight
, karena tinggi default adalah tinggi default Tombol dan tinggi yang lebih besar dapat ditetapkan menggunakan pengubah; menghapusSmallActionButtonHeight
dariSwipeToRevealDefaults
; membuat parameter nilai dalam konstruktorRevealValue
danRevealDirection
menjadi 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
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
menggantikancontainerColor
dandisabledContainerColor
(I4a453). - Mengembalikan perubahan pada
TimeText
di rilis sebelumnya yang memindahkanBroadcastReceiver
ke thread pekerja, karena menyebabkan masalah pada aplikasi yang mengelola threading-nya sendiri selama navigasi. (I34d02). - Memperbarui contoh Pemilih untuk menghapus panggilan remember yang tidak perlu dan 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 Foundation dan Material Swipe to Reveal untuk mengumumkan tindakan aksesibilitas kustom (tindakan kustom harus ditambahkan sebagai semantik pada konten, bukan pada composable
SwipeToReveal
itu sendiri). (Ie92a3). - Memperbarui set
MaxLines
default pada kontenEdgeButton
sesuai ukurannya - kini 1 untuk ekstra kecil, 2 untuk kecil dan sedang, dan 3 untuk besar. (Ie35f6). LocalReduceMotion
yang disederhanakan sehingga pengamat hanya didaftarkan satu kali, untuk meningkatkan performa. (Ib1979).- Meminimalkan jumlah penggambaran ulang di
ScrollIndicator
, untuk meningkatkan performa. (Ia7a67). - Memperbaiki bug di
TransformingLazyColumn
, saat item yang terlihat di bagian atas dalam daftar tidak diskalakan dengan benar saat EdgeButton mencapai tinggi penuhnya. (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 tampilan API publik. Gunakan kombinasi pengubahtransformedHeight
dangraphicsLayer
jika Anda perlu mendapatkan fungsi yang sama. (Ie181d) - Mengganti composable
ImageButton
danImageCard
dengan overloadButton
danCard/TitleCard
masing-masing. 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
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 tinggi adalah 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
ButtonDefaults.imageBackgroundButtonColors
diganti denganImageButton
,ButtonDefaults.imageButtonColors
,ButtonDefaults.containerPainter
, danButtonDefaults.disabledContainerPainter
. Dan perubahan serupa untuk Kartu. Pelukis dihapus dariButtonColors
danCardColors
. (I8c6a1)- Memperbarui placeholder untuk menyederhanakan API. Sekarang kita menyediakan dua Pengubah,
Modifier.placeholderShimmer
untuk menerapkan efek berkilau di tingkat komponen, danModifier.placeholder
untuk menerapkan mask di atas konten yang belum dimuat (Iaee7a)
Perbaikan Bug
- Mengintegrasikan overscroll ke dalam
ScrollIndicator
. (Icfb7f) - Mengatasi latar belakang kosong dan dialog yang tidak ada saat meluncurkan dialog material3. (Ice597)
- Memperbaiki masalah di
FadingExpandingLabel
saat teks mencakup beberapa baris. (I04eb7) - Padding yang diperbarui antara label utama dan sekunder pada tombol. (I99b7b)
ArcLarge
telah diturunkan 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
- Padding atas
AlertDialog
kini dikurangi secara default saat ikon disediakan - hal ini memanfaatkan ukuran layar yang tersedia dengan sebaik-baiknya. (Ief06c) PagerScaffoldDefaults.FadeOutAnimation
diganti namanya menjadiPagerScaffoldDefaults.FadeOutAnimationSpec
. Parameter halaman diAnimatedPage
telah diganti namanya menjadipageIndex
. (I701f2)- Memperbarui penamaan untuk pemisahan
SurfaceTransformation
-applyTransformation
TransformingLazyColumn
menjadiapplyContainerTransformation
danapplyContentTransformation
, serta mengganti namacreateBackgroundPainter
menjadicreateContainerPainter
. Pembaruan penamaan lebih lanjut untukTransformationSpec
danResponsiveTransformationSpec
. (I1c534) AppScaffold backgroundColor
telah diganti namanya menjadicontainerColor
. (I4e63f)
Perbaikan Bug
- Memperbaiki masalah di
FadingExpandingLabel
saat teks tidak selalu meluas dengan benar. (I0e773) ArcLarge
telah dikurangi dari 20 sp menjadi 18 sp, dan jarak antar-huruf padaArcLarge
danArcSmall
telah diperbarui.ConfirmationDialog/OpenOnPhoneDialog
sekarang menggunakanArcLarge
default, bukan menggantinya menjadi 18 sp. (Id39a8)- Memperbarui animasi judul untuk
DatePicker
danTimePicker
berdasarkan, sehingga animasi fade-out dan fade-in bertindak 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 dianggap sebagai kasus penggunaan yang paling sering dan penggunaan angka tabular secara default menghasilkan terlalu banyak ruang di antara pasangan angka tertentu.
TimePicker
danDatePicker
terus menerapkanFontFeatureSetting=tnum
untuk angka tabular. (I88929) - Mengoreksi 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 memancarkan komponenPager
- sebagai gantinya, komponen ini harus disediakan melalui Composablecontent
.AnimatedPage
dansnapWithSpringFlingBehaviour
kini bersifat publik dan dapat digunakan bersama denganPager
Wear Foundation untuk mencapai perilakuPagerScaffold
M3 sebelumnya. (Lihat contoh terbaru). (Ia4724)- Memperbarui
PagerState
, menghapusPagerState
Compose Foundation sebagai class dasar dan menambahkan properticurrentPage
,currentPageOffsetFraction
, danpageCount
. Memperbarui antarmukaGestureInclusion
, mengganti nama metode menjadiignoreGestureStart
. (I4ae07) - Parameter sudut sapuan
LevelIndicator
kini dianotasi denganFloatRange(0, 360)
(I7e636) - Kami telah menambahkan
CurvedModifier.clearAndSetSemantics
untuk menyediakan cara agar semantik melengkung dapat dinonaktifkan.CurvedText
terus menetapkan deskripsi konten ke teks secara default, 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 pengelola halaman, 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 kami menjadi 'public val', untuk menghindari nilai yang di-inline. (Ib0f32)
- Menambahkan dukungan untuk zona geser tepi ke
SwipeToReveal
. Perilaku defaultSwipeToReveal
Foundation kini adalah melarang menggeser saat gestur dimulai dari tepi. Perilaku defaultSwipeToReveal’
Material 3 kini tidak mengizinkan penggeseran saat gestur dimulai dari tepi, jikaSwipeDirection
disetel ke satu arah. (I32ef0) - Menambahkan composable
FadingExpandingLabel
, yang memungkinkannya memudarkan teks dengan animasi baris demi baris. (Ic60fa) TransformingLazyColumn
kini menggunakancontentPadding
kosong secara default, bukan menempatkan item pertama dan terakhir ke tengah. (I77ab7)- Menghapus
SwipeToReveal
’srememberRevealState
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 dalamConfirmationDialogDefaults
danOpenOnPhoneDialogDefaults
telah diupdate 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. (I80bb8)- Kami telah memperbarui warna
TimeText
danScrollIndicator
default untuk menyertakan lebih banyak warna abu-abu, karena penggunaanOnBackground
(putih) secara langsung memiliki bobot visual yang terlalu besar 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 menyetel tanggal/waktu. (Id738d) AnimatedText
kini mengikuti setelan kurangi gerakan. (Ib6578)- Pengoptimalan untuk menggunakan
AppScaffold
guna menampilkan konten Dialog telah ditingkatkan untuk memungkinkan beberapa dialog 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. Oleh karena itu, kami menghapus metodepickerGroupItem
dariPickerGroupScope
, dan menambahkan@Composable PickerGroupItem
yang harus digunakan untuk menambahkan Pemilih kePickerGroup
. Kami juga memperbarui jenis parameterPickerGroup
'content' 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 persis yang terjadi pada item saat item 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
sendiri, bukan menggunakanPagerScope
Compose. (I9195b) - Kita telah menghapus composable
LinearProgressIndicatorContent
. GunakanLinearProgressIndicator
secara langsung agar perubahan pada nilai dianimasikan secara default. (I2c4ad) - Kita telah menghapus composable
CircularProgressIndicatorStatic
dan menambahkan fungsiDrawScope
publikdrawCircularProgressIndicator
dengan fungsi yang sama. GunakanCircularProgressIndicator
secara langsung agar perubahan dianimasikan secara default, tetapi buat composable Anda sendiri daridrawCircularProgressIndicator
jika diperlukan animasi kustom. (Ie762f) - Kami telah mengurutkan ulang parameter di
DrawScope.drawCircularProgressIndicator
untuk memindahkan parametertargetProgress
ke atas. (I8ab92) - API
OpenOnPhoneDialog
telah diupdate 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 peringatan 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
, kami telah membagi spasi huruf menjadi spasi huruf searah jarum jam dan spasi huruf berlawanan arah jarum jam. Hal ini wajib dilakukan karena huruf searah jarum jam melebar dari garis dasar, sedangkan huruf berlawanan arah jarum jam menyempit (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 caching 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 menggunakanInteractionSource
, bukanMutableInteractionSource
karena tidak perlu diubah. Kami juga telah menambahkan konstanta publikButtonGroupDefaults.DefaultMinWidth
, lebar minimum default tombol dalamButtonGroup
. (Ie27ec) - Kami telah memperbarui
ListHeaderDefaults.contentColor
untuk 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 pemanggilConfirmationDialog
diharapkan memberikan string dengan lebih banyak konteks. Juga mengganti namaconfirmationCurvedText
menjadiconfirmationDialogCurvedText
. Terakhir, mengganti nama parameter Dialogshow
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 huruf Title Large agar memiliki ukuran font
18dp
(Ic9d52) - Kami telah memperbarui jarak
AlertDialog
dan ukuran ikon (Iac28c) - Kami telah memperbaiki inkonsistensi pada titik henti sementara layar besar (layar dengan 225 dp dan yang lebih tinggi adalah layar besar) (I36474)
- Memperbaiki bug kecil dalam penempatan 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 memperbarui semua library Wear Compose ke mode 'API eksplisit'. (Iebf9f)
- Kami telah mengupdate API
ScreenScaffold
danEdgeButton
, sehingga lebih mudah untuk menentukan padding konten pada layar yang menyertakanEdgeButton
. Di API baru,size
EdgeButton
hanya diteruskan keEdgeButton
, danScreenScaffold
menggunakan parameteredgeButtonSpacing
untuk jarak 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%
tinggi layar (I6f248) - Kami telah memperbarui Confirmation API untuk mencerminkan penggunaannya sebagai dialog. Composable ini sekarang disebut
ConfirmationDialog
, dengan pembaruan terkait pada penamaan class warna dan default. Kami juga telah mengganti nama parametershow
menjadivisible
agar kompatibel dengan API animasi Compose lainnya. Selain itu, kami telah menyediakanConfirmationDialogContent
,SuccessConfirmationDialogContent
,FailureConfirmationDialogContent
untuk situasi saat developer perlu menyesuaikan animasi dialog intro/outro. (Iaeb33) - Kami telah memperbarui
CircularProgressIndicatorContent
menjadiCircularProgressIndicatorStatic
(variasiCircularProgressIndicator
yang tidak beranimasi) sehingga kini dapat digunakan untuk membuatCircularProgressIndicator
dengan animasi kustom. (I1346f) - Kami telah memperbaiki urutan parameter pada
ArcProgressIndicator
, dengan menempatkan parameter pengubah terlebih dahulu (I4656a) - Meningkatkan kualitas API
SwipeToReveal
untuk menerima parameter slot teks bagi label tindakan (kecuali tindakan sekunder) dan untuk menghapus parameter label dari tindakan urungkan (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 layar besar, tombol konfirmasi dan tutup kini lebih kecil. Ada juga peningkatan jarak di bawah tombol konfirmasi dan tutup. (I4f066) - Kami telah mengubah spesifikasi animasi label tombol tindakan komponen
SwipeToReveal
. (Ib87fb) - Mengubah
SwipeToReveal
untuk meluaskan penampung pada saat yang sama dengan teks ditampilkan. (I44cf8) SwipeToReveal
yang ditingkatkan untuk melakukan respons sentuhan saat gesekan melewati nilai minimum tempat tindakan utama dilakukan. (I23efe)- Kami telah memperbarui
SwipeToReveal
untuk menampilkan elipsis pada teks yang meluap secara default, untuk tindakan utama dan urungkan. (I71f5a) - Kami telah memperbaiki masalah yang menyebabkan gangguan 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 keadaan diperkecil) (Id24ac)
- Kami telah menambahkan animasi perubahan 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
telah di-refactor 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. Artinya, pemanggil harus menangani kasus penggantian secara eksplisit 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
membungkus 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
kini menyediakan komposisi lokalLocalTransformingLazyColumnItemScope
yang kini digunakan olehCard
,Button
, danListHeader
untuk berubah bentuk secara otomatis saat ditempatkan di dalamTransformingLazyColumn
. Pemanggil dapat menonaktifkan pengubahan bentuk otomatis menggunakan wrapperTransformExclusion
baru. (I1652f)- Kami telah memperbarui jenis
ButtonDefaults.shape
menjadiRoundedCornerShape
(Iccdf2)
Perbaikan Bug
- Kami telah memperbaiki bug untuk menghormati alfa yang ada di latar belakang untuk
TimeText
(I1eb60) - Kami telah menyetel
TextMotion
keAnimated
secara default dalam tipografi kami, untuk menghindari jitter teks karena menyelaraskan glyph huruf ke batas piksel selama operasi penskalaan. (I626fa) - Kami telah memperbarui tampilan
ScrollIndicator
dengan menambah ukuran lebar dan jarak, untuk meningkatkan visibilitas. (Ied7cb) - Kami telah memperbaiki bug di
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 pemosisian
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 dalam animasi progres
OpenOnPhoneDialog
dengan menggunakanCircularProgressIndicatorContent
baru. (I3e443) - Kami telah memperbarui
HorizontalPagerScaffold
danVerticalPagerScaffold
untuk menonaktifkan animasi saat kurangi 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 baru ini adalah agarTimeText
tetap berada di tempatnya untuk penentuan halaman horizontal dan vertikal. (I71767) LocalHapticFeedback
kini menyediakan implementasiHapticFeedback
default saat Vibrator API menunjukkan bahwa haptik didukung. Berikut telah ditambahkan keHapticFeedbackType
-Confirm
,ContextClick
,GestureEnd
,GestureThresholdActivate
,Reject
,SegmentFrequentTick
,SegmentTick
,ToggleOn
,ToggleOff
,VirtualKey
. Komponen yang dapat diklik lama Wear Compose sepertiButton
,IconButton
,TextButton
, danCard
kini melakukan haptikLONG_PRESS
saat handler 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)
- Animasi baru 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 menyusut menjadi titik 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 memublikasikan composable
AlertDialogContent
danDialog
yang membentuk APIAlertDialog
, sehingga penyesuaian dapat ditambahkan 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 memperbarui
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 material3 Wear (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 pengulangan
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
EdgeButton
'spreferredHeight
telah diganti namanya menjadibuttonSize
dan nilainya hanya dapat dipilih dari 4 konstanta di 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 baru dan koordinasi antara komponen teks waktu dan indikator halaman. (Iff7d0) - Kami telah menambahkan dukungan rotasi ke
HorizontalPagerScaffold
danVerticalPagerScaffold
, sehingga pengguna dapat menavigasi pager menggunakan perangkat input rotasi. (I9770d) - Kami telah melakukan perubahan pada
MotionScheme
API untuk menyederhanakan penggunaan dan meningkatkan konsistensi. Menghapus fungsi remember inline 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 8 dp menjadi 12 dp 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 menghilangkan 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 menggeser dua arah di
SwipeToReveal
, untuk kasus langka saat layar saat ini tidak mendukung geser untuk menutup. Setelan defaultnya tetap menggeser untuk menampilkan hanya pada geseran dari kanan ke kiri dan sangat disarankan untuk mematuhi perilaku default guna 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 bentrokan 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 Google Symbols 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 overflow progres (>100% progres) untuk
CircularProgressIndicator
danSegmentedCircularProgressIndicator
. Jika progres melebihi 1,0, hal ini akan ditunjukkan oleh warnaoverflowTrack
baru. (Iaaa3d) IconToggleButton
danTextToggleButton
bulat kini mendukung variasi animasi bentuk baru, yang menampilkan bentuk berbeda untuk status dicentang, tidak dicentang, dan ditekan. Variasi bentuk animasi sebelumnya untuk status baru saja ditekan tetap 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
ke dalam satu komposisi lokalLocalTextConfiguration
untuk memberikan solusi yang lebih skalabel ke depannya. (I5edbc) - Kami telah menambahkan arc-large sebagai skala huruf tambahan, yang dikhususkan untuk string teks header pendek di bagian paling atas atau bawah layar, seperti pada overlay Konfirmasi. (I60e3e)
- Kami telah menambahkan nilai default ke Tombol untuk ukuran ikon besar dan sangat besar yang direkomendasikan serta padding konten. (I84675)
Perbaikan Bug
- Kami telah memperbarui warna untuk
IconButton
danTextButton
. (I48324) - Kami telah mengubah penggantian Button dasar agar selaras di tengah secara vertikal agar konsisten dengan penggantian 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. Objek 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. Oleh karena itu, menambahkanTimeText
keAppScaffold
memungkinkanTimeText
tetap berada di tempatnya saat menggeser antar-layar. Layar itu sendiri dapat mengganti atau menyembunyikan teks waktu.ScreenScaffold
menyediakan slot untukScrollIndicator
dan otomatis menganimasikan indikator scroll saat men-scroll, termasuk waktu tunggu untuk menyembunyikan indikator scroll setelah tidak aktif. (I047d6) - Kami telah menambahkan
ScrollIndicator
yang menampilkan desain Material 3 baru. Scroll ini memiliki ukuran gambar mini tetap berdasarkan konten daftar awal, untuk menghindari variasi ukuran saat konten lambat dimuat ke dalam daftar. (Ic228d) - Kami telah mengubah
ScrollAway
API sehinggaScreenStage
menjadi class nilai, bukan class enum, untuk memungkinkan tahap tambahan ditambahkan sesuai kebutuhan ke depannya. (I48c93) - Kami telah menambahkan
EdgeButton
, tombol khusus Wear yang berbeda dengan bentuk yang mengikuti kelengkungan bagian bawah layar (I16369) - Kami telah menambahkan slot baru ke
ScreenScaffold
untuk tombol bawah (sepertiEdgeButton
), yang akan ditampilkan dan diubah ukurannya bergantung pada konten yang di-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 yang disegmentasi 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 tumpukan opsi. Kedua variasi memiliki slot untuk ikon, judul, dan teks tambahan untuk memberikan detail lebih lanjut. (Ieb873) - Kita telah menambahkan
OpenOnPhoneDialog
, yang harus digunakan untuk menunjukkan tindakan yang akan dilanjutkan di ponsel pengguna.OpenOnPhoneDialog
akan ditutup setelah waktu tunggu yang ditentukan. (I978fd) - Kami telah menambahkan
Confirmation
, komponen dialog yang memiliki slot untuk ikon dan teks melengkung atau linear. Variasi khusus disediakan untuk pesan keberhasilan/kegagalan. Konfirmasi akan otomatis ditutup setelah waktu tunggu. (Ib43e8) - Kami telah menambahkan latar belakang ke
TimeText
untuk mengurangi masalah saat konten yang mendasarinya danTimeText
tumpang-tindih, dan mengaburkan waktu. (Ia11fd) - Kami 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 layar yang berlawanan 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 Switch 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 default parameter diText
. Sekarang, komposisi lokal dapat digunakan oleh komponen sepertiCheckboxButton
,SwitchButton
,RadioButton
untuk menerapkan panduan UX, tetapi parameter dapat diganti oleh developer jika perlu. (Iab841) - Kami telah menambahkan
Placeholder
untuk membantu menyembunyikan konten komponen seperti tombol & kartu hingga data dimuat. (I1a532) - Kami telah menambahkan
IconToggleButtonColors
danTextToggleButtonColors
untuk menggantikanToggleButtonColors
yang kini telah dihapus. (Ie0bf1)
Perbaikan Bug
- Kami telah memperbarui
Button
,FilledTonalButton
,OutlinedButton
,ChildButton
,CompactButton
untuk menggunakanCompositionLocals
LocalTextMaxLines
,LocalTextAlign
,LocalTextOverflow
baru guna menerapkan panduan UX. Parameter ini dapat diganti oleh developer di Text secara langsung jika perlu (Ie51f7) - Kami telah mengubah lebar goresan default
LevelIndicator
menjadi6dp
untuk membedakannya dariScrollIndicator
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 toggle terpisah saat padding konten yang disesuaikan diberikan. (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 memperbarui
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 Switch Material3 - selain beberapa perubahan warna, tanda centang kini cocok dengan yang digunakan untuk Checkbox. (Icac7b)
Perbaikan Bug
- Perbarui 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 mengakibatkan tidak adanya jar sumber. 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 ditekan dan fokus Ripple untuk kontras. (I59f0a)
- Kami telah menambahkan jarak 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. API Material3 baru yang ringkas menghindari duplikasi antara konten linear dan melengkung. (I4d7c3) - Kami telah memperbarui nama parameter dari
onSelected
menjadionSelect
untukRadioButton
. (I1a971) - Lakukan tokenisasi
RadioButton
danSplitRadioButton
, serta refaktorisasi metode yang ada untuk mengurangi jumlah pencarianCompositionLocal
dengan menambahkan instance warna yang di-cache, dan menjadikan metodeRadioButtonColors
danSplitRadioButtonColors
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 terisi, tone terisi, dan garis luar yang sama dengan Button.(I05df0)
Perubahan API
- Kami telah menambahkan
RadioButton
/SplitRadioButton
sebagai penampung untuk kontrol pilihan, seperti kontrol Radio. Hal ini berbeda denganToggleButton
yang sudah 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 agar konsisten dengan library Compose Material3. (I49a0a) - Komponen Wear Material dan Wear Material 3 yang menampilkan
MutableInteractionSource
di API-nya telah diupdate untuk menampilkanMutableInteractionSource
nullable yang secara default bernilai 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 pada komponen Anda sendiri. (Ib90fc, b/298048146) - Menambahkan API riak baru di library
wear:compose-material
danwear:compose-material3
yang menggantikanrememberRipple
yang tidak digunakan lagi. MenambahkanCompositionLocal
,LocalUseFallbackRippleImplementation
sementara, untuk mengembalikan komponen Material ke penggunaan APIrememberRipple/RippleTheme
yang tidak digunakan lagi. Hal ini akan dihapus dalam rilis stabil berikutnya, dan hanya dimaksudkan sebagai bantuan migrasi sementara untuk kasus saat Anda memberikanRippleTheme
kustom. Lihat developer.android.com untuk mengetahui informasi migrasi dan informasi latar belakang selengkapnya tentang perubahan ini. (af92b21) - Kami telah melakukan peningkatan kecil pada
HorizontalPageIndicator
API 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 memungkinkan, tetapi akan merekomposisi lebih banyak dari sebelumnya. Dengan demikian, kita akan mengurangi jumlah langganan status secara signifikan melalui semua kode material dan akan memengaruhi biaya inisialisasi dan runtime kasus penggunaan yang lebih standar. (Ibc2d6) - Memperbarui API
ToggleButton
danSplitToggleButton
untuk memungkinkan penyesuaian warna yang dinonaktifkan. Selain itu, token Desain Material kini digunakan untuk nilai warna dan tipografi. (If087c) - Memperbarui warna latar belakang gambar Tombol agar menggunakan token Desain Material. (Iba215)
- Kita telah mengubah komponen
Checkbox
,Switch
, danRadioButton
menjadi hanya tampilan, dengan menghapus penanganan klik. Komponen ini diharapkan digunakan di(Split)ToggleButton
yang menangani klik, sehingga komponen kini ditunjukkan dengan lebih jelas sebagai hanya untuk 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
SwipeToDismissBox
level Dasar menjadiBasicSwipeToDismissBox
. Hal ini membuat perbedaan antara komponen tingkat Foundation danSwipeToDismissBox
tingkat Material3 menjadi lebih jelas. Yang terakhir menarik 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 memublikasikan konstruktor
CheckboxColors
,RadioButtonColors
,SwitchColors
. (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 kami. (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
- Menambahkan
HorizontalPageIndicator
di library Wear Material3. (Ifee99)
Perubahan API
- Perbarui kode Tombol untuk menggunakan token desain Material3. (I92fe4)
- Mendeklarasikan Wear Material 3 Stepper dan Slider API sebagai eksperimental karena detail antarmuka pengguna masih dalam tahap penyelesaian. (I84d54)
- Kami telah menghapus ukuran
ExtraSmall
dariTextButton
danTextToggleButton
bulat karena ukuran tersebut hanya berlaku untukIconButton
. (Ibc7d5)
Perbaikan Bug
- Kami telah memperbarui panduan tipografi untuk TextToggleButton agar menggunakan LabelLarge untuk LargeButtonSize (Ib10fa)
- Kami telah memperbarui panduan tentang tipografi untuk TextButton agar menggunakan LabelLarge untuk LargeButtonSize (I8f3a7)
- Kita telah menetapkan target sentuh minimum Kartu menjadi 48 dp untuk aksesibilitas. (Ieb9b1)
- Menambahkan demo AppCard dengan gambar, menghapus demo AppCard dengan Latar Belakang (Id735f)
- Memperbaiki bug pada tombol bulat yang menyebabkan 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 Material3 Wear agar sesuai dengan pedoman Material3 terbaru. (I1bad6)
Perbaikan Bug
- Kami telah memperbarui warna untuk
Button
,IconButton
, danTextButton
sesuai dengan desain Material3. (Ib2495) - Kami telah memperbaiki visibilitas tanda centang kotak di 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 pilihan 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 pengaktifan masing-masing. (I9f015) - Kami telah menambahkan
ListHeader
danListSubheader
ke komponen Material3 kami. (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. Dengan adanya komponen ini, pengguna dapat 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 dalam tema Material 3 Wear untuk menggunakan
RoundedCornerShape
berbasis, bukan Bentuk. (Idb133) - Kami telah membuat konstanta tinggi untuk Button menjadi publik (Idbfde)
- Memperbarui 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 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 saat ditekan lama sehingga Anda dapat menambah/mengurangi nilaiStepper
danInlineSlider
dengan cepat 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 Material 3 Compose untuk Wear OS. Ini mirip dengan versi Material sebelumnya, tetapi menghilangkan semantik rentang secara default, mengikuti masukan developer. Kami menyediakanModifier.rangeSemantics
kasus yang memerlukan semantik rentang. (Ic39fd) - Kami telah menambahkan
curvedText
ke library Material 3 Compose untuk Wear OS. (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 dengan 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 berbagai ukuranTextButton
, sebaiknya gunakanModifier.touchTargetAwareSize
danExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
, danLargeButtonSizeIcon
yang disediakan diTextButtonDefaults
.TextButton
default tidak memiliki batas dan latar belakang transparan untuk tindakan dengan penekanan rendah. Untuk tindakan yang memerlukan penekanan tinggi, gunakanfilledTextButtonColors
; untukTextButton
bergaris dengan penekanan sedang, tetapkan batas keButtonDefaults.outlinedButtonBorder
; untuk titik tengah antara bergaris dan terisi, gunakanfilledTonalTextButtonColors
. (I667e4) - Kami telah menambahkan
Card
,OutlinedCard
,AppCard
, danTitleCard
ke dalam library Wear Compose Material3.AppCard
danTitleCard
juga dapat diberi tampilan garis luar menggunakanCardDefaults.outlinedCardColors
danCardDefaults.outlinedCardBorder
(I80e72)
Perubahan API
- Kita telah memindahkan parameter label Tombol ke akhir untuk mendukung sintaksis lambda akhir dan menghapus parameter peran (karena parameter ini 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
- Kami telah menambahkan
IconButton
ke Material3, tombol lingkaran dengan satu slot untuk ikon/gambar. Ada empat variasi:IconButton
,FilledIconButton
,FilledTonalIconButton
, danOutlinedIconButton
. Untuk berbagai ukuranIconButton
, 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 kami dan sebelumnya bernama Chip di library Wear Compose Material (telah diganti namanya menjadi Tombol agar konsisten dengan library Compose Material 3). Tombol default memiliki latar belakang yang diisi dan ada variasi tombol untuk
FilledTonal
(latar belakang redup), Bergaris (transparan dengan batas tipis), dan Turunan (latar belakang transparan dan tanpa batas, digunakan untuk tindakan tambahan dengan jumlah keunggulan terendah). Tombol bulat untuk konten ikon dan teks sederhana akan tersedia pada 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 secara default menyetelPlatformTextStyle.includeFontPadding
ke benar (setelan saat ini). 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 penerapan tema yang diperbarui dan komponen yang didesain ulang. Material 3 di Wear Compose dirancang agar kohesif 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 set 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 digabungkan dalam aplikasi yang sama, terutama karena keduanya mereferensikan tema yang berbeda sehingga akan menyebabkan inkonsistensi yang tidak terduga.