AndroidAnnotations - परियोजना के स्वास्थ्य को नुकसान पहुँचाए बिना कोड को सरल और छोटा करें (भाग I)

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

लाभ

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

अंदर क्या है और यह कैसे काम करता है

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

परियोजना कार्यान्वयन

इसके बाद, संस्करण 2.6 के लिए सब कुछ वर्णित है। भविष्य के संस्करणों में परिवर्तन के लिए, चैंज पढ़ें

प्रोजेक्ट सेटिंग्स

• लाइब्रेरी के साथ संग्रह डाउनलोड करें
• androidannotations-2.6-api.jar - हमारी परियोजना के "लिबास" फ़ोल्डर में डाल दिया।
• androidannotations-2.6.jar - परियोजना के अंदर एक नया फ़ोल्डर में "एक्स-लिबास" नाम के साथ रखा गया है।
• फिर "प्रोजेक्ट / प्रॉपर्टीज / जावा कंपाइलर / एनोटेशन प्रोसेसिंग" पर जाएं।
• बक्से "परियोजना विशिष्ट सेटिंग्स सक्षम करें", "एनोटेशन प्रसंस्करण सक्षम करें", "संपादक में प्रसंस्करण सक्षम करें" चेक करें।
• हम "फ़ैक्टरी पथ" उप-टैब पर जाते हैं: "प्रोजेक्ट विशिष्ट सेटिंग्स सक्षम करें" चेकबॉक्स की जाँच करें और "जार जोड़ें" पर क्लिक करें। "Ext-libs" फ़ोल्डर से "androidannotations-2.6.jar" जोड़ें। "लागू करें" और "हाँ" पर क्लिक करें।
• "जावा कंपाइलर" टैब में, सुनिश्चित करें कि हमारे पास कंपाइलर का "1.6" संस्करण है।
• टैब में "जावा बिल्ड पाथ / सोर्स" पर क्लिक करें "फ़ोल्डर जोड़ें" और एक नया फ़ोल्डर जोड़ें .apt_generated।
• ओके पर क्लिक करें

सबसे थकाऊ अंत हुआ, फिर गीत शुरू होता है।

सरल गतिविधि

सबसे पहले, मुख्यता की व्याख्या करें - प्रकट में:

<activity android:name=".MainActivity" android:label="@string/title_activity_main" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> 

प्रतिस्थापित करें। मुद्रा के साथ सक्रियता।
वर्ग का उल्लेख करें:

 @EActivity(R.layout.main_activity) public class MainActivity extends Activity { 

अब onCreate अधिभार को सुरक्षित रूप से हटाया जा सकता है और संकलन करने का प्रयास किया जा सकता है।

बाद की गतिविधि लॉन्च करें

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

  @AfterViews protected void afterViews(){ TestActivity_.intent(this).start(); } 

इस तरह के एक सरल तरीके से, एनोटेट गतिविधियों को लॉन्च किया जाता है।
एक्स्ट्रा के हस्तांतरण के साथ शुरू करने के लिए: TestActivity_.intent(context).myDateExtra(someDate).start();
जहाँ myDateExtra, TestActivity में एनोटेट @ Extra क्रमिक संरक्षित क्षेत्र है
झंडे के साथ चलाने के लिए: TestActivity_.intent(context).flags(FLAG_ACTIVITY_CLEAR_TOP).start();

गतिविधि को पूर्णता में दें

खोज दृश्य:

  @ViewById protected EditText testactivity_first_edittext; @ViewById(R.id.testactivity_second_textview) protected TextView secondTextView; 

राज्य को बचाने के लिए, आपको संग्रहीत इंस्टेंस स्टेट ऑब्जेक्ट को मैन्युअल रूप से निकालने की आवश्यकता नहीं है, यह पर्याप्त है:

  @InstanceState String stateToSave; 

और जब राज्य बदलता है, उदाहरण के लिए, जब स्क्रीन को घुमाया जाता है, तो इस फ़ील्ड को फिर से बनाया नहीं जाएगा, लेकिन इसके मूल्य को बनाए रखेगा।

संसाधन प्राप्त करना, उदाहरण के लिए तार:

  @StringRes(R.string.hello_world) String myHelloString; 

HangClistListener पर लटकाएं:

  @Click(R.id.testactivity_first_button) void myButtonWasClicked() { secondTextView.setText("first button was clicked"); } 

पाठ परिवर्तन सुनकर:

  @TextChange(R.id.testactivity_second_edittext) void onTextChangesOnSomeTextViews(TextView tv, CharSequence text) { Toast.makeText(this, "second textview was changed", Toast.LENGTH_SHORT).show(); } 

धाराओं के साथ सबसे आरामदायक काम

मूल रूप से, मैं स्ट्रीम के साथ काम करने के लिए अपनी परियोजनाओं में इस पुस्तकालय का उपयोग करता हूं।
इसके लिए दो एनोटेशन का उपयोग किया जाता है:
@ Background - एनोटेट है इसलिए @ Background में विधि निष्पादित होगी
@ UiThread - इसमें बैकग्राउंड थ्रेड नामक विधि को एनोटेट किया जाना चाहिए, लेकिन UI थ्रेड में निष्पादित किया जाता है
यहाँ एक उदाहरण कोड है:

  @Click(R.id.testactivity_second_button) protected void secondButtonWasClicked() { backgroundWork(); } @Background protected void backgroundWork() { publishProgress(0); publishProgress(10); publishProgress(100); onBGTaskFinish("bg task finished"); } @UiThread void publishProgress(int progress) { testactivity_first_edittext.setText("Background task progress: "+ progress); } @UiThread void onBGTaskFinish(String resultText){ secondTextView.setText(resultText); } 

एक बटन के क्लिक पर, एक पृष्ठभूमि धागा लॉन्च किया जाता है, जो अपने निष्पादन के दौरान प्रगति को प्रकाशित करता है और अंततः निष्पादन के परिणाम को स्थानांतरित करता है।

आज के लिए बस इतना ही, जारी रखने के लिए ...

पुस्तकालय
सभी लाइब्रेरी एनोटेशन का विवरण
एक नई परियोजना में पुस्तकालय का तेजी से कार्यान्वयन
एक लेख से एक उदाहरण परियोजना