ऐप्लिकेशन विजेट को कॉन्फ़िगर किया जा सकता है. उदाहरण के लिए, घड़ी वाला विजेट, उपयोगकर्ताओं को यह कॉन्फ़िगर करने की सुविधा दे सकता है कि कौनसा टाइम ज़ोन दिखाना है.
अगर आपको उपयोगकर्ताओं को अपने विजेट की सेटिंग कॉन्फ़िगर करने की अनुमति देनी है, तो विजेट कॉन्फ़िगरेशन Activity बनाएं.
कॉन्फ़िगरेशन गतिविधि के बारे में बताना
मेनिफ़ेस्ट में कॉन्फ़िगरेशन गतिविधि का एलान करना और उसे अपने प्रोवाइडर के एक्सएमएल मेटाडेटा में लिंक करना, व्यू-आधारित और Glance-आधारित, दोनों तरह के ऐप्लिकेशन विजेट में एक जैसा होता है.
कॉन्फ़िगरेशन गतिविधि को एलान करने का तरीका जानने के लिए, Glance कॉन्फ़िगरेशन दस्तावेज़ में Compose-first कॉन्फ़िगरेशन गतिविधि सेक्शन का एलान करें देखें.
कॉन्फ़िगरेशन गतिविधि लागू करना
कॉन्फ़िगरेशन से जुड़ी गतिविधियां, स्टैंडर्ड कॉम्पोनेंट होती हैं. इन्हें प्लैटफ़ॉर्म लॉन्चर कॉल करता है. इसलिए, उनकी लाइफ़साइकल के बुनियादी कॉलबैक को सिस्टम के रिटर्न वैल्यू के नियमों का पालन करना चाहिए.
कॉन्फ़िगरेशन गतिविधि को लागू करने का तरीका जानने के लिए, Glance के दस्तावेज़ में Compose-first कॉन्फ़िगरेशन गतिविधि को लागू करें सेक्शन देखें.
कॉन्फ़िगरेशन गतिविधि से विजेट को अपडेट करना
व्यू पर आधारित पारंपरिक विजेट में, कॉन्फ़िगरेशन पूरा होने पर विजेट को अपडेट किया जाता है. इसके लिए, AppWidgetManager और RemoteViews लेआउट इंस्टेंस का इस्तेमाल किया जाता है.
अगर आपको व्यू पर आधारित लेगसी विजेट बनाना है और RemoteViews लेआउट को अपडेट करना है, तो GitHub पर व्यू अपडेट करने का सैंपल कोड देखें. Compose-first वाले आधुनिक विजेट के लिए, Glance के दस्तावेज़ में कॉन्फ़िगरेशन गतिविधि सेक्शन से अपडेट करें देखें.
विजेट को कॉन्फ़िगर करने के विकल्प
विजेट के काम करने के तरीके (जैसे, बाद में फिर से कॉन्फ़िगर करने की अनुमति देना या शुरुआती कॉन्फ़िगरेशन सेटअप के चरणों को पूरी तरह से छोड़ना), स्टैंडर्ड Android 12 फ़्लैग का इस्तेमाल करके मेटाडेटा एट्रिब्यूट में रजिस्टर किए जाते हैं.
डाइनैमिक विजेट के विकल्पों का फ़ायदा पाने का तरीका जानने के लिए, Glance के कॉन्फ़िगरेशन दस्तावेज़ में Compose-first विजेट कॉन्फ़िगरेशन के विकल्प सेक्शन देखें.
उपयोगकर्ताओं को, जोड़े गए विजेट फिर से कॉन्फ़िगर करने की सुविधा देना
फिर से कॉन्फ़िगर किए जा सकने वाले कस्टम सेटअप ट्रिगर जोड़ने का तरीका जानने के लिए, Glance के दस्तावेज़ में Compose-first उपयोगकर्ताओं को प्लेस किए गए विजेट फिर से कॉन्फ़िगर करने की सुविधा दें सेक्शन देखें.
विजेट के डिफ़ॉल्ट कॉन्फ़िगरेशन का इस्तेमाल करना
कॉन्फ़िगरेशन सेटअप को डिफ़ॉल्ट रूप से स्किप करने का तरीका जानने के लिए, Glance के दस्तावेज़ में Compose-first विजेट के डिफ़ॉल्ट कॉन्फ़िगरेशन सेक्शन का इस्तेमाल करें देखें.