Android 12 (एपीआई लेवल 31) में, मौजूदा विजेट एपीआई को बेहतर बनाया गया है. इससे प्लैटफ़ॉर्म और लॉन्चर में, उपयोगकर्ता और डेवलपर को बेहतर अनुभव मिलता है. इस गाइड का इस्तेमाल करके, यह पक्का करें कि आपका विजेट Android 12 के साथ काम करता हो. साथ ही, अपने मौजूदा विजेट को रीफ़्रेश करने के लिए, एपीआई के रेफ़रंस के तौर पर भी इसका इस्तेमाल करें.
पक्का करें कि आपका विजेट Android 12 के साथ काम करता हो
Android 12 में विजेट के कोने गोल होते हैं. जब Android 12 या इसके बाद के वर्शन वाले डिवाइस पर किसी ऐप्लिकेशन विजेट का इस्तेमाल किया जाता है, तो लॉन्चर विजेट के बैकग्राउंड की पहचान अपने-आप कर लेता है. साथ ही, उसे इस तरह से काटता है कि उसके कोने गोल हो जाएं.
इस मामले में, हो सकता है कि आपका विजेट इनमें से किसी भी स्थिति में ठीक से न दिखे:
विजेट के कोनों में कॉन्टेंट मौजूद है: इसकी वजह से, कोने में मौजूद कुछ कॉन्टेंट कट सकता है.
विजेट में ऐसे बैकग्राउंड का इस्तेमाल किया गया है जिसे क्रॉप नहीं किया जा सकता. इसमें पारदर्शी बैकग्राउंड, खाली व्यू या लेआउट या किसी अन्य तरह का खास बैकग्राउंड शामिल है, जिसे काटा नहीं जा सकता. ऐसा हो सकता है कि सिस्टम, इस्तेमाल किए जाने वाले बैकग्राउंड की सही पहचान न कर पाए.
अगर इस बदलाव का असर आपके विजेट पर पड़ेगा, तो हमारा सुझाव है कि आप उसे गोल कोनों के साथ रीफ़्रेश करें. इससे यह पक्का किया जा सकेगा कि वह सही तरीके से दिखे. इस बारे में यहां बताया गया है.
सैंपल का इस्तेमाल करना
इन सभी एपीआई को काम करते हुए देखने के लिए, हमारा सैंपल लिस्ट विजेट देखें.
गोल बॉर्डर लागू करना
Android 12 में, system_app_widget_background_radius और system_app_widget_inner_radius सिस्टम पैरामीटर जोड़े गए हैं. इनकी मदद से, विजेट के गोल कोनों की त्रिज्या सेट की जा सकती है.
1 विजेट का कोना.
2 विजेट के अंदर मौजूद व्यू का कोना.
ज़्यादा जानकारी के लिए, गोल कोने लागू करना लेख पढ़ें.
डिवाइस की थीमिंग जोड़ना
Android 12 से, विजेट में डिवाइस की थीम के रंगों का इस्तेमाल किया जा सकता है. इन रंगों का इस्तेमाल बटन, बैकग्राउंड, और अन्य कॉम्पोनेंट के लिए किया जा सकता है. इनमें हल्के और गहरे रंग वाली थीम भी शामिल हैं. इससे, अलग-अलग विजेट के बीच आसानी से ट्रांज़िशन किया जा सकता है और एक जैसा अनुभव मिलता है.
ज़्यादा जानकारी के लिए, डिवाइस की थीम जोड़ना लेख पढ़ें.
विजेट को अपनी पसंद के मुताबिक बनाना आसान हो जाता है
अगर आपने appwidget-provider के configure एट्रिब्यूट की मदद से, कॉन्फ़िगरेशन गतिविधि तय की है, तो ऐप्लिकेशन विजेट होस्ट उस गतिविधि को तुरंत लॉन्च कर देता है. ऐसा तब होता है, जब कोई उपयोगकर्ता अपनी होम स्क्रीन पर विजेट जोड़ता है.
Android 12 में नए विकल्प जोड़े गए हैं. इनकी मदद से, उपयोगकर्ताओं को कॉन्फ़िगरेशन का बेहतर अनुभव दिया जा सकता है. ज़्यादा जानकारी के लिए, उपयोगकर्ताओं को विजेट कॉन्फ़िगर करने की सुविधा देना लेख पढ़ें.
नए कंपाउंड बटन जोड़ना
Android 12 में, स्टेटफ़ुल व्यवहार के लिए नई सुविधा जोड़ी गई है. इसके लिए, इन मौजूदा कॉम्पोनेंट का इस्तेमाल किया जाता है:
विजेट अब भी स्टेटलेस है. आपके ऐप्लिकेशन को स्थिति को सेव करना होगा और स्थिति में बदलाव होने पर होने वाले इवेंट के लिए रजिस्टर करना होगा.
ज़्यादा जानकारी के लिए, स्टेटफ़ुल बिहेवियर के लिए सहायता लेख पढ़ें.
विजेट के साइज़ और लेआउट के लिए, बेहतर एपीआई का इस्तेमाल करना
Android 12 से, विजेट के साइज़ से जुड़ी ज़्यादा सटीक विशेषताओं और ज़्यादा सुविधाजनक लेआउट का फ़ायदा लिया जा सकता है. इसके लिए, विजेट के साइज़ से जुड़ी अन्य पाबंदियां तय करनी होंगी. साथ ही, रिस्पॉन्सिव लेआउट और सटीक लेआउट उपलब्ध कराने होंगे.
ज़्यादा जानकारी के लिए, विजेट के लिए फ़्लेक्सिबल लेआउट उपलब्ध कराना लेख पढ़ें.
अपने ऐप्लिकेशन के विजेट पिकर की सुविधा को बेहतर बनाना
Android 12 में, विजेट पिकर के अनुभव को बेहतर बनाया जा सकता है. इसके लिए, अपने ऐप्लिकेशन में विजेट की डाइनैमिक झलक और विजेट की जानकारी जोड़ें. ज़्यादा जानकारी के लिए, विजेट पिकर में, विजेट की झलक को बड़ा या छोटा करने की सुविधा जोड़ना और अपने विजेट के लिए ब्यौरा जोड़ना लेख पढ़ें.
बेहतर ट्रांज़िशन की सुविधा चालू करना
Android 12 से, लॉन्चर की मदद से उपयोगकर्ता को आपके ऐप्लिकेशन को विजेट से लॉन्च करने पर, बेहतर ट्रांज़िशन मिलता है. ज़्यादा जानकारी के लिए, ट्रांज़िशन को बेहतर बनाएं लेख पढ़ें.
RemoteViews के आसान कलेक्शन इस्तेमाल करना
Android 12 में
setRemoteAdapter(int viewId, RemoteViews.RemoteCollectionItems items)
तरीका जोड़ा गया है. इसकी मदद से, आपका ऐप्लिकेशन
ListView को पॉप्युलेट करते समय, कलेक्शन को सीधे पास कर सकता है. पहले, ListView का इस्तेमाल करते समय, RemoteViewsFactory को रिटर्न करने के लिए, RemoteViewsService को लागू करना और एलान करना ज़रूरी था.
ज़्यादा जानकारी के लिए, RemoteViews के कलेक्शन इस्तेमाल करना लेख पढ़ें.
RemoteViews के रनटाइम में बदलाव करने की सुविधा का इस्तेमाल करना
Android 12 में कई RemoteViews तरीके जोड़े गए हैं. इनकी मदद से, रनटाइम के दौरान RemoteViews एट्रिब्यूट में बदलाव किया जा सकता है. जोड़े गए तरीकों की पूरी सूची देखने के लिए, RemoteViews एपीआई का संदर्भ देखें.
ज़्यादा जानकारी के लिए, RemoteViews में रनटाइम के दौरान बदलाव करने की सुविधा का इस्तेमाल करना लेख पढ़ें.