किसी उपयोगकर्ता की होमस्क्रीन को पसंद के मुताबिक बनाने के लिए, विजेट एक अहम कॉम्पोनेंट होते हैं. ये अक्सर उपयोगकर्ताओं को एक टैप से, ऐप्लिकेशन के लिए अहम यूज़र जर्नी को पूरा करने में मदद कर सकते हैं. इसके अलावा, ये ऐप्लिकेशन के सबसे अहम डेटा की खास जानकारी भी तुरंत दे सकते हैं. उपयोगकर्ता की ज़रूरतों के हिसाब से उन्हें पसंद के मुताबिक बनाया जा सकता है और पसंद के मुताबिक बनाया जा सकता है.
विजेट की क्वालिटी से, आपके ऐप्लिकेशन के कॉन्टेंट और सुविधाओं में उपयोगकर्ता की दिलचस्पी पर असर पड़ सकता है. विजेट की क्वालिटी के तीन मुख्य टीयर होते हैं:
- टीयर 3: खराब क्वालिटी - वह ज़रूरी क्वालिटी की शर्तों को पूरा नहीं करता और साथ ही बेहतर उपयोगकर्ता अनुभव नहीं देता.
- टीयर 2: क्वालिटी स्टैंडर्ड - यह मददगार और इस्तेमाल करने लायक होता है. साथ ही, इससे बेहतर अनुभव मिलता है.
- टीयर 1: अलग-अलग - ये ऐसे विजेट हैं जो उपयोगकर्ताओं को बेहतरीन अनुभव देते हैं. ये विजेट, उपयोगकर्ताओं के हिसाब से बनाए जाते हैं. साथ ही, इनकी मदद से उपयोगकर्ता, अपनी होमस्क्रीन को यूनीक और काम का बना सकते हैं.
तीसरा टीयर: खराब क्वालिटी
अगर कोई विजेट स्टैंडर्ड लेआउट, रंग, डिस्कवरी, और कॉन्टेंट से जुड़ी शर्तों को पूरा नहीं करता है, तो उसे खराब क्वालिटी का माना जाता है. सबसे सही तरीके और अच्छी क्वालिटी का विजेट बनाने के बारे में ज़्यादा जानने के लिए, नीचे दिए गए दिशा-निर्देश देखें.
टियर 2 - क्वालिटी स्टैंडर्ड
किसी विजेट को अच्छी क्वालिटी का माना जाता है, अगर वह लेआउट, रंग, डिस्कवरी, और कॉन्टेंट से जुड़ी इन सभी शर्तों को पूरा करता है:
लेआउट
- विजेट को होमस्क्रीन पर छोड़े जाने पर, लॉन्चर ग्रिड से सेट की गई सीमाएं भरनी होंगी. विजेट का साइज़, इनमें से कम से कम एक साइज़ में बदला जा सकता है : 2x2, 4x2 (लॉन्चर ग्रिड सेल).
ज़्यादा जानकारी के लिए, साइज़ तय करने के दिशा-निर्देश देखें.
- विजेट, वर्टिकल या हॉरिज़ॉन्टल ऐक्सिस पर होम स्क्रीन के अन्य एलिमेंट के साथ सही तरीके से अलाइन होना चाहिए. साथ ही, यह ज़रूरत से ज़्यादा जगह नहीं लेना चाहिए.
- विजेट, ग्रिड के कम से कम दो किनारों को छूना चाहिए. दूसरे शब्दों में, विजेट के आकार को रेक्टैंगल बनाने की ज़रूरत नहीं है. इनमें कस्टम शेप हो सकते हैं. हालांकि, इसके लिए ज़रूरी है कि शेप के किनारे, ग्रिड के कम से कम दो किनारों को छूते हों.
- अगर विजेट का साइज़ बदला जा सकता है, तो उनका कम से कम या ज़्यादा से ज़्यादा साइज़ सही होना चाहिए. इसे AppWidgetProviderInfo के एक्सएमएल में
minWidth
,minHeight
,maxResizeWidth
, औरmaxResizeHeight
की मदद से सेट किया जा सकता है- अगर विजेट का साइज़ बदलने पर सिर्फ़ खाली जगह दिखती है, तो ज़्यादा से ज़्यादा साइज़ सेट किया जाना चाहिए.
- कम से कम साइज़ को इस आधार पर सेट किया जाना चाहिए कि आपका विजेट कम से कम किस साइज़ में काम करता है और टच टारगेट की ज़रूरी शर्तों (48x48) को पूरा करता है.

यह करें

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

यह करें

यह न करें
डिस्कवरी
विजेट पिकर में, विजेट की सटीक झलकें दिखनी चाहिए. इसे AppWidgetProviderInfo एक्सएमएल में
previewImage
औरpreviewLayout
के साथ या जनरेट की गई झलक के साथ सेट किया जा सकता है.- विजेट की झलक, होम स्क्रीन पर जोड़े जाने पर मिलने वाली सुविधाओं के मुताबिक दिखती है.
पहला वीडियो: गलत झलक वाला विजेट.
कॉन्टेंट
- विजेट का कॉन्टेंट, समय-समय पर पुराना या पुराना नहीं होना चाहिए.
- उपयोगकर्ता के विजेट से कोई कार्रवाई करने के बाद, विजेट को अपडेट करना ज़रूरी है.
- जब उपयोगकर्ता ऐप्लिकेशन में जाकर कोई कार्रवाई पूरी करता है, तो विजेट को अपडेट करना चाहिए
- अगर डेटा, यूज़र इंटरफ़ेस (यूआई) की तुलना में ज़्यादा बार रीफ़्रेश होता है, तो विजेट में उपयोगकर्ताओं को कॉन्टेंट को मैन्युअल तरीके से रीफ़्रेश करने की सुविधा देनी चाहिए.
- विजेट का यूज़र इंटरफ़ेस (यूआई) काम करना चाहिए या कॉन्टेंट को काटा गया हो.
- विजेट की वैल्यू शून्य और खाली होनी चाहिए. अगर विजेट को इंस्टॉल किया गया है, लेकिन उपयोगकर्ता ने अभी तक लॉग इन नहीं किया है, तो विजेट की वैल्यू या कॉल-टू-ऐक्शन देना ज़रूरी है.


टियर 1 - अलग-अलग
सबसे अच्छे विजेट, टीयर 2 की सभी शर्तों के साथ-साथ, लेआउट, रंग, डिस्कवरी, और सिस्टम कोहैरेंस की इन सभी शर्तों को पूरा करते हैं.
लेआउट
- विजेट, होम स्क्रीन के वर्टिकल या हॉरिज़ॉन्टल ऐक्सिस पर मौजूद अन्य एलिमेंट के साथ सही तरीके से अलाइन होता है और ज़रूरत से ज़्यादा जगह नहीं लेता. साथ ही, विजेट के लिए तय किए गए बॉर्डर में ही दिखता है
- सभी आकार, ग्रिड के चारों किनारों को छूने चाहिए

यह करें

यह न करें
विजेट को पसंदीदा साइज़ में सेट किया जा सकता है
- विजेट का साइज़, इनमें से कम से कम किसी एक साइज़ में बदला जा सकता है : 2x2, 4x2
विजेट हेडर का इस्तेमाल और उसे लगातार लागू किया जाता है
- हेडर का इस्तेमाल तब करें, जब:
- आपको खोज जैसे कुछ ऐप्लिकेशन फ़ंक्शन के लिए डीप लिंक देने हैं.
- आपको ऐप्लिकेशन ब्रैंडिंग आइकॉन लागू करना है, जो टैप करने पर ऐप्लिकेशन पर वापस ले जाने के लिए, एक लिंक के तौर पर भी काम करता है.
- विजेट में, स्क्रोल करने वाला कॉन्टेंट है (सूची, ग्रिड वगैरह)
- हेडर का कॉन्टेंट काम का कॉन्टेक्स्ट देता है (टू-डू सूची का नाम)
- हेडर तब ज़रूरी नहीं होता, जब:
- विजेट, फ़ुल ब्लीड इमेज (फ़ोटो) है
- स्पेस में जगह कम है (दो पंक्तियों से कम)
- जब हेडर का कॉन्टेंट ज़रूरी न हो.
- हेडर का इस्तेमाल करने पर, हमारी शर्तों को पूरा करें:
- आइकॉन, टाइटल, कार्रवाइयां.
- आइकॉन हमेशा मौजूद होता है
- ज़रूरत के मुताबिक जगह होने पर टाइटल दिखता है
- विजेट के कॉन्टेक्स्ट के आधार पर कार्रवाइयां.
- ऊंचाई 48dp, पैडिंग, 14dp
- आइकॉन, टाइटल, कार्रवाइयां.
- हेडर का इस्तेमाल तब करें, जब:

यह करें

यह न करें
रंग
- विजेट में सिस्टम की थीम, कॉन्टेंट के रंग या ब्रैंड के रंग के आधार पर रंग पटल का इस्तेमाल किया जा सकता है.
- विजेट में लाइट और डार्क मोड पैलेट काम करते हैं.
- डाइनैमिक कलर, डिवाइस के हिसाब से थीम तय करने का एक उदाहरण है.
- स्थानीय रंग निकालने की सुविधा, ऐप्लिकेशन के कॉन्टेंट के आधार पर थीम बनाने का एक उदाहरण है.
- सेमैंटिक रंग ऐप्लिकेशन के कॉन्टेंट पर आधारित थीम का एक उदाहरण है.

डिस्कवरी
- झलक में उपयोगकर्ता का कॉन्टेंट शामिल होता है या यह सिस्टम की थीम (जनरेट की गई झलक एपीआई या AppWidgetProviderInfo
एक्सएमएल में
previewLayout
) लागू करता है.

- विजेट का नाम या ब्यौरा ऐसा होना चाहिए जिससे उपयोगकर्ताओं को विजेट की अहमियत समझने में मदद मिल सके.
- नाम में 50 से कम वर्ण होने चाहिए.
- ऐप्लिकेशन का नाम और ब्यौरा यूनीक होता है. उदाहरण के लिए, ऐप्लिकेशन में एक ही नाम के कई विजेट नहीं हो सकते.

यह करें

यह न करें
सिस्टम कोऑरेंस
- आयताकार विजेट के लिए, सिस्टम से मिले कोने के दायरे का इस्तेमाल करना ज़रूरी है (ओरिजनल इक्विपमेंट मैन्युफ़ैक्चरर के हिसाब से)

यह करें

यह न करें
- प्रगति के सूचक के साथ लोड होने की स्थिति दिखाता है. यह सूचक,
initialLayout
के अंदर होता है. इसमें थीम वाले रंग या ब्रैंड के बराबर रंग का इस्तेमाल किया जाता है.

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