एंड्रॉइड 3.0 में टुकड़े एपीआई

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



एंड्रॉइड 3.0 का एक महत्वपूर्ण लक्ष्य उन लेखन कार्यक्रमों को सरल बनाना है जो स्क्रीन के आकार के आधार पर स्केल करने की आवश्यकता होती है। इसके लिए, निम्नलिखित उपकरण पहले से ही एंड्रॉइड प्लेटफॉर्म पर उपलब्ध हैं:

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

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

सुगंध का परिचय

एंड्रॉइड 3.0 उन नए वर्गों के लिए समर्थन का परिचय देता है जो एप्लिकेशन को उनके इंटरफ़ेस को स्केल करने में मदद करते हैं, जिन्हें टुकड़े कहते हैं। एक टुकड़ा अपने स्वयं के इंटरफेस और जीवन चक्र के साथ एक स्वतंत्र घटक है; किसी विशिष्ट डिवाइस या स्क्रीन के लिए वांछित UI स्ट्रीम के आधार पर, इसे उपयोगकर्ता इंटरफ़ेस के विभिन्न भागों में बार-बार उपयोग किया जा सकता है।



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

• एक्टिविटीग्रुप के माध्यम से नेस्टेड गतिविधियां एक अच्छा विचार था, लेकिन गतिविधि के साथ काम करना आसान नहीं था, क्योंकि गतिविधि को मूल रूप से एक स्वतंत्र घटक के रूप में विकसित किया गया था। फ्रैगमेंट एपीआई इसके लिए एक बेहतर समाधान है, इसे नेस्टेड एक्टिविटीज के प्रतिस्थापन के रूप में माना जाना चाहिए।
• गतिविधि उदाहरणों के लिए डेटा सहेजना गतिविधि.onRetainNonConfigurationInstance () के माध्यम से किया जा सकता है, लेकिन यह अपने आप में अनाड़ी है और स्पष्ट नहीं है। टुकड़े इस तंत्र को प्रतिस्थापित करते हैं, जिससे आप केवल एक ध्वज स्थापित करके टुकड़े के एक पूरे उदाहरण को सहेज सकते हैं।
• टुकड़े के तात्कालिकता में से एक DialogFragment है, जो एक गतिविधि के प्रदर्शन को सरल करता है जिसे गतिविधि चक्र चक्र के भाग के रूप में प्रबंधित किया जाता है। यह संवादों को प्रबंधित करने के लिए उपयोग की जाने वाली गतिविधि एपीआई की जगह लेता है।
• टुकड़े का एक और उदाहरण है ListFragment, जो डेटा की एक सूची के प्रदर्शन को सरल करता है। ListFragment ListActivity (कुछ अतिरिक्त सुविधाओं के साथ) के समान है, इसका उपयोग सूची में डेटा के प्रदर्शन को सरल करेगा।
• गतिविधि से जुड़ी सभी अंशों की जानकारी को उसी गतिविधि की सहेजी स्थिति में फ्रेमवर्क द्वारा सहेजा जाता है और पुनः आरंभ करने पर पुनर्स्थापित किया जाता है। इस प्रकार, संग्रहीत राज्यों की संख्या कम हो जाती है।
• फ्रेमवर्क में टुकड़ों के ढेर के प्रबंधन के लिए अंतर्निहित समर्थन है, यह गतिविधि के अंदर बैक बटन के व्यवहार के समर्थन को सरल करता है, और यह व्यवहार मौजूदा गतिविधियों के ढेर के साथ एकीकृत है।

शुरुआत हो रही है

यहाँ टुकड़ों का उपयोग करके कई UI थ्रेड्स को लागू करने का एक सरल लेकिन पूर्ण उदाहरण है। आइए एक परिदृश्य लेआउट डिजाइन करके शुरू करें जिसमें बाईं ओर तत्वों की एक सूची है और दाईं ओर उन पर डेटा है। यह वह लेआउट है जिसकी हमें आवश्यकता है:







गतिविधि के लिए कोड विशेष रूप से दिलचस्प नहीं है, यह बस निम्नलिखित लेआउट के साथ setContentView () कहता है:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="horizontal" android:layout_width="match_parent" android:layout_height="match_parent"> <fragment class="com.example.android.apis.app.TitlesFragment" android:id="@+id/titles" android:layout_weight="1" android:layout_width="0px" android:layout_height="match_parent" /> <FrameLayout android:id="@+id/details" android:layout_weight="1" android:layout_width="0px" android:layout_height="match_parent" /> </LinearLayout>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

आप पहली विशेषता को देख सकते हैं: टैग

 <fragment>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

आपको अपने इंटरफ़ेस पदानुक्रम में एक टुकड़ा सेट करने की अनुमति देता है। ऊपर वर्णित टुकड़ा लिस्टफ्रेगमेंट गुणों को विरासत में मिला है, जो वर्तमान स्थान में तत्व पर या एक अलग गतिविधि में लेआउट के आधार पर डेटा प्रदर्शित करता है। ध्यान दें कि खंड स्थिति में परिवर्तन कैसे सहेजे जाते हैं।

 public static class TitlesFragment extends ListFragment { boolean mDualPane; int mCurCheckPosition = 0; @Override public void onActivityCreated(Bundle savedState) { super.onActivityCreated(savedState); // Populate list with our static array of titles. setListAdapter(new ArrayAdapter<String>(getActivity(), R.layout.simple_list_item_checkable_1, Shakespeare.TITLES)); // Check to see if we have a frame in which to embed the details // fragment directly in the containing UI. View detailsFrame = getActivity().findViewById(R.id.details); mDualPane = detailsFrame != null && detailsFrame.getVisibility() == View.VISIBLE; if (savedState != null) { // Restore last state for checked position. mCurCheckPosition = savedState.getInt("curChoice", 0); } if (mDualPane) { // In dual-pane mode, list view highlights selected item. getListView().setChoiceMode(ListView.CHOICE_MODE_SINGLE); // Make sure our UI is in the correct state. showDetails(mCurCheckPosition); } } @Override public void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); outState.putInt("curChoice", mCurCheckPosition); } @Override public void onListItemClick(ListView l, View v, int pos, long id) { showDetails(pos); } /** * Helper function to show the details of a selected item, either by * displaying a fragment in-place in the current UI, or starting a * whole new activity in which it is displayed. */ void showDetails(int index) { mCurCheckPosition = index; if (mDualPane) { // We can display everything in-place with fragments. // Have the list highlight this item and show the data. getListView().setItemChecked(index, true); // Check what fragment is shown, replace if needed. DetailsFragment details = (DetailsFragment) getFragmentManager().findFragmentById(R.id.details); if (details == null || details.getShownIndex() != index) { // Make new fragment to show this selection. details = DetailsFragment.newInstance(index); // Execute a transaction, replacing any existing // fragment with this one inside the frame. FragmentTransaction ft = getFragmentManager().beginTransaction(); ft.replace(R.id.details, details); ft.setTransition( FragmentTransaction.TRANSIT_FRAGMENT_FADE); ft.commit(); } } else { // Otherwise we need to launch a new activity to display // the dialog fragment with selected text. Intent intent = new Intent(); intent.setClass(getActivity(), DetailsActivity.class); intent.putExtra("index", index); startActivity(intent); } } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

यह विवरणफ्रैगमेंट को लागू करने के लिए भी आवश्यक है, जो एक तत्व पर डेटा को नियमित रूप से टेक्स्ट व्यू में प्रदर्शित करेगा।

 public static class DetailsFragment extends Fragment { /** * Create a new instance of DetailsFragment, initialized to * show the text at 'index'. */ public static DetailsFragment newInstance(int index) { DetailsFragment f = new DetailsFragment(); // Supply index input as an argument. Bundle args = new Bundle(); args.putInt("index", index); f.setArguments(args); return f; } public int getShownIndex() { return getArguments().getInt("index", 0); } @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { if (container == null) { // Currently in a layout without a container, so no // reason to create our view. return null; } ScrollView scroller = new ScrollView(getActivity()); TextView text = new TextView(getActivity()); int padding = (int)TypedValue.applyDimension( TypedValue.COMPLEX_UNIT_DIP, 4, getActivity().getResources().getDisplayMetrics()); text.setPadding(padding, padding, padding, padding); scroller.addView(text); text.setText(Shakespeare.DIALOGUE[getShownIndex()]); return scroller; } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

हमारे आवेदन में एक और यूआई धागा जोड़ने का समय है। जब स्क्रीन पोर्ट्रेट मोड में होती है, तो दो टुकड़ों को एक साथ प्रदर्शित करने के लिए पर्याप्त जगह नहीं होती है। यही है, हम चाहते हैं कि केवल सूची प्रदर्शित हो:







चलो चित्र अभिविन्यास के लिए एक नया लेआउट लिखें:

 <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent"> <fragment class="com.example.android.apis.app.TitlesFragment" android:id="@+id/titles" android:layout_width="match_parent" android:layout_height="match_parent" /> </FrameLayout>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

अब हमारे पास TitlesFragment के लिए डेटा प्रदर्शित करने के लिए एक कंटेनर नहीं है, केवल एक सूची प्रदर्शित की गई है। जब आप किसी सूची आइटम पर क्लिक करते हैं, तो आपको अब एक अलग गतिविधि को कॉल करने की आवश्यकता होती है, जिसमें डेटा प्रदर्शित किया जाएगा:







अब, हम में से जो भी आवश्यक है वह पहले से तैयार विवरण का उपयोग करना है:

 public static class DetailsActivity extends FragmentActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); if (getResources().getConfiguration().orientation == Configuration.ORIENTATION_LANDSCAPE) { // If the screen is now in landscape mode, we can show the // dialog in-line so we don't need this activity. finish(); return; } if (savedInstanceState == null) { // During initial setup, plug in the details fragment. DetailsFragment details = new DetailsFragment(); details.setArguments(getIntent().getExtras()); getSupportFragmentManager().beginTransaction().add( android.R.id.content, details).commit(); } } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

गतिविधि को जोड़ने से, हमें उस एप्लिकेशन का पूरी तरह से काम करने का उदाहरण मिलता है जो धारा के यूआई में एक क्रांतिकारी बदलाव का उपयोग करता है, जो वर्तमान में उपयोग किए गए कॉन्फ़िगरेशन के आधार पर होता है। साथ ही, कॉन्फ़िगरेशन बदलते समय एप्लिकेशन को स्क्रीन आकार की आवश्यकताओं के लिए स्वचालित रूप से समायोजित किया जाता है।



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



हमेशा की तरह, एसडीके प्रलेखन में अधिक जानकारी पाई जा सकती है। आप ApiDemos में भी उदाहरण पा सकते हैं।

सभी के लिए विखंडन

फ्रैगमेंट एपीआई टैबलेट-उन्मुख अनुप्रयोगों के साथ काम करने वाले डेवलपर्स के लिए उपयोगी होगा जो एंड्रॉइड 3.0 के लिए डिज़ाइन किए गए हैं, कई मामलों में एक बड़ी स्क्रीन शामिल है। इसके अलावा, टुकड़ों के उपयोग से नए एंड्रॉइड डिवाइसों, जैसे टीवी के लिए अनुप्रयोगों के लिए यूआई को कॉन्फ़िगर करना आसान हो सकता है।



हालांकि, अब टैबलेट के लिए फोन के लिए मौजूदा एप्लिकेशन के इंटरफेस में सुधार करने के लिए फ्रैगमेंट एपीआई सबसे अधिक मांग में होगा।



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



लाइब्रेरी कब उपलब्ध होगी इसकी कोई सटीक तारीख अभी नहीं है, लेकिन यह जल्द ही होगी। अभी के लिए, आप एंड्रॉइड 3.0 पर टुकड़ों के साथ काम करना शुरू कर सकते हैं।