Halaman ini menyertakan detail untuk peningkatan widget opsional yang tersedia mulai dari Android 12 (API level 31). Fitur ini bersifat opsional, tetapi mudah diterapkan dan meningkatkan pengalaman widget pengguna Anda.
Menggunakan warna dinamis
Mulai Android 12, widget dapat menggunakan warna tema perangkat untuk tombol, latar belakang, dan komponen lainnya. Hal ini memberikan transisi dan konsistensi yang lebih lancar di berbagai widget.
Ada dua cara untuk menghasilkan warna dinamis:
Gunakan tema default sistem (
@android:style/Theme.DeviceDefault.DayNight
) dalam tata letak root.Gunakan tema Material 3 (
Theme.Material3.DynamicColors.DayNight
) dari library Komponen Material untuk Android, yang tersedia mulai di Komponen Material untuk Android v1.6.0.
Setelah tema ditetapkan di tata letak root, Anda dapat menggunakan atribut warna umum di root atau salah satu turunannya untuk mengambil warna dinamis.
Beberapa contoh atribut warna yang dapat Anda gunakan adalah sebagai berikut:
?attr/primary
?attr/primaryContainer
?attr/onPrimary
?attr/onPrimaryContainer
Pada contoh berikut yang menggunakan tema Material 3, warna tema perangkat adalah "keunguan". Warna aksen dan latar belakang widget beradaptasi untuk mode terang dan gelap, seperti yang ditunjukkan pada gambar 1 dan 2.
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="?attr/colorPrimaryContainer"
android:theme="@style/Theme.Material3.DynamicColors.DayNight">
<ImageView
...
app:tint="?attr/colorPrimaryContainer"
android:src="@drawable/ic_partly_cloudy" />
<!-- Other widget content. -->
</LinearLayout>
![Widget dalam tema mode terang](https://developer.android.com/static/images/appwidgets/example-lightmode.png?authuser=6&hl=id)
![Widget dalam tema mode gelap](https://developer.android.com/static/images/appwidgets/example-darkmode.png?authuser=6&hl=id)
Kompatibilitas mundur untuk warna dinamis
Warna dinamis hanya tersedia di perangkat yang menjalankan Android 12
atau yang lebih baru. Guna menyediakan tema kustom untuk versi yang lebih rendah, buat tema default
dengan warna kustom dan penentu baru (values-v31
) menggunakan atribut
tema default.
Berikut adalah contoh yang menggunakan tema Material 3:
/values/styles.xml
<resources>
<style name="MyWidgetTheme" parent="Theme.Material3.DynamicColors.DayNight">
<!-- Override default colorBackground attribute with custom color. -->
<item name="android:colorBackground">@color/my_background_color</item>
<!-- Add other colors/attributes. -->
</style>
</resources>
/values-v31/styles.xml
<resources>
<!-- Do not override any color attribute. -->
<style name="MyWidgetTheme" parent="Theme.Material3.DynamicColors.DayNight" />
</resources>
/layout/my_widget_layout.xml
<resources>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
...
android:background="?android:attr/colorBackground"
android:theme="@style/MyWidgetTheme" />
</resources>
Aktifkan dukungan suara
Action Aplikasi memungkinkan Asisten Google menampilkan widget sebagai respons terhadap perintah suara pengguna yang relevan. Dengan mengonfigurasi widget agar merespons intent bawaan (BII), aplikasi Anda dapat secara proaktif menampilkan widget di platform Asisten seperti Android dan Android Auto. Pengguna memiliki opsi untuk menyematkan widget yang ditampilkan oleh Asisten ke peluncur mereka, sehingga mendorong interaksi di masa mendatang.
Misalnya, Anda dapat mengonfigurasi widget ringkasan olahraga untuk aplikasi olahraga Anda
guna memenuhi perintah suara pengguna yang memicu
BII
GET_EXERCISE_OBSERVATION
. Asisten menampilkan widget Anda secara proaktif saat pengguna memicu BII ini dengan
membuat permintaan seperti, "Ok Google, berapa mil yang saya tempuh minggu ini di
ExampleApp?"
Ada puluhan BII yang mencakup beberapa kategori interaksi pengguna, sehingga hampir semua aplikasi Android dapat meningkatkan kualitas widgetnya untuk suara. Untuk memulai, lihat Mengintegrasikan Action Aplikasi dengan widget Android.
Mengoptimalkan pengalaman alat pilih widget aplikasi
Android 12 memungkinkan Anda meningkatkan pengalaman alat pilih widget untuk aplikasi Anda dengan menambahkan pratinjau widget dinamis dan deskripsi widget.
Menambahkan pratinjau widget skalabel ke alat pilih widget
Mulai Android 12, pratinjau widget yang ditampilkan di pemilih widget bersifat skalabel. Anda memberikannya sebagai tata letak XML yang disetel ke ukuran default widget. Sebelumnya, pratinjau widget adalah resource drawable statis, dalam beberapa kasus yang menyebabkan pratinjau secara tidak akurat mencerminkan tampilan widget saat ditambahkan ke layar utama.
Untuk menerapkan pratinjau widget skalabel, gunakan
atribut previewLayout
dari elemen appwidget-provider
untuk memberikan tata letak XML:
<appwidget-provider
android:previewLayout="@layout/my_widget_preview">
</appwidget-provider>
Sebaiknya gunakan tata letak yang sama dengan widget yang sebenarnya, dengan nilai default
atau pengujian yang realistis. Sebagian besar aplikasi menggunakan previewLayout
dan initialLayout
yang sama. Untuk
mengetahui panduan membuat tata letak pratinjau yang akurat, lihat bagian berikut di
halaman ini.
Sebaiknya tentukan atribut previewLayout
dan previewImage
,
sehingga aplikasi Anda dapat kembali menggunakan previewImage
jika perangkat pengguna
tidak mendukung previewLayout
. Atribut previewLayout
lebih diprioritaskan
daripada atribut previewImage
.
Pendekatan yang direkomendasikan untuk membuat pratinjau yang akurat
Untuk menerapkan pratinjau widget skalabel, gunakan atribut previewLayout
dari elemen appwidget-provider
untuk menyediakan tata letak XML:
<appwidget-provider
...
android:previewLayout="@layout/my_widget_preview">
</appwidget-provider>
![Gambar yang menampilkan pratinjau widget](https://developer.android.com/static/images/appwidgets/todo-list-groceries.png?authuser=6&hl=id)
Untuk menampilkan pratinjau yang akurat, Anda dapat langsung memberikan tata letak widget yang sebenarnya dengan nilai default dengan menyelesaikan langkah-langkah berikut:
Menetapkan
android:text="@string/my_widget_item_fake_1"
untuk elemenTextView
.Menetapkan gambar atau ikon default atau placeholder, seperti
android:src="@drawable/my_widget_icon"
, untuk komponenImageView
.
Tanpa nilai default, pratinjau mungkin menampilkan nilai yang salah atau kosong. Manfaat penting dari pendekatan ini adalah Anda dapat menyediakan konten pratinjau yang dilokalkan.
Untuk pendekatan yang direkomendasikan bagi pratinjau lebih kompleks yang berisi ListView
,
GridView
, atau StackView
, lihat Membuat pratinjau akurat yang menyertakan item
dinamis untuk detailnya.
Kompatibilitas mundur dengan pratinjau widget yang skalabel
Untuk mengizinkan pemilih widget di Android 11 (API level 30) atau yang lebih rendah menampilkan pratinjau widget
Anda, tentukan atribut
previewImage
.
Jika Anda mengubah tampilan widget, perbarui gambar pratinjau.
Menambahkan deskripsi untuk widget Anda
Mulai Android 12, berikan deskripsi untuk alat pilih widget yang akan ditampilkan untuk widget Anda.
![Gambar yang menunjukkan alat pilih widget yang menampilkan widget dan deskripsinya](https://developer.android.com/static/images/appwidgets/description.png?authuser=6&hl=id)
Berikan deskripsi untuk widget Anda menggunakan atribut description
dari elemen <appwidget-provider>
:
<appwidget-provider
android:description="@string/my_widget_description">
</appwidget-provider>
Anda dapat menggunakan atribut
descriptionRes
pada versi Android sebelumnya, tetapi akan diabaikan oleh alat pilih
widget.
Mengaktifkan transisi yang lebih lancar
Di Android 12, peluncur memberikan transisi yang lebih lancar saat pengguna meluncurkan aplikasi Anda dari widget.
Untuk mengaktifkan transisi yang telah ditingkatkan ini, gunakan @android:id/background
atau
android.R.id.background
untuk mengidentifikasi elemen latar belakang Anda:
// Top-level layout of the widget.
<LinearLayout
android:id="@android:id/background">
</LinearLayout>
Aplikasi Anda dapat menggunakan @android:id/background
di versi Android sebelumnya
tanpa menyebabkan gangguan, tetapi akan diabaikan.
Menggunakan modifikasi runtime RemoteView
Mulai Android 12, Anda dapat memanfaatkan beberapa
metode RemoteViews
yang menyediakan modifikasi runtime atribut
RemoteViews
. Lihat referensi RemoteViews
API
untuk mengetahui daftar lengkap metode yang ditambahkan.
Contoh kode berikut menunjukkan cara menggunakan beberapa metode ini.
Kotlin
// Set the colors of a progress bar at runtime. remoteView.setColorStateList(R.id.progress, "setProgressTintList", createProgressColorStateList()) // Specify exact sizes for margins. remoteView.setViewLayoutMargin(R.id.text, RemoteViews.MARGIN_END, 8f, TypedValue.COMPLEX_UNIT_DP)
Java
// Set the colors of a progress bar at runtime. remoteView.setColorStateList(R.id.progress, "setProgressTintList", createProgressColorStateList()); // Specify exact sizes for margins. remoteView.setViewLayoutMargin(R.id.text, RemoteViews.MARGIN_END, 8f, TypedValue.COMPLEX_UNIT_DP);