Glance

Membuat tata letak untuk platform jarak jauh menggunakan API khas Jetpack Compose.
Update Terbaru Rilis Stabil Kandidat Rilis Rilis Beta Rilis Alfa
5 Oktober 2022 - - - 1.0.0-alpha05

Mendeklarasikan dependensi

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

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

Groovy

dependencies {
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.0.0-alpha05"

    // For Wear-Tiles support
    implementation "androidx.glance:glance-wear-tiles:1.0.0-alpha05"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.0.0-alpha05")

    // For Wear-Tiles support
    implementation("androidx.glance:glance-wear-tiles:1.0.0-alpha05")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

Versi 1.0.0-alpha05

5 Oktober 2022

androidx.glance:glance:1.0.0-alpha05, androidx.glance:glance-appwidget:1.0.0-alpha05, dan androidx.glance:glance-wear-tiles:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Fitur Baru

  • Menambahkan requestPinGlanceAppWidget ke GlanceAppWidgetManager, yang memungkinkan aplikasi meminta pengguna untuk menambahkan widget berbasis Glance ke layar utama mereka. (Ic6e47)
  • Menambahkan ACTION_DEBUG_UPDATE ke GlanceAppWidgetReceiver untuk memungkinkan developer memaksa widget mereka diupdate dari adb pada emulator dan perangkat yang telah di-root. (I94ae1)

Perubahan API

  • Menghapus tombol tindakan header di template Glance untuk menyederhanakan kasus penggunaan. (Ie4387)
  • Memfaktorkan ulang Template Entity Tunggal untuk menggunakan kembali desain subsistem Blokir. (Iecd2c)
  • Memfaktorkan ulang Template Daftar Glance untuk menggunakan desain Blokir Text/Image/Action. (If0cc1)
  • Menambahkan rentang nomor prioritas untuk TextBlock dan ImageBlock. (I73100)

Perbaikan Bug

  • Menghapus dependensi Material3. (I28d1c)
  • Berpindah ke sistem yang lebih konsisten untuk menambahkan margin dan spasi dalam tata letak template Glance. (I29773)
  • Memperbaiki aturan Proguard yang salah format yang memblokir rilis yang diminifikasi dari pembuatan.

Versi 1.0.0-alpha04

10 Agustus 2022

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

Fitur Baru

  • Menambahkan fitur pewarnaan Tombol.
  • Menambahkan anotasi GlanceComposable untuk pemeriksaan waktu kompilasi yang lebih baik.
  • Menambahkan fitur Glance khusus Wear.

Perubahan API

  • Mengupdate Glance Gallery Data API dan Condensed View. (Ibc7a8)
  • Menambahkan ButtonColors untuk mengonfigurasi tombol. (Iea88d, b/236305351)
  • Mengganti nama ColorProvider.resolve menjadi ColorProvider.getColor (Ic9dfe)
  • Menambahkan metode copy() ke TextStyle. (I9aef6)
  • Menambahkan class ColorProviders yang dapat digunakan sebagai bagian dari tema untuk Glance. (I848b9, b/237012816)
  • Menambahkan dukungan Template Daftar ke gaya daftar dan tampilan yang diciutkan. (I50cdc)
  • Menambahkan semantik ke GlanceModiier dan GlanceCurvedModifier. (Ifda7e)
  • Menambahkan anotasi GlanceComposable. (I5dbf0)
  • Memindahkan Template Glance ke project Glance utama. (I9db94)
  • Menambahkan ColorProvider.resolve() (Ife532, b/214733442)
  • Metode baru untuk mendapatkan GlanceId dari appWidgetId yang ada atau intent dari aktivitas konfigurasi (Icb70c, b/230391946)
  • Menambahkan anotasi GlanceComposable. (I2c21f)
  • Menambahkan GlanceRemoteViews untuk menjalankan komposisi di luar GlanceAppWidget. (I18f92)
  • Menghapus Warna di ProgressIndicatorDefaults. (I40299)
  • Mengganti nama metode onRun ActionCallback menjadi onAction, agar konsisten dengan API publik, seperti yang diperlukan oleh masukan ulasan API. (Icfa57)
  • Mengonversi tata letak template glance untuk menggunakan peta (I46bfd)
  • Menambahkan composable RadioButton (I4ecce)
  • Menambahkan GlanceWearTiles untuk menulis kartu Wear (Ia9f65)
  • Menambahkan clickable ke GlanceCurvedModifier (Iec2a0)
  • Menerapkan CurvedRow sebagai cakupan dan membuat DSL untuk menambahkan elemen composable dan/atau melengkung normal. Juga menambahkan curvedLine dan curvedSpacer yang diterjemahkan ke ArcLine dan ArcSpacer dalam kartu proto (Ib955b)
  • Mengubah nullability di core dan appcompat agar sesuai dengan Tiramisu DP2 (I0cbb7)
  • Menambahkan dukungan untuk RuncallbackAction di kartu glance-wear, hanya RunCallbackAction TANPA parameter yang didukung untuk saat ini (Ide64a)

Kontribusi Eksternal

  • Diupdate: compose:ui:ui-test api (updateApi) karena migrasi test-coroutines-lib (I3366d)

Versi 1.0.0-alpha03

23 Februari 2022

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

Fitur Baru

  • Definisi status disederhanakan menjadi default untuk Preferensi.

Perubahan API

  • Menyederhanakan handle status dengan menjadikan PreferencesGlanceStateDefinition sebagai handle status default. Menghapus GlanceAppWidget.updateAppWidgetState dan memperkenalkan updateAppWidgetState yang menggunakan Preferences secara default. (I58963)
  • Menambahkan class Glance TemplateText dan memperbarui desain Template (I4e146)
  • Menambahkan infrastruktur outline untuk template Freeform (If03d6)
  • Memperbarui ke tata letak SingleEntityTemplate (If925d)
  • Menambahkan LazyVerticalGrid (I5f442)
  • Menggunakan ColorProvider pada SingleEntityTemplate (I01ee0)
  • Memperbarui nama class template (I3720e)
  • Menambahkan composable LinearProgressIndicator dan CircularProgressIndicator. (Ie116b)

Perbaikan Bug

  • Penerapan template glance awal, menentukan data "single item template" dan tata letak template contoh (I35837)
  • Menyejajarkan isi kolom ke tengah secara default (I264be)
  • Perbaikan bug dengan fillMaxSize/Width/Height dalam glance-wear-tiles (I0a39f)

Versi 1.0.0-alpha02

26 Januari 2022

androidx.glance:glance-*:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Fitur Baru

Rilis ini berisi kumpulan API untuk mem-build Kartu Wear menggunakan runtime Compose dengan composable yang dioptimalkan untuk "Glanceable"

  • Deklarasikan layanan kartu Wear Anda dengan memperluas GlanceTileService, sebuah layanan untuk membuat kartu di fungsi Content() composable.
  • Composable glance khusus kartu Wear: CurvedRow, CurvedText.
  • Tangani mode linimasa yang berbeda untuk kartu dengan menentukan TimelineMode.SingleEntry dan TimelineMode.TimeBoundEntries.
  • LocalTimeInterval, Komposisi lokal mengacu pada interval waktu tertentu.
  • BorderModifer adalah GlanceModifier yang menerapkan batas di sekeliling elemen.

Rilis ini juga menambahkan Indikator Progres ke AppWidget Glance.

Perubahan API

  • Menambahkan composable LinearProgressIndicator dan CircularProgressIndicator. (Ie116b)
  • Mengubah actionStartBroadcastReceiver menjadi actionSendBroadcast (I7d555)
  • Meneruskan Konteks ke callback onDelete GlanceAppWidget (I4c795)

Perbaikan Bug

  • Penanganan OPTIONS_APPWIDGET_SIZES yang benar jika ada tetapi kosong. (I01f82)

Versi 1.0.0-alpha01

15 Desember 2021

androidx.glance:glance:1.0.0-alpha01, androidx.glance:glance-appwidget:1.0.0-alpha01, dan androidx.glance:glance-appwidget-proto:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit berikut ini.

Fitur dalam rilis awal

  • Rilis pertama Glance mencakup kumpulan API pertama untuk membuat AppWidget menggunakan Compose Runtime dengan kumpulan Composable baru yang dioptimalkan untuk “Glanceable”.

Fitur