Wear Compose Material 3

  
Menulis aplikasi Jetpack Compose untuk perangkat Wear OS dengan memberikan fungsi guna mendukung berbagai ukuran perangkat dan gestur navigasi menggunakan sistem desain Ekspresif Material 3.
Update Terbaru Rilis Stabil Kandidat Rilis Rilis Beta Rilis Alfa
27 Agustus 2025 1.5.0 - - -

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"

    // For Wear Material Design UX guidelines and specifications
    implementation "androidx.wear.compose:compose-material3:1.5.0"

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation "androidx.wear.compose:compose-navigation:1.5.0"

    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0")
    
    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

Kotlin

dependencies {
    implementation("androidx.wear.compose:compose-foundation:1.5.0")

    // For Wear Material Design UX guidelines and specifications
    implementation("androidx.wear.compose:compose-material3:1.5.0")

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation("androidx.wear.compose:compose-navigation:1.5.0")
    
    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0")

    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

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.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Wear Compose Material3 Versi 1.5

Versi 1.5.0

27 Agustus 2025

androidx.wear.compose:compose-*:1.5.0 dirilis. Versi 1.5.0 berisi commit ini.

Perubahan penting sejak versi 1.4.0

Rilis pertama library Wear Compose Material 3, yang mendukung sistem desain Ekspresif Material 3 yang baru. Rilis ini mencakup:

  • Tema warna dinamis dan MaterialTheme yang diperbarui.
  • Komponen AppScaffold, ScreenScaffold, HorizontalPagerScaffold, dan VerticalPagerScaffold baru untuk menata struktur layar dan mengoordinasikan animasi ScrollIndicator,TimeText,HorizontalPageIndicator, dan VerticalPageIndicator.
  • Perubahan bentuk IconButton, TextButton, IconToggleButton, dan TextToggleButton, dengan variasi yang dianimasikan saat ditekan atau dicentang.
  • EdgeButton, yang memiliki bentuk khusus yang dirancang untuk bagian bawah layar.
  • ButtonGroup mengimplementasikan grup tombol ekspresif, dalam baris yang berubah bentuk saat disentuh.
  • AlertDialog dan ConfirmationDialog dengan variasi untuk konten dialog tambahan.
  • Komponen TimePicker dan DatePicker.
  • Indikator progres mencakup CircularProgressIndicator (dengan variasi yang tersegmentasi), ArcProgressIndicator, dan LinearProgressIndicator.

Selain itu, Wear Compose Foundation 1.5.0 mencakup hal berikut:

  • TransformingLazyColumn, daftar scroll vertikal lambat yang mendukung animasi penskalaan dan pengubahan bentuk.
  • Dukungan untuk paging di Wear Compose Foundation dengan HorizontalPager dan VerticalPager.
  • Grup Fokus Hierarkis - digunakan untuk menganotasi composable dalam aplikasi untuk melacak bagian komposisi yang aktif dan mengoordinasikan fokus.

Baca selengkapnya tentang (Material 3 Expressive untuk Wear OS)

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, menggunakan DateFormat.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 dan VerticalPageIndicator yang digambar dalam layar penuh. Indikator halaman tidak lagi ditampilkan dalam layar penuh, dan akan diposisikan secara otomatis saat digunakan dengan HorizontalPagerScaffold atau VerticalPagerScaffold. Jika tidak menggunakan scaffold pager, tentukan perataan secara eksplisit menggunakan modifier = Modifier.align(Alignment.BottomCenter) dengan HorizontalPageIndicator dan modifier =Modifier.align(Alignment.CenterEnd) dengan VerticalPageIndicator. (I3a0ad)
  • Arah geser di SwipeToReveal kini konsisten untuk LayoutDirections LTR dan RTL. (I6d427)
  • Mengaktifkan kembali penataan vertikal SwipeToReveal untuk tindakan. Jika hasPartiallyRevealedState = true, RevealState harus direset ke RevealValue.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 saat LazyColumn atau ScalingLazyColumn memiliki reverseLayout = true. (I46a1a)
  • Memperbaiki bug di ScreenScaffold yang menyebabkan sentuh untuk menjelajahi tidak berfungsi di TalkBack jika ScrollIndicator/PageIndicator disediakan. (I6dcee)
  • TransformingLazyColumn kini memungkinkan pengubahan bentuk kustom dari TransformationSpec dengan membaca nilai itemHeight yang diberikan oleh TransformationSpec di painter latar belakang. (I6a599)
  • Transisi warna yang diaktifkan/dinonaktifkan untuk IconButton, agar konsisten dengan IconToggleButton. (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, parameter targetProgress di drawCircularProgressIndicator 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 dan DatePicker 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 dengan EdgeButton. Progres scroll kini mengikuti penurunan gradien saat memulihkan tata letak. (Iea375)
  • TransformingLazyColumn kini membaca tinggi item di dalam painter latar belakang, yang memungkinkan TransformationSpecs 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, dan SwipeToReveal 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 dan ScreenScaffold. (I946e3)
  • Memperbaiki kondisi race yang dapat menyebabkan animasi Placeholder berhenti. (I53530)
  • Meningkatkan performa HorizontalPageIndicator dan VerticalPageIndicator 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 parameter iconContentDescription dan contentDescription dari icon(). Selain itu, ConfirmationDialogDefaults kini memiliki parameter pengubah pada composable SuccessIcon dan FailureIcon. (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 status SwipeToReveal saat aktivitas atau proses dibuat ulang. Fungsi rememberRevealState kini menggunakan Penghemat ini secara default. (Ie0ecb)
  • Tombol tindakan utama dan sekunder SwipeToReveal harus ditetapkan ke ButtonDefault.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 status Revealing 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 di RevealState.currentValue saat hasPartiallyRevealedState disetel ke salah (false). (I9c7cf)
  • Tombol urungkan SwipeToReveal kini ButtonDefaults.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 penghitungan ScrollProgress 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, dan TextToggleButton 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 dan ScreenScaffold untuk menata struktur layar dan mengoordinasikan animasi ScrollIndicator dan TimeText.
  • Tombol - banyak tombol berbentuk elips yang didukung dengan penampung satu slot yang fleksibel dan variasi multi-slot untuk tombol dengan ikon dan label. CheckboxButton dan SwitchButton disediakan saat tombol aktif/nonaktif diperlukan, sedangkan RadioButton 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 atau EdgeButton.
  • ConfirmationDialog tersedia untuk menampilkan pesan dengan waktu tunggu, yang mendukung animasi khusus untuk variasi berhasil, gagal, dan buka di ponsel.
  • Pemilih - Variasi TimePicker dan DatePicker didukung, serta komponen Pemilih dan PickerGroup 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, dan AnimatedPage mengoordinasikan animasi HorizontalPageIndicator dan VerticalPagerIndicator. HorizontalPager dan VerticalPager 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 dan VerticalPager, 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 menjadi Modifier.hierarchicalFocusGroup dan menghapus parameter callback; menghapus kelebihan beban Modifier.hierarchicalFocusRequester dengan parameter FocusRequester; membuat CompositionLocal, 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 API SwipeToReveal di Wear Compose Material dan Wear Compose Material3. Ganti impor Wear Foundation SwipeToReveal dengan impor Wear Compose Material/ Wear Compose Material3 untuk terus menggunakan API. (Ia147d).
  • Dependensi SwipeToReveal Wear Compose Material3 di Foundation dipindahkan ke paket material3, misalnya RevealValue, RevealDirection, RevealActionType, RevealState, rememberRevealState. Developer harus mengubah impor class dan fungsi ini dari androidx.wear.compose.foundation menjadi androidx.wear.compose.material3. (I640e6).
  • Memperbarui Wear Compose Material3 SwipeToReveal API sebagai berikut: menambahkan parameter primaryAction, onFullSwipe, secondaryAction, undoPrimaryAction, undoSecondaryAction, dan hasPartiallyRevealedState ke composable SwipeToReveal; menghapus kemampuan untuk menyesuaikan positionalThreshold dan animationSpec dari RevealState; menghapus lastActionType, revealThreshold, dan lebar dari RevealState; mengubah konstruktor RevealState untuk menerima RevealDirection, bukan anchor; menghapus fungsi createRevealAnchors, anchor, dan bidirectionalAnchors; fungsi SwipeToRevealScope primaryAction, secondaryAction, undoPrimaryAction, dan undoSecondaryAction diganti namanya menjadi PrimaryActionButton, SecondaryActionButton, UndoActionButton, dan dijadikan fungsi Composable; menandai RevealActionType sebagai internal. (I885d0).
  • Memperbarui lebih lanjut API SwipeToReveal sebagai berikut: mengganti nama onFullSwipe menjadi onSwipePrimaryAction; mengganti nama SwipeToRevealNonAnchoredSample untuk menunjukkan penggunaan parameter hasPartiallyRevealedState; menghapus actionButtonHeight, karena tinggi default adalah tinggi default Tombol dan tinggi yang lebih besar dapat ditetapkan menggunakan pengubah; menghapus SmallActionButtonHeight dari SwipeToRevealDefaults; membuat parameter nilai dalam konstruktor RevealValue dan RevealDirection menjadi pribadi. (I465ce).

Perbaikan Bug

  • Memperbaiki penanganan EdgeButton ScreenScaffold sehingga, setelah item TransformingLazyColumn 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 dan disabledContainerPainter menggantikan containerColor dan disabledContainerColor (I4a453).
  • Mengembalikan perubahan pada TimeText di rilis sebelumnya yang memindahkan BroadcastReceiver 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 lambda contentDescription terbaru. (Icb5b1).
  • Memperbarui gaya teks di TimePicker dan DatePicker sehingga perubahan font tidak lagi menyebabkan pemotongan. (I26194).
  • ListHeader dan ListSubHeader 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 konten EdgeButton 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 pengubah transformedHeight dan graphicsLayer jika Anda perlu mendapatkan fungsi yang sama. (Ie181d)
  • Mengganti composable ImageButton dan ImageCard dengan overload Button dan Card/TitleCard masing-masing. Mengganti nama imageButtonColors menjadi buttonWithContainerPainterColors, dan imageCardColors menjadi cardWithContainerPainterColors. Menambahkan ButtonDefaults.scrimBrush dan CardDefaults.scrimBrush publik. Mengganti nama tombol imageBackgroundGradientStartColor dan imageBackgroundGradientEndColor menjadi scrimGradientStartColor dan scrimGradientEndColor. Mengganti nama CardDefaults.ImageContentPadding menjadi CardDefaults.CardWithContainerPainterContentPadding (I7b8b6)
  • Picker dan PickerGroup kini menggunakan contentDescription 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 dengan ImageButton, ButtonDefaults.imageButtonColors, ButtonDefaults.containerPainter, dan ButtonDefaults.disabledContainerPainter. Dan perubahan serupa untuk Kartu. Pelukis dihapus dari ButtonColors dan CardColors. (I8c6a1)
  • Memperbarui placeholder untuk menyederhanakan API. Sekarang kita menyediakan dua Pengubah, Modifier.placeholderShimmer untuk menerapkan efek berkilau di tingkat komponen, dan Modifier.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 dari 20sp menjadi 18sp, dan spasi huruf pada ArcLarge dan ArcSmall telah diperbarui. ConfirmationDialog/OpenOnPhoneDialog kini menggunakan ArcLarge default, bukan menggantinya dengan 18sp. (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 menjadi PagerScaffoldDefaults.FadeOutAnimationSpec. Parameter halaman di AnimatedPage telah diganti namanya menjadi pageIndex. (I701f2)
  • Memperbarui penamaan untuk pemisahan SurfaceTransformation - applyTransformation TransformingLazyColumn menjadi applyContainerTransformation dan applyContentTransformation, serta mengganti nama createBackgroundPainter menjadi createContainerPainter. Pembaruan penamaan lebih lanjut untuk TransformationSpec dan ResponsiveTransformationSpec. (I1c534)
  • AppScaffold backgroundColor telah diganti namanya menjadi containerColor. (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 pada ArcLarge dan ArcSmall telah diperbarui. ConfirmationDialog/OpenOnPhoneDialog sekarang menggunakan ArcLarge default, bukan menggantinya menjadi 18 sp. (Id39a8)
  • Memperbarui animasi judul untuk DatePicker dan TimePicker berdasarkan, sehingga animasi fade-out dan fade-in bertindak sebagai satu animasi Spring. (I68963)
  • Mengoptimalkan PagerScaffold dengan menghindari pembacaan currentPageOffsetFraction dalam composable AnimatedPage. (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 dan DatePicker terus menerapkan FontFeatureSetting=tnum untuk angka tabular. (I88929)
  • Mengoreksi fokus input RSB awal untuk TimePicker dan DatePicker. (I1c773)
  • Memperbarui teks default di OpenOnPhoneDialog menjadi "Periksa ponsel Anda". (I00a3f)
  • Memperbarui bobot untuk ArcLarge dan ArcMedium 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 komponen Pager - sebagai gantinya, komponen ini harus disediakan melalui Composable content. AnimatedPage dan snapWithSpringFlingBehaviour kini bersifat publik dan dapat digunakan bersama dengan Pager Wear Foundation untuk mencapai perilaku PagerScaffold M3 sebelumnya. (Lihat contoh terbaru). (Ia4724)
  • Memperbarui PagerState, menghapus PagerState Compose Foundation sebagai class dasar dan menambahkan properti currentPage, currentPageOffsetFraction, dan pageCount. Memperbarui antarmuka GestureInclusion, mengganti nama metode menjadi ignoreGestureStart. (I4ae07)
  • Parameter sudut sapuan LevelIndicator kini dianotasi dengan FloatRange(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, tetapi timeTextCurvedText dan timeTextSeparator kini tidak mengumumkan kontennya. (I4b568)
  • Menambahkan parameter warna latar belakang dan konten default ke AppScaffold. (I56652)
  • Penanganan default gestur geser HorizontalPager telah diganti namanya menjadi PagerDefaults.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, seperti TransformingLazyColumn. (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 default SwipeToReveal Foundation kini adalah melarang menggeser saat gestur dimulai dari tepi. Perilaku default SwipeToReveal’ Material 3 kini tidak mengizinkan penggeseran saat gestur dimulai dari tepi, jika SwipeDirection disetel ke satu arah. (I32ef0)
  • Menambahkan composable FadingExpandingLabel, yang memungkinkannya memudarkan teks dengan animasi baris demi baris. (Ic60fa)
  • TransformingLazyColumn kini menggunakan contentPadding kosong secara default, bukan menempatkan item pertama dan terakhir ke tengah. (I77ab7)
  • Menghapus SwipeToReveal’s rememberRevealState dari library Wear Compose Material3. (I8c0e0)

Perbaikan Bug

  • Library Wear Compose telah diupdate ke compiler Kotlin 2.0. (I2de79)
  • Dukungan untuk ScrollIndicator dan PageIndicator 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 dalam ConfirmationDialogDefaults dan OpenOnPhoneDialogDefaults telah diupdate untuk menggunakan tipografi ArcLarge dengan ukuran 18sp dan spasi huruf 1.8sp. (Ic9ced)
  • Card, ListHeader, RadioButton, CheckboxButton, SwitchButton tidak lagi membatasi tinggi kontennya secara default. Jika perlu, gunakan Modifier.height(IntrinsicSize.Min) untuk memulihkan perilaku sebelumnya. (I80bb8)
  • Kami telah memperbarui warna TimeText dan ScrollIndicator default untuk menyertakan lebih banyak warna abu-abu, karena penggunaan OnBackground (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 dan ScrollIndicator 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 pengubah edgeSwipeToDismiss. (I02b07)
  • Kami telah menambahkan judul ke DatePicker dan TimePicker 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 dan secondaryAction SwipeToRevealScope. Semantik tindakan kustom harus ditambahkan ke konten komponen SwipeToReveal secara langsung oleh developer. (Ia67f3)
  • Kami telah menghapus awalan 'Button' dari ukuran, gaya teks, dan fungsi warna di IconToggleButtonDefaults dan TextToggleButtonDefaults (I5471d)
  • Kami telah menghapus LocalMinimumInteractiveComponentEnforcement eksperimental (I4ad8a)
  • Kami telah mengganti DSL PickerGroupScope dengan composable. Oleh karena itu, kami menghapus metode pickerGroupItem dari PickerGroupScope, dan menambahkan @Composable PickerGroupItem yang harus digunakan untuk menambahkan Pemilih ke PickerGroup. Kami juga memperbarui jenis parameter PickerGroup '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, dan TextToggleButtonShapes agar konsisten dengan class compose/material3 (I5a081)
  • Kami telah menambahkan parameter overscrollEffect ke ScalingLazyColumn, TransformingLazyColumn, dan ScreenScaffold. (I0cee8)
  • Kami telah mengganti nama parameter swipeDirection menjadi revealDirection di rememberRevealState. (I7472f)
  • Wear Pager kini memiliki PagerScope sendiri, bukan menggunakan PagerScope Compose. (I9195b)
  • Kita telah menghapus composable LinearProgressIndicatorContent. Gunakan LinearProgressIndicator secara langsung agar perubahan pada nilai dianimasikan secara default. (I2c4ad)
  • Kita telah menghapus composable CircularProgressIndicatorStatic dan menambahkan fungsi DrawScope publik drawCircularProgressIndicator dengan fungsi yang sama. Gunakan CircularProgressIndicator secara langsung agar perubahan dianimasikan secara default, tetapi buat composable Anda sendiri dari drawCircularProgressIndicator jika diperlukan animasi kustom. (Ie762f)
  • Kami telah mengurutkan ulang parameter di DrawScope.drawCircularProgressIndicator untuk memindahkan parameter targetProgress ke atas. (I8ab92)
  • API OpenOnPhoneDialog telah diupdate agar lebih jelas dan konsisten dengan Dialog lainnya. Parameter show diganti namanya menjadi visible dan curvedText kini disediakan oleh pemanggil, bukan memiliki nilai default. (Idec2d)
  • Kami telah mengganti nama openOnPhoneCurvedText menjadi openOnPhoneDialogCurvedText (I65bdd)
  • Kami telah menambahkan ScrollIndicatorColors untuk memberikan warna kustom ke ScrollIndicator. (I9eb8c)
  • Mengizinkan konfigurasi warna yang digunakan untuk menggambar latar belakang di belakang TimeText. (I9f5d9)
  • Memperbarui tipografi ArcLarge, ArcMedium, dan ArcSmall menjadi CurvedTextStyle (Iffc41)
  • Kami telah menghapus ScreenScaffoldDefaults.contentPaddingWithEdgeButton. (Ia923e)
  • Kami telah menambahkan errorDim ke ColorScheme, 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 ke androidx.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, dan TextToggleButtonShapes untuk meningkatkan konsistensi di seluruh library Material3. Perubahan ini juga memperkenalkan caching bentuk untuk mengurangi jumlah alokasi. (I049fc)
  • Kami telah menghapus parameter pressedShapeCornerSizeFraction dari metode variantAnimatedShape di IconToggleButton dan TextToggleButton (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, mengganti ButtonGroupItem berbasis DSL dengan Modifier.weight, Modifier.minWidth, dan Modifier.enlargeOnPress. (I16c3c)
  • Di ButtonGroup API, kami telah memperbarui ButtonGroupScope berbasis pengubah baru: enlargeOnPress kini disebut animateWidth, dan menggunakan InteractionSource, bukan MutableInteractionSource karena tidak perlu diubah. Kami juga telah menambahkan konstanta publik ButtonGroupDefaults.DefaultMinWidth, lebar minimum default tombol dalam ButtonGroup. (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 dan SliderDefaults.IncreaseIcon, dengan nilai default yang sesuai (I2e1a7)
  • Kami telah mengganti nama parameter spacing di Picker dan PickerGroup menjadi verticalSpacing (Ib75cc)
  • Kami telah menghapus ConfirmationDialogDefaults.successText dan failureText karena pemanggil ConfirmationDialog diharapkan memberikan string dengan lebih banyak konteks. Juga mengganti nama confirmationCurvedText menjadi confirmationDialogCurvedText. Terakhir, mengganti nama parameter Dialog show menjadi terlihat agar konsisten dengan update terbaru lainnya pada dialog. (I10074)
  • IconButton mengganti nama disabledImageOpacity menjadi DisabledImageOpacity. (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 dengan Button. (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 dan EdgeButton, sehingga lebih mudah untuk menentukan padding konten pada layar yang menyertakan EdgeButton. Di API baru, size EdgeButton hanya diteruskan ke EdgeButton, dan ScreenScaffold menggunakan parameter edgeButtonSpacing untuk jarak antara EdgeButton dan konten daftar. (I424fd)
  • Di DatePicker, kami telah mengganti nama parameter minDate menjadi maxDate, dan minValidDate menjadi maxValidDate. Di DatePickerColors, kami telah mengganti nama parameter selectedPickerContentColor menjadi activePickerContentColor, dan unselectedPickerContentColor menjadi inactivePickerContentColor (Iba17b)
  • Kami telah memperbarui default ArcProgressIndicator menjadi strokeWidth=6dp dan merekomendasikan diameter = 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 parameter show menjadi visible agar kompatibel dengan API animasi Compose lainnya. Selain itu, kami telah menyediakan ConfirmationDialogContent, SuccessConfirmationDialogContent, FailureConfirmationDialogContent untuk situasi saat developer perlu menyesuaikan animasi dialog intro/outro. (Iaeb33)
  • Kami telah memperbarui CircularProgressIndicatorContent menjadi CircularProgressIndicatorStatic (variasi CircularProgressIndicator yang tidak beranimasi) sehingga kini dapat digunakan untuk membuat CircularProgressIndicator 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 di Button, 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 untuk TransformingLazyColumn telah di-refactor yang memicu perubahan API. (I0c6dc)
  • Kami telah memperbarui IconToggleButtonShapes dan TextToggleButtonShapes agar memiliki dua parameter bentuk yang berbeda, yaitu uncheckedPressed dan checkedPressed (I85dbd)
  • Opsi bulan/hari yang tidak valid kini terlihat di DatePicker, dengan invalidPickerContentColor baru, saat menggunakan minDate atau maxDate. (If4541)
  • Kami telah mengupdate Stepper API untuk menyediakan slot increaseIcon dan decreaseIcon - konten untuk slot ini dapat dibuat seperti biasa dari composable Ikon. (Id35da)
  • Kami telah memperbarui dynamicColorScheme dengan menghapus parameter defaultColorScheme opsional dan sekarang menampilkan ColorScheme 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 dengan CompactButton. CompactButton yang hanya berisi ikon harus menggunakan ButtonDefaults.SmallIconSize = 24.dp, sedangkan CompactButton yang berisi ikon dan teks harus menggunakan ButtonDefaults.ExtraSmallIconSize = 20.dp. Sebaiknya CompactButton membungkus kontennya (bukan mengisi lebar maksimum) dan contoh telah diperbarui untuk menunjukkannya. (I0582c)
  • Kami telah menambahkan EdgeButtonDefaults dengan ukuran ikon yang direkomendasikan untuk 4 EdgeButtonSizes yang berbeda. Selain itu, memperbarui tata letak EdgeButton 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 mengekspos LinearProgressIndicatorContent yang menyediakan konten visual tanpa animasi. (Idee99)
  • Kami telah menambahkan composable CircularProgressIndicatorContent baru untuk menampilkan konten visual CircularProgressIndicator tanpa animasi. (Ie33d4)
  • TransformingLazyColumn kini menyediakan komposisi lokal LocalTransformingLazyColumnItemScope yang kini digunakan oleh Card, Button, dan ListHeader untuk berubah bentuk secara otomatis saat ditempatkan di dalam TransformingLazyColumn. Pemanggil dapat menonaktifkan pengubahan bentuk otomatis menggunakan wrapper TransformExclusion baru. (I1652f)
  • Kami telah memperbarui jenis ButtonDefaults.shape menjadi RoundedCornerShape (Iccdf2)

Perbaikan Bug

  • Kami telah memperbaiki bug untuk menghormati alfa yang ada di latar belakang untuk TimeText (I1eb60)
  • Kami telah menyetel TextMotion ke Animated 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 saat ScalingLazyColumn digunakan dengan AutoCenteringParams. (I387dd)
  • Kami telah memperbarui warna dan tipografi untuk ListHeader dan ListSubHeader. Juga warna untuk kontrol tombol di CheckboxButton dan SwitchButton. (I39817)
  • Kami telah memperbaiki posisi ScrollIndicator di LazyColumn dan ScalingLazyColumn dengan ContentPadding. (I2bc51)
  • Kami telah memperbaiki bug yang terlihat dalam animasi progres OpenOnPhoneDialog dengan menggunakan CircularProgressIndicatorContent baru. (I3e443)
  • Kami telah memperbarui HorizontalPagerScaffold dan VerticalPagerScaffold 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 untuk PagerState dengan menghapus parameter orientation, yang tidak lagi diperlukan. Perilaku baru ini adalah agar TimeText tetap berada di tempatnya untuk penentuan halaman horizontal dan vertikal. (I71767)
  • LocalHapticFeedback kini menyediakan implementasi HapticFeedback default saat Vibrator API menunjukkan bahwa haptik didukung. Berikut telah ditambahkan ke HapticFeedbackType - Confirm, ContextClick, GestureEnd, GestureThresholdActivate, Reject, SegmentFrequentTick, SegmentTick, ToggleOn, ToggleOff, VirtualKey. Komponen yang dapat diklik lama Wear Compose seperti Button, IconButton, TextButton, dan Card kini melakukan haptik LONG_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 dan VerticalPageIndicator. (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 dan Dialog yang membentuk API AlertDialog, sehingga penyesuaian dapat ditambahkan jika diperlukan (seperti menyesuaikan animasi AlertDialog sambil mempertahankan tata letak konten yang direkomendasikan). Selain itu, kami telah menambahkan parameter Modifier dan Color ke anggota EdgeButton, ConfirmButton, dan DismissButton dari AlertDialogDefaults. (I4eb71)
  • Kami telah memperbarui Placeholder API sebagai berikut: mengganti nama PlaceholderState.startPlaceholderAnimation menjadi PlaceholderState.animatePlaceholder, PlaceholderState.isShowContent menjadi PlaceholderState.isHidden, dan PlaceholderDefaults.shape menjadi PlaceholderDefaults.Shape; mengganti nama parameter painter di painterWithPlaceholderOverlayBackgroundBrush menjadi originalPainter; mengubah visibilitas PlaceholderState.placeholderProgression dari publik menjadi internal dan mengganti namanya menjadi placeholderShimmerProgression; menambahkan konstanta durasi animasi placeholder ke PlaceholderDefaults. (Ie5a59)
  • Kami telah memperbarui EdgeButton API sebagai berikut: mengganti nama parameter di ScreenScaffold dari bottomButton menjadi edgeButton; menjadikan EdgeButtonSize 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 dan TextToggleButton saat diklik (Ieb333)
  • Menambahkan durasi minimum pada animasi bentuk IconButton dan TextButton (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 dan ScrollIndicator setelah mengganti nama Wear Compose Foundation LazyColumn menjadi TransformingLazyColumn. (I0608b)
  • Parameter EdgeButton's preferredHeight telah diganti namanya menjadi buttonSize dan nilainya hanya dapat dipilih dari 4 konstanta di class nilai EdgeButtonSize yang baru diperkenalkan. (Icdd70)
  • Kami telah mengubah penamaan ListSubheader menjadi ListSubHeader dan menambahkan nilai default yang dapat diakses secara publik untuk ListHeader dan ListSubHeader. (I96730)
  • Kami telah menambahkan komponen HorizontalPagerScaffold dan VerticalPagerScaffold baru untuk Wear yang menyediakan animasi baru dan koordinasi antara komponen teks waktu dan indikator halaman. (Iff7d0)
  • Kami telah menambahkan dukungan rotasi ke HorizontalPagerScaffold dan VerticalPagerScaffold, 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 nama standardMotionScheme dan expressiveMotionScheme 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 menambahkan VerticalPageIndicator untuk digunakan dengan VerticalPager (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 menjadi preferredHeight. (I4fab3)
  • Versi Kotlin telah diupdate ke 1.9 (I1a14c)
  • Kami telah mengganti nama OpenOnPhoneDialogDefaults.Icon menjadi OpenOnPhoneDialogDefaults.OpenOnPhoneIcon untuk menghindari bentrokan dengan Icon(I0f391)
  • Kami telah menambahkan dukungan untuk ScrollIndicator di LazyColumn. (Ia546a)
  • Kami telah memperbarui nilai default untuk TextToggleButton dan IconToggleButton. (I7aaa9)
  • Kami telah menyederhanakan Picker dan PickerGroup API. (Id0653)
  • Kami telah menambahkan CardDefaults.Shape dan CardDefaults.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, dan DatePicker. (I46c7c)
  • Kami telah memperbarui padding di Confirmation dan OpenOnPhoneDialog. (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 dan SegmentedCircularProgressIndicator. Jika progres melebihi 1,0, hal ini akan ditunjukkan oleh warna overflowTrack baru. (Iaaa3d)
  • IconToggleButton dan TextToggleButton 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 dengan Column, karena perlu menentukan tinggi EdgeButton secara eksplisit di ScreenScaffold. (Ie353d)
  • Kami telah menambahkan dukungan untuk LazyColumn Wear Compose dengan ScreenScaffold kami (dan menambahkan implementasi ScrollInfoProvider untuk LazyColumnState). (Ib8d29)
  • Kami telah menggabungkan LocalTextMaxLines, LocalTextAlign, LocalTextOverflow ke dalam satu komposisi lokal LocalTextConfiguration 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 dan TextButton. (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 dari RowScope. (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 dan ScreenScaffold ke library Material3, yang mencakup fungsi untuk mengoordinasikan pelapisan dan transisi TimeText dan ScrollIndicator. AppScaffold menyediakan komponen scaffold level teratas yang berada di atas semua layar. Oleh karena itu, menambahkan TimeText ke AppScaffold memungkinkan TimeText tetap berada di tempatnya saat menggeser antar-layar. Layar itu sendiri dapat mengganti atau menyembunyikan teks waktu. ScreenScaffold menyediakan slot untuk ScrollIndicator 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 sehingga ScreenStage 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 (seperti EdgeButton), yang akan ditampilkan dan diubah ukurannya bergantung pada konten yang di-scroll (I032eb)
  • Kami telah menambahkan Modifier.scrollTransform dan Modifier.targetMorphingHeight untuk menambahkan efek gerakan Material3 ke item di LazyColumn. (Ie229a)
  • Kami telah menambahkan SegmentedCircularProgressIndicator sebagai variasi pada CircularProgressIndicator. Variasi yang disegmentasi menampilkan satu nilai progres di semua segmen atau menampilkan setiap segmen sebagai aktif/nonaktif. (I6e059)
  • Kami telah menambahkan LinearProgressIndicator sebagai alternatif untuk CircularProgressIndicator 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 dan TimeText tumpang-tindih, dan mengaburkan waktu. (Ia11fd)
  • Kami telah menambahkan LevelIndicator, yang menampilkan nilai setelan seperti volume, dan dapat digunakan dengan komponen Stepper yang ada untuk membuat layar volume. LevelIndicator mirip dengan ScrollIndicator, 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 dan SplitRadioButton - komponen ini menyederhanakan API sebelumnya dengan menggabungkan (Split)SelectableButton dan kontrol radio turunan (If7ae8)
  • Kami telah menambahkan CheckboxButton dan SplitCheckboxButton - komponen ini menyederhanakan API sebelumnya dengan menggabungkan (Split)ToggleButton dan kontrol Checkbox turunan (Ia8f70)
  • Kami telah menambahkan SwitchButton dan SplitSwitchButton - 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 dan TextButton saat ditekan. (Iffca5)
  • Kami telah menambahkan variasi warna tambahan, FilledVariant, ke Button, IconButton, TextButton, CompactButton, dan EdgeButton (I65fc3)
  • Kami telah menambahkan parameter forcedSize ke ImageWithScrimPainter, sehingga latar belakang gambar Tombol kini mempertahankan ukuran komponennya secara default. Menetapkan forcedSize = null akan mengadopsi Painter.instrinsicSize. (Ic57af)
  • Kami telah menambahkan klik lama ke Tombol (Ib613d)
  • Dukungan klik lama juga telah ditambahkan ke IconButton dan TextButton. (I38891)
  • Dukungan klik lama telah ditambahkan ke Kartu. (I305d5)
  • Kami telah menambahkan LocalTextMaxLines, LocalTextAlign, LocalTextOverflow sebagai CompositionLocals dan menggunakannya sebagai default parameter di Text. Sekarang, komposisi lokal dapat digunakan oleh komponen seperti CheckboxButton, 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 dan TextToggleButtonColors untuk menggantikan ToggleButtonColors yang kini telah dihapus. (Ie0bf1)

Perbaikan Bug

  • Kami telah memperbarui Button, FilledTonalButton, OutlinedButton, ChildButton, CompactButton untuk menggunakan CompositionLocals 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 menjadi 6dp untuk membedakannya dari ScrollIndicator yang memiliki lebar goresan 4dp. (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 dan RadioButton 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, dan RadioButton, 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 menjadi onSelect untuk RadioButton. (I1a971)
  • Lakukan tokenisasi RadioButton dan SplitRadioButton, serta refaktorisasi metode yang ada untuk mengurangi jumlah pencarian CompositionLocal dengan menambahkan instance warna yang di-cache, dan menjadikan metode RadioButtonColors dan SplitRadioButtonColors 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, dan SplitToggleButtonColors dengan membuat instance yang di-cache secara internal dan mengurangi penggunaan CompositionLocal. (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 menghapus filledButtonColors duplikat. (I4fe3b)
  • Kami telah memfaktorkan ulang pola default untuk ButtonColors, IconButtonColors, dan TextButtonColors dengan membuat instance yang di-cache secara internal dan mengurangi penggunaan CompositionLocal. (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 menggunakan Modifier.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 dengan ToggleButton yang sudah ada karena RadioButton dapat dipilih (dan beroperasi dalam grup pilihan) sedangkan ToggleButton 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 menampilkan MutableInteractionSource nullable yang secara default bernilai null. Tidak ada perubahan semantik di sini: meneruskan null berarti Anda tidak ingin mengangkat MutableInteractionSource, dan MutableInteractionSource akan dibuat di dalam komponen jika diperlukan. Mengubah ke null memungkinkan beberapa komponen tidak pernah mengalokasikan MutableInteractionSource, dan memungkinkan komponen lain hanya membuat instance secara lambat saat diperlukan, yang meningkatkan performa di seluruh komponen ini. Jika Anda tidak menggunakan MutableInteractionSource 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 dan wear:compose-material3 yang menggantikan rememberRipple yang tidak digunakan lagi. Menambahkan CompositionLocal, LocalUseFallbackRippleImplementation sementara, untuk mengembalikan komponen Material ke penggunaan API rememberRipple/RippleTheme yang tidak digunakan lagi. Hal ini akan dihapus dalam rilis stabil berikutnya, dan hanya dimaksudkan sebagai bantuan migrasi sementara untuk kasus saat Anda memberikan RippleTheme 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 dan SplitToggleButton 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, dan RadioButton 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, dan RadioButton 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 menjadi BasicSwipeToDismissBox. Hal ini membuat perbedaan antara komponen tingkat Foundation dan SwipeToDismissBox tingkat Material3 menjadi lebih jelas. Yang terakhir menarik warna dari MaterialTheme untuk digunakan dalam scrim dan mendelegasikan implementasi yang tersisa ke BasicSwipeToDismissBox. (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 dari HorizontalPageIndicator Material3 - sebagai gantinya, parameter ini akan mengikuti bentuk layar perangkat (linear atau bulat). (I83728)
  • Kami telah memisahkan warna untuk SplitToggleButton dari warna untuk ToggleButton, dengan menambahkan class SplitToggleButtonColors 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 dan ListSubheader 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 dari TextButton dan TextToggleButton bulat karena ukuran tersebut hanya berlaku untuk IconButton. (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, dan TextButton 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 dan TextToggleButton ke Material3, tombol tombol lingkaran dengan satu slot untuk ikon dan teks. Untuk ukuran ToggleButton yang berbeda, sebaiknya gunakan Modifier.touchTargetAwareSize dengan ukuran yang disediakan di tombol pengaktifan masing-masing. (I9f015)
  • Kami telah menambahkan ListHeader dan ListSubheader ke komponen Material3 kami. (Ibaefe)
  • Kami telah menambahkan SwipeToDismissBox Material3, yang memanggil SwipeToDismissBox 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 dan InlineSlider kini mendukung klik berulang saat ditekan lama sehingga Anda dapat menambah/mengurangi nilai Stepper dan InlineSlider 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 menyediakan Modifier.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 API wear.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 ekstensi toDisabledColor 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 ukuran TextButton, sebaiknya gunakan Modifier.touchTargetAwareSize dan ExtraSmallButtonSize, SmallButtonSize, DefaultButtonSize, dan LargeButtonSizeIcon yang disediakan di TextButtonDefaults. TextButton default tidak memiliki batas dan latar belakang transparan untuk tindakan dengan penekanan rendah. Untuk tindakan yang memerlukan penekanan tinggi, gunakan filledTextButtonColors; untuk TextButton bergaris dengan penekanan sedang, tetapkan batas ke ButtonDefaults.outlinedButtonBorder; untuk titik tengah antara bergaris dan terisi, gunakan filledTonalTextButtonColors. (I667e4)
  • Kami telah menambahkan Card, OutlinedCard, AppCard, dan TitleCard ke dalam library Wear Compose Material3. AppCard dan TitleCard juga dapat diberi tampilan garis luar menggunakan CardDefaults.outlinedCardColors dan CardDefaults.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). Konstruktor ButtonColors 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, dan OutlinedIconButton. Untuk berbagai ukuran IconButton, sebaiknya gunakan Modifier.touchTargetAwareSize dan ExtraSmallButtonSize, SmallButtonSize, DefaultButtonSize, dan LargeButtonSizeIcon yang disediakan di IconButtonDefaults. Kami juga menyediakan IconButtonDefaults.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 menyetel PlatformTextStyle.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:

    • Tema Material - mengonfigurasi skema warna, tipografi, dan bentuk secara konsisten di seluruh komponen dalam library. Tema Material3 telah merevisi warna yang mendukung kontras yang dapat diakses. (I84005)
    • Teks/Ikon - elemen penyusun untuk aplikasi Wear Compose (I8e06a)

  • 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.