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
7 Mei 2025 1.2.1 - 1.3.0-beta02 -

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.2.1"

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

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

Kotlin

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

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

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

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

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 pada API 36 dan yang lebih baru. Hal ini karena mulai API 36, semua Kartu akan menggunakan font sistem, sehingga perubahan ini akan menghasilkan konsistensi yang lebih baik di carousel Kartu. (If316f)
  • Builder Text,Spacer, ArcLine, dan DashedArcLine tidak akan ditampilkan jika layoutConstraintsuntuk nilai dinamis tidak ditetapkan. Perhatikan bahwa perender lama masih memerlukan layoutConstraints untuk ditetapkan dan akan mengabaikan nilai dinamis yang tidak ditetapkan. (Ic52e8)
  • Menambahkan pengubah semantik judul untuk menunjukkan bahwa elemen tata letak adalah judul untuk bagian konten untuk tujuan aksesibilitas, dan menandai teks di slot judul primaryLayout sebagai judul aksesibilitas secara default. (Iae1fb)
  • Pengoptimalan UX akhir primaryLayout dengan ruang antara slot judul dan slot utama dikurangi menjadi 4dp, bukan 6dp pada 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 Wear ProtoLayout 1.3.0-beta01 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 pendapat 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, yang menyediakan penggantian yang wajar jika berlaku
  • API seperti Compose yang lebih cocok untuk Kotlin 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
  • Dukungan animasi Lottie termasuk opsi untuk menetapkan pemicu yang berbeda saat animasi harus dimulai, misalnya saat tata letak dimuat atau saat tata letak terlihat
    • Peningkatan dukungan gradien:
    • API gradien linear 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 di objek busur kini mendukung warna dinamis serta sudut awal dan akhir
  • Data binding platform di protolayout-expression untuk menerima informasi kapan saja visibilitas tata letak diubah, yang misalnya dapat digunakan untuk menyembunyikan bagian tertentu dari tata letak saat kartu digeser 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 baris dapat memiliki tanda hubung, tidak seperti ArcLine yang ada
  • Dukungan ArcSpacer untuk menetapkan panjangnya dalam dimensi DP, bukan derajat
  • Menambahkan sumbu FontSetting kebulatan 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 ruang 2 dp lebih sedikit untuk slot utama. (I8f5d3)
  • Klarifikasi tema warna dinamis default di komponen Material3 ProtoLayout. (Iff5f3)
  • Tipografi Typography.NUMERAL_* tidak lagi tabular/monospace secara default. Jika teks dianimasikan, sebaiknya tambahkan setelan FontSetting.tabularNum() ke teks tersebut. Dalam kasus lain, 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 tata letak berubah. (I250c3)
  • Mengizinkan injeksi 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 salin, 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 alias yang terlihat pada garis busur di perender kartu 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 ColorScheme ProtoLayout Material3, untuk error prioritas tinggi atau tindakan darurat seperti notifikasi 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 redundan. (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 memberikan penggantian saat dimensi luaskan weight tidak didukung (misalnya, di bawah API 33). Memperbarui komponen teks untuk kembali ke TEXT_OVERFLOW_ELLIPSIZE_END jika TEXT_OVERFLOW_ELLIPSIZE tidak didukung oleh perender. (I19e2c)
  • Update 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 menetapkan 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)
  • Sekarang kami mengizinkan margin (sisi dan dalam beberapa kasus bawah) untuk disesuaikan di Material3 primaryLayout. (Ib22f6)
  • Menambahkan varian tersegmentasi dari indikator progres melingkar. (I6a648)
  • Menambahkan komponen tombol rapat ke ProtoLayout Material3. (Ia3c5c)
  • Menambahkan komponen tombol bentuk pil dan tombol gambar ke ProtoLayout Material3. (Ifb88a)

Perubahan API

  • LayoutModfier.foldIn kini disebut foldRight untuk lebih mencerminkan perilaku yang diharapkan (Idf242)
  • Pemicu VisibleOnce kini bersifat eksperimental. (Ib2d26)
  • Menghapus withOpacity dari API publik karena ada alternatif library grafis. (I030c2)
  • Mengganti nama metode tingkat teratas di LayoutString.kt dan LayoutColor.kt agar memiliki nama yang mudah digunakan Java. (I7aff0)
  • Menghapus tipografi non-ProtoLayout di Material3. (Idd9ae)
  • Menambahkan akhiran Warna 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 ProtoLayout Material3 iconButton. (Ica3f0)
  • Menambahkan komponen penampung tombol ProtoLayout Material3. (I17a38)
  • Menambahkan dukungan untuk pengubah semantik Chainable ke protolayout-material3 (I4af62)
  • Menambahkan CircularProgressIndicator segmen tunggal ProtoLayout Material3 (I2c8a2)
  • Menambahkan pengubah padding,metadata (I8720a)
  • Menambahkan pengubah background,clip, dan clickable (I35478)
  • Tambahkan LinearGradient ke Kuas dan izinkan untuk digunakan di Pengubah Latar Belakang. (Ic4dea)
  • Menambahkan ukuran kecil untuk appCard dan titleCard. (I91f98)
  • Menambahkan komponen graphicDataCard ProtoLayout Material3. (I92be7)
  • Menambahkan komponen iconDataCard dan textDataCard ProtoLayout Material3. (I4e1e4)
  • Menambahkan komponen appCard ProtoLayout Material3. (Id4c57)
  • Abstrak EdgeButtonColors ke ButtonColors. (I83624)
  • Menambahkan komponen titleCard ProtoLayout Material3. (I2dc72)

Perubahan API

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

Perbaikan Bug

  • Menambahkan implementasi perender untuk meng-inflate DashedArcLine (I0c700)
  • Perubahan perender untuk mengizinkan ArcSpacer menggunakan 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 nullness JSpecify, yang merupakan penggunaan jenis. Developer Kotlin harus menggunakan argumen compiler berikut untuk menerapkan penggunaan yang benar: -Xjspecify-annotations=strict (ini adalah 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 Sudut sebenarnya, sama seperti di Wear Compose. (Ied8cd)
  • Memperbarui warna Material3 untuk menyertakan konsep ColorScheme, sama seperti di Wear Compose. (If645e)
  • Menambahkan beberapa matcher yang biasa 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. Menyertakan 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 Kartu 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 diperbarui agar 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 48dpx48dp.
  • Meningkatkan PrimaryLayout dan EdgeContentLayout dengan menambahkan setResponsiveContentInsetEnabled untuk lebih mendukung perilaku responsif tata letak ini di berbagai ukuran layar dan meningkatkan konsistensi Kartu.
  • Peningkatan penskalaan/tanpa penskalaan Teks Material untuk penskalaan font non-linear Android 14.
  • Meningkatkan dukungan untuk arah tata letak RTL di semua elemen busur.

Perubahan lainnya

  • Untuk kumpulan 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 hanya jika tidak ada label utama 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 Wear ProtoLayout 1.2.0-beta01 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:
    • Menetapkan setelan variasi font yang berbeda seperti FontSetting.weight dan FontSetting.width
    • Menetapkan lebar yang sama untuk semua karakter numerik - angka tabel (setelan fitur font FontSetting.tnum)
    • API pemilihan font yang ditingkatkan untuk mendukung font fleksibel mendatang dengan menentukan nama jenis font yang diinginkan untuk 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 berbagai arah tata letak (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 PrimaryLayout dan EdgeContentLayout dengan menambahkan setResponsiveContentInsetEnabled untuk lebih mendukung perilaku responsif tata letak ini di berbagai ukuran layar dan meningkatkan konsistensi Kartu. Menambahkan peringatan lint untuk menyarankan penggunaan API ini dengan perbaikan cepat.
  • Peningkatan penskalaan/tanpa penskalaan Text Material untuk penskalaan font non-linear Android 14.

Perubahan API

  • Nama jenis font 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 agar berada di FontStyle, bukan class Builder-nya. (I06ced)
  • Memperbarui FontSetting.weight dan FontSetting.width API untuk menyertakan anotasi Rentang dan mengubah parameter bobot 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 menetapkan font menjadi tabel. (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 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 respons ripple 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 dalam PlatformDataValue lainnya. (I50ba3)
  • Text#setIsScalable diganti namanya menjadi Text#setScalable. (If920e)
  • Teks Material dapat menetapkan apakah akan menggunakan ukuran yang dapat diskalakan (membesar saat ukuran font pengguna diubah) atau tidak. (Ibc849)
  • Kami telah menambahkan opsi untuk menetapkan deskripsi konten ke TitleChip. (I5d21f)
  • Memperbaiki CompactChip agar berfungsi dengan benar hanya dengan ikon dan mengupdate API untuk mengizinkan opsi ini. (I6589e)

Perbaikan Bug

  • Memperbaiki masalah potensi data platform duplikat selama inisialisasi. (Iba0fd)
  • Memperkenalkan pengambil baru ke DynamicDataNode untuk mengambil biaya node. Biaya ini digunakan saat memperoleh 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 diperbarui dengan penyetel setResponsiveContentInsetEnabled baru untuk mencapai penyelarasan yang lebih baik dengan panduan UX, konsistensi dalam Kartu dengan menempatkan label utama di tempat tetap di bagian 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 menghindari 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 di semua elemen teks secara default, tanpa opsi untuk menyertakannya. (I3e300)

Perbaikan Bug

  • Memperbaiki masalah perataan Teks saat ellipsize, spasi huruf, dan perataan tengah semuanya 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-waktu mendukung zona waktu yang berbeda untuk jenis data dinamis.
  • Opsi penskalaan otomatis dan elipsis teks yang lebih baik, untuk menangani teks yang terpotong.
  • Spacer mendukung dimensi yang diperluas dengan ketebalan opsional.
  • Anotasi persyaratan versi skema untuk semua ProtoLayout API.
  • Memperluas area target ke elemen Clickable apa 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 kumpulan 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 akan langsung berbunyi setelah mengaktifkan update. (I77145)
  • CircularProgressIndicator telah diperbaiki untuk tata letak RTL. Mulai sekarang, semua kasus akan berjalan searah jarum jam. (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 Wear ProtoLayout 1.1.0-beta01 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 lebih mewakili panjang yang lebih besar dari 360 derajat dengan menambahkan Shadow pada StrokeCap yang ada.
  • DynamicInstant memiliki dukungan untuk pemformatan tanggal-waktu zona. DynamicInstant dan DynamicDuration dapat digunakan sebagai jenis data status atau platform.
  • Fitur penyesuaian ukuran otomatis untuk ukuran teks yang memungkinkan penetapan beberapa ukuran ke FontStyle.setSizes dengan Ukuran teks akan otomatis diskalakan berdasarkan ruang yang dimilikinya di dalam induk. Selain itu, kami meningkatkan opsi elipsis untuk 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 mem-build ExpandedDimensionProp, kita telah menambahkan metode bantuan DimensionBuilders.weight.
  • Dukungan untuk menyembunyikan dan menampilkan kembali elemen tata letak secara dinamis dengan Modifier.visible. Hal ini termasuk memiliki nilai dinamis di BoolProp.
  • Semua ProtoLayout API 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 hingga minimal 48x48 di perender untuk mendukung persyaratan aksesibilitas dengan lebih baik.
  • Mengikuti komponen Material dan inisiatif Compose lainnya, kini kami telah menonaktifkan padding font secara default di semua elemen Text. Selain itu, AndroidTextStyle dan penyetel terkait telah dihapus dari API publik. dengan perbaikan bug berikut:
  • Menambahkan penyetel untuk memosisikan konten tepi di EdgeContentLayout sehingga dapat diposisikan sebelum konten lain.
  • Secara konsisten menampilkan pengecualian saat menemukan nilai enum yang tidak dikenali.
  • Membatalkan hasil ekspresi jika menghasilkan nilai numerik yang tidak valid (NaN atau tak terhingga) atau menampilkan ArithmeticException.

Perubahan API

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

Perbaikan Bug

  • Menambahkan dukungan API dan perender yang dibatasi untuk menetapkan arah penggambaran elemen busur. (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)
  • Perender kini mendukung opsi TEXT_OVERFLOW_ELLIPSIZE. (I7f085)

Perubahan API

  • Opsi overflow teks TEXT_OVERFLOW_ELLIPSIZE_END kini tidak digunakan lagi. Harap gunakan API TEXT_OVERFLOW_ELLIPSIZE baru dengan perilaku yang sangat mirip. (I822d8)
  • Mengikuti komponen Material dan inisiatif Compose lainnya, kini kami telah 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 int, bukan argumen SpProp. (I02b37)

Perbaikan Bug

  • Menampilkan pengecualian saat menemukan nilai enum Undefined atau Unrecognized. (I9d2cf)
  • Faktorkan ulang DynamicTypeBindingRequest. (I27b57)
  • Membatalkan 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/menampilkan 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 membuat elipsis pada Teks dalam penampung induk tetap meskipun baris maksimum tidak tercapai (tetapi tidak ada cukup ruang untuk Teks). (I110a9)
  • Menambahkan metode helper DimensionBuilders.weight untuk mem-build 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 yang Diperluas untuk lebar/tinggi. (Ie7c94)
  • Mendukung ekstensi area target klik di Perender (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 untuk diperluas. (I757ca)
  • Kami telah menambahkan API eksperimental untuk menskalakan ukuran teks secara otomatis berdasarkan ruang yang dimilikinya di dalam induk. (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-waktu zona. (Ibfae0)
  • Menambahkan proto dan Wrapper java yang diperlukan untuk pemformatan tanggal-waktu zona. (I97126)
  • Menambahkan pengambil untuk membaca kembali nilai yang disimpan di DynamicDataValue. (Ie6cea)
  • Menambahkan penyetel untuk memosisikan konten tepi di EdgeContentLayout sehingga dapat diposisikan sebelum konten lain. (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 ditetapkan (atau kosong) tidak akan diabaikan lagi. (Ibc785)
  • Mengurangi penundaan antara tata letak yang 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 tidak sengaja dan tidak berpengaruh pada tata letak yang disediakan. (If7d01)
  • Kami telah membatasi kedalaman maksimum yang dapat dimiliki tata letak ProtoLayout hingga 30 LayoutElements bertingkat. (I8a74b)

Perbaikan Bug

  • Kami telah menambahkan pemeriksaan untuk ditampilkan jika DynamicColor telah ditetapkan untuk SpanText. (I0e5bc)
  • Dijelaskan bahwa satuan sumber data DAILY_CALORIES adalah kcal. (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 setelan jam untuk pengujian binding waktu. (I05622)

Perubahan API

  • PlatformDataReceiver.onData() dan StateBuilders.Builder.addKeyToValueMapping kini menerima pemetaan aman jenis DynamicDataKey ke DynamicDataValue, bukan generik yang tidak aman. Artinya, DynamicDataValue kini diketik dengan DynamicType-nya. Konstanta HEART_RATE_ACCURACY_X dipindahkan ke root PlatformHealthSources, agar cocok dengan posisi 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 tidak sengaja dibuat instance-nya. 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 Properti dengan kolom dinamis untuk menggunakan oneof (I81739)
  • Menggunakan kembali penerapan penyetel untuk overload yang memiliki penyetel (Ied70c)
  • Merekam sidik jari dengan benar di penyetel 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)
  • Membuat StateStore menjadi class final (I408ca)
  • Antarmuka TimeGateway telah diganti dengan 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)
  • Dalam Teks Material, getExcludeFontPadding telah diganti namanya menjadi hasExcludeFontPadding. (Iea01d)
  • Penyetel untuk menyelaraskan label dengan sempurna telah ditambahkan ke semua komponen chip. Semua chip kini memiliki 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 Properti untuk menjelaskan alasan penerapan nilai statis. 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 aplikasi yang didorong; 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 sudah 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 yang mengubah 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 di StateStore untuk memastikan bahwa penggunaan memori dan waktu pembaruan status dimuat dan dikontrol dengan baik untuk setiap instance StateStore. Akibatnya, 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)
  • Sembunyikan class OnLoadTrigger dan OnConditionMetTrigger, dan ganti nama setTrigger menjadi setCondition untuk OnConditionMetTrigger. (Ibf629)
  • Karena alasan performa dan kompatibilitas, perender ProtoLayout tidak akan mendukung kumpulan fitur lengkap dalam resource AnimatedVectorDrawable. Kami menandai API tersebut sebagai eksperimental hingga kami dapat menentukan kumpulan yang didukung. (Ic6daf)
  • Menambahkan jenis dinamis untuk jarak harian, kalori harian, dan lantai harian. Kunci untuk sumber info kesehatan platform kini berada di PlatformHealthSources.Keys (Ib7637)
  • Metode Easing.cubicBezier menggantikan CubicBezierEasing.Builder. Dengan demikian, class EasingFunction akan 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 menjadi Closeable karena tidak lagi mempertahankan status apa pun. (I6b4f7)
  • Izinkan penggunaan FloatProp dengan DynamicFloat untuk progres di CircularProgressIndicator. Hal ini didukung untuk perender yang mendukung versi 1.2. Perender lama akan kembali ke staticValue jika disediakan, jika tidak, ke 0 (I0d91b)
  • Konstanta MultiButtonLayout telah difaktorkan ulang menjadi class LayoutDefaults.MultiButtonLayoutDefaults yang sekarang berisi konstanta untuk ukuran tombol, bergantung pada jumlah tombol dalam tata letak. (I13973)
  • Mendukung penggunaan StringProp dengan DynamicString di Teks Material. Hal ini didukung untuk perender yang mendukung versi 1.2. Perender lama akan kembali 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 setelan yang mengecualikan padding font di Teks Material ProtoLayout. (I17f5d)
  • ARGB_8888 kini didukung untuk gambar inline. (I18c1e)
  • DynamicColor kini mendukung operasi onCondition. (I10927)

Perubahan API

  • Mendukung durasi kustom untuk animasi terbalik (I3251f)
  • Kami 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 DynamicFloat NaN dan mempersempit DynamicInt32 ke 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 Konsumen. (Icf314)
  • ObservableStateStore diganti namanya menjadi StateStore. (Ieb0e2)
  • Menambahkan DynamicTypeEvaluator.Builder, bukan argumen konstruktor, untuk mengizinkan lebih banyak argumen opsional, termasuk ObservableStateStore yang kini ditetapkan secara default ke penyimpanan kosong. (I6f832)
  • Memfaktorkan ulang urutan parameter di DynamicTypeEvaluator. (Ic1ba4)

Perbaikan Bug

  • Memperluas sinyal dari sumber sensor platform ke node downstream dengan benar (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 update 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 berikutnya dari satu elemen. (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 digabungkan.
  • Kami telah menambahkan jenis dinamis durasi dan instan. Fungsi ini dapat digunakan untuk mewakili waktu instan atau durasi 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.