Glance Wear

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada glance-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:

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha13"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha13"
}

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha13")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha13")
}

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.

Glance Wear Versi 1.0

Versi 1.0.0-alpha17

26 Agustus 2026

androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17, dan androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17 dirilis. Versi 1.0.0-alpha17 berisi commit ini.

Fitur baru

• Menambahkan pemeriksaan lint di Glance Wear untuk memastikan bahwa setiap <container> dalam XML <wearwidget-provider> untuk Metadata Widget secara eksplisit menentukan atribut jenis yang didukung dan tidak menentukan jenis duplikat. (I52c9a, b/464458215)

Versi 1.0.0-alpha16

12 Agustus 2026

androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16, dan androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16 dirilis. Versi 1.0.0-alpha16 berisi commit ini.

Fitur baru

• Menambahkan validasi Lint untuk metadata XML <wearwidget-provider> guna memastikan elemen konfigurasi yang diperlukan (seperti container dan previewImage) ada. (Ia9983, b/464458215)
• Menambahkan peringatan error Lint untuk menyetel latar belakang hitam atau transparan ke Widget Wear (Idedb0, b/529269573)
• Mengaktifkan operasi Remote Compose CORE_TEXT untuk profil Widget Wear. Hal ini memungkinkan RemoteText menggunakan fitur font variabel, seperti sumbu font, tinggi baris, dll., pada perender Host yang didukung, dengan penggantian otomatis jika tidak didukung.

Perbaikan

• Memperbarui KDocs untuk anotasi AssociateWithGlanceWearWidget sesuai masukan developer

Versi 1.0.0-alpha15

29 Juli 2026

androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15, dan androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15 dirilis. Versi 1.0.0-alpha15 berisi commit ini.

Fitur baru

• Menambahkan peringatan Lint saat menyetel latar belakang kosong ke dokumen Widget Wear. (Ic6475, b/529269573)

Versi 1.0.0-alpha14

15 Juli 2026

androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14, dan androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14 dirilis. Versi 1.0.0-alpha14 berisi commit ini.

Perubahan API

• Kami telah menambahkan penyedia parameter pratinjau RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams, dan RoundLargeWidgetPreviewParams untuk widget Glance Wear yang sepenuhnya dibulatkan. (If5336, b/512405233)

Fitur baru

• Kami telah menyiapkan dan menambahkan library Linter untuk widget Glance Wear.(If4218, b/527402079)
  • Menambahkan pemeriksaan lint untuk memastikan bahwa subclass GlanceWearWidgetService secara eksplisit mendeklarasikan class widget terkait menggunakan anotasi @AssociateWithGlanceWearWidget. (Idc575, b/477024153)
• Kami telah meningkatkan kompatibilitas mundur untuk widget yang berjalan di Host lama dengan menyebarkan operasi yang didukung melalui WearWidgetParams dan menambahkan pemfilteran profil operasi yang diizinkan ke operasi tersebut. (Ib0a1b, I83cb1, [b/526716195])

Versi 1.0.0-alpha13

1 Juli 2026

androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13, dan androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13 dirilis. Versi 1.0.0-alpha13 berisi commit ini.

Perubahan API

• Menghapus pemeriksaan izin dari heartRateAccuracy (I14269, b/522444636)

Perbaikan bug

• Kami telah menyesuaikan parameter widget Wear berbentuk Squircle untuk pratinjau per masukan UX

Versi 1.0.0-alpha12

17 Juni 2026

androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12, dan androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12 dirilis. Versi 1.0.0-alpha12 berisi commit ini.

Fitur baru

• Menambahkan AssociateWithGlanceWearWidget yang harus digunakan di GlanceWearWidgetService untuk menyediakan implementasi GlanceWearWidget yang terkait. (Ifcabb, b/514679763)

  • Contoh:

   @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
   class MyGlanceWearWidgetService : GlanceWearWidgetService() {
     override val widget = MyGlanceWearWidget()
   }
   ```
  

• Kami telah menambahkan kuas image ke WearWidgetBrush untuk mendukung latar belakang bitmap di Widget Wear. (I9a228, b/513481558)

• Kami telah memperkenalkan fungsi bantuan @Composable, WearWidgetPreview, untuk menyederhanakan pengembangan widget Glance Wear dengan menghapus boilerplate yang diperlukan untuk pratinjau IDE.

Perubahan API

• Mengganti nama androidx.glance.wear.health.DataType menjadi androidx.glance.wear.health.HealthData (I4cb0b, b/516746689)
• isHeartRateBpmAvailable diekspos untuk menentukan apakah heartRateBpm tersedia di host. (I5999d, b/514641567)
• Mengekspos RemoteInt operator perbandingan. (I5fe3d, b/513228889)
• Mengekspos captureRemoteDocument Flow API dan overload captureSingleRemoteDocument baru (yang menggunakan RemoteCreationDisplayInfo) sebagai API publik. (I87b0e, b/513228889)
• Kami telah menambahkan @CallSuper ke metode siklus proses GlanceWearWidgetService

Versi 1.0.0-alpha11

3 Juni 2026

androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11, dan androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11 dirilis. Versi 1.0.0-alpha11 berisi commit ini.

Perubahan API

• Kami telah menambahkan WearWidgetPreview untuk melihat pratinjau Widget Wear di Android Studio. (I36504, b/485147770)
• Mengekspos is*Available (isDailyStepsAvailable, dll.) variabel untuk memverifikasi apakah jenis data kesehatan terkait tersedia dan valid. (Ib98a7, b/498179656)
• Menambahkan triggerUpdateAll API ke GlanceWearWidget untuk memicu update pada semua widget aplikasi yang diberikan. (I6ab20, b/510896410)

Perbaikan Bug

• Menyertakan informasi versi Perender di WearWidgetParams sebagai kolom internal untuk mencegah kerusakan dalam dokumen yang dibuat dengan versi alpha10. (Idcf8e, b/511263591, b/512830184)
• Memicu alur update tarik paksa dalam mode debug atau emulator untuk Widget Wear.

Versi 1.0.0-alpha10

19 Mei 2026

androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10, dan androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10 dirilis. Versi 1.0.0-alpha10 berisi commit ini.

Perubahan API

• Mengekspos glance.wear.health.DataType API di Widget Wear. API ini dapat digunakan oleh developer untuk mengakses data kesehatan sistem.

Perbaikan Bug

• Memperbaiki loop error yang terjadi di versi alpha09 pada emulator Wear 7 atau perangkat yang menjalankan perender 1.6 dengan tidak mengizinkan sumbu font kosong dikirim ke Pemutar untuk Widget Glance Wear.

Versi 1.0.0-alpha09

6 Mei 2026

androidx.glance.wear:wear:1.0.0-alpha09 dan androidx.glance.wear:wear-core:1.0.0-alpha09 dirilis. Versi 1.0.0-alpha09 berisi commit ini.

Perubahan API

• Kami telah menambahkan ExperimentalGlanceWearApi yang akan digunakan untuk fitur Glance Wear eksperimental. (Id2f76, b/498179813)

Perbaikan Bug

• Memperbarui parser untuk metadata XML Widget Wear agar mengetahui widget selama booting.

Versi 1.0.0-alpha08

22 April 2026

androidx.glance.wear:wear:1.0.0-alpha08 dan androidx.glance.wear:wear-core:1.0.0-alpha08 dirilis. Versi 1.0.0-alpha08 berisi commit ini.

Perbaikan Bug

• Menambahkan tag <queries> ke manifes library glance:wear:wear untuk memastikan PackageManager mengkueri layanan yang benar untuk update push. (I192787)

Lainnya

• Mengembalikan "Updates Compose compileSdk to 37" (I6007) yang juga berlaku untuk glance-wear, sehingga persyaratan compileSdk tidak lagi 37 dalam rilis ini.

Versi 1.0.0-alpha07

8 April 2026

androidx.glance.wear:wear:1.0.0-alpha07 dan androidx.glance.wear:wear-core:1.0.0-alpha07 dirilis. Versi 1.0.0-alpha07 berisi commit ini.

Fitur Baru

• Menambahkan latar belakang Widget Wear default saat WearWidgetBrush kosong atau tidak ditentukan. (I8300b)
• Memperbarui getActiveWidgets API untuk menampilkan Jenis Penampung Widget. (2772eb1)

Perubahan API

• Mengubah API update Widget untuk menggunakan WidgetInstanceId dan menambahkan helper untuk mengambil ID untuk widget tertentu. API baru akan menampilkan IllegalArgumentException jika ID yang diberikan tidak valid atau tidak dimiliki oleh pemanggil. (I6f3c5, b/446828899)
• Menambahkan gradien vertikal dan horizontal di WearWidgetBrush. (If70ae, b/470080675)

Versi 1.0.0-alpha06

25 Maret 2026

androidx.glance.wear:wear:1.0.0-alpha06 dan androidx.glance.wear:wear-core:1.0.0-alpha06 dirilis. Versi 1.0.0-alpha06 berisi commit ini.

Fitur Baru

• Menentukan operasi untuk profil Widget Wear secara inline.

Perubahan API

• Kami telah mengganti nama CONTAINER_TYPE_FULLSCREEN menjadi CONTAINER_TYPE_TILE_COMPAT untuk membedakan widget kompatibilitas layar penuh dengan lebih baik. Hal ini mencakup pengembalian pemetaan jenis FULLSCREEN sebelumnya ke LARGE dalam parameter Widget.

Versi 1.0.0-alpha05

11 Maret 2026

androidx.glance.wear:wear:1.0.0-alpha05 dan androidx.glance.wear:wear-core:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Perubahan API

• Kami telah menambahkan WearWidgetBrush API dengan metode color untuk digunakan sebagai latar belakang Widget Wear. (I66f54, b/464273091)
• Metode fetchActiveWidgetsForProvider telah dihapus karena sudah ada fetchActiveWidgets. (I85e4e, b/486197890)

Versi 1.0.0-alpha04

25 Februari 2026

androidx.glance.wear:wear:1.0.0-alpha04 dan androidx.glance.wear:wear-core:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit ini.

Perubahan API

• Menambahkan GlanceWearWidgetManager API untuk memungkinkan Aplikasi mengkueri widget dan kartu aktifnya. (I5be95)
• Kami telah memindahkan API dari library glance:wear:wear-core ke paket androidx.glance.wear.core. (I429cf)

Perbaikan Bug

• Mengekspos jenis Remote Composable dan Modifier umum (Id1d40)

Versi 1.0.0-alpha03

11 Februari 2026

androidx.glance.wear:wear:1.0.0-alpha03 dan androidx.glance.wear:wear-core:1.0.0-alpha03 dirilis. Versi 1.0.0-alpha03 berisi commit ini.

Perubahan API

• Menambahkan dukungan untuk Peristiwa Interaksi ke GlanceWearWidget. (Ia4e28, b/469808447)

Versi 1.0.0-alpha02

28 Januari 2026

androidx.glance.wear:wear:1.0.0-alpha02 dan androidx.glance.wear:wear-core:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Fitur Baru

• Memetakan ulang FULLSCREEN ke LARGE dalam parameter Widget (ad78d95)

Perbaikan Bug

• Memperbaiki penggunaan DataStore yang akan mencegah beberapa instance widget ditampilkan (474f3e4)

Versi 1.0.0-alpha01

14 Januari 2026

androidx.glance.wear:wear:1.0.0-alpha01 dan androidx.glance.wear:wear-core:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

• Glance Wear adalah library untuk membuat Widget untuk Wear OS menggunakan RemoteCompose.