ऐप्लिकेशन के रिसॉर्स की खास जानकारी (व्यू)

डायरेक्ट्री

संसाधन का टाइप

animator/

प्रॉपर्टी ऐनिमेशन तय करने वाली एक्सएमएल फ़ाइलें.

anim/

एक्सएमएल फ़ाइलें, जो ट्वीन ऐनिमेशन तय करती हैं. प्रॉपर्टी के ऐनिमेशन भी इस डायरेक्ट्री में सेव किए जा सकते हैं. हालांकि, प्रॉपर्टी के ऐनिमेशन के लिए animator/ डायरेक्ट्री का इस्तेमाल करने का सुझाव दिया जाता है, ताकि दोनों टाइप के बीच अंतर किया जा सके.

color/

ऐसी एक्सएमएल फ़ाइलें जो रंगों की स्थिति के हिसाब से सूची तय करती हैं. ज़्यादा जानकारी के लिए, कलर स्टेट लिस्ट रिसॉर्स देखें.

drawable/

बिटमैप फ़ाइलें (PNG, .9.png, JPG या GIF) या XML फ़ाइलें, जिन्हें ड्रॉएबल रिसॉर्स के इन सबटाइप में कंपाइल किया जाता है:

• बिटमैप फ़ाइलें
• नौ पैच (रीसाइज़ किए जा सकने वाले बिटमैप)
• राज्य के हिसाब से सूचियां
• आकार
• ऐनिमेशन वाले ड्रॉअबल
• अन्य ड्रॉएबल

ज़्यादा जानकारी के लिए, ड्रॉएबल रिसॉर्स देखें.

mipmap/

अलग-अलग लॉन्चर आइकॉन डेंसिटी के लिए ड्रॉएबल फ़ाइलें. mipmap/ फ़ोल्डर की मदद से लॉन्चर आइकॉन मैनेज करने के बारे में ज़्यादा जानने के लिए, ऐप्लिकेशन आइकॉन को मिपमैप डायरेक्ट्री में रखना लेख पढ़ें.

layout/

एक्सएमएल फ़ाइलें, जो यूज़र इंटरफ़ेस लेआउट तय करती हैं. ज़्यादा जानकारी के लिए, लेआउट संसाधन देखें.

menu/

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

raw/

फ़ाइलों को उनके रॉ फ़ॉर्म में सेव करने के लिए. इन संसाधनों को रॉ InputStream के साथ खोलने के लिए, संसाधन आईडी के साथ Resources.openRawResource को कॉल करें. संसाधन आईडी R.raw.filename है.

हालांकि, अगर आपको ओरिजनल फ़ाइल के नाम और फ़ाइल के क्रम को ऐक्सेस करना है, तो assets/ डायरेक्ट्री के बजाय assets/ डायरेक्ट्री में रिसॉर्स सेव करें.res/raw/ assets/ में मौजूद फ़ाइलों को संसाधन आईडी नहीं दिया जाता. इसलिए, उन्हें सिर्फ़ AssetManager का इस्तेमाल करके पढ़ा जा सकता है.

values/

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

वहीं, अन्य res/ सबडायरेक्ट्री में मौजूद एक्सएमएल रिसॉर्स फ़ाइलें, एक्सएमएल फ़ाइल के नाम के आधार पर एक रिसॉर्स तय करती हैं. हालांकि, values/ डायरेक्ट्री में मौजूद फ़ाइलें, एक से ज़्यादा रिसॉर्स के बारे में बताती हैं. इस डायरेक्ट्री में मौजूद किसी फ़ाइल के लिए, एलिमेंट का हर चाइल्ड, एक संसाधन के बारे में बताता है. उदाहरण के लिए, एलिमेंट से R.string संसाधन बनता है और एलिमेंट से R.color संसाधन बनता है.

हर संसाधन को उसके अपने एक्सएमएल एलिमेंट के साथ तय किया जाता है. इसलिए, फ़ाइल का नाम अपनी पसंद के हिसाब से रखा जा सकता है. साथ ही, एक ही फ़ाइल में अलग-अलग तरह के संसाधन रखे जा सकते हैं. हालांकि, बेहतर तरीके से समझने के लिए, अलग-अलग फ़ाइलों में यूनीक रिसॉर्स टाइप रखे जा सकते हैं. उदाहरण के लिए, इस डायरेक्ट्री में बनाए जा सकने वाले संसाधनों के लिए, फ़ाइल के नाम रखने के कुछ नियम यहां दिए गए हैं:

• arrays.xml संसाधन के अरे (टाइप किए गए अरे) के लिए
• कलर वैल्यू के लिए colors.xml
• डाइमेंशन वैल्यू के लिए dimens.xml
• स्ट्रिंग वैल्यू के लिए strings.xml
• स्टाइल के लिए styles.xml

ज़्यादा जानकारी के लिए, स्ट्रिंग रिसॉर्स, स्टाइल रिसॉर्स, और अन्य रिसॉर्स टाइप देखें.

xml/

कोई भी एक्सएमएल फ़ाइल, जिसे रनटाइम के दौरान Resources.getXML() को कॉल करके पढ़ा जा सकता है. अलग-अलग एक्सएमएल कॉन्फ़िगरेशन फ़ाइलों को यहां सेव किया जाना चाहिए.

font/

TTF, OTF या TTC जैसे एक्सटेंशन वाली फ़ॉन्ट फ़ाइलें या ऐसी एक्सएमएल फ़ाइलें जिनमें एलिमेंट शामिल हो. फ़ॉन्ट को संसाधन के तौर पर इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, एक्सएमएल संसाधन के तौर पर फ़ॉन्ट जोड़ना लेख पढ़ें.

कॉन्फ़िगरेशन

क्वालिफ़ायर वैल्यू

ब्यौरा

एमसीसी और एमएनसी

उदाहरण:

mcc310

mcc310-mnc004

mcc208-mnc00

मोबाइल कंट्री कोड (एमसीसी). इसके बाद, डिवाइस में मौजूद सिम कार्ड से मिला मोबाइल नेटवर्क कोड (एमएनसी) भी शामिल किया जा सकता है. उदाहरण के लिए, mcc310 अमेरिका में किसी भी कैरियर के लिए, mcc310-mnc004 अमेरिका में Verizon के लिए, और mcc208-mnc00 फ़्रांस में Orange के लिए है.

अगर डिवाइस रेडियो कनेक्शन का इस्तेमाल करता है (यानी कि यह जीएसएम फ़ोन है), तो एमसीसी और एमएनसी की वैल्यू, सिम कार्ड से मिलती हैं.

सिर्फ़ एमसीसी का इस्तेमाल भी किया जा सकता है. उदाहरण के लिए, अपने ऐप्लिकेशन में देश के हिसाब से कानूनी संसाधन शामिल करने के लिए. अगर आपको सिर्फ़ भाषा के आधार पर जानकारी देनी है, तो भाषा, स्क्रिप्ट (ज़रूरी नहीं), और क्षेत्र (ज़रूरी नहीं) क्वालिफ़ायर का इस्तेमाल करें. अगर एमसीसी और एमएनसी क्वालिफ़ायर का इस्तेमाल किया जाता है, तो इसे ध्यान से करें. साथ ही, यह जांच लें कि यह आपकी उम्मीद के मुताबिक काम कर रहा है या नहीं.

कॉन्फ़िगरेशन फ़ील्ड mcc और mnc भी देखें. इनसे, मोबाइल के मौजूदा देश के कोड और मोबाइल नेटवर्क के कोड के बारे में पता चलता है.

भाषा, स्क्रिप्ट (ज़रूरी नहीं), और क्षेत्र (ज़रूरी नहीं)

उदाहरण:

en

fr

en-rUS

fr-rFR

fr-rCA

b+en

b+en+US

b+es+419

b+zh+Hant

b+sr+Latn+RS

भाषा को दो अक्षरों वाले ISO 639-2{:.external} भाषा कोड से तय किया जाता है. इसके बाद, दो अक्षरों वाला ISO 3166-1-alpha-2{:.external} क्षेत्र कोड (इससे पहले छोटे अक्षरों वाला r) दिया जा सकता है.

कोड, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) नहीं होते हैं. r प्रीफ़िक्स का इस्तेमाल, क्षेत्र के हिस्से को अलग करने के लिए किया जाता है. सिर्फ़ क्षेत्र की जानकारी नहीं दी जा सकती.

Android 7.0 (एपीआई लेवल 24) में, BCP 47 भाषा टैग{:.external} के लिए सहायता शुरू की गई थी. इनका इस्तेमाल, भाषा और क्षेत्र के हिसाब से उपलब्ध संसाधनों को बेहतर बनाने के लिए किया जा सकता है. भाषा टैग, एक या उससे ज़्यादा सबटैग के क्रम से बना होता है. इनमें से हर सबटैग, पूरे टैग से पहचानी गई भाषा की रेंज को बेहतर बनाता है या कम करता है. भाषा के टैग के बारे में ज़्यादा जानकारी के लिए, भाषाओं की पहचान करने वाले टैग{:.external} देखें.

BCP 47 भाषा टैग का इस्तेमाल करने के लिए, b+ और दो अक्षरों वाले ISO 639-2{:.external} भाषा कोड को एक साथ जोड़ें. इसके बाद, + से अलग किए गए अतिरिक्त सबटैग जोड़े जा सकते हैं.

अगर उपयोगकर्ता सिस्टम की सेटिंग में जाकर भाषा बदलते हैं, तो आपके ऐप्लिकेशन के लिए भाषा का टैग बदल सकता है. इसकी वजह से, रनटाइम के दौरान आपके ऐप्लिकेशन पर क्या असर पड़ सकता है, इस बारे में जानने के लिए कॉन्फ़िगरेशन में हुए बदलावों को मैनेज करना लेख पढ़ें.

अपने ऐप्लिकेशन को अन्य भाषाओं के लिए स्थानीय भाषा के मुताबिक बनाने के बारे में पूरी जानकारी पाने के लिए, अपने ऐप्लिकेशन को स्थानीय भाषा के मुताबिक बनाएं लेख पढ़ें.

getLocales तरीका भी देखें. इससे, तय की गई भाषाओं की सूची मिलती है. इस सूची में मुख्य स्थान-भाषा शामिल है.

उपयोगकर्ता का व्याकरण के हिसाब से लिंग. इसका इस्तेमाल उन भाषाओं के लिए किया जाता है जिनमें व्याकरण के हिसाब से लिंग होता है.

उदाहरण के लिए, अगर आपको फ़्रेंच बोलने वाले लोगों के लिए अलग-अलग संसाधन उपलब्ध कराने हैं, तो यहां दी गई डायरेक्ट्री का इस्तेमाल किया जा सकता है:

res/
  values-fr/
    strings.xml (डिफ़ॉल्ट स्ट्रिंग, जिनमें लिंग की जानकारी नहीं दी गई है)
  values-fr-masculine/
    strings.xml (पुरुषवाचक स्ट्रिंग)
  values-fr-feminine/
    strings.xml (स्त्रीवाचक स्ट्रिंग)
  values-fr-neuter/
    strings.xml (ऐसे शब्द जो पुरुष या महिला, दोनों के लिए इस्तेमाल किए जा सकते हैं)

Android में अपने हिसाब से जेंडर चुनना देखें.

getGrammaticalGender() कॉन्फ़िगरेशन का तरीका भी देखें. इससे व्याकरण के हिसाब से लिंग का पता चलता है.

इसे एपीआई लेवल 34 में जोड़ा गया है.

लेआउट की दिशा

ldrtl

ldltr

आपके ऐप्लिकेशन का लेआउट. ldrtl का मतलब है "layout-direction-right-to-left." ldltr का मतलब "layout-direction-left-to-right" है. यह डिफ़ॉल्ट वैल्यू है.

यह किसी भी संसाधन पर लागू हो सकता है. जैसे, लेआउट, ड्रॉएबल या वैल्यू.

उदाहरण के लिए, अगर आपको अरबी भाषा के लिए कोई खास लेआउट और फ़ारसी या हिब्रू जैसी किसी अन्य "दाईं से बाईं ओर" लिखी जाने वाली भाषा के लिए कोई सामान्य लेआउट देना है, तो यहां दी गई डायरेक्ट्री का इस्तेमाल करें:

res/
layout/
main.xml (डिफ़ॉल्ट लेआउट)
layout-ar/
main.xml (अरबी भाषा के लिए खास लेआउट)
layout-ldrtl/
main.xml (अरबी के अलावा, दाईं से बाईं ओर लिखी जाने वाली कोई भी भाषा, क्योंकि "ar" भाषा क्वालिफ़ायर को ज़्यादा प्राथमिकता दी जाती है)

ध्यान दें: अपने ऐप्लिकेशन के लिए, दाईं से बाईं ओर लेआउट करने की सुविधाएँ चालू करने के लिए, आपको SupportsRtl को "true" पर सेट करना होगा. साथ ही, TargetSdkVersion को 17 या उससे ज़्यादा पर सेट करना होगा.

एपीआई लेवल 17 में जोड़ा गया.

सबसे कम चौड़ाई की स्क्रीन सेट करें

swdp

उदाहरण:

sw320dp

sw600dp

sw720dp

वगैरह

ऐप्लिकेशन के लिए उपलब्ध स्क्रीन एरिया का सबसे छोटा डाइमेंशन. खास तौर पर, ऐप्लिकेशन विंडो की smallestWidth, विंडो की उपलब्ध ऊंचाई और चौड़ाई में सबसे छोटी होती है. इसे विंडो की "कम से कम चौड़ाई" के तौर पर भी माना जा सकता है. इस क्वालिफ़ायर का इस्तेमाल किया जा सकता है, ताकि आपके ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) के लिए कम से कम डीपी की चौड़ाई उपलब्ध हो.

उदाहरण के लिए, अगर आपके लेआउट के लिए यह ज़रूरी है कि स्क्रीन एरिया का सबसे छोटा डाइमेंशन हमेशा कम से कम 600 डीपी हो, तो इस क्वालिफ़ायर का इस्तेमाल करके, res/layout-sw600dp/ डायरेक्ट्री में लेआउट रिसॉर्स बनाए जा सकते हैं. सिस्टम इन संसाधनों का इस्तेमाल सिर्फ़ तब करता है, जब उपलब्ध स्क्रीन का सबसे छोटा डाइमेंशन कम से कम 600 डीपी हो. इससे कोई फ़र्क़ नहीं पड़ता कि 600 डीपी वाली साइड, उपयोगकर्ता को दिखने वाली ऊंचाई है या चौड़ाई. अगर विंडो का साइज़ बदला जाता है, तो सबसे कम चौड़ाई बदल सकती है. इससे उपलब्ध चौड़ाई/ऊंचाई बदल जाती है या विंडो की जगह बदल जाती है. इससे सिस्टम इनसेट भी बदल सकते हैं.

स्क्रीन के सामान्य साइज़ का पता लगाने के लिए, सबसे कम चौड़ाई का इस्तेमाल करना फ़ायदेमंद होता है. ऐसा इसलिए, क्योंकि लेआउट डिज़ाइन करते समय चौड़ाई अक्सर अहम भूमिका निभाती है. यूज़र इंटरफ़ेस (यूआई) को अक्सर वर्टिकल तौर पर स्क्रोल किया जाता है. हालांकि, इसे हॉरिज़ॉन्टल तौर पर कम से कम जगह की ज़रूरत होती है.

उपलब्ध चौड़ाई भी यह तय करने में अहम भूमिका निभाती है कि हैंडसेट के लिए एक पैन वाला लेआउट इस्तेमाल करना है या टैबलेट के लिए मल्टीपैन वाला लेआउट. इसलिए, आपको इस बात से ज़्यादा फ़र्क़ पड़ता है कि हर डिवाइस पर सबसे कम चौड़ाई कितनी है.

डिवाइस की सबसे कम चौड़ाई में, स्क्रीन डेकोरेशन और सिस्टम यूज़र इंटरफ़ेस (यूआई) को ध्यान में रखा जाता है. उदाहरण के लिए, अगर डिवाइस की स्क्रीन पर ऐसे यूज़र इंटरफ़ेस (यूआई) एलिमेंट मौजूद हैं जो सबसे कम चौड़ाई वाले ऐक्सिस के साथ जगह घेरते हैं, तो सिस्टम सबसे कम चौड़ाई को स्क्रीन के असल साइज़ से कम मानता है. ऐसा इसलिए, क्योंकि ये स्क्रीन पिक्सल आपके यूज़र इंटरफ़ेस (यूआई) के लिए उपलब्ध नहीं हैं.

यहां स्क्रीन के सामान्य साइज़ के लिए, कुछ वैल्यू दी गई हैं:

• 320, इन जैसे स्क्रीन कॉन्फ़िगरेशन वाले डिवाइसों के लिए:
• 240x320 ldpi (QVGA हैंडसेट)
• 320x480 mdpi (हैंडसेट)
• 480x800 hdpi (हाई-डेंसिटी हैंडसेट)
• 480, 480x800 mdpi (टैबलेट/हैंडसेट) जैसी स्क्रीन के लिए
• 600, 600x1024 mdpi (7" टैबलेट) जैसी स्क्रीन के लिए
• 720, 720x1280 mdpi (10" टैबलेट) जैसी स्क्रीन के लिए

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

एपीआई लेवल 13 में जोड़ा गया.

android:requiresSmallestWidthDp एट्रिब्यूट भी देखें. इससे यह पता चलता है कि आपका ऐप्लिकेशन कम से कम smallestWidth के साथ काम करता है. साथ ही, smallestScreenWidthDp कॉन्फ़िगरेशन फ़ील्ड देखें. इसमें डिवाइस के smallestWidth की वैल्यू होती है.

इस क्वालिफ़ायर का इस्तेमाल करके, अलग-अलग स्क्रीन के लिए डिज़ाइन करने के बारे में ज़्यादा जानने के लिए, व्यू के साथ रिस्पॉन्सिव/अडैप्टिव डिज़ाइन देखें.

उपलब्ध चौड़ाई और ऊंचाई

wdp

hdp

उदाहरण:

w720dp

w1024dp

h720dp

h1024dp

वगैरह

यह विकल्प, स्क्रीन की कम से कम चौड़ाई या ऊंचाई (dp यूनिट में, जिसे वैल्यू से तय किया जाता है) तय करता है. इस चौड़ाई या ऊंचाई पर, संसाधन का इस्तेमाल किया जाता है. इन कॉन्फ़िगरेशन वैल्यू की तुलना, डिसप्ले की मौजूदा चौड़ाई और ऊंचाई से की जाती है. ऐसा तब होता है, जब डिवाइस को पोर्ट्रेट से लैंडस्केप या लैंडस्केप से पोर्ट्रेट मोड में बदला जाता है, डिवाइस को फ़ोल्ड या अनफ़ोल्ड किया जाता है या सिस्टम मल्टी-विंडो मोड में चालू या बंद होता है. मल्टी-विंडो मोड में, वैल्यू से डिवाइस की स्क्रीन की चौड़ाई और ऊंचाई नहीं, बल्कि ऐप्लिकेशन वाली विंडो की चौड़ाई और ऊंचाई दिखती है. इसी तरह, एम्बेड की गई गतिविधियों के लिए वैल्यू, स्क्रीन की चौड़ाई और लंबाई के बजाय, अलग-अलग गतिविधियों की चौड़ाई और लंबाई से जुड़ी होती हैं. ज़्यादा जानकारी के लिए, गतिविधि को एम्बेड करना लेख पढ़ें.

उपलब्ध चौड़ाई और ऊंचाई, यह तय करने में अक्सर काम आती है कि मल्टीपैन लेआउट का इस्तेमाल करना है या नहीं. ऐसा इसलिए, क्योंकि टैबलेट डिवाइस पर भी, पोर्ट्रेट ओरिएंटेशन के लिए आपको अक्सर लैंडस्केप ओरिएंटेशन वाला मल्टीपैन लेआउट नहीं चाहिए होता. इसलिए, लेआउट के लिए ज़रूरी कम से कम चौड़ाई और/या ऊंचाई तय करने के लिए, इनका इस्तेमाल किया जा सकता है. इसके लिए, स्क्रीन साइज़ और ओरिएंटेशन क्वालिफ़ायर, दोनों का एक साथ इस्तेमाल करने की ज़रूरत नहीं है.

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

इन वैल्यू में, विंडो इंसर्ट के लिए इस्तेमाल की गई जगह शामिल नहीं होती. इसलिए, अगर डिवाइस के डिसप्ले के किनारों पर यूज़र इंटरफ़ेस (यूआई) के एलिमेंट मौजूद हैं, तो चौड़ाई और ऊंचाई की वैल्यू, स्क्रीन के असल डाइमेंशन से कम होती हैं. भले ही, ऐप्लिकेशन को Window.setDecorFitsSystemWindows या WindowCompat.setDecorFitsSystemWindows का इस्तेमाल करके, किनारे से किनारे तक दिखाया जा रहा हो.

कुछ वर्टिकल स्क्रीन डेकोरेशन ऐसे होते हैं जो तय नहीं होते. जैसे, फ़ोन का स्टेटस बार, जिसे फ़ुल स्क्रीन मोड में छिपाया जा सकता है. इन्हें यहां शामिल नहीं किया गया है. साथ ही, टाइटल बार या ऐक्शन बार जैसे विंडो डेकोरेशन भी शामिल नहीं किए गए हैं. इसलिए, ऐप्लिकेशन को उस जगह के लिए तैयार रहना चाहिए जो उन्होंने तय की है.

ध्यान दें: सिस्टम, चौड़ाई और ऊंचाई, दोनों के हिसाब से मैच करने वाला संसाधन चुनता है. इसलिए, ऐसे संसाधन को प्राथमिकता दी जाती है जिसमें दोनों के बारे में बताया गया हो. इसके बजाय, ऐसे संसाधन को प्राथमिकता नहीं दी जाती है जिसमें सिर्फ़ एक के बारे में बताया गया हो. उदाहरण के लिए, अगर स्क्रीन की चौड़ाई 720 डीपी और लंबाई 1280 डीपी है, तो w720dp के तौर पर क्वालिफ़ाई किए गए संसाधन के बजाय, w700dp-h1200dp के तौर पर क्वालिफ़ाई किए गए संसाधन को चुना जाएगा. भले ही, पहला संसाधन स्क्रीन के डाइमेंशन से पूरी तरह मेल खाता हो.

एपीआई लेवल 13 में जोड़ा गया.

screenWidthDp और screenHeightDp कॉन्फ़िगरेशन फ़ील्ड भी देखें. इनमें स्क्रीन की मौजूदा चौड़ाई और ऊंचाई की जानकारी होती है.

इस क्वालिफ़ायर का इस्तेमाल करके, अलग-अलग स्क्रीन के लिए डिज़ाइन करने के बारे में ज़्यादा जानने के लिए, व्यू के साथ रिस्पॉन्सिव/अडैप्टिव डिज़ाइन देखें.

स्क्रीन का साइज़

small

normal

large

xlarge

• small: ऐसी स्क्रीन जो कम डेंसिटी वाली QVGA स्क्रीन के साइज़ की होती हैं. छोटी स्क्रीन के लिए लेआउट का कम से कम साइज़, करीब 320x426 डीपी यूनिट होता है. उदाहरण के लिए, QVGA लो डेंसिटी और VGA हाई डेंसिटी.
• normal: ऐसी स्क्रीन जिनका साइज़, मीडियम-डेंसिटी वाली HVGA स्क्रीन के बराबर होता है. सामान्य स्क्रीन के लिए, लेआउट का कम से कम साइज़ करीब 320x470 डीपी यूनिट होता है. इस तरह की स्क्रीन के उदाहरण हैं: WQVGA कम डेंसिटी, HVGA मीडियम डेंसिटी, और WVGA हाई डेंसिटी.
• large: ऐसी स्क्रीन जो मीडियम-डेंसिटी वाली वीजीए स्क्रीन के साइज़ की हों. बड़ी स्क्रीन के लिए, लेआउट का कम से कम साइज़ करीब 480x640 डीपी यूनिट होना चाहिए. उदाहरण के लिए, VGA और WVGA मीडियम-डेंसिटी वाली स्क्रीन.
• xlarge: ऐसी स्क्रीन जो मीडियम-डेंसिटी वाली पारंपरिक एचवीजीए स्क्रीन से काफ़ी बड़ी होती हैं. ज़्यादा बड़ी स्क्रीन के लिए, लेआउट का कम से कम साइज़ करीब 720x960 डीपी यूनिट होता है. ज़्यादातर मामलों में, बहुत बड़ी स्क्रीन वाले डिवाइसों को जेब में नहीं रखा जा सकता. साथ ही, ये डिवाइस ज़्यादातर टैबलेट स्टाइल के होते हैं. एपीआई लेवल 9 में जोड़ा गया.

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

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

इसे एपीआई लेवल 4 में जोड़ा गया है.

screenLayout कॉन्फ़िगरेशन फ़ील्ड भी देखें. इससे पता चलता है कि स्क्रीन छोटी, सामान्य या बड़ी है.

ज़्यादा जानकारी के लिए, स्क्रीन के साथ काम करने की सुविधा के बारे में खास जानकारी लेख पढ़ें.

स्क्रीन का आसपेक्ट रेशियो

long

notlong

• long: लंबी स्क्रीन, जैसे कि WQVGA, WVGA, FWVGA
• notlong: लंबी स्क्रीन नहीं, जैसे कि QVGA, HVGA, और VGA

इसे एपीआई लेवल 4 में जोड़ा गया है.

यह पूरी तरह से स्क्रीन के आसपेक्ट रेशियो पर आधारित होता है (long स्क्रीन ज़्यादा चौड़ी होती है). यह समस्या स्क्रीन के ओरिएंटेशन से जुड़ी नहीं है.

screenLayout कॉन्फ़िगरेशन फ़ील्ड भी देखें. इससे पता चलता है कि स्क्रीन लंबी है या नहीं.

गोल स्क्रीन

round

notround

• round: गोल स्क्रीन वाले डिवाइस, जैसे कि गोल स्मार्टवॉच
• notround: आयताकार स्क्रीन, जैसे कि फ़ोन या टैबलेट

एपीआई लेवल 23 में जोड़ा गया.

isScreenRound कॉन्फ़िगरेशन का तरीका भी देखें. इससे पता चलता है कि स्क्रीन गोल है या नहीं.

वाइड कलर गैमट

widecg

nowidecg

• widecg: डिसप्ले, जिनमें कलर गैमट की रेंज ज़्यादा होती है. जैसे, Display P3 या AdobeRGB
• nowidecg: नैरो कलर गैमट वाले डिसप्ले, जैसे कि sRGB

इसे एपीआई लेवल 26 में जोड़ा गया है.

isScreenWideColorGamut कॉन्फ़िगरेशन का तरीका भी देखें. इससे पता चलता है कि स्क्रीन में वाइड कलर गैमट है या नहीं.

हाई डाइनैमिक रेंज (एचडीआर)

highdr

lowdr

• highdr: हाई डाइनैमिक रेंज वाले डिसप्ले
• lowdr: कम/स्टैंडर्ड डाइनैमिक रेंज वाले डिसप्ले

इसे एपीआई लेवल 26 में जोड़ा गया है.

isScreenHdr कॉन्फ़िगरेशन का तरीका भी देखें. इससे पता चलता है कि स्क्रीन पर एचडीआर की सुविधा है या नहीं.

स्क्रीन की दिशा

port

land

• port: डिवाइस पोर्ट्रेट ओरिएंटेशन (वर्टिकल) में है
• land: डिवाइस लैंडस्केप ओरिएंटेशन (हॉरिज़ॉन्टल) में है

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

orientation कॉन्फ़िगरेशन फ़ील्ड भी देखें. इससे डिवाइस के मौजूदा ओरिएंटेशन के बारे में पता चलता है.

यूज़र इंटरफ़ेस (यूआई) मोड

car

desk

television

appliance

watch

vrheadset

• car: डिवाइस, कार डॉक में दिख रहा हो
• desk: डिवाइस को डेस्क डॉक में दिखाया जा रहा है
• television: डिवाइस, टीवी पर डिसप्ले हो रहा है. इससे "दस फ़ीट" का अनुभव मिलता है. इसमें यूज़र इंटरफ़ेस (यूआई) बड़ी स्क्रीन पर दिखता है और उपयोगकर्ता उससे दूर होता है. साथ ही, यह अनुभव मुख्य रूप से डी-पैड या अन्य नॉन-पॉइंटर इंटरैक्शन पर आधारित होता है
• appliance: डिवाइस, डिसप्ले के बिना एक उपकरण के तौर पर काम कर रहा है
• watch: डिवाइस में डिसप्ले है और इसे कलाई पर पहना जाता है
• vrheadset: डिवाइस, वर्चुअल रिएलिटी हेडसेट में दिख रहा है

एपीआई लेवल 8 में जोड़ा गया; टेलीविज़न को एपीआई 13 में जोड़ा गया; डिवाइस को एपीआई 16 में जोड़ा गया; घड़ी को एपीआई 20 में जोड़ा गया; वीआर हेडसेट को एपीआई 26 में जोड़ा गया.

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

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

नाइट मोड

night

notnight

• night: रात के समय
• notnight: दिन के समय

एपीआई लेवल 8 में जोड़ा गया.

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

स्क्रीन पिक्सल डेंसिटी (डीपीआई)

ldpi

mdpi

hdpi

xhdpi

xxhdpi

xxxhdpi

nodpi

tvdpi

anydpi

nnndpi

• ldpi: कम डेंसिटी वाली स्क्रीन; करीब 120 डीपीआई.
• mdpi: मीडियम-डेंसिटी (पारंपरिक एचवीजीए पर) स्क्रीन; करीब 160 डीपीआई.
• hdpi: ज़्यादा डेंसिटी वाली स्क्रीन; करीब 240 डीपीआई.
• xhdpi: एक्स्ट्रा-हाई-डेंसिटी वाली स्क्रीन; करीब 320 डीपीआई. एपीआई लेवल 8 में जोड़ा गया.
• xxhdpi: एक्स्ट्रा-एक्स्ट्रा-हाई-डेंसिटी वाली स्क्रीन; करीब 480 डीपीआई. इसे एपीआई लेवल 16 में जोड़ा गया है.
• xxxhdpi: बहुत ज़्यादा डेंसिटी वाले पिक्सल का इस्तेमाल (सिर्फ़ लॉन्चर आइकॉन के लिए—अलग-अलग पिक्सल डेंसिटी के साथ काम करना देखें); करीब 640 डीपीआई. इसे एपीआई लेवल 18 में जोड़ा गया है.
• nodpi: इसका इस्तेमाल बिटमैप इमेज के लिए किया जाता है. इन इमेज को डिवाइस की डेंसिटी के हिसाब से छोटा-बड़ा नहीं किया जाता.
• tvdpi: mdpi और hdpi के बीच की स्क्रीन; करीब 213 डीपीआई. इसे "प्राइमरी" डेनसिटी ग्रुप नहीं माना जाता. यह सुविधा, मुख्य रूप से 720 पिक्सल वाले टीवी के लिए है. ज़्यादातर ऐप्लिकेशन को इसकी ज़रूरत नहीं होती. 1080 पिक्सल रिज़ॉल्यूशन वाले टीवी पैनल के लिए xhdpi और 4K रिज़ॉल्यूशन वाले टीवी पैनल के लिए xxxhdpi का इस्तेमाल करें. एपीआई लेवल 13 में जोड़ा गया.
• anydpi: यह सभी स्क्रीन डेंसिटी से मेल खाता है और अन्य क्वालिफ़ायर के मुकाबले इसे प्राथमिकता दी जाती है. यह ड्रॉ करने लायक वेक्टर के लिए काम का है. एपीआई लेवल 21 में जोड़ा गया.
• nnndpi: इसका इस्तेमाल, नॉन-स्टैंडर्ड डेंसिटी को दिखाने के लिए किया जाता है. इसमें nnn, स्क्रीन की डेंसिटी का पॉज़िटिव पूर्णांक होता है. ज़्यादातर मामलों में इसका इस्तेमाल नहीं किया जाता. स्टैंडर्ड डेंसिटी बकेट का इस्तेमाल करने से, बाज़ार में मौजूद अलग-अलग डिवाइसों की स्क्रीन डेंसिटी के लिए सहायता देने का खर्च काफ़ी कम हो जाता है.

छह मुख्य डेंसिटी (tvdpi डेंसिटी को छोड़कर) के बीच, 3:4:6:8:12:16 का स्केलिंग अनुपात होता है. इसलिए, ldpi में 9x9 बिटमैप, mdpi में 12x12, hdpi में 18x18, xhdpi में 24x24 वगैरह होता है.

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

अलग-अलग स्क्रीन डेंसिटी को मैनेज करने और Android, बिटमैप को मौजूदा डेंसिटी के हिसाब से कैसे स्केल करता है, इस बारे में ज़्यादा जानने के लिए, स्क्रीन के साथ काम करने की सुविधा के बारे में खास जानकारी देखें.

टचस्क्रीन का टाइप

notouch

finger

• notouch: डिवाइस में टचस्क्रीन नहीं है.
• finger: डिवाइस में टचस्क्रीन है, जिसे उपयोगकर्ता की उंगली से सीधे तौर पर इस्तेमाल किया जा सकता है.

touchscreen कॉन्फ़िगरेशन फ़ील्ड भी देखें. इससे पता चलता है कि डिवाइस पर किस तरह की टचस्क्रीन है.

कीबोर्ड उपलब्ध है या नहीं

keysexposed

keyshidden

keyssoft

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

अगर आपने keysexposed रिसॉर्स दिए हैं, लेकिन keyssoft रिसॉर्स नहीं दिए हैं, तो सिस्टम keysexposed रिसॉर्स का इस्तेमाल करेगा. भले ही, कीबोर्ड दिख रहा हो या नहीं. हालांकि, इसके लिए ज़रूरी है कि सिस्टम में सॉफ़्टवेयर कीबोर्ड चालू हो.

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

कॉन्फ़िगरेशन फ़ील्ड hardKeyboardHidden और keyboardHidden भी देखें. इनसे पता चलता है कि हार्डवेयर कीबोर्ड और किसी भी तरह के कीबोर्ड (सॉफ़्टवेयर कीबोर्ड भी शामिल है) को दिखाया जा सकता है या नहीं.

टेक्स्ट डालने का मुख्य तरीका

nokeys

qwerty

12key

• nokeys: डिवाइस में टेक्स्ट डालने के लिए कोई हार्डवेयर बटन नहीं है.
• qwerty: डिवाइस में हार्डवेयर QWERTY कीबोर्ड है. भले ही, यह उपयोगकर्ता को दिखता हो या नहीं.
• 12key: डिवाइस में 12 बटन वाला हार्डवेयर कीबोर्ड है. भले ही, यह उपयोगकर्ता को दिखता हो या न दिखता हो.

keyboard कॉन्फ़िगरेशन फ़ील्ड भी देखें. इससे पता चलता है कि टेक्स्ट इनपुट करने का मुख्य तरीका कौन-सा है.

नेविगेशन की उपलब्धता

navexposed

navhidden

• navexposed: उपयोगकर्ता के लिए नेविगेशन कुंजियां उपलब्ध हैं.
• navhidden: नेविगेशन कुंजियां उपलब्ध नहीं हैं (जैसे कि बंद ढक्कन के पीछे).

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

navigationHidden कॉन्फ़िगरेशन फ़ील्ड भी देखें. इससे पता चलता है कि नेविगेशन कुंजियां छिपी हुई हैं या नहीं.

बिना टच किए नेविगेट करने का मुख्य तरीका

nonav

dpad

trackball

wheel

• nonav: डिवाइस में टचस्क्रीन के अलावा, नेविगेशन की कोई सुविधा नहीं है.
• dpad: डिवाइस में नेविगेशन के लिए डायरेक्शनल-पैड (डी-पैड) है.
• trackball: डिवाइस में नेविगेशन के लिए ट्रैकबॉल है.
• wheel: डिवाइस में नेविगेशन के लिए दिशा बदलने वाले पहिए हैं (यह सुविधा आम तौर पर नहीं मिलती).

navigation कॉन्फ़िगरेशन फ़ील्ड भी देखें. इससे पता चलता है कि नेविगेशन का कौन-सा तरीका उपलब्ध है.

प्लैटफ़ॉर्म वर्शन (एपीआई लेवल)

उदाहरण:

v3

v4

v7

वगैरह

डिवाइस पर काम करने वाला एपीआई लेवल. उदाहरण के लिए, v1 एपीआई लेवल 1 (Android 1.0 या इसके बाद के वर्शन वाले डिवाइस) और v4 एपीआई लेवल 4 (Android 1.6 या इसके बाद के वर्शन वाले डिवाइस) के लिए. इन वैल्यू के बारे में ज़्यादा जानने के लिए, Android API लेवल दस्तावेज़ देखें.