Android स्ट्रिंग संसाधनों के साथ कार्य करना

यह समझना कि कार्यक्रम में उपयोग किया जाने वाला पाठ एक अलग संसाधन है, चित्र और ध्वनि के समान, तुरंत आता है। लेकिन दर्जनों फाइलों में कई बार कार्यक्रम का नाम बदलने या पांच, छह अलग-अलग स्थानों में एक ही वाक्यविन्यास त्रुटि को ठीक करने और कोड से अलग लाइनों को संग्रहीत करने की आवश्यकता स्पष्ट हो जाती है।
एंड्रॉइड में, स्ट्रिंग संसाधनों के साथ काम करना बहुत सुविधाजनक है और पहली बार में कोई कठिनाइयों का कारण नहीं है। आधिकारिक प्रलेखन में, यह स्ट्रिंग संसाधनों के लेख में वर्णित है। फ़ाइल प्रोजेक्ट \ res \ values ​​\ strings.xml में हम स्ट्रिंग और उसका नाम सेट करते हैं, जिसके बाद हम गतिविधि में इस नाम से स्ट्रिंग लोड करते हैं।
strings.xml

<?xml version="1.0" encoding="utf-8"?> <resources> <string name="appName">Project Name</string> </resources> 

ProjectActivity.java

 public class LoadingActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { String applicationName = getString(R.string.appName); } //... } 

उसी लाइन का उपयोग xml फ़ाइल लेआउट फॉर्म (लेआउट संसाधन) में किया जा सकता है। आप देख सकते हैं कि नई परियोजना बनाकर और main.xml फ़ाइल खोलकर इसे कैसे लागू किया गया है।

main.xml

 <?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent" > <TextView android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/appName" /> </LinearLayout> 

संसाधन विवरण

अब कुछ और रोचक बातें, जो कि दस्तावेज़ीकरण में भी वर्णित हैं, लेकिन जो इतने व्यापक रूप से उपयोग नहीं की जाती हैं।
तार के साथ (साथ ही अन्य संसाधनों के साथ) कई फाइलें हो सकती हैं। मुख्य बात यह है कि वे प्रोजेक्ट \ res \ values ​​\ folder में थे, xml एक्सटेंशन था, नाम में लोअरकेस अक्षर, संख्याएँ और स्थान शामिल नहीं थे। आंतरिक संरचना को स्ट्रिंग्स . xml फ़ाइल की संरचना को दोहराना चाहिए। इसका क्या उपयोग किया जा सकता है? एक फ़ाइल में मैं उन सभी लाइनों को संग्रहीत करता हूं, जिनका अनुवाद करने की आवश्यकता होगी, दूसरी पंक्ति में जिन्हें अनुवाद की आवश्यकता नहीं है, तीसरे में मैं उन स्थिरांक को संग्रहीत करता हूं जिनका उपयोग मैं वेब सर्वर के अनुरोधों को संकलित करने के लिए करता हूं।
XML फ़ाइल में संग्रहीत डेटा के प्रारूप पर छोटे प्रतिबंध हैं। स्पष्ट में, आप इसमें वर्णों का उपयोग नहीं कर सकते। आप एक विशेष अनुक्रम का उपयोग करके इन वर्णों को सेट कर सकते हैं
<- & lt;
& - & amp;
सिंगल और डबल एपोस्ट्रोफ के साथ काम करने पर अतिरिक्त प्रतिबंध लगाए गए हैं: आप केवल एक अप्रकाशित एपोस्ट्रोफ का उपयोग नहीं कर सकते हैं। इस समस्या को हल करने के लिए कई तरीके हैं, उनमें से सबसे सरल एपोस्ट्रोफ संकेत से पहले एक बैकस्लैश जोड़ रहा है:
'- \' या & apos;
"- \" या & quot;
यदि पाठ में html टैग हैं और इसमें एक निष्क्रिय स्थान & nbsp; है, तो इसे # # 160 के साथ प्रतिस्थापित किया जाना चाहिए।

लोड हो रहा है पंक्तियों

यदि आपको संसाधनों से पाठ को इंटरफ़ेस तत्वों में से किसी एक पर सेट करने की आवश्यकता है, तो इसे पहले से डाउनलोड करने की आवश्यकता नहीं है। उपरोक्त उदाहरण में दूसरी और तीसरी पंक्तियाँ बिल्कुल समान हैं।

 TextView sectionHeader = (TextView)findViewById(R.id.sectionHeader); sectionHeader.setText(getString(R.string.sectionPhone)); sectionHeader.setText(R.string.sectionPhone); 

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

 int sectionId = 10; String header = getString(R.id.headerSection); sectionHeader.setText(String.format(header, sectionId)); //----------------- sectionHeader.setText(getString(R.id.headerSection, sectionId)); 

निम्नलिखित निर्माण स्ट्रिंग प्रारूप के लिए उपयोग किया जाता है:% X $ F।
एक्स $ प्रतिस्थापित किए जाने वाले पैरामीटर की संख्या है। मुख्य पाठ में, वे आमतौर पर $ 1, $ 2 के क्रम में जाते हैं, लेकिन स्थानीय संसाधनों में वे स्थान बदल सकते हैं। इसे कई बार प्रति पंक्ति एक पैरामीटर का उपयोग करने की भी अनुमति है।
F एक नियमित प्रारूप पहचानकर्ता है जैसे 's', 'd'। फॉर्मेट क्लास के लिए प्रलेखन में तिथि प्रारूपण सहित एक पूरी सूची वर्णित है ।
यदि लाइन केवल एक पैरामीटर का उपयोग करती है, तो X $ को छोड़ा जा सकता है। यदि आप मापदंडों को असुविधाजनक मानते हैं, और स्थानीयकरण की समस्याओं की उम्मीद नहीं की जाती है, तो आप मानक स्ट्रिंग प्रारूप योजना पर लौट सकते हैं - इसके लिए, आपको तत्व विवरण के लिए मान के साथ स्वरूपित विशेषता को जोड़ने की आवश्यकता है। निम्न दो पंक्तियाँ उसी तरह से पाठ को प्रारूपित करती हैं:

 <string name="score_correct">%1$d - %2$d</string> <string name="score_simple" formatted="false">%d - %d</string> 

आप किसी भी अन्य संसाधन की तरह इसके नाम से एक लाइन लोड कर सकते हैं। ऐसा करने के लिए, पहले आपको स्ट्रिंग के नाम से इसकी आईडी खोजने के लिए गेटआईंटिफायर विधि का उपयोग करने की आवश्यकता है, और आपको पहले से ही सामान्य तरीके से इस नंबर के साथ काम करना चाहिए। निम्न उदाहरण "score_correct" नामक एक पंक्ति को लोड करता है।

 int strId = getResources().getIdentifier("score_correct", "string", getPackageName()); String strValue = getString(strId); 

Android संसाधनों में स्ट्रिंग सरणियों को संग्रहीत करने की अनुमति देता है। ऐसा करने के लिए, स्ट्रिंग-ऐरे टैग का उपयोग करें, जिसमें विशिष्ट स्ट्रिंग के साथ आइटम तत्व शामिल हैं। यहां Android प्रलेखन से एक संक्षिप्त उदाहरण दिया गया है जो किसी सरणी को निर्दिष्ट करता है।
strings.xml

 <string-array name="planets_array"> <item>Earth</item> <item>Mars</item> </string-array> 

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

strings.xml

 <string name="earth">Earth</string> <string name="mars">Mars</string> <string-array name="planets_array"> <item>@string/earth</item> <item>@string/mars</item> </string-array> 

उपयोगी नोट: एंड्रॉइड 2.3 से पहले, स्ट्रिंग-सरणी लोडिंग कार्यान्वयन में एक त्रुटि थी, जिसने अधिकतम 512 तत्वों को लोड करने की अनुमति दी थी।

सिस्टम के तार

एंड्रॉइड सिस्टम संसाधनों में संग्रहीत कई लाइनों तक पहुंच देता है। उनमें से कुछ काफी विशिष्ट हैं: वीडियो चलाने के लिए त्रुटि संदेश का शीर्षक। लेकिन "ओके" या "रद्द" जैसे तार लगभग हर परियोजना में उपयोग करने के लिए सुविधाजनक हैं। सिस्टम स्ट्रिंग्स का उपयोग करना अपने स्वयं के संसाधनों का उपयोग करना लगभग आसान है - आपको एक कोलोन के साथ स्ट्रिंग संसाधन पहचानकर्ता के सामने एंड्रॉइड नाम निर्दिष्ट करना होगा। निम्न उदाहरण सिस्टम संसाधनों से एक स्ट्रिंग का उपयोग करके "रद्द करें" लेबल वाले बटन का वर्णन करता है।

main.xml

 <Button android:text="@android:string/cancel" android:layout_width="wrap_content" android:layout_height="wrap_content" /> 

स्ट्रिंग स्थानीयकरण

एंड्रॉइड में संसाधनों के स्थानीयकरण के लिए बुनियादी तंत्र स्थानीयकरण स्ट्रिंग्स के साथ लगभग सभी कार्यों को हल करना आसान बनाता है। Android प्रलेखन में पूर्ण विवरण यहां पाया जा सकता है । संसाधनों में आपको मानों-xx नामक एक नया फ़ोल्डर बनाने और वहां आधार मान फ़ोल्डर से स्ट्रिंग संसाधनों के साथ फ़ाइलें डालने की आवश्यकता है। xx एक दो-वर्ण भाषा पहचानकर्ता है (पाठ के अंत में समर्थित मानों की एक सूची दी गई है)। इसके बाद, आवश्यक लाइनों का अनुवाद किया जाना चाहिए, बाकी को हटा दिया गया है।
बेहतर स्थानीयकरण के लिए, आप क्षेत्र सेट करने के लिए तंत्र का उपयोग कर सकते हैं। उदाहरण के लिए, आपके कार्यक्रम में फ्रेंच में अनुवादित एक उपयोगकर्ता समझौता है, लेकिन इसमें फ्रांस के लिए संस्करण और कनाडा के लिए संस्करण के बीच अंतर है। इन अंतरों को महसूस करने के लिए, rYY प्रारूप में क्षेत्र का नाम मान- fr फ़ोल्डर में जोड़ें , जहां YY दो-वर्ण क्षेत्र का नाम है। इस उदाहरण में, हमें वैल्यूज़-फ़्र-आरएफआर और वैल्यूज़-फ़्र-आरसीए फोल्डर मिलते हैं । उन्हें उपयोगकर्ता अनुबंध के आवश्यक संस्करण के साथ संसाधन फ़ाइल रखनी चाहिए, और मान- fr फ़ोल्डर में फ्रेंच में अन्य सभी पंक्तियों को छोड़ देना चाहिए ।
क्षेत्रों और भाषा को एक दूसरे के साथ किसी भी संबंध के बिना निर्दिष्ट किया जा सकता है। तो मूल्यों में आरयू-आरजेपी फ़ोल्डर को जापान के निवासियों के लिए रूसी ग्रंथों को संग्रहीत किया जाएगा।

चूंकि निश्चित रूप से कुछ क्षेत्र हैं, ज्यादातर मामलों में उनके बजाय सटीक देश पहचानकर्ता को निर्दिष्ट करना अधिक सुविधाजनक है। कोड की सूची विकिपीडिया पर उपलब्ध है और इस पद्धति का एकमात्र दोष यह है कि कुछ देशों में कई कोड हैं (संयुक्त राज्य अमेरिका 7 नंबर का उपयोग करता है, जापान 2 नंबर का उपयोग करता है)। Mcc का उपयोग करने के लिए उदाहरण को याद करते हुए , हम फ्रांस के लिए मान-mcc208-fr फ़ोल्डर और कनाडा के लिए मान-mcc302-fr प्राप्त करते हैं।
स्थानीयकरण के साथ कठिनाइयाँ उस समय शुरू होती हैं जब आपको सिस्टम द्वारा समर्थित भाषा में एप्लिकेशन को स्थानीय बनाने की आवश्यकता होती है। इस स्थिति में आना आसान है, क्योंकि अधिकांश भाषाओं और क्षेत्रों को केवल प्लेटफॉर्म 2.3 के संस्करण में जोड़ा गया था। उसी समय, कुछ निर्माताओं ने अपने उपकरणों में अन्य भाषाओं के लिए समर्थन जोड़ा, लेकिन विभिन्न कोड का उपयोग किया। नतीजतन, एंड्रॉइड 2.1 और 2.2 में नॉर्वेजियन भाषा को कई उपकरणों पर बिना किसी कोड के पहचाना जाता है, कुछ उपकरणों पर यह मान्यता प्राप्त नहीं है, और एंड्रॉइड 2.3 से शुरू होकर इसे एनबी कोड द्वारा मान्यता प्राप्त है। एक ही स्थिति, लेकिन एक छोटे पैमाने पर, हिब्रू के साथ, जिसे वह कोड और इंडोनेशियाई भाषा के तहत पाया जा सकता है, आईडी कोड है।
इस मामले में, अलग-अलग फ़ाइलों में समान लाइनों के दो सेटों को संग्रहीत नहीं करने के लिए, आप उन संसाधनों के लिए उपनाम का उपयोग कर सकते हैं जो पहले ही उल्लेख किए गए थे।
इस स्थिति में, वास्तविक लाइन फ़ीड मान फ़ोल्डर में संग्रहीत किया जाता है, और उनके नाम के लिए काम कर रहे नामों का उपयोग किया जाता है। वैल्यू-नो और वैल्यू-एनबी फोल्डर में, स्ट्रिंग्स के लिंक संग्रहीत किए जाते हैं और वास्तविक संसाधन नाम पहले से ही यहां उपयोग किए जाते हैं।

मान / स्ट्रिंग्स। xml

 <resources> <!--    --> <string name="hello">Hello World</string> <!--   --> <string name="hello_translate">Hallo Verden</string> </resources> 

मान-नहीं / स्ट्रिंग्स। xml

 <resources> <string name="hello">@string/hello_translate</string> </resources> 

मान- nb / strings.xml

 <resources> <string name="hello">@string/hello_translate</string> </resources> 

आप भाषा और क्षेत्र के लिए किसी भी कोड के साथ संसाधन बना सकते हैं। यदि ऑपरेटिंग सिस्टम को वांछित क्षेत्र नहीं मिलता है, तो यह वर्तमान भाषा के लिए मान लेगा। यदि यह भाषा नहीं ढूंढ सकता है, तो यह मान फ़ोल्डर से डिफ़ॉल्ट मान लेगा।

आप डिवाइस पर स्थापित भाषाओं के अलावा भाषा और क्षेत्र के लिए संसाधनों में स्ट्रिंग डाउनलोड कर सकते हैं। ऐसा करने के लिए, एक नया संसाधन बनाएं और इसके लिए आवश्यक स्थान निर्धारित करें। निम्नलिखित उदाहरण फ्रांसीसी भाषा के लिए एक स्ट्रिंग लोड करता है।

 Resources baseResources = getResources(); Configuration config = new Configuration(baseResources.getConfiguration()); config.locale = Locale.FRANCE; Resources localResources = new Resources(baseResources.getAssets(), baseResources.getDisplayMetrics(), config); String strFranceValue = localResources.getString(R.string.score_correct); 

आप प्रोग्राम को पूरे एप्लिकेशन के लिए मनमाने ढंग से भाषा भी सेट कर सकते हैं, लेकिन इस कार्य पर विचार करना इस विषय के दायरे से परे है।

आवेदन

एंड्रॉइड 2.3 तक समर्थित भाषाएं

अंग्रेज़ी (en), डच (nl), स्पेनिश (es), इतालवी (यह), चीनी (zh), कोरियाई (ko), जर्मन (de), जर्मन (de), पोलिश (pl), रूसी (ru), फ्रेंच (fr), चेक (cs), जापानी (ja)

Android 2.3 के बाद से समर्थित भाषाएँ

अरबी (ar), बल्गेरियाई (bg), हंगेरियन (hu), वियतनामी (vi), ग्रीक (el), डेनिश (da), हिब्रू (iw), इन्डोनेशियाई (in), कातालान (ca), लातवियाई (lv), लिथुआनियाई (lt), नॉर्वेजियन बोकमाल (nb), पुर्तगाली (pt), रोमानियाई (ro), सर्बियाई (sr), स्लोवाक (sk), स्लोवेनियाई (sl), तागालोग (tl), थाई (th), तुर्की (tr) ), यूक्रेनी (ब्रिटेन), फ़िनिश (फाई), हिंदी (हाय), क्रोएशियाई (घंटा), स्वीडिश (sv)

एंड्रॉइड 2.3 तक समर्थित क्षेत्र

ऑस्ट्रेलिया (AU), ऑस्ट्रिया (AT), बेल्जियम (BE), ब्रिटेन (GB), जर्मनी (DE), स्पेन (ES), इटली (IT), कनाडा (CA), चीन (CN), कोरिया (KR), लिकटेंस्टीन (LI), नीदरलैंड्स (NL), न्यूजीलैंड (NZ), पोलैंड (PL), रूस (RU), सिंगापुर (SG), USA (यूएस), ताइवान (TW), फ्रांस (FR), चेक गणराज्य (CZ) ), स्विट्जरलैंड (CH), जापान (JP)

एंड्रॉइड 2.3 से शुरू होने वाले समर्थित क्षेत्र

बुल्गारिया (बीजी), ब्राजील (बीआर), हंगरी (एचयू), वियतनाम (वीएन), ग्रीस (जीआर), डेनमार्क (डीके), मिस्र (ईजी), जिम्बाब्वे (जेडए), इजरायल (आईएल), भारत (आईएन), इंडोनेशिया (आईडी), आयरलैंड (IE), लातविया (LV), लिथुआनिया (LT), नॉर्वे (NO), पुर्तगाल (PT), रोमानिया (RO), सर्बिया (RS), स्लोवाकिया (SK), स्लोवेनिया (SI), थाईलैंड (टीएच), तुर्की (टीआर), यूक्रेन (यूए), फिलीपींस (पीएच), फिनलैंड (एफआई) बुल्गारिया (बीजी), ब्राजील (बीआर), हंगरी (एचयू), वियतनाम (वीएन), ग्रीस (जीआर), डेनमार्क (DK), मिस्र (EG), ज़िम्बाब्वे (ZA), इज़राइल (IL), भारत (IN), इंडोनेशिया (ID), आयरलैंड (IE), लातविया (LV), लिथुआनिया (LT), नॉर्वे (NO), पुर्तगाल (PT), रोमानिया (RO), सर्बिया (RS), स्लोवाकिया (SK), स्लोवेनिया (SI), थाईलैंड (TH), तुर्की (TR), U रैना (UA), फिलीपींस (पीएच), फिनलैंड (एफआई) क्रोएशिया (एचआर), स्वीडन (एसई)

अद्यतन: स्ट्रिंग सरणियों, स्ट्रिंग स्थानीयकरण, सिस्टम स्ट्रिंग्स के बारे में जोड़ा गया खंड। विभिन्न गतिविधियों के बीच डेटा स्थानांतरित करने के लिए संसाधनों का उपयोग करके एक उदाहरण को हटा दिया।