Uygulama widget'ları yapılandırılabilir. Örneğin, bir saat widget'ı, kullanıcıların hangi saat diliminin gösterileceğini yapılandırmasına olanak tanıyabilir.
Kullanıcıların widget'ınızın ayarlarını yapılandırmasına izin vermek istiyorsanız bir widget yapılandırması Activity oluşturun.
Yapılandırma etkinliğini bildirme
Yapılandırma etkinliğini manifest dosyasında beyan etmek ve sağlayıcı XML meta verilerinize bağlamak, hem Görünüm tabanlı hem de Glance tabanlı uygulama widget'larında aynıdır.
Yapılandırma etkinliğini nasıl tanımlayacağınızı öğrenmek için Glance yapılandırma belgelerindeki Compose öncelikli Yapılandırma etkinliğini tanımlama bölümüne bakın.
Yapılandırma etkinliğini uygulama
Yapılandırma etkinlikleri, platform başlatıcı tarafından çağrılan standart bileşenler olduğundan temel yaşam döngüsü geri çağırma yöntemleri, sistemin dönüş değeri kurallarına uymalıdır.
Yapılandırma etkinliğinin nasıl uygulanacağını öğrenmek için Glance belgelerindeki Compose öncelikli Yapılandırma etkinliğini uygulama bölümüne bakın.
Yapılandırma etkinliğinden widget'ı güncelleme
Geleneksel Görünüm tabanlı widget'larda, yapılandırma tamamlandıktan sonra AppWidgetManager ve bir RemoteViews düzen örneği kullanarak widget'ı güncellersiniz.
Eski bir Görünüm tabanlı widget oluşturuyorsanız ve RemoteViews düzenini güncellemeniz gerekiyorsa GitHub'daki geleneksel Görünüm Güncelleme örnek koduna bakın. Modern Compose öncelikli widget'lar için Glance belgelerindeki Yapılandırma etkinliği bölümünden güncelleme başlıklı makaleyi inceleyin.
Widget yapılandırma seçenekleri
Widget davranışları (ör. daha sonra yeniden yapılandırmaya izin verme veya ilk yapılandırma kurulum adımlarını tamamen atlama), standart Android 12 işaretleri kullanılarak meta veri özellikleri içinde kaydedilir.
Dinamik widget seçeneklerinden nasıl yararlanacağınızı öğrenmek için Glance yapılandırma belgelerindeki Compose öncelikli Widget yapılandırma seçenekleri bölümüne bakın.
Kullanıcıların yerleştirilen widget'ları yeniden yapılandırmasına izin verme
Özel yeniden yapılandırılabilir kurulum tetikleyicilerinin nasıl ekleneceğini öğrenmek için Glance belgelerindeki Compose öncelikli Kullanıcıların Konum Widget'larını yeniden yapılandırmasına izin verme bölümünü inceleyin.
Widget'ın varsayılan yapılandırmasını kullanma
Yapılandırma ayarlarını varsayılan olarak nasıl atlayacağınızı öğrenmek için Glance belgelerindeki Compose öncelikli Widget'ın varsayılan yapılandırma bölümünü kullanma konusuna bakın.