Halaman ini diterjemahkan oleh Cloud Translation API.

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
11 Desember 2024	1.2.1	-	-	1.3.0-alpha05

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-alpha04"

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

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

Kotlin

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

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

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

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-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, -Xtype-enhancement-improvements-strict-mode (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 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.
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)
- Meningkatkan API pemilihan font 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 batasan 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 bobot 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 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 yang akan 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 telah 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 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 informasi 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.