Android 12 (API düzeyi 31), platform ve başlatıcılarda kullanıcı ve geliştirici deneyimini iyileştirmek için mevcut Widgets API'yi yeniler. Widget'ınızın Android 12 ile uyumlu olmasını nasıl sağlayacağınızı öğrenmek ve mevcut widget'ınızı yenilemek için API'lerle ilgili referans olarak 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ümleri çalıştıran bir cihazda uygulama widget'ı kullanıldığında başlatıcı, widget'ın arka planını otomatik olarak tanımlar ve köşeleri yuvarlatılmış olacak şekilde kırpar.
Bu senaryoda, widget'ınız aşağıdaki durumlardan birinde düzgün görüntülenmeyebilir:
Widget'ın köşelerinde içerik varsa: 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 etkilenecekse düzgün şekilde görüntülenmesi için yuvarlatılmış köşelerle yenilemenizi (aşağıdaki bölümde açıklandığı gibi) öneririz.
Örneği kullanma
Tüm bu API'leri çalışırken görmek için örnek liste widget'ımıza göz atın.
Yuvarlatılmış köşeler kullanma
Android 12, widget'ınızın yuvarlak köşelerinin yarıçapı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; düğmeler, arka planlar ve diğer bileşenler için açık ve koyu temalar da dahil olmak üzere cihaz teması renklerini kullanabilir. Bu sayede farklı widget'lar arasında daha yumuşak 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ırma
appwidget-provider öğesinin configure özelliğiyle 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ğlayan yeni seçenekler ekler. 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ışlar için yeni destek ekler:
Widget hâlâ durum bilgisizdir. Uygulamanız durumu depolamalı ve durum değişikliği etkinliklerine kaydolmalıdır.
Ayrıntılar için Durum bilgisi olan 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 için 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.
Daha akıcı geçişler sağlayın
Android 12'den itibaren başlatıcılar, kullanıcı 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ı makaleyi inceleyin.
Basitleştirilmiş RemoteViews koleksiyonlarını kullanma
Android 12, uygulamanızın bir ListView doldururken doğrudan bir koleksiyon iletmesine olanak tanıyan setRemoteAdapter(int viewId, RemoteViews.RemoteCollectionItems items) yöntemini ekler. Daha önce, ListView kullanırken RemoteViewsFactory döndürmek için bir RemoteViewsService uygulayıp beyan etmek gerekiyordu.
Ayrıntılı bilgi için RemoteViews koleksiyonlarını kullanma başlıklı makaleyi inceleyin.
RemoteViews için ç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ılı bilgi için RemoteViews için çalışma zamanı değişikliğini kullanma başlıklı makaleyi inceleyin.