एंड्रॉइड 2.1+ पर एक्शनबॉलर के साथ एक्शनबार

हैलो, हब्रहाब!

मैंने हाल ही में लिखा है कि Google ने ActionBar सपोर्ट को अपनी सपोर्ट लाइब्रेरी में जोड़ा है। मुझे लगता है कि यह बताने योग्य है कि इसका उपयोग कैसे किया जाए। कटौती के तहत - अपनी परियोजना में पुस्तकालय के सही आयात और SupportActionBar का उपयोग करने के मुख्य बिंदुओं के लिए निर्देश।

पुस्तकालय आयात करें

हमारे ActionBar को पुराने उपकरणों पर दिखाई देने के लिए, आपको Theme.AppCompat से एप्लिकेशन थीम को इनहेरिट करना होगा। बेशक, इसे कहीं से भी नहीं लिया जाएगा, इसलिए आपको एक पुस्तकालय परियोजना बनाने की आवश्यकता है (ग्रहण और एंड्रॉइड स्टूडियो के लिए अंग्रेजी में मूल निर्देश यहां हैं ( संसाधनों के साथ पुस्तकालय जोड़ना )):
1. सबसे पहले आपको यह सुनिश्चित करने की आवश्यकता है कि हमने समर्थन लाइब्रेरी का नवीनतम संस्करण डाउनलोड किया है। ऐसा करने के लिए, एसडीके प्रबंधक खोलें और एक्स्ट्रास फ़ोल्डर में बहुत नीचे तक स्क्रॉल करें। इसमें एक Android समर्थन लाइब्रेरी आइटम है - हमें इसकी आवश्यकता है। हम इसे नवीनतम संस्करण में अपडेट करते हैं (अब - Rev। 18), यदि आपने पहले ऐसा नहीं किया है।
2. अपडेट किया गया? अच्छा किया। अब फ़ाइल> नया> एंड्रॉइड फ़ोल्डर में, मौजूदा कोड से एंड्रॉइड प्रोजेक्ट चुनें पर क्लिक करें ।
3. ब्राउज़ ... बटन पर क्लिक करें और उस फ़ोल्डर की तलाश करें जिसकी हमें ज़रूरत है। इसका मार्ग कुछ इस प्रकार है: <अपने SDK> / अतिरिक्त / Android / समर्थन / v7 / appcompat /। सूची में प्रदर्शित आइटम का चयन करें और समाप्त पर क्लिक करें।
4. अब आपको प्रोजेक्ट एक्सप्लोरर में प्रोजेक्ट android-support-v7-appcompat देखना चाहिए। इसे खोलें, दोनों .jar फ़ाइलों में लिबर / फ़ोल्डर में, राइट-क्लिक करें और बिल्ड पाथ> ऐड टू बिल्ड पाथ पर क्लिक करें।
5. प्रोजेक्ट पर राइट-क्लिक करें, बिल्ड पाथ> कन्फर्म बिल्ड पाथ चुनें।
6. ऑर्डर और एक्सपोर्ट टैब में बिल्ड पाथ पेज पर, उन दो .jar फाइलों को चिह्नित करें जिन्हें अभी जोड़ा गया है और एंड्रॉइड डिपेंडेंसीज को अनचेक करें।
7. परिवर्तनों को सहेजने के लिए ठीक पर क्लिक करें। यही है - पुस्तकालय का उपयोग करने के लिए तैयार है!

अनुप्रयोग निर्माण

अब हमारे आवेदन के लिए एक परियोजना बनाएं, जो हम करेंगे। नाम SupportActionBarDemo है, पैकेज com.habrahabr.sabd है, न्यूनतम एपीआई स्तर 7 है (ये पुस्तकालय की आवश्यकताएं हैं)। एक गतिविधि बनाएँ, नाम MainActivity है, लेआउट मुख्य है।
अब हम इस परियोजना पर राइट-क्लिक करते हैं और गुण क्लिक करते हैं। लाइब्रेरी शीर्षक के तहत Android पृष्ठ पर, जोड़ें पर क्लिक करें और दिखाई देने वाली विंडो में android-support-v7-appcompat चुनें और फिर परिवर्तनों को सहेजने के लिए फिर से ठीक करें। अब लाइब्रेरी को प्रोजेक्ट में जोड़ा गया है!

सरल उदाहरण है

सबसे पहले, Res / values ​​/ styles.xml , res / values-v11 / styles.xml , res / values-v14 / styles.xml ( DeusModus के लिए धन्यवाद) पर जाएं और लिखें

<style name="AppBaseTheme" parent="@style/Theme.AppCompat.Light" > . . . 

अब ActionBar Android के किसी भी संस्करण पर दिखाई देगा।

Res / मान / strings.xml खोलें और लाइनें जोड़ें:

 <string name="action_item_1">Item 1</string> <string name="action_item_2">Item 2</string> <string name="action_item_3">Item 3</string> 

Res / मेनू / main.xml खोलें और वहां लिखें:

 <menu xmlns:android="http://schemas.android.com/apk/res/android" xmlns:sabd="http://schemas.android.com/apk/res-auto" > <item android:id="@+id/action_settings" android:title="@string/action_settings" android:icon="@android:drawable/ic_menu_add" sabd:showAsAction="always" /> <item android:id="@+id/action_item_1" android:title="@string/action_item_1" android:icon="@android:drawable/ic_menu_delete" sabd:showAsAction="ifRoom" /> <item android:id="@+id/action_item_2" android:title="@string/action_item_2" android:icon="@android:drawable/ic_menu_add" sabd:showAsAction="ifRoom|withText" /> <item android:id="@+id/action_item_3" android:title="@string/action_item_3" android:icon="@android:drawable/ic_menu_add" sabd:showAsAction="never" /> </menu> 

विशेषताओं पर ध्यान दें आइकन यादृच्छिक हैं, कोई फर्क नहीं पड़ता। मैं अब भी लिखता हूं कि sabd: showAsAction विशेषता का अर्थ है:

हमेशा - तत्व हमेशा दिखाई देगा, अगर पर्याप्त जगह नहीं है, तो शीर्षक पूरी तरह से प्रदर्शित नहीं होगा
ifRoom - तत्व तभी दिखाई देगा जब इसके लिए स्थान होगा
कभी नहीं - तत्व कभी भी दिखाई नहीं देगा, इसे प्रदर्शित करने के लिए आपको डिवाइस पर मेनू बटन या एक्शनबॉलर पर अतिप्रवाह बटन को दबाने की आवश्यकता है यदि कोई पहली नहीं है

withText - तत्व को केवल इसके शीर्षक के साथ प्रदर्शित किया जाएगा
पतनActionView - एक तत्व को एक बटन में ढहाया जा सकता है या क्लिक करके एक्शनबार की पूरी चौड़ाई तक विस्तारित किया जा सकता है, फिर मैं इसका एक उदाहरण दूंगा

अब हम कोड लिखने के लिए सीधे आगे बढ़ते हैं। गतिविधि कोड में पहली बात यह है कि फैली हुई गतिविधि को ActionBarActivity के साथ बदलना और आयात में जोड़ना। ADT के हाल के संस्करणों में, एक गतिविधि बनाते समय, onCreateOptionsMenu (मेनू मेनू) विधि स्वचालित रूप से बनाई जाती है, जिसमें हम मेनू बनाते हैं:

 import android.os.Bundle; import android.support.v7.app.ActionBarActivity; import android.view.Menu; public class MainActivity extends ActionBarActivity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); } @Override public boolean onCreateOptionsMenu(Menu menu) { getMenuInflater().inflate(R.menu.main, menu); return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { Log.d("MENU", "Cliced MenuItem is " + item.getTitle()); return super.onOptionsItemSelected(item); } } 

हम एप्लिकेशन लॉन्च करते हैं और हमारे ActionBar देखते हैं:



आइटम 2 दिखाई नहीं दिया क्योंकि इसके लिए पर्याप्त जगह नहीं थी। आइटम 3 किसी भी परिस्थिति में दिखाई नहीं देगा, क्योंकि हम सबड सेट करते हैं : showAsAction = "never" विशेषता। आप डिवाइस पर "मेनू" बटन का उपयोग करके उन्हें प्राप्त कर सकते हैं।
आप मेनू आइटमों पर क्लिक उसी प्रक्रिया में कर सकते हैं जैसे कि पहले - onOptionsItemSelected (MenuItem आइटम) विधि में। आप एक ही विधि में एप्लिकेशन आइकन पर क्लिक करके संभाल सकते हैं, इसमें android.R.id.home आईडी है। ActionBar में अप बटन जोड़ने के लिए, आपको ActionBar.setDisplayHomeAsUpEnabled (बूलियन शोहोमएस्प) विधि का उपयोग करने की आवश्यकता है:

खोज

कभी-कभी आपको एक खोज करने की आवश्यकता होती है, उदाहरण के लिए, जैसे कि Google Play में। ActionView बचाव के लिए आता है। Res / मेनू / main.xml खोलें और अंतिम 3 तत्वों को हटा दें - हमें उनकी आवश्यकता नहीं है, और वे जगह लेंगे। इसके बजाय, हम एक नया जोड़ते हैं:

 <item android:id="@+id/action_search" android:title="@string/action_search" android:icon="@android:drawable/ic_menu_search" sabd:showAsAction="always|collapseActionView" sabd:actionViewClass="android.support.v7.widget.SearchView" /> 

sabd विशेषता : actionViewClass = "android.support.v7.widget.SearchView" इंगित करता है कि सामान्य के बजाय किस दृश्य का उपयोग किया जाएगा। सबड में पाठ ढाँचा दृश्य: showAsAction विशेषता दर्शाती है कि ActionView को एक बटन पर छोटा किया जा सकता है या एक बटन के क्लिक पर पूरी चौड़ाई में विस्तारित किया जा सकता है। गतिविधि में इसका उपयोग करने के लिए, मुख्यता कोड बदलें:

 import android.os.Bundle; import android.support.v4.view.MenuItemCompat; import android.support.v7.app.ActionBarActivity; import android.support.v7.widget.SearchView; import android.support.v7.widget.SearchView.OnQueryTextListener; import android.view.Menu; import android.view.MenuItem; public class MainActivity extends ActionBarActivity implements OnQueryTextListener { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); } @Override public boolean onCreateOptionsMenu(Menu menu) { getMenuInflater().inflate(R.menu.main, menu); MenuItem searchItem = menu.findItem(R.id.action_search); SearchView searchView = (SearchView) MenuItemCompat.getActionView(searchItem); searchView.setQueryHint(""); searchView.setOnQueryTextListener(this); return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { Log.d("MENU", "Cliced MenuItem is " + item.getTitle()); return super.onOptionsItemSelected(item); } public boolean onQueryTextChange(String text_new) { Log.d("QUERY", "New text is " + text_new); return true; } public boolean onQueryTextSubmit(String text) { Log.d("QUERY", "Search text is " + text); return true; } } 

हम एप्लिकेशन लॉन्च करते हैं और देखते हैं:



खोज बटन पर क्लिक करें:



वैसे, कीबोर्ड स्वचालित रूप से प्रकट होता है। आप ActionBar के बाईं ओर ऊपर बटन पर क्लिक करके या हार्डवेयर बटन को दबाकर खोज मोड से बाहर निकल सकते हैं।
OnQueryTextChange () विधि में, उपयोगकर्ता द्वारा अगला अक्षर टाइप करने पर हमें इनपुट फ़ील्ड से टेक्स्ट मिलता है। OnQueryTextSubmit (स्ट्रिंग पाठ) विधि में, हमें वह पाठ दिया जाता है, जिसकी उपयोगकर्ता को तलाश है। SearchView के पास ये उपयोगी तरीके हैं:
सेटिविओ (CharSequence query, बूलियन सबमिट) - इनपुट फ़ील्ड में टेक्स्ट को उसमें से एक में बदल दिया जाता है, वैकल्पिक रूप से इसे अंतिम बनाता है (खोज शुरू करता है)
getQuery () - वह पाठ लौटाता है जो अब इनपुट फ़ील्ड में है
setQueryHint (CharSequence hint) - टूलटिप को इसमें से एक में बदल दिया जाता है
getQueryHint () - एक संकेत देता है
setSuggestionsAdapter (CursorAdapter अडैप्टर) - एक ड्रॉप-डाउन सूची जोड़ता है, जैसे AutoCompleteText View
getSuggestionsAdapter () - इस सूची का एडाप्टर लौटाता है
setOnCloseListener (SearchView.OnCloseListener श्रोता) - इस पर एक करीबी हैंडलर डालता है
setOnSuggestionListener (SearchView.OnSuggestionListener श्रोता) - इस पर ड्रॉप-डाउन सूची आइटम पर क्लिक करने के लिए एक हैंडलर डालता है।

निष्कर्ष

और Google के लोग, अच्छी तरह से किए गए, अपने ओएस के पुराने संस्करणों का समर्थन करने के बारे में मत भूलना। उदाहरण के लिए, टुकड़े, ViewPager और API v4 के साथ नेवीगेशन उपलब्ध हैं, API v7 के साथ एक्शनबार। हालांकि यह मुझे लगता है कि यह सब एंड्रॉइड 2.3 के लिए किया गया था, और इससे पहले के प्लेटफॉर्म - "कंपनी के लिए"।

मुझे खुशी होगी अगर यह लेख किसी की मदद करता है :-)

भाग 2 - टैब और ड्रॉप-डाउन सूची के साथ नेविगेट करना
भाग 3 - उन्नत सुविधाएँ