wear protolayout

  
Library ini memungkinkan penentuan serangkaian tata letak UI dan ekspresi non-UI dirender/dievaluasi pada platform jarak jauh.
Update Terbaru Rilis Stabil Kandidat Rilis Rilis Beta Rilis Alfa
22 Oktober 2025 1.3.0 - - 1.4.0-alpha02

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada wear-protolayout, 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 {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0"

    // Use to implement support for Wear ProtoLayout
    implementation "androidx.wear.protolayout:protolayout:1.3.0"

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0"
}

Kotlin

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0")

    // Use to implement support for Wear ProtoLayout
    implementation("androidx.wear.protolayout:protolayout:1.3.0")

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0")
}

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.

Versi 1.4

Versi 1.4.0-alpha02

22 Oktober 2025

androidx.wear.protolayout:protolayout-*:1.4.0-alpha02 dirilis. Versi 1.4.0-alpha02 berisi commit ini.

Fitur Baru

  • Menambahkan sumber peristiwa Platform baru (isInAmbientMode) yang menjelaskan apakah perangkat dalam mode standby atau tidak (Ief832)

Perubahan API

  • PendingIntent clickable kini menerima tindakan penggantian (LoadAction/LaunchAction) yang akan digunakan saat PendingIntent tidak didukung oleh Perender ProtoLayout. Tindakan penggantian akan otomatis diambil dan ditempatkan dalam tata letak saat versi Renderer lebih rendah daripada yang mendukung PendingIntent. (I6eee2, b/450259727)
  • Kolom protoLayoutScope dalam MaterialScope kini dibuat NonNull agar lebih mudah digunakan saat MaterialScope dibuat melalui materialScopeWithResources. Selain itu, ada fungsi hasProtoLayoutScope untuk memeriksa keberadaannya. (I1858f, b/450067019)

Versi 1.4.0-alpha01

24 September 2025

androidx.wear.protolayout:protolayout-*:1.4.0-alpha01 dirilis. Versi 1.4.0-alpha01 berisi commit ini.

Fitur Baru

  • Menambahkan metode helper untuk LayoutModifier yang membuat elemen memudar saat kartu menjadi terlihat. (I38531, b/390345969)
  • Menambahkan materialScopeWithResources untuk mendukung konsep MaterialScope M3 yang juga menangani pendaftaran resource otomatis. Di dalamnya, ditambahkan metode bantuan baru untuk gambar (backgroundImage avatarImage dan ikon) yang menghilangkan kebutuhan untuk mendaftarkan resource secara manual di onTileResourceRequest saat digunakan. (I525bd, b/428692714)
  • Helper Kotlin ProtoLayout untuk Image dan ImageResources untuk digunakan dengan ProtoLayoutScope dan pendaftaran resource otomatis. (Iada82, b/430584304)
  • Menambahkan getter untuk jumlah properti Lottie yang diizinkan dalam penyesuaian satu animasi Lottie. (I73733, b/436532706)
  • Menambahkan API di AndroidLottieResourceByResId untuk memungkinkan penyesuaian animasi Lottie melalui properti dan menambahkan API untuk membuat properti bagi slot tema dengan ID slot ke warna yang ditentukan. (I301b3, b/423581481)
  • Menambahkan API penyedia untuk menerima PendingIntent sebagai tindakan klik (I01978, b/433802488)
  • Tambahkan API baru di Image.Builder - setImageResource untuk menetapkan objek resource secara langsung ke Gambar di onTileRequest, tanpa perlu mendaftarkannya dalam pemetaan di onTileResourcesRequest. (Ifa69a, b/428693523)
  • Menambahkan konsep ProtoLayoutScope sebagai persiapan untuk penanganan resource yang lebih baik di Petak. (I132ce, b/428692423)
  • ProtoLayout Material3 MaterialScope kini mengekspos kolom Context sebagai publik, untuk digunakan dalam metode dalam cakupan, tanpa perlu meneruskannya. (I0e5cc, b/414559956)
  • Menjadikan API semantik heading publik (I75299, b/413653475)
  • Mengekspos konstanta ARC_DIRECTION_* sebagai publik untuk digunakan di Arc/ArcLine/ArcText/DashedArcLine. (I83959, b/427556439)

Perubahan API

  • Kami telah menghentikan penggunaan metode Image.Builder() dan Image.Builder.setResourceId untuk mendukung API pendaftaran resource otomatis baru, yang tersedia di API Image.Builder(ProtoLayoutScope) dan Image.Builder.setImageResource yang menghilangkan kebutuhan untuk mengganti onTileResourcesRequest. (I7bfe6, b/432758526)
  • Memindahkan API untuk membuat ProtoLayoutScope dari terbatas ke publik. Namun, fungsi tersebut tidak boleh digunakan karena sistem sudah menangani panggilan tersebut. (I1d8e8, b/432758251)

Perbaikan Bug

Versi 1.3

Versi 1.3.0

4 Juni 2025

androidx.wear.protolayout:protolayout-*:1.3.0 dirilis. Versi 1.3.0 berisi commit ini.

Perubahan penting sejak versi 1.2.0

  • Desain Material 3 hadir di smartwatch, dengan komponen dan tata letak yang dioptimalkan untuk layar bulat dan diskalakan dengan tepat dari ukuran layar kecil hingga besar
    • Hal ini mencakup library protolayout-material3 khusus Kotlin dengan lebih banyak API seperti Compose untuk komponen dan fitur berikut:
    • Tema warna dinamis yang berasal dari sistem dan tampilan jam dengan tema Material3 terbaru untuk warna, bentuk, dan tipografi
    • MaterialScope untuk menangani semua default yang memiliki opini dan penyesuaian yang lebih mudah
    • iconEdgeButton, textEdgeButton
    • iconButton, textButton, button, imageButton, avatarButton, compactButton
    • titleCard, appCard, graphicDataCard, iconDataCard, textDataCard
    • circularProgressIndicator, segmentedCircularProgressIndicator
    • primaryLayout, buttonGroup
    • Semua komponen berfungsi di semua level SDK dan versi ProtoLayout Renderer, serta menyediakan penggantian yang wajar jika berlaku
  • API yang lebih cocok untuk Kotlin dan mirip Compose untuk elemen ProtoLayout dasar
    • LayoutModifier dengan kemampuan untuk menambahkan sebagian besar pengubah sebagai fungsi berantai (padding, contentDescription (termasuk clearSemantics), background, clip, opacity, dll.), yang dapat dikonversi ke objek Modifiers yang ada
    • LayoutColors dan LayoutString sebagai jenis dengan dukungan yang lebih mudah untuk menggunakan kolom dan batasan dinamis
    • text dan fontStyle
    • dukungan peta yang lebih baik untuk StateBuilder, termasuk DynamicDataMap dan metode factory seperti intAppDataKey untuk memudahkan pembuatan objek AppDataKey
  • Animasi Lottie mendukung penyertaan opsi untuk menyetel pemicu yang berbeda tentang kapan animasi harus dimulai, misalnya saat tata letak dimuat atau saat tata letak menjadi terlihat
    • Peningkatan dukungan gradien:
    • Linear gradient API sebagai bagian dari Brush yang dapat digunakan dalam pengubah Background untuk elemen seperti Box, Spacer, dll. …
    • Mengizinkan nilai warna dinamis di ColorStop yang digunakan untuk gradien linear dan sapuan
    • Gradien Sapuan yang ada dalam objek busur kini mendukung warna dinamis serta sudut awal dan akhir
  • Binding data platform di protolayout-expression untuk menerima informasi kapan saja visibilitas tata letak tersebut diubah, yang misalnya dapat digunakan untuk menyembunyikan bagian tertentu dari tata letak saat kartu di-swipe ke
  • Library pengujian - protolayout-testing - telah ditambahkan untuk mendukung cakupan pengujian Unit yang lebih mudah untuk elemen ProtoLayout apa pun
  • Elemen baru DashedArcLine dengan kumpulan fitur yang ditingkatkan sehingga garis dapat memiliki garis putus-putus, berbeda dengan ArcLine yang ada
  • Dukungan ArcSpacer untuk menyetel panjangnya dalam dimensi DP, bukan derajat
  • Menambahkan sumbu kebulatan FontSetting yang berlaku untuk beberapa font

Versi 1.3.0-rc01

20 Mei 2025

androidx.wear.protolayout:protolayout-*:1.3.0-rc01 dirilis tanpa perubahan dari rilis sebelumnya. Versi 1.3.0-rc01 berisi commit ini.

Versi 1.3.0-beta02

7 Mei 2025

androidx.wear.protolayout:protolayout-*:1.3.0-beta02 dirilis. Versi 1.3.0-beta02 berisi commit ini.

Perbaikan Bug

  • Kami telah melakukan peningkatan penting pada nilai desain Tipografi yang diterapkan di API 36 dan yang lebih baru. Hal ini karena mulai API 36, semua Kartu akan menggunakan font sistem, sehingga perubahan ini memberikan konsistensi yang lebih baik pada carousel Kartu. (If316f)
  • Pembangun Text,Spacer, ArcLine, dan DashedArcLine tidak akan menampilkan pengecualian jika layoutConstraintsuntuk nilai dinamis tidak ditetapkan. Perhatikan bahwa perender lama masih memerlukan layoutConstraints untuk ditetapkan dan akan mengabaikan nilai dinamis yang tidak ditetapkan. (Ic52e8)
  • Tambahkan pengubah semantik heading untuk menunjukkan bahwa elemen tata letak adalah heading untuk bagian konten untuk tujuan aksesibilitas, dan tandai teks di slot judul primaryLayout agar menjadi heading aksesibilitas secara default. (Iae1fb)
  • Penyempurnaan UX akhir primaryLayout dengan mengurangi jarak antara slot judul dan slot utama menjadi 4 dp, bukan 6 dp di layar yang lebih kecil. (I0e056)
  • Terapkan deskripsi konten default ke textEdgeButton. (Ifaf8b)
  • Pembaruan kecil pada padding dalam avatarButton. (I0910b)

Versi 1.3.0-beta01

9 April 2025

androidx.wear.protolayout:protolayout-*:1.3.0-beta01 dirilis. Versi 1.3.0-beta01 berisi commit ini.

Fitur Baru

Rilis 1.3.0-beta01 Wear ProtoLayout menunjukkan bahwa rilis library ini sudah berfitur lengkap dan API dikunci (kecuali jika ditandai sebagai eksperimental). Wear ProtoLayout 1.3 menyertakan fungsi dan API baru berikut:

  • Desain Material 3 hadir di smartwatch, dengan komponen dan tata letak yang dioptimalkan untuk layar bulat dan diskalakan dengan tepat dari ukuran layar kecil hingga besar
    • Hal ini mencakup library protolayout-material3 khusus Kotlin dengan lebih banyak API seperti Compose untuk komponen dan fitur berikut:
    • Tema warna dinamis yang berasal dari sistem dan tampilan jam dengan tema Material3 terbaru untuk warna, bentuk, dan tipografi
    • MaterialScope untuk menangani semua default yang memiliki opini dan penyesuaian yang lebih mudah
    • iconEdgeButton, textEdgeButton
    • iconButton, textButton, button, imageButton, avatarButton, compactButton
    • titleCard, appCard, graphicDataCard, iconDataCard, textDataCard
    • circularProgressIndicator, segmentedCircularProgressIndicator
    • primaryLayout, buttonGroup
    • Semua komponen berfungsi di semua tingkat SDK dan versi ProtoLayout Renderer, serta menyediakan penggantian yang wajar jika berlaku
  • API yang lebih cocok untuk Kotlin dan mirip Compose untuk elemen ProtoLayout dasar
    • LayoutModifier dengan kemampuan untuk menambahkan sebagian besar pengubah sebagai fungsi berantai (padding, contentDescription (termasuk clearSemantics), background, clip, opacity, dll.), yang dapat dikonversi ke objek Modifiers yang ada
    • LayoutColors dan LayoutString sebagai jenis dengan dukungan yang lebih mudah untuk menggunakan kolom dan batasan dinamis
    • text dan fontStyle
    • dukungan peta yang lebih baik untuk StateBuilder, termasuk DynamicDataMap dan metode factory seperti intAppDataKey untuk memudahkan pembuatan objek AppDataKey
  • Animasi Lottie mendukung penyertaan opsi untuk menyetel pemicu yang berbeda tentang kapan animasi harus dimulai, misalnya saat tata letak dimuat atau saat tata letak menjadi terlihat
    • Peningkatan dukungan gradien:
    • Linear gradient API sebagai bagian dari Brush yang dapat digunakan dalam pengubah Background untuk elemen seperti Box, Spacer, dll. …
    • Mengizinkan nilai warna dinamis di ColorStop yang digunakan untuk gradien linear dan sapuan
    • Gradien Sapuan yang ada dalam objek busur kini mendukung warna dinamis serta sudut awal dan akhir
  • Binding data platform di protolayout-expression untuk menerima informasi kapan saja visibilitas tata letak tersebut diubah, yang misalnya dapat digunakan untuk menyembunyikan bagian tertentu dari tata letak saat kartu di-swipe ke
  • Library pengujian - protolayout-testing - telah ditambahkan untuk mendukung cakupan pengujian Unit yang lebih mudah untuk elemen ProtoLayout apa pun
  • Elemen baru DashedArcLine dengan kumpulan fitur yang ditingkatkan sehingga garis dapat memiliki garis putus-putus, berbeda dengan ArcLine yang ada
  • Dukungan ArcSpacer untuk menyetel panjangnya dalam dimensi DP, bukan derajat
  • Menambahkan sumbu kebulatan FontSetting yang berlaku untuk beberapa font

Versi 1.3.0-alpha10

12 Maret 2025

androidx.wear.protolayout:protolayout-*:1.3.0-alpha10 dirilis. Versi 1.3.0-alpha10 berisi commit ini.

Fitur Baru

  • Menambahkan helper untuk Kuas di Pengubah Latar Belakang Kotlin. (I995de)
  • Kolom Konteks Android wajib telah dipublikasikan di MaterialScope untuk memungkinkan penggunaan yang lebih mudah dalam fungsi developer yang membuat komponen untuk kartu Material3. (I7df73)

Perubahan API

  • Mengganti nama API platformVisibilityStatus menjadi PlatformEventSources.isLayoutVisible dan menambahkan API eksperimental baru PlatformEventSources.isLayoutUpdatePending. (Ie1e04)

Perbaikan Bug

  • Margin untuk primaryLayout kini dibulatkan dengan benar, yang dapat memengaruhi beberapa tata letak hingga 2dp lebih sedikit untuk slot utama. (I8f5d3)
  • Klarifikasi tema warna dinamis default di komponen Material3 ProtoLayout. (Iff5f3)
  • Tipografi Typography.NUMERAL_* tidak lagi berbentuk tabel/monospace secara default. Jika teks dianimasikan, sebaiknya tambahkan setelan FontSetting.tabularNum() ke teks tersebut. Dalam semua kasus lainnya, opsi monospace ini tidak diperlukan dan akan ada lebih banyak karakter yang tersedia jika tidak menggunakannya. (Id3cd9)
  • Klarifikasi tema warna dinamis default di komponen Material3 ProtoLayout. (I9d831)

Versi 1.3.0-alpha09

26 Februari 2025

androidx.wear.protolayout:protolayout-*:1.3.0-alpha09 dirilis. Versi 1.3.0-alpha09 berisi commit ini.

Fitur Baru

  • Menambahkan pengubah eksperimental untuk enterTransition dan exitTransition (I4a4d6)
  • Kami telah menambahkan binding platform tambahan untuk menerima status visibilitas tata letak penuh, setiap kali status tersebut berubah. (I250c3)
  • Mengizinkan penyisipan status aplikasi pengujian dan data platform ke LayoutElementAssertionsProvider untuk mengevaluasi nilai dinamis. (Ib5fcb)
  • Menambahkan filter sudut ke library pengujian protolayout (Ie2361)
  • ButtonColors, CardColors, dan ProgressIndicatorColors kini mendukung metode penyalinan, dengan penggantian opsional beberapa parameter. (Ie2054)

Perubahan API

  • Menambahkan dukungan data binding dinamis ke library pengujian (Ib98de)
  • Memperbaiki imageButton saat digunakan dengan fungsi backgroundImage dengan menghapus overlay. Selain itu, izinkan fungsi backgroundImage untuk memungkinkan penentuan null untuk warna overlay, yang berarti overlay tidak akan diterapkan. (Ibec3c)

Perbaikan Bug

  • Mengubah metode hasValueOfType default untuk menampilkan UnsupportedOperationException, bukan IllegalArgumentException. (Ia36c3)
  • Nilai token warna default diperbarui untuk mencerminkan spesifikasi terbaru. (I75d44)
  • Perbaikan untuk masalah aliasing yang terlihat pada garis busur di perender petak AndroidX. (I88190)

Versi 1.3.0-alpha08

12 Februari 2025

androidx.wear.protolayout:protolayout-*:1.3.0-alpha08 dirilis. Versi 1.3.0-alpha08 berisi commit ini.

Fitur Baru

  • Menambahkan parameter daftar FontSetting untuk teks Material3. (Ic102d)
  • Menambahkan class DynamicDataMap yang kini didukung StateBuilder untuk API Kotlin yang lebih aman untuk status aplikasi (I012ba)
  • Menambahkan metode factory seperti intAppDataKey untuk mempermudah pembuatan objek AppDataKey (Icea2a)
  • DynamicDataValue kini memiliki metode hasValueOfType(Class<?>) selain metode hasInt/hasColor/.... (I4f7a6)
  • Kami telah menambahkan errorDim ke ProtoLayout Material3 ColorScheme, untuk error prioritas tinggi atau tindakan darurat seperti peringatan keselamatan. (Ia17bb)
  • Kami telah menambahkan perlindungan terhadap error saat mengakses setelan reducemotion global, yang dipicu di beberapa platform tempat setelan tersebut tidak disediakan. (I01e2c)

Perubahan API

  • addKeyToValueMapping diganti namanya menjadi addToStateMap dan metode DynamicDataMap.put dihapus karena berlebihan. (Ibe9dd)
  • Tipografi Material3 kini mendukung sumbu variabel kebulatan untuk font sistem yang mendukung sumbu ini. ProtoLayout FontSetting mendukung sumbu kebulatan untuk font yang mendukung sumbu ini. (I33eb5)
  • Mengganti nama multilineAlignment menjadi perataan dalam metode teks Material3. (I2b66b)
  • Memperbarui indikator progres melingkar menjadi jenis Kotak, juga menentukan mainContent di constructGraphic menjadi jenis Kotak (I5a3dc)
  • Dukungan yang lebih baik untuk menggunakan indikator progres melingkar dalam grafik (I039db)

Perbaikan Bug

  • Mengizinkan nilai dinamis di ColorStop dan juga untuk sudut awal/akhir di SweepGradient. (I0146d)
  • Perbaikan Dokumen. (I4a63a)
  • Memperbarui komponen Material 3 (graphicCard dan avatarButton) untuk menyediakan penggantian saat dimensi perluasan weight tidak didukung (misalnya, di bawah API 33). Memperbarui komponen teks untuk melakukan penggantian ke TEXT_OVERFLOW_ELLIPSIZE_END jika TEXT_OVERFLOW_ELLIPSIZE tidak didukung oleh perender. (I19e2c)
  • Pembaruan Dokumen untuk PrimaryLayoutMargins. (Ibaf7b)

Versi 1.3.0-alpha07

29 Januari 2025

androidx.wear.protolayout:protolayout-*:1.3.0-alpha07 dirilis. Versi 1.3.0-alpha07 berisi commit ini.

Fitur Baru

  • Menambahkan opsi API untuk menyetel pemicu yang berbeda untuk animasi Lottie. Selain itu, menambahkan API untuk pemicu yang diaktifkan saat tata letak terlihat (I8272d)
  • Menambahkan pengubah border, visibility, dan opacity. (I6d3dd)
  • Menambahkan tombol avatar ke komponen ProtoLayout Material3. (Idb5ae)
  • Kami kini mengizinkan margin (samping dan dalam beberapa kasus bawah) untuk disesuaikan di Material3 primaryLayout. (Ib22f6)
  • Tambahkan varian tersegmentasi dari indikator progres melingkar. (I6a648)
  • Menambahkan komponen tombol ringkas ke ProtoLayout Material3. (Ia3c5c)
  • Menambahkan komponen tombol bentuk pil dan tombol gambar ke ProtoLayout Material3. (Ifb88a)

Perubahan API

  • LayoutModfier.foldIn kini disebut foldRight agar lebih mencerminkan perilaku yang diharapkan (Idf242)
  • Pemicu VisibleOnce kini bersifat eksperimental. (Ib2d26)
  • Menghapus withOpacity dari API publik karena ada alternatif pustaka grafis. (I030c2)
  • Mengganti nama metode tingkat teratas di LayoutString.kt dan LayoutColor.kt agar memiliki nama yang kompatibel dengan Java. (I7aff0)
  • Menghapus tipografi non-ProtoLayout di Material3. (Idd9ae)
  • Menambahkan akhiran Color ke kolom di class *Colors di Material3. (I2d114)

Perbaikan Bug

  • Menambahkan implementasi penggantian EdgeButton untuk perender lama tanpa dukungan sudut asimetris. (I63364)
  • Menambahkan implementasi penggantian indikator progres melingkar dengan perender yang lebih lama. (I0f134)

Versi 1.3.0-alpha06

15 Januari 2025

androidx.wear.protolayout:protolayout-*:1.3.0-alpha06 dirilis. Versi 1.3.0-alpha06 berisi commit ini.

Fitur Baru

  • LayoutColor untuk mendukung jenis warna statis dan dinamis (I4c89b)
  • Menambahkan komponen textButton ProtoLayout Material3. (Id680d)
  • Menambahkan komponen iconButton ProtoLayout Material3. (Ica3f0)
  • Menambahkan komponen penampung tombol Material3 ProtoLayout. (I17a38)
  • Menambahkan dukungan untuk pengubah semantik yang dapat dirantai ke protolayout-material3 (I4af62)
  • Menambahkan segmen tunggal ProtoLayout Material3 CircularProgressIndicator (I2c8a2)
  • Menambahkan pengubah padding,metadata (I8720a)
  • Menambahkan pengubah background,clip, dan clickable (I35478)
  • Menambahkan LinearGradient ke Kuas dan mengizinkannya digunakan di Pengubah Latar Belakang. (Ic4dea)
  • Menambahkan ukuran kecil untuk appCard dan titleCard. (I91f98)
  • Menambahkan komponen ProtoLayout Material3 graphicDataCard. (I92be7)
  • Menambahkan komponen ProtoLayout Material3 iconDataCard dan textDataCard. (I4e1e4)
  • Menambahkan komponen ProtoLayout Material3 appCard. (Id4c57)
  • Abstrak EdgeButtonColors ke ButtonColors. (I83624)
  • Menambahkan komponen ProtoLayout Material3 titleCard. (I2dc72)

Perubahan API

  • ProtoLayout Material3 API kini menerima LayoutString untuk mendukung teks statis dan dinamis. (I9c24a)

Perbaikan Bug

  • Menambahkan implementasi perender untuk mem-inflate DashedArcLine (I0c700)
  • Perubahan perender untuk mengizinkan ArcSpacer mengambil panjang dp. (I1437b)

Versi 1.3.0-alpha05

11 Desember 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha05 dirilis. Versi 1.3.0-alpha05 berisi commit ini.

Fitur Baru

  • Menambahkan LayoutString untuk mendukung kolom string tata letak yang dapat diikat. (Ida650)
  • Menambahkan komponen penampung kartu ProtoLayout Material3. (Ic985a)

Perbaikan Bug

  • Library ini kini menggunakan anotasi nullabilitas JSpecify, yang merupakan penggunaan jenis. Developer Kotlin harus menggunakan argumen compiler berikut untuk menerapkan penggunaan yang benar: -Xjspecify-annotations=strict (ini adalah nilai default yang dimulai dengan compiler Kotlin versi 2.1.0). (Id1f9b, b/326456246)

Versi 1.3.0-alpha04

13 November 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha04 dirilis. Versi 1.3.0-alpha04 berisi commit ini.

Fitur Baru

  • Memperbarui bentuk Material3 menjadi class dengan kolom yang menyimpan nilai Corner sebenarnya, sama seperti di Wear Compose. (Ied8cd)
  • Warna Material3 yang diperbarui untuk menyertakan konsep ColorScheme, sama seperti di Wear Compose. (If645e)
  • Menambahkan beberapa pencocok yang umum digunakan ke library pengujian. (Ie5cec)

Versi 1.3.0-alpha03

30 Oktober 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha03 dirilis. Versi 1.3.0-alpha03 berisi commit ini.

Fitur Baru

  • Menambahkan LayoutElementAssertionsProvider, LayoutElementAssertion, dan LayoutElementMatcher ke library pengujian (Id1110)

Versi 1.3.0-alpha02

16 Oktober 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha02 dirilis. Versi 1.3.0-alpha02 berisi commit ini.

Fitur Baru

  • Versi awal library Material 3. Mencakup komponen text, edgeButton, buttonGroup, dan primaryLayout.

Perbaikan Keamanan

  • Mulai perubahan ini, androidx dikompilasi terhadap protobuf 4.28.2 untuk mengatasi CVE-2024-7254. Upgrade dependensi Anda pada androidx.wear.protolayout:protolayout-proto dan androidx.wear.protolayout:protolayout-external-protobuf versi 1.3.0-alpha01 ke 1.3.0-alpha02 untuk mengatasi risiko kerentanan.

Kontribusi Eksternal

Versi 1.3.0-alpha01

2 Oktober 2024

androidx.wear.protolayout:protolayout-*:1.3.0-alpha01 dirilis. Versi 1.3.0-alpha01 berisi commit ini.

Perbaikan Bug

  • Memperjelas bahwa ketersediaan nama jenis font Roboto dan Roboto Flex bergantung pada perangkat. (I193be)
  • Mengaktifkan jenis font Roboto Flex di perender Petak AndroidX. (I08e94)

Versi 1.2

Versi 1.2.1

16 Oktober 2024

androidx.wear.protolayout:protolayout-*:1.2.1 dirilis. Versi 1.2.1 berisi commit ini.

Perbaikan Keamanan

  • Mulai perubahan ini, androidx dikompilasi terhadap protobuf 4.28.2 untuk mengatasi CVE-2024-7254. Upgrade dependensi Anda pada androidx.wear.protolayout:protolayout-proto dan androidx.wear.protolayout:protolayout-external-protobuf versi 1.2.0 ke 1.2.1 untuk mengatasi risiko kerentanan.

Versi 1.2.0

7 Agustus 2024

androidx.wear.protolayout:protolayout-*:1.2.0 dirilis. Versi 1.2.0 berisi commit ini.

Perubahan penting sejak 1.1.0

  • FontStyle telah diupdate untuk memiliki dukungan font tambahan untuk sumbu variabel dan API pemilihan font yang lebih baik untuk mendukung font Flex mendatang.
  • Dukungan Pengubah Tambahan:
    • Pengubah transformasi yang menawarkan terjemahan, rotasi, dan penskalaan dengan atau tanpa animasi.
    • Menentukan nilai yang berbeda (horizontal dan vertikal) untuk setiap radius sudut.
  • Meningkatkan aksesibilitas semua target sentuh dengan memperluas area yang dapat diketuk dari elemen apa pun yang menggunakan pengubah Clickable menjadi minimal 48dp x 48dp.
  • Meningkatkan kualitas PrimaryLayout dan EdgeContentLayout dengan menambahkan setResponsiveContentInsetEnabled untuk mendukung perilaku responsif tata letak ini di berbagai ukuran layar dan meningkatkan konsistensi Kartu.
  • Penskalaan/non-penskalaan yang ditingkatkan pada Teks Material untuk penskalaan font non-linear Android 14.
  • Peningkatan dukungan untuk arah tata letak RTL pada semua elemen busur.

Perubahan lainnya

  • Untuk mengetahui serangkaian perubahan yang lebih lengkap yang diperkenalkan di versi 1.1.0, lihat catatan rilis beta01.

Versi 1.2.0-rc01

24 Juli 2024

androidx.wear.protolayout:protolayout-*:1.2.0-rc01 dirilis. Versi 1.2.0-rc01 berisi commit ini.

Perbaikan Bug

  • Kami telah memperbaiki Chip Material standar sehingga dapat digunakan sebagai ikon saja jika tidak ada label primer atau sekunder yang diteruskan. (Iceef9)
  • Dokumentasi untuk tata letak Material telah diperbarui untuk menyertakan visual dari halaman yang relevan agar tata letak lebih mudah dipahami. (I0256a)

Versi 1.2.0-beta01

10 Juli 2024

androidx.wear.protolayout:protolayout-*:1.2.0-beta01 dirilis. Versi 1.2.0-beta01 berisi commit ini.

Fitur Baru

Rilis 1.2.0-beta01 Wear ProtoLayout menunjukkan bahwa rilis library ini sudah berfitur lengkap dan API dikunci (kecuali jika ditandai sebagai eksperimental). Wear ProtoLayout 1.2 menyertakan fungsi dan API baru berikut:

  • FontStyle telah diperbarui untuk memiliki dukungan font tambahan sebagai berikut:
    • Menyetel setelan variasi font yang berbeda seperti FontSetting.weight dan FontSetting.width
    • Menetapkan lebar yang sama untuk semua karakter numerik - angka tabular (setelan fitur font FontSetting.tnum)
    • API pemilihan font yang ditingkatkan untuk mendukung font fleksibel yang akan datang dengan menentukan nama jenis font pilihan yang akan digunakan.
  • Memperluas pengubah Corner untuk mendukung penentuan setiap CornerRadius dengan nilai horizontal dan vertikal terpisah untuk memungkinkan pembuatan elemen dengan sudut asimetris.
  • Menambahkan pengubah Transformation baru yang menawarkan terjemahan, rotasi, dan penskalaan LayoutElement. Transformasi ini dapat dianimasikan menggunakan nilai dinamis.
  • Menambahkan setArcDirection dengan opsi Clockwise, CounterClockwise, dan Normal ke semua elemen busur (Arc, ArcLine, dan ArcText) untuk dukungan yang lebih baik dalam arah tata letak yang berbeda (seperti LTR dan RTL).
  • Meningkatkan aksesibilitas semua target sentuh dengan memperluas area yang dapat diketuk dari elemen apa pun yang menggunakan pengubah Clickable menjadi setidaknya 48dp x 48dp.
  • Meningkatkan kualitas PrimaryLayout dan EdgeContentLayout dengan menambahkan setResponsiveContentInsetEnabled untuk mendukung perilaku responsif tata letak ini di berbagai ukuran layar dan meningkatkan konsistensi Kartu. Menambahkan peringatan linter untuk menyarankan penggunaan API ini dengan perbaikan cepat.
  • Penskalaan/non-penskalaan yang ditingkatkan pada Text Material untuk penskalaan font non-linear Android 14.

Perubahan API

  • Nama jenis huruf default (DEFAULT_SYSTEM_FONT) dihapus karena tersirat dengan tidak menggunakan preferredFontFamilies API. (I39dab)
  • Parameter yang diteruskan ke FontSetting.width harus positif. (I1266f)

Versi 1.2.0-alpha05

26 Juni 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha05 dirilis. Versi 1.2.0-alpha05 berisi commit ini.

Fitur Baru

  • Tambahkan metode hasText ke Material.CompactChip untuk memeriksa apakah konten teks telah ditetapkan. (I6e8fc)

Perubahan API

  • Konstanta FontFamily dipindahkan ke FontStyle, bukan class Builder-nya. (I06ced)
  • Memperbarui API FontSetting.weight dan FontSetting.width untuk menyertakan anotasi Rentang dan mengubah parameter berat menjadi int. (Ia726c)

Perbaikan Bug

  • Teks yang tidak dapat diskalakan di library Material kini berfungsi dengan benar dengan penskalaan font non-linear Android 14. (I6601e)

Versi 1.2.0-alpha04

29 Mei 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha04 dirilis. Versi 1.2.0-alpha04 berisi commit ini.

Perubahan API

  • Menambahkan API sudut asimetris agar dapat menentukan radius setiap sudut secara terpisah dengan 2 nilai. (Icbd69)
  • Memperluas FontSetting API untuk menyertakan:
    • setelan fitur font seperti menyetel font menjadi tabular. (If12b7)
    • setelan variasi font seperti menetapkan lebar kustom untuk font variabel. (I2b36d)
  • Menambahkan API jenis font ke FontStyle untuk memungkinkan penentuan daftar urutan jenis font yang akan digunakan. (Iba9f5)
  • Mengganti nama konstanta untuk tinggi ruang antara konten dan label sekunder di LayoutDefaults Material yang awalnya diawali dengan “Konten tepi” agar lebih umum karena dapat diterapkan ke PrimaryLayout dan EdgeContentLayout. (I4dc32)

Perbaikan Bug

  • Mengganti nama penamaan untuk sumbu font variabel dari axisName menjadi axisTag. (I02ba3)

Versi 1.2.0-alpha03

14 Mei 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha03 dirilis. Versi 1.2.0-alpha03 berisi commit ini.

Fitur Baru

  • Menambahkan API untuk menetapkan nilai bobot kustom untuk FontStyle. (I7390a)

Perbaikan Bug

  • Memperbaiki kegagalan di getTouchDelegateInfo karena peta target kosong. (I2accf)

Versi 1.2.0-alpha02

1 Mei 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha02 dirilis. Versi 1.2.0-alpha02 berisi commit ini.

Perubahan API

  • Kami telah menambahkan dukungan untuk menonaktifkan umpan balik riak pada setiap elemen yang dapat diklik. (If1ede)
  • API untuk transformasi telah dihapus dari ArcModifiers karena tidak mendukung fitur tersebut (Ic0827)
  • Builder ArcDirectionProp kini mengharapkan nilai dalam konstruktor. (I76ada)
  • Metode PlatformDataValues.Builder.putAll akan memungkinkan penggabungan satu PlatformDataValue ke PlatformDataValue lainnya. (I50ba3)
  • Text#setIsScalable diganti namanya menjadi Text#setScalable. (If920e)
  • Teks Material dapat menyetel apakah akan menggunakan ukuran yang dapat diskalakan (bertambah besar saat ukuran font pengguna diubah) atau tidak. (Ibc849)
  • Kami telah menambahkan opsi untuk menyetel deskripsi konten ke TitleChip. (I5d21f)
  • Memperbaiki CompactChip agar berfungsi dengan benar hanya dengan ikon dan memperbarui API untuk mengizinkan opsi ini. (I6589e)

Perbaikan Bug

  • Memperbaiki masalah potensi duplikasi data platform selama inisialisasi. (Iba0fd)
  • Memperkenalkan getter baru ke DynamicDataNode untuk mengambil biaya node. Biaya ini digunakan saat mendapatkan kuota node dinamis. Saat ini, Node dengan nilai tetap akan memiliki biaya 0, semua node lainnya akan memiliki biaya 1. (Ia33e1)
  • Hapus logika penghitungan dari NO_OP_QUOTA_MANAGER. (Ib50b8)
  • Kami telah menambahkan aturan lint untuk melaporkan peringatan saat PrimaryLayout digunakan tanpa setResponsiveContentInsetEnabled dan memberikan perbaikan cepat. (I12025)
  • Ada batas jumlah node ekspresi dinamis. (Iffae8)

Versi 1.2.0-alpha01

6 Maret 2024

androidx.wear.protolayout:protolayout-*:1.2.0-alpha01 dirilis. Versi 1.2.0-alpha01 berisi commit ini.

Fitur Baru

  • Elemen ProtoLayout Arc kini memiliki opsi untuk menambahkan ArcDirection (Clockwise, Counterclockwise, atau Normal) ke dalamnya. Menambahkan perilaku ini ke Arc, ArcLine, atau ArcText akan memperbaiki perilakunya pada tata letak RTL. (I90699)
  • EdgeContentLayout telah diupdate dengan setter setResponsiveContentInsetEnabled baru untuk mencapai keselarasan yang lebih baik dengan panduan UX, konsistensi di Kartu dengan memiliki label utama di tempat tetap di atas dan inset responsif untuk label. (I60175)
  • Kami telah menambahkan PrimaryLayout.setResponsiveContentInsetEnabled yang menambahkan inset responsif ke label utama, label sekunder, dan chip bawah dalam tata letak ini, untuk mencegah konten keluar dari tepi layar. (I0c457)
  • Menambahkan metode untuk menghapus margin luar dari CircularProgressIndicator sehingga dapat digunakan sebagai komponen yang lebih kecil. (I55c06)

Perubahan API

  • Perender kartu kini mengecualikan padding font pada semua elemen teks secara default, tanpa opsi untuk menyertakannya. (I3e300)

Perbaikan Bug

  • Memperbaiki masalah Perataan teks saat pemangkasan, jarak antar-huruf, dan perataan tengah digunakan pada Teks. (I716c7)
  • Menambahkan solusi untuk masalah gambar busur skia. (I08f09)
  • Memperbaiki arah gambar ArcLine untuk tata letak RTL. (I6c141)

Versi 1.1

Versi 1.1.0

7 Februari 2024

androidx.wear.protolayout:protolayout-*:1.1.0 dirilis. Versi 1.1.0 berisi commit ini.

Perubahan penting sejak versi 1.0.0

  • Dukungan gradien dan representasi yang lebih baik untuk panjang yang lebih besar dari 360 derajat di ArcLine.
  • Pemformatan tanggal dan waktu mendukung zona waktu yang berbeda untuk jenis data dinamis.
  • Opsi pengubahan ukuran otomatis dan pemotongan teks yang lebih baik, untuk menangani teks yang terpotong.
  • Spacer mendukung dimensi yang diperluas dengan bobot opsional.
  • Anotasi persyaratan versi skema untuk semua API ProtoLayout.
  • Memperluas area target ke elemen Clickable mana pun menjadi 48 dp x 48 dp, untuk memenuhi persyaratan aksesibilitas.
  • Padding font dinonaktifkan secara default dan merupakan satu-satunya perilaku di semua elemen Teks dan komponen Material yang berisi teks.

Perubahan lainnya

  • Untuk mengetahui serangkaian perubahan yang lebih lengkap yang diperkenalkan di versi 1.1.0, lihat catatan rilis beta01.

Versi 1.1.0-rc01

24 Januari 2024

androidx.wear.protolayout:protolayout-*:1.1.0-rc01 dirilis. Versi 1.1.0-rc01 berisi commit ini.

Perbaikan Bug

  • PlatformTimeUpdateNotifierImpl segera berdetak setelah mengaktifkan update. (I77145)
  • CircularProgressIndicator telah diperbaiki untuk tata letak RTL. Mulai sekarang, arahnya akan searah jarum jam dalam semua kasus. (I95ee3)
  • Menambahkan solusi untuk masalah gambar busur skia. (I08f09)

Versi 1.1.0-beta01

10 Januari 2024

androidx.wear.protolayout:protolayout-*:1.1.0-beta01 dirilis. Versi 1.1.0-beta01 berisi commit ini.

Fitur Baru

Rilis 1.1.0-beta01 Wear ProtoLayout menunjukkan bahwa rilis library ini sudah berfitur lengkap dan API dikunci (kecuali jika ditandai sebagai eksperimental). Wear ProtoLayout 1.1 menyertakan fungsi dan API baru berikut:

  • ArcLine kini mendukung gradien dengan menambahkan Brush dengan SweepGradient dan memiliki bayangan pada tutup untuk merepresentasikan panjang yang lebih besar dari 360 derajat dengan lebih baik dengan menambahkan Shadow pada StrokeCap yang ada.
  • DynamicInstant memiliki dukungan untuk pemformatan tanggal-waktu yang di-zona. DynamicInstant dan DynamicDuration dapat digunakan sebagai jenis data status atau platform.
  • Fitur penyesuaian ukuran untuk ukuran teks yang memungkinkan penetapan beberapa ukuran ke FontStyle.setSizes tempat Ukuran teks akan otomatis disesuaikan skalanya berdasarkan ruang yang tersedia di dalam induk. Selain itu, kami meningkatkan opsi pemotongan teks yang meluap dengan menambahkan TEXT_OVERFLOW_ELLIPSIZE dan menghentikan penggunaan TEXT_OVERFLOW_ELLIPSIZE_END.
  • Spacer kini mendukung dimensi yang diperluas dengan bobot opsional. Untuk membangun ExpandedDimensionProp, kami telah menambahkan metode bantuan DimensionBuilders.weight.
  • Dukungan untuk menyembunyikan dan menampilkan elemen tata letak secara dinamis dengan Modifier.visible. Hal ini termasuk memiliki nilai dinamis di BoolProp.
  • Semua API ProtoLayout kini memiliki anotasi persyaratan versi skema dan versi dapat diperiksa sebelum memanggil API yang lebih baru.
  • Setiap elemen yang memiliki Clickable kini memiliki area target yang diperluas menjadi setidaknya 48x48 di perender untuk mendukung persyaratan aksesibilitas dengan lebih baik.
  • Mengikuti inisiatif Compose dan komponen Material lainnya, kami kini menonaktifkan padding font secara default pada semua elemen Text. Selain itu, AndroidTextStyle dan setter terkait telah dihapus dari API publik. dengan perbaikan bug berikut:
  • Menambahkan setter untuk memosisikan konten tepi di EdgeContentLayout sehingga dapat diposisikan sebelum konten lainnya.
  • Secara konsisten memunculkan pengecualian saat menemukan nilai enum yang tidak dikenali.
  • Membatalkan validitas hasil ekspresi jika menghasilkan nilai numerik yang tidak valid (NaN atau tak terhingga) atau menampilkan ArithmeticException.

Perubahan API

  • Memperbarui SweepGradient API untuk mengizinkan penerimaan warna atau ColorStops dalam konstruktor. (I6676f)

Perbaikan Bug

  • Menambahkan dukungan API dan perender terbatas untuk menyetel arah elemen busur digambar. (Idef5a)
  • RoundMode ditetapkan secara default ke Floor di FloatToInt32Node jika tidak ditentukan. Node akan tetap menampilkan pengecualian jika RoundMode yang diberikan tidak dikenali. (I1b2d8)

Versi 1.1.0-alpha04

13 Desember 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha04 dirilis. Versi 1.1.0-alpha04 berisi commit ini.

Fitur Baru

  • Class VersionInfo tidak mengimplementasikan antarmuka Comparable. (I8d13c)
  • Renderer kini mendukung opsi TEXT_OVERFLOW_ELLIPSIZE. (I7f085)

Perubahan API

  • Opsi peluapan teks TEXT_OVERFLOW_ELLIPSIZE_END kini tidak digunakan lagi. Gunakan API TEXT_OVERFLOW_ELLIPSIZE baru dengan perilaku yang sangat mirip. (I822d8)
  • Mengikuti inisiatif Compose dan komponen Material lainnya, kami kini menonaktifkan padding font secara default di semua elemen Teks. Selain itu, AndroidTextStyle dan penyetel terkait telah dihapus dari API publik. (I79094, Ib0b03, I32959, Iaf7d5, Ifa298, I0a4ae, Ida9d3)
  • Modifier.hidden diganti dengan Modifier.visible (I56902)
  • FontStyle#setSizes kini menerima argumen int, bukan SpProp. (I02b37)

Perbaikan Bug

  • Menampilkan pengecualian saat menemukan nilai enum yang Tidak Ditentukan atau Tidak Dikenali. (I9d2cf)
  • Refaktor DynamicTypeBindingRequest. (I27b57)
  • Membatalkan validitas hasil ekspresi jika menghasilkan nilai numerik yang tidak valid (NaN atau tak terhingga) atau menampilkan ArithmeticException. (I681ae)

Versi 1.1.0-alpha03

29 November 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha03 dirilis. Versi 1.1.0-alpha03 berisi commit ini.

Fitur Baru

  • Menambahkan dukungan eksperimental untuk menyembunyikan/memunculkan elemen tata letak secara dinamis (I64a78)
  • Menambahkan dukungan nilai dinamis ke BoolProp (I2fe96)
  • Menambahkan anotasi persyaratan versi skema ke API ProtoLayout (I0f03c)
  • Memperluas API dengan opsi baru di TextOverflow untuk memangkas Teks dalam penampung induk tetap meskipun baris maksimum belum tercapai (tetapi tidak ada cukup ruang untuk Teks). (I110a9)
  • Menambahkan metode helper DimensionBuilders.weight untuk membuat ExpandedDimensionProp dengan bobot. (I4f72b)
  • DynamicInstant dan DynamicDuration dapat digunakan sebagai jenis data status atau platform. (I6819f)

Perubahan API

  • Mengupdate API untuk menyembunyikan DynamicZonedDateTime dan memindahkan semua operasinya ke DyanamicInstant (I34b94)
  • Spacer kini mendukung dimensi Diperluas untuk lebar/tinggi. (Ie7c94)
  • Mendukung ekstensi area target klik di Renderer (I39c79)

Versi 1.1.0-alpha02

15 November 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha02 dirilis. Versi 1.1.0-alpha02 berisi commit ini.

Fitur Baru

  • Menambahkan kolom ArcLine StrokeCap Shadow ke API. (I830ec)
  • Memperluas API agar dapat menentukan lebar atau tinggi Spacer yang akan diperluas. (I757ca)
  • Kami telah menambahkan API eksperimental untuk menyesuaikan ukuran teks secara otomatis berdasarkan ruang yang tersedia di dalam induknya. (Ibbe63)
  • Mendukung ukuran minimum yang dapat diklik (I178e3)
  • Menambahkan dukungan perender untuk StrokeCap Shadow. (I48b17)
  • Menambahkan dukungan perender untuk Gradien Sapu di ArcLine. (I4d5bb)

Versi 1.1.0-alpha01

18 Oktober 2023

androidx.wear.protolayout:protolayout-*:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit ini.

Fitur Baru

  • Menambahkan opsi kuas ke Arcline, dengan dukungan untuk SweepGradient. (Ie7ce3)
  • Menambahkan dukungan untuk pemformatan tanggal dan waktu yang di-zona. (Ibfae0)
  • Menambahkan wrapper Java dan proto yang diperlukan untuk pemformatan tanggal-waktu yang memiliki zona. (I97126)
  • Menambahkan getter untuk membaca kembali nilai yang disimpan di DynamicDataValue. (Ie6cea)
  • Menambahkan setter untuk memosisikan konten tepi di EdgeContentLayout sehingga dapat diposisikan sebelum konten lainnya. (Ie8e8a)

Perbaikan Bug

  • Memperbaiki masalah saat ekspresi dengan beberapa pendaftaran sumber data waktu tidak segera diperbarui. (I8e1a8)
  • Memperbaiki bug untuk memusatkan elemen root selama update perbedaan. (Ie48f7)
  • Nilai batasan tata letak yang tidak disetel (atau kosong) tidak akan diabaikan lagi. (Ibc785)
  • Mengurangi penundaan antara tata letak yang menjadi terlihat dan node pipeline-nya diinisialisasi. (I38d4e)

Versi 1.0

Versi 1.0.0

9 Agustus 2023

androidx.wear.protolayout:protolayout-*:1.0.0 dirilis. Versi 1.0.0 berisi commit ini.

Fitur utama 1.0.0

Library ProtoLayout memperkenalkan API untuk membuat tata letak dan ekspresi yang dapat digunakan di berbagai platform Wear OS. Misalnya, library Kartu menggunakan API ini untuk mendukung data binding platform (untuk pembaruan data kartu yang lebih cepat) dan animasi.

Versi 1.0.0-rc01

26 Juli 2023

androidx.wear.protolayout:protolayout-*:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit ini.

  • Untuk bermigrasi dari Kartu ke ProtoLayout, ikuti petunjuk di sini.

Perubahan API

  • Kami telah menghapus metode setLayoutConstraintForDynamicAnchorAngle dan getLayoutConstraintForDynamicAnchorAngle dari elemen Arc. Metode ini telah ditambahkan secara keliru dan tidak berpengaruh pada tata letak yang diberikan. (If7d01)
  • Kami telah membatasi kedalaman maksimum tata letak ProtoLayout menjadi 30 LayoutElements bertingkat. (I8a74b)

Perbaikan Bug

  • Kami telah menambahkan pemeriksaan untuk menampilkan pengecualian jika DynamicColor telah ditetapkan untuk SpanText. (I0e5bc)
  • Diperjelas bahwa satuan sumber data DAILY_CALORIES adalah kkal. (Iaa785)

Versi 1.0.0-beta01

21 Juni 2023

androidx.wear.protolayout:protolayout-*:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

Fitur Baru

  • Mengizinkan penyetelan clock untuk pengujian pengikatan waktu. (I05622)

Perubahan API

  • PlatformDataReceiver.onData() dan StateBuilders.Builder.addKeyToValueMapping kini menerima pemetaan DynamicDataKey ke DynamicDataValue yang aman untuk jenis, bukan generik yang tidak aman. Artinya, DynamicDataValue kini diketik dengan DynamicType-nya. Konstanta HEART_RATE_ACCURACY_X dipindahkan ke root PlatformHealthSources, agar sesuai dengan penempatan konstanta Android lainnya. Konstanta int HEART_RATE_ACCURACY_X kini digunakan langsung di DynamicHeartRateAccuracy.constant() dan DynamicHeartRateAccuracy.dynamicDataValueOf(), bukan konstanta nilai. (I82ff5)
  • Class PlatformHealthSources.Constants dapat di-instantiate karena kesalahan. Masalah ini telah diperbaiki. (Icb849)
  • PlatformTimeUpdateNotifier#setReceiver kini menerima Runnable, bukan fungsi Supplier dan Executor untuk diberi tahu. (I9d938)
  • Kami telah mengubah jenis parameter di PlatformTimeUpdateNotifier#setReceiver dari Callable menjadi Supplier. (I664bf)
  • CompactChip dan TitleChip kini mendukung penambahan ikon ke dalamnya. (I5a01e)

Perbaikan Bug

  • Memperbarui pesan Prop dengan kolom dinamis untuk menggunakan oneof (I81739)
  • Menggunakan kembali penerapan setter untuk overload yang memiliki setter (Ied70c)
  • Merekam sidik jari dengan benar di setter yang memiliki overload (I86ed2)

Versi 1.0.0-alpha11

7 Juni 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha11 dirilis. Versi 1.0.0-alpha11 berisi commit berikut ini.

Fitur Baru

  • Kami telah menambahkan PlatformDataKey untuk akurasi detak jantung. (I7f9b8)

Perubahan API

  • Mengganti nama StateBuilders#getIdToValueMapping menjadi getKeyToValueMapping dan mengubah jenis nilai yang ditampilkan menjadi Map<<AppDataKey<?>,DynamicDataValue>. (Iaa7ae)
  • Menjadikan StateStore sebagai class final (I408ca)
  • Antarmuka TimeGateway telah digantikan oleh PlatformTimeUpdateNotifier di library protolayout-expression-pipeline yang memberikan frekuensi yang diinginkan untuk memperbarui data waktu. (I60869)
  • Mengganti nama register/unregisterForData di PlatformDataProvider menjadi set/clearReceiver (I14b02)
  • Di Teks Material, getExcludeFontPadding telah diganti namanya menjadi hasExcludeFontPadding. (Iea01d)
  • Setter untuk menyelaraskan label dengan sempurna telah ditambahkan ke semua komponen chip. Semua chip kini menerapkan target minimum yang dapat diketuk. (I8ae92)
  • LayoutDefaults#BUTTON_MAX_NUMBER diganti namanya menjadi MAX_BUTTONS. (I84788)
  • DAILY_DISTANCE diganti namanya menjadi DAILY_DISTANCE_M. (I4f758)

Perbaikan Bug

  • Memperbarui dokumen Jenis prop untuk mengklarifikasi alasan nilai statis diterapkan. Tentukan nilai default yang digunakan jika nilai statis tidak diberikan. (I155aa)
  • Namespace PlatformDataKey harus mengikuti penamaan gaya Java. (I47bda)

Versi 1.0.0-alpha10

24 Mei 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha10 dirilis. Versi 1.0.0-alpha10 berisi commit berikut.

Fitur Baru

  • Menambahkan AppDataKey untuk mengakses status yang didorong aplikasi; Menambahkan PlatformDataKey untuk mengakses data platform; Menambahkan dukungan namespace di StateStore. (I7985e)
  • Mendukung operasi Equal dan NotEqual untuk DynamicBool. (I6a0c1)

Perubahan API

  • Class FontStyles sekarang sudah final (Iaa2ea)
  • LayoutElementBuilders#FontStyles tidak digunakan lagi. Gunakan androidx.wear.protolayout.Typography atau buat FontStyle Anda sendiri. (Ic929b)
  • Menyembunyikan antarmuka bertingkat Action#Builder dari antarmuka Action. Implementasi Builder telah disediakan oleh class LoadAction dan LaunchAction. (I1d70c)
  • Mengizinkan penggunaan DynamicFloat dengan FloatProp. Perhatikan bahwa FloatProp tidak memerlukan batasan tata letak karena tidak digunakan sebagai properti pengubah tata letak. (I286ac)
  • Tindakan LoalAction dan SetStateAction dihapus karena belum benar-benar didukung. (I5d6a6)
  • Menambahkan dukungan untuk format ARGB_8888 untuk resource gambar inline. (I8a07c)
  • Mengganti nama StateEntryValue menjadi DynamicDataValue, dan memperbarui API status untuk menggunakan DynamicDataKey (If1c01)
  • Kami membatasi jumlah entri yang diizinkan dalam StateStore untuk memastikan penggunaan memori dan waktu update status dapat dikelola dan dikontrol dengan baik untuk setiap instance StateStore. Oleh karena itu, developer harus memastikan bahwa mereka tidak memiliki lebih dari MAX_STATE_ENTRY_COUNT entri di peta. Jika tidak, mereka akan mendapatkan IllegalStateException saat membuat atau memperbarui StateStore. (Ibadb3)
  • Menyembunyikan class OnLoadTrigger dan OnConditionMetTrigger, serta mengganti nama setTrigger menjadi setCondition untuk OnConditionMetTrigger. (Ibf629)
  • Karena alasan performa dan kompatibilitas, perender ProtoLayout tidak akan mendukung set fitur lengkap di resource AnimatedVectorDrawable. Kami menandai API tersebut sebagai eksperimental hingga kami dapat menentukan set yang didukung. (Ic6daf)
  • Menambahkan jenis dinamis untuk jarak harian, kalori harian, dan lantai harian. Kunci untuk sumber informasi kondisi platform kini berada di bagian PlatformHealthSources.Keys (Ib7637)
  • Metode Easing.cubicBezier menggantikan CubicBezierEasing.Builder. Dengan demikian, class EasingFunction dihapus dan konstanta easing dari class tersebut kini dapat diakses langsung dari antarmuka Easing. Selain itu, setInfiniteRepeatable diganti dengan INFINITE_REPEATABLE_WITH_RESTART dan INFINITE_REPEATABLE_WITH_REVERSE (Ib41e7)
  • Terapkan PlatformDataProvider untuk memberikan detak jantung dan langkah harian. Antarmuka SensorGateway dihapus dari API publik. (I55b84)
  • Tambahkan PlatformDataProvider, dan perbarui StateStore untuk mendaftar ke PlatformDataProvider saat kunci yang didukung penyedia diperlukan oleh node dari pipeline ekspresi. (Ib616a)
  • SensorGateway tidak lagi Closeable karena tidak lagi mempertahankan status apa pun. (I6b4f7)
  • Izinkan penggunaan FloatProp dengan DynamicFloat untuk kemajuan di CircularProgressIndicator. Hal ini didukung untuk perender yang mendukung versi 1.2. Renderer lama akan melakukan penggantian ke staticValue jika disediakan, atau ke 0 (I0d91b)
  • Konstanta MultiButtonLayout telah di-refactor ke dalam class LayoutDefaults.MultiButtonLayoutDefaults yang kini berisi konstanta untuk ukuran tombol, bergantung pada jumlah tombol dalam tata letak. (I13973)
  • Mendukung penggunaan StringProp dengan DynamicString dalam Teks Material. Hal ini didukung untuk perender yang mendukung versi 1.2. Renderer lama akan melakukan penggantian ke nilai statis yang diberikan. Perbarui jenis nilai yang ditampilkan Text#getText dari String menjadi StringProp. (I7275b)

Versi 1.0.0-alpha09

10 Mei 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha09 dirilis. Versi 1.0.0-alpha09 berisi commit berikut ini.

Fitur Baru

  • Kami telah menambahkan elemen tata letak ekstensi eksperimental. Perhatikan bahwa ini tidak dapat digunakan secara default dan memerlukan ekstensi perender yang dapat memahami elemen tata letak. (I6581d)
  • Menambahkan dukungan StrokeCap untuk ArcLine. (I94951)
  • Menambahkan dukungan untuk operasi Instan Bersyarat. (I489a7)
  • Menambahkan dukungan untuk operasi Durasi Bersyarat. (Iab469)
  • Menambahkan dukungan untuk membuat durasi dari detik. (Ib5fa1)

Perubahan API

  • Metode enable/disablePlatformSource telah dihapus dari DynamicTypeEvaluator. Pemanggil harus bertanggung jawab atas update. (I78c6d)
  • Mengizinkan pembatasan ukuran jenis data terikat. (Ie2966)
  • Menambahkan dukungan untuk deskripsi konten dinamis di protolayout-material. (I62c8e)
  • Gunakan long dan @IntRange untuk durasi dan penundaan di AnimationParameters. (I388b6)

Versi 1.0.0-alpha08

19 April 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha08 dirilis. Versi 1.0.0-alpha08 berisi commit ini.

Fitur Baru

  • AndroidTextStyle telah ditambahkan ke LayoutElementBuilders (I8d967)
  • Kami telah menambahkan dukungan untuk menyetel pengecualian padding font di Teks Material ProtoLayout. (I17f5d)
  • ARGB_8888 kini didukung untuk gambar inline. (I18c1e)
  • DynamicColor sekarang mendukung operasi onCondition. (I10927)

Perubahan API

  • Mendukung durasi kustom untuk animasi terbalik (I3251f)
  • Kita telah menambahkan pengubah SemanticDescription. Selain itu, ContentDescription tidak dapat diikat. (I3f1d)
  • Metode DynamicBool.isFalse() kini diganti dengan DynamicBool.negate() dan DynamicBool.isTrue() dihapus. Selain itu, nilai NaN DynamicFloat dan mempersempit DynamicInt32 menjadi DynamicFloat kini menghasilkan hasil dinamis yang tidak valid. (I6ac1e)
  • Pemformat int dan float kini menggunakan pola Builder. (Ieb213)

Perbaikan Bug

  • Nilai statis penggantian telah dihapus dari kolom yang dapat dianimasikan. (Ifcb01)
  • DynamicTypeValueReceiver#onPreUpdate telah dihapus (I2dc35)
  • Panjang String dalam ekspresi dinamis kini dibatasi. (I4c93)
  • Dependensi gradle kini disetel dengan benar ke api, bukan implementation, jika diperlukan. (I40503)

Versi 1.0.0-alpha07

5 April 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha07 dirilis. Versi 1.0.0-alpha07 berisi commit ini.

Fitur Baru

  • Menambahkan dukungan nilai dinamis ke StringProp (I04342)
  • Menandai elemen tata letak yang dapat diikat (Ia110b)

Perubahan API

  • sensorGateway#registerSensorGatewayConsumer menggunakan jenis data sebagai parameter, bukan metode di Consumer. (Icf314)
  • ObservableStateStore diganti namanya menjadi StateStore. (Ieb0e2)
  • Menambahkan DynamicTypeEvaluator.Builder, bukan argumen konstruktor, untuk memungkinkan lebih banyak argumen opsional, termasuk ObservableStateStore yang kini secara default menggunakan penyimpanan kosong. (I6f832)
  • Memfaktorkan ulang urutan parameter di DynamicTypeEvaluator. (Ic1ba4)

Perbaikan Bug

  • Menyebarkan sinyal dengan benar dari sumber sensor platform ke node hilir (I5a922)

Versi 1.0.0-alpha06

22 Maret 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha06 dirilis. Versi 1.0.0-alpha06 berisi commit ini.

Fitur Baru

  • Kami telah menambahkan API eksperimental untuk menggunakan detak jantung dan langkah harian dalam ekspresi dinamis (Ifd711)
  • Kami telah menambahkan dukungan untuk penundaan mundur dan maju untuk animasi. (Ic25f7)
  • Kami telah menambahkan dukungan DynamicColor ke Batas dan Latar Belakang
  • Kami telah menambahkan dukungan nilai dinamis ke jenis di DimensionBuilder
  • Tata letak dan komponen dari tiles-material beralih ke protolayout-material

Perubahan API

  • LoadActionListener telah ditambahkan ke ProtoLayoutViewInstance (If7806)

Perbaikan Bug

  • Menambahkan FloatNodesTest (Id7281)
  • Memperbaiki error perender saat tidak dapat memuat bitmap terstruktur.

Versi 1.0.0-alpha05

8 Maret 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Fitur Baru

  • Kami telah menambahkan animasi "pembaruan konten" eksperimental ke objek Modifiers. Animasi ini akan dipicu setiap kali elemen (dengan pengubah ini) atau salah satu turunannya berubah selama pembaruan tata letak. (bd03e5d)

Perubahan API

  • Kami telah menambahkan forwardRepeatDelayMillis dan reverseRepeatDelayMillis ke Repeatable. Kami juga telah mengganti nama delayMillis di AnimationSpec menjadi startDelayMillis (Ifb266)
  • Metode DynamicTypeEvaluator.bind kini menerima Executor. (I346ab)
  • Kami telah menambahkan metode startEvaluation ke BoundDynamicType untuk memicu evaluasi setelah jenis dinamis terikat. (I19908)

Perbaikan Bug

  • Objek Animator akan digunakan kembali untuk animasi elemen tunggal berikutnya. (Ia3be9)

Versi 1.0.0-alpha04

22 Februari 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit ini.

Fitur Baru

  • ObservableStateStore kini juga memberi tahu pemroses saat kunci dihapus.
  • Kami telah menambahkan versi skema perender dan skala font ke DeviceParameters (yang dapat digunakan untuk membuat tata letak secara kondisional sebagai respons terhadap versi dan setelan font yang berbeda).
  • Kami telah menambahkan dukungan untuk menganimasikan nilai DynamicInt32 (I05485)
  • Kami telah menambahkan pemicu OnLoad dan OnConditionalMet. Ini dapat digunakan untuk memulai animasi yang mendukung pemicu.
  • Kami telah menambahkan bobot tata letak untuk dimensi yang diluaskan dan ukuran minimum untuk dimensi yang di-wrap.
  • Kami telah menambahkan jenis dinamis durasi dan instan. Objek ini dapat digunakan untuk merepresentasikan instan atau durasi waktu dalam ekspresi dinamis.
  • Kami telah menambahkan dukungan untuk AnimatedVectorDrawable dan SeekableAnimatedVectorDrawable sebagai resource tata letak.

Perubahan API

  • Data sensor memerlukan API 29+. (I8099e)
  • Kami telah menambahkan dua metode bantuan launchAction (untuk meluncurkan Aktivitas).

Perbaikan Bug

  • Mengganti nama set/getSpec menjadi set/getAnimationSpec dalam animasi Kartu (I3d74b)

Versi 1.0.0-alpha03

8 Februari 2023

androidx.wear.protolayout:protolayout-*:1.0.0-alpha03 dirilis. Versi 1.0.0-alpha03 berisi commit ini.

Fitur Baru

  • Kami telah menambahkan toByteArray() dan fromByteArray() ke jenis Dinamis di library protolayout-express.
  • Kami telah menambahkan toString() ke jenis Dinamis di library protolayout-express.
  • Kami telah menambahkan dukungan evaluasi untuk jenis Dinamis. Class DynamicTypeEvaluator dari library protolayout-expression-pipeline dapat digunakan untuk mengevaluasi (dan menerima nilai yang diperbarui) untuk jenis Dinamis yang dibuat sebelumnya (DynamicString, DynamicFloat, …)
  • Jika animasi tidak dapat diputar (karena dinonaktifkan oleh evaluator atau jumlah animasi yang berjalan telah mencapai batas yang ditetapkan), nilai statis yang ditetapkan pada node yang dapat dianimasikan akan digunakan untuk mengganti animasi.

Versi 1.0.0-alpha02

25 Januari 2023

androidx.wear.protolayout:protolayout:1.0.0-alpha02, androidx.wear.protolayout:protolayout-expression:1.0.0-alpha02, dan androidx.wear.protolayout:protolayout-proto:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit berikut ini.

Fitur Baru

  • Builder tata letak dari androidx.wear.tiles:tiles beralih ke androidx.wear.protolayout:protolayout. Builder tata letak di androidx.wear.tiles:tiles tidak akan digunakan lagi dalam salah satu rilis alfa berikutnya.

Versi 1.0.0-alpha01

11 Januari 2023

androidx.wear.protolayout:protolayout-expression:1.0.0-alpha01 dan androidx.wear.protolayout:protolayout-proto:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

  • Rilis ini memperkenalkan library baru "ProtoLayout Expression" untuk membuat ekspresi dari variabel dinamis.