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 manifestte bildirme ve sağlayıcı XML meta verilerinizde bağlama, hem Görünümler 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 dokümanlarındaki Compose-first 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ğırmaları, 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-first Yapılandırma etkinliğini uygulama bölümünü inceleyin.
Widget'ı yapılandırma etkinliğinden güncelleme
Görünümlere dayalı geleneksel widget'larda, yapılandırma tamamlandıktan sonra AppWidgetManager ve RemoteViews düzen örneğini kullanarak widget'ı güncellersiniz.
Eski bir Görünümler tabanlı widget oluşturuyorsanız ve RemoteViews düzenini güncellemeniz gerekiyorsa geleneksel Views Update örnek koduna GitHub'dan bakın. Modern Compose öncelikli widget'lar için Glance dokümanlarındaki Yapılandırma etkinliği bölümünden güncelleme başlıklı makaleye bakın.
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 özelliklerine kaydedilir.
Dinamik widget seçeneklerinden nasıl yararlanacağınızı öğrenmek için Glance yapılandırma dokümanlarındaki Compose-first 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 dokümanlarındaki Compose-first Enable users to reconfigure placed widgets section (Öncelikle oluşturma: Yerleştirilen widget'ları yeniden yapılandırmayı etkinleştirme) bölümüne bakın.
Widget'ın varsayılan yapılandırmasını kullanma
Yapılandırma kurulumlarını varsayılan olarak nasıl atlayacağınızı öğrenmek için Glance dokümanlarındaki Compose-first Use the widget's default configuration section (Widget'ın varsayılan yapılandırma bölümünü kullanma) başlıklı makaleyi inceleyin.