👩‍🌾 🍆 🐀 एंड्रॉइड के लिए हैलो वर्ल्ड विजेट 🤯 👨‍👦 👩🏻‍🌾

अजीब तरह से पर्याप्त है, लेकिन रूसी में एंड्रॉइड के लिए विगेट्स पर लगभग कोई सामान्य लेख नहीं हैं। और अंग्रेजी भाषा के संसाधनों पर शुरू करने के लिए लगभग कोई सरल उदाहरण नहीं हैं, सभी उदाहरण किसी कारण से जटिल और समझने में मुश्किल हैं। मैं इसे ठीक करने के लिए जल्दबाजी करता हूं।

मैं परियोजना की संरचना और इसे बनाने के तरीके का वर्णन नहीं करूंगा। यह माना जाता है कि आप पहले से ही जानते हैं कि यह कैसे करना है, लेकिन उन लोगों के लिए जो यह नहीं जानते कि, मैं आपको इस लेख को पढ़ने की सलाह देता हूं। विजेट के लिए, हमें 3 फाइलें बनाने की आवश्यकता है:

विजेट प्रदाता जानकारी
विजेट प्रदाता
ख़ाका

विजेट प्रदाता जानकारी - यह एक xml फ़ाइल है जो विजेट मेटाडेटा का वर्णन करती है। इनमें विजेट का आकार, इसकी अद्यतन आवृत्ति, टेम्प्लेट फ़ाइल और कॉन्फ़िगरेशन क्लास शामिल हैं। यह हमारी फ़ाइल (Res / xml / hello_widget_provider.xml) जैसी दिखाई देगी:

<? xml संस्करण = "1.0" एन्कोडिंग = "utf-8" ?>
<appwidget- प्रदाता xmlns: android = "schemas.android.com/apk/res/android"
Android: minWidth = "146dip"
Android: minHeight = "72dip"
Android: अपडेटपेरिओमिलिस = "86400000"
Android: initialLayout = "@ लेआउट / मुख्य" />

हम किसी भी विजेट आकार को निर्दिष्ट कर सकते हैं, लेकिन Google विजेट आकार (कोशिकाओं की संख्या * 74) - 2 की गणना के लिए सूत्र का पालन करने की सिफारिश करता है। updatePeriodMillis विजेट रिफ्रेश रेट है, लेकिन बैटरी बचाने के लिए हर 30 मिनट में एक बार से ज्यादा नहीं। initialLayout एक विजेट टेम्पलेट फ़ाइल है।

विजेट प्रदाता - यह एक जावा फ़ाइल है, इसे AppWidgetProvider वर्ग से विरासत में प्राप्त होना चाहिए। हमारे मामले में, यह अभी के लिए खाली रहेगा (src / ru / example / android / widget / HelloWidget.java)।

पैकेज ru.example.android.widget ;
आयात android.appwidget.AppWidgetProvider ;
सार्वजनिक वर्ग HelloWidget फैली AppWidgetProvider {
}

लेआउट - यह एक विजेट टेम्पलेट या दृश्य परत है, जैसा आप चाहते हैं। यह इस तरह दिखेगा: (Res / layout /main.xml)।

<? xml संस्करण = "1.0" एन्कोडिंग = "utf-8" ?>
<LinearLayout xmlns: android = " schemas.android.com/apk/res/android"
एंड्रॉइड: लेआउट_ एक्सपोज़र = "fill_parent"
Android: ओरिएंटेशन = "वर्टिकल"
Android: पृष्ठभूमि = "@ रंग: सफेद / सफेद"
एंड्रॉइड: लेआउट_ग्रेविटी = "केंद्र"
Android: layout_height = "wra_content" >
<TextView android: id = "@ + id / widget_textview"
Android: पाठ = "हैलो विजेट"
Android: Layout_height = "wra_content"
एंड्रॉइड: लेआउट_ एक्सपोज़र = "wra_content"
एंड्रॉइड: लेआउट_ग्रेविटी = "सेंटर_होर्गेनिक | सेंटर"
Android: textColor = " @android : color / black" />
</ LinearLayout >

हमने सभी बुनियादी चीजें कीं, यह AndroidManifest.xml में विजेट को पंजीकृत करने के लिए बनी हुई है। ऐसा करने के लिए, <code> ... </ application> अनुभाग में निम्न कोड जोड़ें:

<रिसीवर एंड्रॉइड: नाम = ".widget.HelloWidget" Android: label = "@ string / app_name" >
<आशय-फ़िल्टर >
<Action android: name = "android.appwidget.action.APPWIDGET_UPDATE" />
</ आशय-फ़िल्टर >
<मेटा-डेटा Android: नाम = "android.appwidget.provider"
Android: संसाधन = "@ xml / hello_widget_provider" />
</ रिसीवर >

अब हम प्रोजेक्ट संकलित कर सकते हैं और एमुलेटर में परिणाम देख सकते हैं!

हमारा विजेट, हालांकि यह काम करता है, बिल्कुल बेकार है। आइए इसे एक बटन क्लिक का जवाब दें।

एक बटन या किसी अन्य घटना के क्लिक पर एक पूर्ण घटना को एक विजेट में लटका देना असंभव है, जैसा कि आप गतिविधि में कर रहे हैं। इस उदाहरण में, आप देखेंगे कि आप बटन क्लिक से किसी ईवेंट को कैसे संभाल सकते हैं। आइए हमारे टेम्पलेट (Res / layout /main.xml) में एक बटन जोड़कर शुरू करें।

<? xml संस्करण = "1.0" एन्कोडिंग = "utf-8" ?>
<LinearLayout xmlns: android = " schemas.android.com/apk/res/android"
एंड्रॉइड: लेआउट_ एक्सपोज़र = "fill_parent"
Android: ओरिएंटेशन = "वर्टिकल"
Android: पृष्ठभूमि = "@ रंग: सफेद / सफेद"
एंड्रॉइड: लेआउट_ग्रेविटी = "केंद्र"
Android: layout_height = "wra_content" >
<TextView android: id = "@ + id / widget_textview"
Android: पाठ = "हैलो विजेट"
Android: Layout_height = "wra_content"
एंड्रॉइड: लेआउट_ एक्सपोज़र = "wra_content"
एंड्रॉइड: लेआउट_ग्रेविटी = "सेंटर_होर्गेनिक | सेंटर"
Android: textColor = " @android : color / black" />
<बटन Android: id = "@ + id / widget_button"
Android: पाठ = "मुझे क्लिक करें"
Android: Layout_height = "wra_content"
एंड्रॉइड: लेआउट_ एक्सपोज़र = "रैप_ कॉन्टेंट" />
</ LinearLayout >

हम प्रदाता वर्ग (src / ru / example / android / widget / HelloWidget.java) में विजेट के साथ सभी इंटरैक्शन करेंगे। यहाँ सबसे सरल घटना से निपटने की तरह दिखेगा:

सार्वजनिक वर्ग HelloWidget फैली AppWidgetProvider {
सार्वजनिक स्थैतिक स्ट्रिंग ACTION_WIDGET_RECEIVER = "ActionReceiverWidget" ;
@ ओवरराइड
सार्वजनिक शून्य onUpdate ( संदर्भ संदर्भ, AppWidgetManager appWidgetManager, int [ ] appWidgetIds ) {
// नया रिमोट व्यू बनाएं
RemoteViews RemoteViews = नया RemoteViews ( संदर्भ। GetPackageName ( ) , R. लेआउट ; मुख्य ) ;
// ब्रॉडकास्ट के लिए आशय तैयार करें
आशय सक्रिय = नया आशय ( संदर्भ, HelloWidget। वर्ग ) ;
सक्रिय। setAction ( ACTION_WIDGET_RECEIVER ) ;
सक्रिय। putExtra ( "संदेश" , "हैलो हब्रह्रब " ) ;
// हमारी घटना बनाएँ
लंबित क्रिया। लंबित = लंबित। getBroadcast ( संदर्भ, 0 , सक्रिय, 0 ) ;
// हमारे कार्यक्रम को पंजीकृत करें
remoteViews। setOnClickPendingIntent ( R. id । widget_button , actionPendingIntent ) ;
// अपडेट विजेट
appWidgetManager। updateAppWidget ( appWidgetIds, RemoteViews ) ;
}
@ ओवरराइड
सार्वजनिक शून्य onReceive ( संदर्भ प्रसंग, आशय अभिप्राय ) {
// हमारे प्रसारण को पकड़ें, चेक करें और संदेश प्रदर्शित करें
अंतिम स्ट्रिंग कार्रवाई = इरादा। getAction ( ) ;
अगर ( ACTION_WIDGET_RECEIVER। बराबर ( क्रिया ) ) {
स्ट्रिंग संदेश = "अशक्त" ;
कोशिश करो {
संदेश = आशय। getStringExtra ( "संदेश" ) ;
} पकड़ ( NullPointerException e ) {
लॉग इन करें। ई ( "त्रुटि" , "संदेश = अशक्त" ) ;
}
टोस्ट। makeText ( संदर्भ, संदेश, टोस्ट। LENGTH_SHORT ) । शो ( ) ;
}
सुपर । onReceive ( संदर्भ, आशय ) ;
}
}

कक्षा में 2 विधियाँ हैं - onUpdate और onReceive। जब विजेट को अपडेट किया जाता है, तो ऑनपडेट विधि को कहा जाता है। हम अपडेट अपडेट को एंड्रॉइड अपडेटPeriodMillis = "86400000" विशेषता के साथ Res / xml / hello_widget_provider.xml फ़ाइल में सेट करते हैं। OnReceive विधि BroadcastReceiver वर्ग से विरासत में मिली है।
आप किसी भी तत्व को विजेट में, जैसे पाठ, गतिविधि में अद्यतन नहीं कर सकते। संपूर्ण दृश्य पदानुक्रम हमेशा अपडेट किया जाता है। विजेट को अपडेट करने के लिए, हमें दूरस्थ दृश्य वर्ग की आवश्यकता है, जिसके साथ हम दृश्य पदानुक्रम को एक पूरे के रूप में बदल देंगे। दुर्भाग्य से, इस वर्ग की क्षमताएं दुर्लभ हैं। यह हमें पाठ, चित्र और क्लिक पर घटनाओं को बदलने की अनुमति देता है। विजेट में घटना को एक खिंचाव के साथ एक घटना कहा जा सकता है, एपीआई आपको केवल 3 क्रियाएं करने की अनुमति देता है:

प्रसारण फेंक दो
गतिविधि शुरू करें
सेवा का शुभारंभ करें

हमारे मामले में, हम ब्रॉडकास्ट (प्रसारण संदेश) भेजेंगे। परिणाम कुछ सामान्य घटना से निपटने की तरह है। PendingIntent वर्ग का उपयोग करके, हम अपना ईवेंट बनाते हैं और इसे RemoteViews में पंजीकृत करते हैं। फिर हम विजेट को अपडेट करते हैं। और onReceive मेथड में, हम अपने "इवेंट" को पकड़ते हैं और टोस्ट क्लास का उपयोग करके एक संदेश प्रदर्शित करके इसे प्रोसेस करते हैं।

AndroidManifest.xml फ़ाइल में परिवर्तन जोड़ें:

<रिसीवर एंड्रॉइड: नाम = ".widget.HelloWidget" Android: label = "@ string / app_name" >
<आशय-फ़िल्टर >
<Action android: name = "android.appwidget.action.APPWIDGET_UPDATE" />
< Action android: name = "ru.example.android.widget.ACTION_WIDGET_RECEIVER" />
</ आशय-फ़िल्टर >
<मेटा-डेटा Android: नाम = "android.appwidget.provider"
Android: संसाधन = "@ xml / hello_widget_provider" />
</ रिसीवर >

हम परिणाम का संकलन और आनंद लेते हैं।

एंड्रॉइड के लिए हैलो वर्ल्ड विजेट

More articles: