Android 12 (API düzeyi 31), platform ve başlatıcılarda kullanıcı ve geliştirici deneyimini iyileştirmek için mevcut Widget'lar API'sini yeniliyor. Widget'ınızın Android 12 ile uyumlu olduğundan nasıl emin olacağınızı öğrenmek ve mevcut widget'ınızı yenilemeye yönelik API'ler hakkında bilgi edinmek için bu kılavuzu kullanın.
Widget'ınızın Android 12 ile uyumlu olduğundan emin olun.
Android 12'deki widget'ların köşeleri yuvarlatılmıştır. Android 12 veya sonraki sürümlerin yüklü olduğu bir cihazda uygulama widget'ı kullanıldığında başlatıcı, widget'ın arka planını otomatik olarak tanımlar ve yuvarlak köşeli olacak şekilde kırpar.
Bu senaryoda, widget'ınız aşağıdaki koşullardan birinde düzgün görüntülenmeyebilir:
Widget'ın köşelerinde içerik var: Bu durum, köşe alanındaki bazı içeriklerin kırpılmasına neden olabilir.
Widget, kırpılmaya uygun olmayan bir arka plan kullanıyor. Şeffaf arka plan, boş görünümler veya düzenler ya da kırpılmaya uygun olmayan diğer özel arka planlar buna dahildir. Sistem, kullanılacak arka planı doğru şekilde tanımlayamayabilir.
Widget'ınız bu değişiklikten etkilenirse düzgün şekilde gösterilmesi için yuvarlak köşelerle yenilemenizi (aşağıdaki bölümde açıklandığı gibi) öneririz.
Örneği kullanma
Bu API'lerin tümünü çalışırken görmek için örnek liste widget'ımıza göz atın.
Yuvarlak köşeleri uygulama
Android 12, widget'ınızın yuvarlak köşelerinin yarıçaplarını ayarlamak için system_app_widget_background_radius
ve system_app_widget_inner_radius
sistem parametrelerini kullanıma sunar.

1 Widget'ın köşesi.
2 Widget'ın içindeki bir görünümün köşesi.
Ayrıntılar için Yuvarlak köşeleri uygulama başlıklı makaleyi inceleyin.
Cihaz teması ekleme
Android 12'den itibaren widget'lar, açık ve koyu temalar da dahil olmak üzere düğmeler, arka planlar ve diğer bileşenler için cihaz teması renklerini kullanabilir. Bu sayede farklı widget'lar arasında daha sorunsuz geçişler ve tutarlılık sağlanır.
Daha fazla bilgi için Cihaz teması ekleme başlıklı makaleyi inceleyin.


Widget'ları kişiselleştirmeyi kolaylaştırın
configure
özelliği appwidget-provider
olan bir yapılandırma etkinliği belirtirseniz uygulama widget'ı ana makinesi, kullanıcı widget'ı ana ekranına ekledikten hemen sonra bu etkinliği başlatır.
Android 12, kullanıcılara daha iyi bir yapılandırma deneyimi sunmanızı sağlayacak yeni seçenekler ekliyor. Ayrıntılar için Kullanıcıların widget'ları yapılandırmasına izin verme başlıklı makaleyi inceleyin.
Yeni bileşik düğmeler ekleme
Android 12, aşağıdaki mevcut bileşenleri kullanarak durum bilgisi olan davranış için yeni destek ekler:
Widget hâlâ durum bilgisizdir. Uygulamanız durumu saklamalı ve durum değişikliği etkinliklerine kaydolmalıdır.

Ayrıntılar için Durumlu davranış desteği başlıklı makaleyi inceleyin.
Widget boyutları ve düzenleri için geliştirilmiş API'leri kullanma
Android 12'den itibaren ek widget boyutlandırma kısıtlamaları belirterek ve duyarlı düzenler ile tam düzenler sağlayarak daha hassas boyut özelliklerinden ve daha esnek düzenlerden yararlanabilirsiniz.
Ayrıntılar için Esnek widget düzenleri sağlama başlıklı makaleyi inceleyin.
Uygulamanızın widget seçici deneyimini iyileştirme
Android 12, dinamik widget önizlemeleri ve widget açıklamaları ekleyerek uygulamanızın widget seçici deneyimini iyileştirmenize olanak tanır. Ayrıntılar için Widget seçiciye ölçeklenebilir widget önizlemeleri ekleme ve Widget'ınız için açıklama ekleme başlıklı makaleleri inceleyin.
Geçişleri daha akıcı hâle getirme
Android 12'den itibaren başlatıcılar, kullanıcılar uygulamanızı bir widget'tan başlattığında daha sorunsuz bir geçiş sağlar. Ayrıntılar için Daha akıcı geçişleri etkinleştirme başlıklı makaleye bakın.
Basitleştirilmiş RemoteViews
koleksiyonları kullanma
Android 12, setRemoteAdapter(int viewId, RemoteViews.RemoteCollectionItems items)
yöntemini ekler. Bu yöntem, uygulamanızın bir ListView
doldururken doğrudan bir koleksiyonu iletmesine olanak tanır. Daha önce ListView
kullanılırken RemoteViewsFactory
döndürmek için RemoteViewsService
uygulanması ve bildirilmesi gerekiyordu.
Ayrıntılar için RemoteViews
koleksiyonlarını kullanma başlıklı makaleyi inceleyin.
RemoteViews
öğesinin çalışma zamanı değişikliğini kullanma
Android 12, RemoteViews
özelliklerinin çalışma zamanında değiştirilmesine olanak tanıyan çeşitli RemoteViews
yöntemleri ekler. Eklenen yöntemlerin tam listesi için RemoteViews
API referansına bakın.
Ayrıntılar için RemoteViews
çalışma zamanı değişikliğini kullanma başlıklı makaleyi inceleyin.