उपयोगकर्ताओं को ऐप्लिकेशन के विजेट कॉन्फ़िगर करने की सुविधा दें

ऐप्लिकेशन के विजेट को कॉन्फ़िगर किया जा सकता है. उदाहरण के लिए, घड़ी का विजेट उपयोगकर्ताओं को यह कॉन्फ़िगर करने की सुविधा दे सकता है कि उन्हें कौनसे टाइम ज़ोन का समय दिखाना है.

अगर आपको उपयोगकर्ताओं को अपने विजेट की सेटिंग कॉन्फ़िगर करने की अनुमति देनी है, तो विजेट कॉन्फ़िगरेशन Activity बनाएं.

कॉन्फ़िगरेशन गतिविधि का एलान करना

मेनिफ़ेस्ट में कॉन्फ़िगरेशन ऐक्टिविटी का एलान करना और उसे अपने प्रोवाइडर एक्सएमएल मेटाडेटा में लिंक करना, व्यू और ग्लैंस, दोनों पर आधारित ऐप्लिकेशन विजेट के लिए एक जैसा होता है.

कॉन्फ़िगरेशन गतिविधि को एलान करने का तरीका जानने के लिए, Glance कॉन्फ़िगरेशन के दस्तावेज़ में, Compose-first कॉन्फ़िगरेशन गतिविधि का एलान करें सेक्शन देखें.

कॉन्फ़िगरेशन गतिविधि लागू करना

कॉन्फ़िगरेशन गतिविधियां, स्टैंडर्ड कॉम्पोनेंट होती हैं. इन्हें प्लैटफ़ॉर्म लॉन्चर कॉल करता है. इसलिए, इनके बुनियादी लाइफ़साइकल कॉलबैक को सिस्टम की रिटर्न वैल्यू से जुड़े नियमों का पालन करना चाहिए.

कॉन्फ़िगरेशन गतिविधि लागू करने का तरीका जानने के लिए, Glance के दस्तावेज़ में Compose-first Implement the configuration activity section देखें.

कॉन्फ़िगरेशन गतिविधि से विजेट को अपडेट करना

व्यू पर आधारित पारंपरिक विजेट में, कॉन्फ़िगरेशन पूरा होने पर विजेट को अपडेट किया जाता है. इसके लिए, AppWidgetManager और RemoteViews लेआउट इंस्टेंस का इस्तेमाल किया जाता है.

अगर आपको लेगसी व्यू पर आधारित कोई विजेट बनाना है और RemoteViews लेआउट को अपडेट करना है, तो GitHub पर व्यू अपडेट करने का पारंपरिक सैंपल कोड देखें. मॉडर्न कंपोज़-फ़र्स्ट विजेट के लिए, Glance के दस्तावेज़ में कॉन्फ़िगरेशन गतिविधि सेक्शन से अपडेट करें देखें.

विजेट कॉन्फ़िगर करने के विकल्प

विजेट के व्यवहार (जैसे कि बाद में फिर से कॉन्फ़िगर करने की अनुमति देना या शुरुआती कॉन्फ़िगरेशन सेटअप के चरणों को पूरी तरह से छोड़ना) को Android 12 के स्टैंडर्ड फ़्लैग का इस्तेमाल करके, मेटाडेटा एट्रिब्यूट में रजिस्टर किया जाता है.

डाइनैमिक विजेट के विकल्पों का फ़ायदा उठाने का तरीका जानने के लिए, Glance कॉन्फ़िगरेशन के दस्तावेज़ में Compose-first विजेट कॉन्फ़िगरेशन के विकल्प सेक्शन देखें.

उपयोगकर्ताओं को, होम स्क्रीन पर रखे गए विजेट को फिर से कॉन्फ़िगर करने की अनुमति दें

रीकॉन्फ़िगर किए जा सकने वाले कस्टम सेटअप ट्रिगर जोड़ने का तरीका जानने के लिए, Glance के दस्तावेज़ में Compose-first Enable users to reconfigure placed widgets section देखें.

विजेट के डिफ़ॉल्ट कॉन्फ़िगरेशन का इस्तेमाल करें

डिफ़ॉल्ट रूप से कॉन्फ़िगरेशन सेटअप को स्किप करने का तरीका जानने के लिए, Glance के दस्तावेज़ में Compose-first विजेट के डिफ़ॉल्ट कॉन्फ़िगरेशन सेक्शन का इस्तेमाल करें देखें.