Wear Tiles

Membuat aplikasi untuk smartwatch Wear OS by Google.
Update Terbaru Rilis Stabil Kandidat Rilis Rilis Beta Rilis Alfa
13 November 2024 1.4.1 - - 1.5.0-alpha04

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada Wear, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

Groovy

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.5.0-alpha04"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha04"

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

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0-alpha04"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0-alpha04"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0-alpha04")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha04")

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

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0-alpha04")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.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.5

Versi 1.5.0-alpha04

13 November 2024

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

Versi 1.5.0-alpha03

30 Oktober 2024

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

Versi 1.5.0-alpha02

16 Oktober 2024

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

Perbaikan Keamanan

  • Mulai perubahan ini, androidx dikompilasi dengan protobuf 4.28.2 untuk mengatasi CVE-2024-7254. Upgrade dependensi Anda pada androidx.wear.tiles:tiles-proto versi 1.5.0-alpha01 ke 1.5.0-alpha02 untuk mengatasi risiko kerentanan.

Versi 1.5.0-alpha01

2 Oktober 2024

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

Versi 1.4

Versi 1.4.1

16 Oktober 2024

androidx.wear.tiles:tiles-*:1.4.1 dirilis. Versi 1.4.1 berisi commit ini.

Perbaikan Keamanan

  • Mulai perubahan ini, androidx dikompilasi dengan protobuf 4.28.2 untuk mengatasi CVE-2024-7254. Upgrade dependensi Anda pada androidx.wear.tiles:tiles-proto versi 1.4.0 ke 1.4.1 untuk mengatasi risiko kerentanan.

Versi 1.4.0

7 Agustus 2024

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

Perubahan penting sejak versi 1.3.0

  • Dukungan alat untuk menentukan data platform kustom untuk pratinjau Kartu di Android Studio.

Versi 1.4.0-rc01

24 Juli 2024

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

Versi 1.4.0-beta01

10 Juli 2024

androidx.wear.tiles:tiles-*:1.4.0-beta01 dirilis. Versi 1.4.0-beta01 berisi commit ini.

Fitur Baru

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

  • Dukungan alat untuk menentukan data platform kustom untuk pratinjau Kartu di Android Studio.

Versi 1.4.0-alpha05

26 Juni 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha05 dirilis. Versi 1.4.0-alpha05 berisi commit ini.

Versi 1.4.0-alpha04

29 Mei 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha04 dirilis. Versi 1.4.0-alpha04 berisi commit ini.

Versi 1.4.0-alpha03

14 Mei 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha03 dirilis. Versi 1.4.0-alpha03 berisi commit ini.

Perbaikan Bug

  • TileService#getActiveTilesAsync kini menggunakan WearSdk API (jika tersedia) untuk memberikan hasil yang lebih akurat. (I57bd8)

Versi 1.4.0-alpha02

1 Mei 2024

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

Perubahan API

  • Pindahkan tileId ke parameter konstruktor Builder sebagai kolom wajib dan dokumentasikan nilai stempel waktu default di pengambil. (I98c2b)
  • Tambahkan pesan proto TileInteractionEvent, TileEnter, dan TileLeave serta Wrapper Java yang diperlukan untuk mengelompokkan peristiwa masuk/keluar kartu. (I112b0)
  • Faktorkan ulang TileRenderer untuk menggunakan Builder, bukan objek TileRenderer.Config. (Ib66f9)
  • Tambahkan atribut platformDataProviders ke TileRenderer.Config. (I6030d)
  • Tambahkan konstruktor baru ke TileRenderer yang mendukung class TileRenderer.Config baru. Konstruktor lainnya tidak digunakan lagi. (Iae7ff)
  • Tambahkan kolom platformDataValues ke TilePreviewData untuk mengizinkan penggantian nilai data platform. (If437a)

Perbaikan Bug

  • Dokumentasikan bahwa nilai default untuk TileRenderer.Config.Builder#setTilesTheme adalah nol. (Iced18)

Versi 1.4.0-alpha01

6 Maret 2024

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

Versi 1.3

Versi 1.3.0

7 Februari 2024

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

Perubahan penting sejak versi 1.2.0

  • Memperbarui alat untuk dukungan pratinjau kartu.
  • Dukungan untuk membuat kueri kartu aktif milik aplikasi.

Perubahan lainnya

  • Untuk kumpulan perubahan yang lebih lengkap yang diperkenalkan di versi 1.3.0, lihat catatan rilis beta01.

Versi 1.3.0-rc01

24 Januari 2024

androidx.wear.tiles:tiles-*:1.3.0-rc01 dirilis. Version 1.3.0-rc01 berisi commit berikut ini.

Perubahan API

  • Mengganti nama TileService#getActiveTilesSnapshotAsync menjadi getActiveTilesAsync. (If6b87)

Versi 1.3.0-beta01

10 Januari 2024

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

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

  • Modul untuk alat kartu Wear diperbarui untuk dukungan pratinjau kartu dan disiapkan untuk dipublikasikan.
  • Dukungan untuk membuat kueri kartu mana yang termasuk dalam aplikasi yang aktif dengan TileService.getActiveTilesSnapshotAsync.

Versi 1.3.0-alpha04

13 Desember 2023

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

Versi 1.3.0-alpha03

29 November 2023

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

Fitur Baru

  • Menambahkan TileService#getActiveTilesSnapshotAsync API baru untuk membuat kueri kartu mana yang termasuk dalam aplikasi yang aktif. (I6850e)

Perubahan API

  • Mengganti nama @TilePreview menjadi @Preview (Ifc08a)

Versi 1.3.0-alpha02

15 November 2023

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

Fitur Baru

  • Kami telah menambahkan API eksperimental untuk menskalakan ukuran teks secara otomatis berdasarkan ruang yang dimilikinya di dalam induk. (Ibbe63)

Versi 1.3.0-alpha01

18 Oktober 2023

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

Fitur Baru

  • Berikan konteks sebagai parameter metode pratinjau, bukan parameter callback TilePreviewData. (I5e97d)
  • Modul untuk alat kartu Wear diperbarui untuk dukungan pratinjau kartu dan disiapkan untuk dipublikasikan. (I63d0f)

Versi 1.2

Versi 1.2.0

9 Agustus 2023

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

Perubahan penting sejak 1.1.0

  • Rilis stabil Wear Tiles 1.2.0 (baca selengkapnya)
  • Kartu 1.2 menambahkan dukungan untuk mengikat elemen tata letak ke data platform (untuk pembaruan yang lebih cepat) dan animasi. Untuk petunjuk migrasi, lihat catatan rilis untuk (1.2.0-rc01)

Versi 1.2.0-rc01

26 Juli 2023

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

  • Dengan rilis v1.2, library Kartu telah difaktorkan ulang dan sebagian besar fitur dan API dipindahkan ke library ProtoLayout baru (paket androidx.wear.protolayout) dengan sebagian kecil yang tersisa di Kartu (androidx.wear.tiles):

    • Semua nama class tetap sama, hanya ada penambahan pada v1.1
    • Sebagian besar API tetap sama dan satu-satunya perubahan adalah nama paket.
    • Beberapa metode di TileService/TileBuilder tidak digunakan lagi dan kini telah mengganti nama versi yang menerima jenis ProtoLayout baru, bukan jenis Kartu yang tidak digunakan lagi.

  • Untuk mempermudah migrasi ini, kami telah menyusun petunjuk dan skrip kecil yang melakukan penggantian nama ini, lihat di sini.

Perubahan API

  • Kami telah membatasi kedalaman maksimum yang dapat dimiliki tata letak hingga 30 elemen bertingkat dalam kartu. Jika kedalaman tersebut terlampaui, perender kartu akan menampilkan tata letak yang sebelumnya di-inflate. (I8a74b)

Versi 1.2.0-beta01

21 Juni 2023

androidx.wear.tiles:tiles-*:1.2.0-beta01 dirilis tanpa perubahan. Versi 1.2.0-beta01 berisi commit ini.

Versi 1.2.0-alpha07

7 Juni 2023

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

Fitur Baru

  • TileRenderer.setState memungkinkan penetapan status untuk sesi rendering. Status ini akan berlaku untuk tata letak saat ini dan tata letak mendatang (hingga status baru ditetapkan) (Iaaf35)
  • Jenis protolayout kini sepenuhnya didukung di semua API perender ubin. (I428b0)

Perbaikan Bug

  • Sekarang Anda dapat menetapkan tema kustom di ProtoLayoutViewInstance. (Iae8c0)

Versi 1.2.0-alpha06

24 Mei 2023

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

Perubahan API

  • Mengganti nama StateEntryValue menjadi DynamicDataValue, dan mengupdate 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)

Versi 1.2.0-alpha05

10 Mei 2023

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

Fitur Baru

  • Kami telah menambahkan ID kartu ke peristiwa dan permintaan kartu. ID ini dapat digunakan untuk mengaitkan beberapa data dengan instance kartu di carousel. (Ic4f83)

Perubahan API

  • TileRenderer.inflateAsync kini menampilkan ListenableFuture. (I2f2b9)
  • Builder kartu yang memiliki pengganti di library protolayout kini ditandai sebagai tidak digunakan lagi. (Ie2029)

Perbaikan Bug

  • Javadoc untuk TileService.onTileResourcesRequest kini menjelaskan kapan metode dapat dipanggil oleh sistem. (Iee037)

Versi 1.2.0-alpha04

19 April 2023

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

Perbaikan Bug

  • Dependensi gradle kini disetel dengan benar ke api, bukan implementation jika diperlukan. (I40503)

Versi 1.2.0-alpha03

5 April 2023

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

Perubahan API

  • Kami telah menambahkan dukungan untuk jenis androidx.wear.protolayout ke TileRenderer (I4ac7f)
  • ObservableStateStore diganti namanya menjadi StateStore. (Ieb0e2)
  • Menambahkan overload untuk jenis protolayout ke TileRenderer (I4ac7f)
  • Mengaktifkan animasi di TileRenderer (I07dcf)

Versi 1.2.0-alpha02

22 Maret 2023

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

Perubahan API

  • Library Tiles Material tidak digunakan lagi. Gunakan library ProtoLayout Material baru dengan fungsi yang sama. (If242b)

Perbaikan Bug

  • TileRenderer telah diperbarui untuk menggunakan fitur baru dari library protolayout. (I832f9)

Versi 1.2.0-alpha01

8 Maret 2023

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

Fitur Baru

  • Kami telah menambahkan onTileResourceRequest ke TileService, untuk menyediakan resource dari library protolayout. (983d9c5)
  • Kami telah mengupdate ResourcesRequest dan TileRequest untuk mendukung jenis State dan DeviceParameters dari library protolayout. (88fa01d)
  • Kami telah mengupdate TileBuilders.Tile untuk mendukung jenis State dan Timeline dari library protolayout. (168619c)

Perbaikan Bug

  • Peningkatan pada Javadoc. (I3ed73)
  • Warna default untuk onPrimary dan platform telah berubah. (I0b039)

Versi 1.1

Versi 1.1.0

24 Agustus 2022

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

Perubahan penting sejak versi 1.0.0

  • Ini adalah rilis stabil pertama yang berisi library Tiles Material (baca selengkapnya di blog kami).
  • Library ini berisi komponen dan tata letak yang sesuai dengan panduan Material dan mudah digunakan. Komponen yang disertakan adalah Button, Chip, CompactChip, TitleChip, CircularProgressIndicator, Text. Semua komponen ini memiliki objek warna sendiri yang dapat dibuat dengan class Colors utama untuk menerapkan tema yang sama dengan mudah ke semua komponen. Selain warna, terdapat class Typography untuk mendapatkan objek FontStyle dengan mudah menggunakan nama tipografi.
  • Selain komponen, terdapat tata letak bersusun yang direkomendasikan - PrimaryLayout, EdgeContentLayout, MultiButtonLayout, MultiSlotLayout. Semua tata letak memiliki rekomendasi padding dan gaya yang diterapkan dalam pedoman Material.
  • Untuk daftar komponen dan tata letak dalam library Tiles Material, lihat catatan rilis untuk Tiles.

Versi 1.1.0-rc01

10 Agustus 2022

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

  • Tidak ada perubahan baru antara rilis Beta dan RC.

Versi 1.1.0-beta01

27 Juli 2022

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

Rilis 1.0.0-beta01 library Tiles Material berisi komponen dan tata letak yang selaras dengan pedoman Material dan mudah di-build.

Komponen yang disertakan adalah:

  • Button - objek berbentuk lingkaran yang dapat diklik, dengan ikon, teks, atau gambar serta 3 ukuran yang telah ditentukan.
  • Chip - objek berbentuk elips yang dapat diklik dan dapat berisi ikon, label utama dan sekunder, serta memiliki tinggi tetap dan lebar yang dapat disesuaikan.
  • CompactChip & TitleChip - dua variasi Chip standar yang masing-masing memiliki tinggi lebih kecil dan lebih besar, serta dapat berisi satu baris teks.
  • CircularProgressIndicator - lengkung berwarna di sekitar tepi layar dengan sudut awal dan akhir tertentu, yang dapat mendeskripsikan lingkaran penuh atau sebagian dengan lengkung progres penuh di belakangnya.
  • Text - teks bergaya yang menggunakan gaya tipografi Material Wear yang direkomendasikan

Semua komponen ini memiliki objek warnanya sendiri yang dapat dibuat dengan class Colors utama untuk menerapkan tema yang sama dengan mudah ke semua komponen. Selain warna, terdapat class Typography untuk mendapatkan objek FontStyle dengan mudah menggunakan nama tipografi.

Selain komponen, ada tata letak kartu yang direkomendasikan:

  • PrimaryLayout - Tata letak yang dapat disesuaikan dengan menambahkan label utama atau sekunder, konten di tengah, dan chip utama di bagian bawah. Konten utama dalam tata letak ini dapat ditambahkan sebagai objek MultiSlotLayout atau MultiButtonLayout.
  • EdgeContentLayout - Tata letak untuk memuat CircularProgressIndicator di sekitar tepi dengan konten utama di dalam dan label utama atau sekunder di sekitarnya.
  • MultiButtonLayout - Tata letak yang dapat berisi 1 - 7 tombol dan disusun sesuai dengan pedoman Material, bergantung pada jumlahnya.
  • MultiSlotLayout - Tata letak gaya seperti baris dengan slot yang sejajar secara horizontal dan memiliki spasi (untuk ikon atau konten kecil lainnya).

Semua tata letak memiliki rekomendasi padding dan gaya yang diterapkan dalam pedoman Material.

Perubahan API

  • Pemfaktoran ulang utama ke komponen Chip yang menyertakan pemisah penyetel di Builder sehingga setiap bagian konten diteruskan secara terpisah dengan penggantian nama agar sesuai dengan pedoman (label utama, label sekunder, ID resource gambar). Selain itu, jika tidak disetel, deskripsi konten akan otomatis dibuat. (I57622)
  • ProgressIndicatorLayout diganti namanya menjadi EdgeContentLayout. (Ic1aa6)
  • Konten ukuran tombol telah diganti namanya menjadi nama tanpa akhiran without _BUTTON di dalamnya dengan klarifikasi Javadocs tambahan di seluruh Button. (I1dfe2)

Perbaikan Bug

  • Margin, padding, dan keseluruhan pengaturan dalam Tata Letak Material telah diperbarui untuk mengakomodasi semua jenis tata letak serta ukuran dan bentuk layar yang direkomendasikan.
  • Peningkatan pada Tata Letak Material. Dalam MultiSlotLayout, lebar slot sekarang fleksibel yang akan menggabungkan konten, bukan ukuran tetap.(I52919),(If18b4)
  • Area yang dapat diketuk di CompactChip telah ditingkatkan untuk mengikuti pedoman aksesibilitas. (Ie8264)

Versi 1.1.0-alpha09

29 Juni 2022

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

Fitur Baru

  • Kami telah menambahkan dukungan untuk menambahkan label opsional di ProgressIndicatorLayout. (I30788)

Perubahan API

  • Metode helper untuk ElementMetadata kini menerima ElementMetadata, bukan Pengubah. (I5a70f)

Perbaikan Bug

  • Batasan 9 karakter pada CompactChip telah dihapus. Jika teks terlalu besar untuk dimuat di layar dalam PrimaryLayout, teks akan dimasukkan dalam elipsis. (Id56ec)
  • Pengambil di Chip kini memiliki akhiran Content. (Iba437)
  • Klarifikasi Javadoc di seluruh class Tiles Material. (I56e41), (I80f31), (Iba437)

Versi 1.1.0-alpha08

1 Juni 2022

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

Fitur Baru

  • Tag metadata telah ditambahkan ke Pengubah yang akan digunakan untuk melacak metadata komponen dengan metode bantuan yang ditambahkan ke class Helper. (I70db2),(I30c3d)
  • Metode statis fromLayoutElement telah ditambahkan ke semua komponen dan tata letak di dalam Tiles Material. Metode ini harus digunakan untuk menguji, guna mentransmisikan LayoutElement yang diperoleh dari mengakses konten penampung ke jenis aslinya. (Ia572a),(Idbd8a),(I3ae13),(I292fe),(I8b20f),(I3cacb),(I84b24)

Versi 1.1.0-alpha07

18 Mei 2022

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

Perubahan API

  • Pengambil yang terkait dengan penyetel yang berbeda untuk konten kini telah ditambahkan ke ProgressIndicatorLayout dan PrimaryLayout. Kini semua penyetel dalam class ini memiliki pengambil yang cocok.(Iddbe5) (Iabe4e)
  • Pengambil untuk deskripsi konten di Komponen Material dapat menampilkan null karena penyetelnya tidak wajib.
  • Mencoba membuat Tombol tanpa konten yang diteruskan akan menghasilkan IllegalArgumentException. (I7fc0c)
  • Kolom yang terkait dengan warna ikon di ChipColors telah diganti namanya dari iconTintColor menjadi iconColor. (Ic053b)

Perbaikan Bug

  • Menambahkan androidTests untuk Tata Letak dalam Tiles Material. (I96404)

Versi 1.1.0-alpha06

11 Mei 2022

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

Fitur Baru

  • Tata letak baru telah ditambahkan ke sub-library Material Layout - MultiButtonLayout. Tindakan ini akan menampilkan tata letak yang dapat berisi antara 1 hingga 7 tombol yang disusun sesuai dengan panduan Material. Pada umumnya, tata letak ini harus diteruskan sebagai konten ke PrimaryLayout. (Ib727f)

Perubahan API

  • MultiSlotLayout telah difaktorkan ulang agar hanya memiliki slot di dalamnya. Tata letak ini harus diteruskan sebagai konten ke PrimaryLayout utama. (I1870f)
  • Memperbarui warna default yang ditentukan untuk CircularProgressIndicator menjadi satu nilai, bukan utama dan sekunder. (I64a51)
  • Menambahkan pengambil untuk pengatur jarak horizontal di MultiSlotLayout. (I11e1e)

Perbaikan Bug

  • Pengujian Android untuk Component telah ditambahkan ke Tiles Material. (I20041)

Versi 1.1.0-alpha05

6 April 2022

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

Fitur Baru

  • Menambahkan metode helper untuk mengonversi LayoutElement ke Layout, Timeline, TimelineEntry menjadi class ini untuk memudahkan build Tiles. (I2f6d1)
  • Objek Colors telah ditambahkan ke library Material untuk diteruskan ke seluruh warna komponen sebagai tema. (I0792c)

Perubahan API

  • Komponen Teks Material mengharuskan teks diteruskan ke dalam konstruktor. Komponen ini kini dapat disesuaikan dengan menyetel bobot. (I25dbd)
  • Menghapus konstanta dari ChipDefaults yang tidak digunakan dalam penyetel publik. (I7baed)
  • Menghapus pengambil dari CompactChip & TitleChip yang tidak memiliki penyetel yang cocok. (I99e85)
  • Menghapus DEFAULT_PADDING dari ProgressIndicatorDefaults. (Idabcd)
  • Komponen material kini menerima CharSequence untuk deskripsi konten, bukan String. (I5b21a)

Perbaikan Bug

  • Memfaktorkan ulang penerapan parameter opsional penyetel di Button. (Ib7135)
  • Varian gaya font telah ditambahkan ke font di Tipografi. (I8dbc6)

Versi 1.1.0-alpha04

23 Maret 2022

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

Fitur Baru

  • Label utama atau sekunder opsional dapat ditambahkan ke PrimaryLayout. (Ib9916)
  • Komponen teks dapat disesuaikan dengan menyetel overflow, italic, underline, dll. (I703f7)

Perubahan API

  • Konstanta warna default telah dihapus dari Tiles Material API. (I0ab55)
  • Semua komponen yang dapat diklik di Material Kartu memerlukan objek Clickable di konstruktor Builder-nya, bukan Action. (I2f101)

Perbaikan Bug

  • Teks sekarang akan menggambar elipsis pada overflow di komponen Chip dan Text. (I8a2f8)
  • Meningkatkan kualitas tampilan komponen saat skala font pengguna disetel ke besar. (Ib63b1)
  • Mengklarifikasi Javadocs setPrimaryChipContent di PrimaryLayout. (Ie6296)

Versi 1.1.0-alpha03

23 Februari 2022

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

Perubahan API

  • Komponen Text dengan gaya tipografi yang direkomendasikan telah ditambahkan ke Material Kartu. (Iec0ae)

Versi 1.1.0-alpha02

9 Februari 2022

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

Fitur Baru

  • Sub-library baru layouts di Tiles Material telah ditambahkan. Sub-library ini berisi tata letak Kartu dengan padding dan margin yang direkomendasikan yang diterapkan untuk mempercepat pengembangan Kartu dan mempermudah penerapan. Tata letak awal adalah:
    • PrimaryLayout (I7ba91) yang menampilkan tata letak dengan chip utama di bagian bawah dan konten di tengah.
    • MultiSlotLayout (I32104) yang menampilkan tata letak dengan label pada baris 1 dan 3, disejajarkan secara horizontal dan slot spasi pada baris 2 dan semuanya diikuti oleh baris ke-4 yang berisi chip utama.
    • ProgressIndicatorLayout (I9fec6) yang menampilkan tata letak dengan indikator progres melingkar di sekitar tepi layar dan konten tertentu di dalamnya.
  • CircularProgressIndicator (Ic4b88) telah ditambahkan ke komponen Tiles Material.

Perubahan API

  • Mengganti nama konstanta yang tersisa yang digunakan oleh TitleChip untuk menyertakan judul dalam nama. (I14f4c)
  • Metode setHorizontalAlignment telah ditambahkan ke Chip. (Ie6e0b)

Versi 1.1.0-alpha01

26 Januari 2022

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

Fitur Baru

  • Library baru, Tiles Material, telah ditambahkan. Library ini berisi komponen untuk membuat tata letak Kartu yang lebih cepat dan lebih mudah dengan Desain Material. Komponen awal adalah:
    • Button
    • Chip
    • CompactChip
    • TitleChip

Perbaikan Bug

  • Memperbaiki bug di TileUiClient yang menyebabkan resource yang di-cache terhapus. (I60e0b)

Versi 1.0

Versi 1.0.1

26 Januari 2022

androidx.wear.tiles:tiles-*:1.0.1 dirilis. Versi 1.0.1 berisi commit ini.

Perbaikan Bug

  • Memperbaiki bug di TileUiClient yang menyebabkan resource yang di-cache terhapus. (I60e0b)

Versi 1.0.0

3 November 2021

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

Fitur utama 1.0.0

  • Library Wear Tiles menyediakan fungsi guna membuat Kartu kustom untuk perangkat Wear OS, beserta class yang memungkinkan sistem mengambil Kartu dan menampilkannya tepat di samping tampilan jam.
  • tiles-renderer memungkinkan Anda menampilkan Kartu sebagai bagian dari Aktivitas Android, yang mempermudah pengujian cepat tata letak kartu.

Versi 1.0.0-rc01

27 Oktober 2021

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

Versi 1.0.0-beta01

13 Oktober 2021

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

Perbaikan Bug

  • Memperbaiki NullPointerException di TileUiClient saat versi resource kosong diberikan. (I0586e)

Versi 1.0.0-alpha12

29 September 2021

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

Perbaikan Bug

  • UpdateScheduler tidak lagi menggunakan referensi lemah, yang memperbaiki masalah saat TileUiClient tidak akan diupdate (I1120d, b/199061124)

  • Mendeklarasikan bahwa SysUiTileUpdateRequester meng-kueri PacakgeManager, yang memperbaiki bug saat update kartu tidak berfungsi pada perangkat R+. (I1120d)

Versi 1.0.0-alpha11

1 September 2021

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

Fitur Baru

  • Menambahkan dan merilis library pengujian, library androidx.wear.tiles:tiles-testing untuk memungkinkan developer menguji kartu dengan lebih mudah. (Iedb6b)

Perubahan API

  • Mengganti nama TileProviderService menjadi TileService. (I1ad2c)
  • Builder kartu diperbarui; metode .builder() statis kini tidak digunakan lagi dan digantikan dengan memanggil new Foo.Builder(), serta kelebihan penyetel yang menerima instance Builder telah dihapus. (Ia9606)
  • TileRenderer sekarang harus menggunakan konteks UI, bukan konteks aplikasi. (I84b61)

Perbaikan Bug

  • Memperbaiki bug yang menyebabkan beberapa garis bawah diterapkan dalam situasi tertentu. (Ib6712)

Versi 1.0.0-alpha10

18 Agustus 2021

androidx.wear.tiles:tiles:1.0.0-alpha10, androidx.wear.tiles:tiles-proto:1.0.0-alpha10, dan androidx.wear.tiles:tiles-renderer:1.0.0-alpha10 dirilis. Versi 1.0.0-alpha10 berisi commit berikut ini.

Perubahan API

  • Menghapus pemeriksa tata letak dari API publik. Pemeriksa akan selalu diaktifkan, meskipun hanya akan menampilkan peringatan jika pemeriksaan gagal. (Ie9f29)
  • TileRenderer sekarang menerima konteks UI, bukan Konteks Aplikasi.

Perbaikan Bug

  • Memperbaiki bug yang membuat elemen yang dapat diklik di Spannable tidak diklik.

Versi 1.0.0-alpha09

21 Juli 2021

androidx.wear.tiles:tiles:1.0.0-alpha09, androidx.wear.tiles:tiles-proto:1.0.0-alpha09, dan androidx.wear.tiles:tiles-renderer:1.0.0-alpha09 dirilis. Versi 1.0.0-alpha09 berisi commit berikut ini.

Fitur Baru

  • Menambahkan pemeriksa tata letak ke perender Wear Tiles. (I3a869)
    • Ini digunakan untuk memvalidasi praktik terbaik dalam kartu Anda. Sebagai permulaan, pemeriksa ini akan memunculkan peringatan jika kartu Anda tidak berisi elemen apa pun dengan pengubah Semantics.
  • Menambahkan dokumentasi untuk DefaultTileProviderClient dan TestingTileProviderClient constructors. (I9f4b9)

Perubahan API

  • Mengganti nama di TileProviderClient (I0ec36):
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • Menambahkan pemeriksa tata letak ke perender Wear Tiles. (I3a869)

Perbaikan Bug

  • Memastikan target LaunchAction tidak memiliki izin khusus. (I39136)

Versi 1.0.0-alpha08

30 Juni 2021

androidx.wear.tiles:tiles:1.0.0-alpha08, androidx.wear.tiles:tiles-proto:1.0.0-alpha08, dan androidx.wear.tiles:tiles-renderer:1.0.0-alpha08 dirilis. Versi 1.0.0-alpha08 berisi commit berikut ini.

Fitur Baru

  • Spannable sekarang mendukung line_height, bukan line_spacing.

Perubahan API

  • Menambahkan dukungan untuk line_height di Spannable, menghapus line_spacing. (Ibeb54)
    • Kode yang menggunakan line_spacing harus ditransfer untuk menggunakan line_height.

Perbaikan Bug

  • Memperbaiki bug saat menggunakan dimensi yang proporsional. (I37ace)
  • Memperbaiki bug yang menyebabkan elemen Teks tidak memiliki deskripsi konten. (Id2c7d)

Versi 1.0.0-alpha07

16 Juni 2021

androidx.wear.tiles:tiles:1.0.0-alpha07, androidx.wear.tiles:tiles-proto:1.0.0-alpha07, dan androidx.wear.tiles:tiles-renderer:1.0.0-alpha07 dirilis. Versi 1.0.0-alpha07 berisi commit berikut ini.

Perubahan API

  • Menambahkan antarmuka TileProviderClient, dan mengekspos DefaultTileProviderClient, sehingga penerapan dapat mengikat ke antarmuka TileProviderService. (I69165)

Versi 1.0.0-alpha06

2 Juni 2021

androidx.wear.tiles:tiles:1.0.0-alpha06, androidx.wear.tiles:tiles-proto:1.0.0-alpha06, dan androidx.wear.tiles:tiles-renderer:1.0.0-alpha06 dirilis. Versi 1.0.0-alpha06 berisi commit berikut ini.

Perubahan API

  • Semua class Builder kini berisi pengambil untuk semua properti. Perlu diketahui bahwa ini hanya dimaksudkan untuk tujuan pengujian (I9d155)
  • Perubahan paket: Class di androidx.wear.tiles.builders telah dipindahkan ke androidx.wear.tiles.
  • Menambahkan dukungan tint eksperimental ke Tiles. (I38929)
  • Mengganti nama LayoutElementBuilders.HALIGN_* menjadi LayoutElementBuilders.HORIZONTAL_ALIGN_* (I67e58)
  • Mengganti nama LayoutElementBuilders.VALIGN_* menjadi LayoutElementBuilders.VERTICAL_ALIGN_* (I67e58)
  • Mengganti nama LayoutElementBuilders.SPAN_VALIGN_* menjadi LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* (I67e58)
  • Menambahkan class builder untuk Request dan Event. (Ib5cf4)
  • Memigrasikan TileProviderService untuk menggunakan class permintaan dan peristiwa dari RequestBuilders dan EventBuilders, bukan RequestReaders/EventReaders (misalnya, onTileRequest kini menyediakan RequestBuilders.TileRequest, bukan RequestReaders.TileRequest). (I46ea1)

Perbaikan Bug

  • Memperbaiki bug dalam pemuatan gambar asinkron untuk perender Tiles. (Iad9b0)
  • Memperbaiki bug tata letak saat menempatkan gambar dengan lebar atau tinggi yang disetel ke expand() dalam Box dengan lebar atau tinggi disetel ke wrap(). (I33770)

Versi 1.0.0-alpha05

18 Mei 2021

androidx.wear.tiles:tiles:1.0.0-alpha05, androidx.wear.tiles:tiles-proto:1.0.0-alpha05, dan androidx.wear.tiles:tiles-renderer:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit berikut ini.

Perubahan API

  • Menghapus getTileId dari peristiwa kartu yang masuk (TileAddEvent, TileRemoveEvent, TileEnterEvent, TileLeaveEvent, TileRequest). (Ifbba2)
  • Mengganti nama ImageResource#setAndroidResourceByResid menjadi setAndroidResourceByResId (I4ba6e)
  • Mengganti nama TimelineManager#deInit menjadi close dan mengimplementasikan AutoCloseable. (I5dff2)

Versi 1.0.0-alpha04

5 Mei 2021

androidx.wear.tiles:tiles:1.0.0-alpha04, androidx.wear.tiles:tiles-proto:1.0.0-alpha04, dan androidx.wear.tiles:tiles-renderer:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit berikut ini.

Perubahan API

  • Menyembunyikan class TileProviderService konkret.
    • Membuat TileUpdateRequester mengambil Class<? extends TileProviderService>. (Ib7cca)
  • Menambahkan kemampuan untuk memberikan tambahan ke AndroidActivity. (I748f4)

Tiles Versi 1.0.0-alpha03

21 April 2021

androidx.wear.tiles:tiles:1.0.0-alpha03, androidx.wear.tiles:tiles-proto:1.0.0-alpha03, dan androidx.wear.tiles:tiles-renderer:1.0.0-alpha03 dirilis. Versi 1.0.0-alpha03 berisi commit berikut ini.

Perubahan API

  • Ganti nama TileManager -> TileClient
    • Ganti nama TileManager#create -> TileClient#connect (I91839)

Perbaikan Bug

  • Menambahkan aturan Proguard untuk memastikan tiles dan tiles-renderer berfungsi dengan baik dengan Proguard yang diaktifkan (Ie3d85)

Versi 1.0.0-alpha02

7 April 2021

androidx.wear.tiles:tiles:1.0.0-alpha02, androidx.wear.tiles:tiles-proto:1.0.0-alpha02, dan androidx.wear.tiles:tiles-renderer:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Perubahan API

  • androidx.wear:wear-tiles telah berpindah grup, dan kini akan disebut sebagai androidx.wear.tiles:tiles
  • androidx.wear:wear-tiles-renderer telah berpindah grup, dan kini akan disebut sebagai androidx.wear.tiles:tiles-renderer
  • TileRenderer.LoadActionListener kini menggunakan instance androidx.wear.tiles.builders.StateBuilders.State, bukan androidx.wear.tiles.proto.StateProto.State.
  • TileRenderer kini menerima resource Kartu dari androidx.wear.tiles.builders.ResourceBuilders.Resources, bukan instance androidx.wear.tiles.renderer.ResourceAccessors.

Perbaikan Bug

  • Memperbaiki ketidakmampuan untuk menggunakan LoadActionListener, karena menampilkan class internal.

Versi 1.0.0-alpha01

10 Maret 2021

androidx.wear:wear-tiles:1.0.0-alpha01, androidx.wear:wear-tiles-proto:1.0.0-alpha01, dan androidx.wear:wear-tiles-renderer:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

  • Library Wear Tiles Renderer menyediakan fungsi guna membuat Kartu kustom untuk perangkat Wear OS, beserta class yang memungkinkan sistem mengambil Kartu dan menampilkannya tepat di samping tampilan jam.