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