हम क्लाउड के लिए डिवाइस मैसेजिंग (C2DM) के समर्थन के साथ Android के लिए एक आवेदन लिख रहे हैं

हेलो रीडर्स हबरहाब!

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

हालाँकि C2DM Android प्लेटफ़ॉर्म की मूलभूत क्षमताओं में से एक है, लेकिन RuNet में इसके बारे में बहुत कम जानकारी है। इस स्थिति को बदलने का प्रयास इस पद के कार्यों में से एक है।

कट के तहत, मैं आपको सरल क्लाइंट और सर्वर एप्लिकेशन लिखने का तरीका बताऊंगा, कुछ "नुकसान" दिखाऊंगा, और नमूना कोड के लिंक भी दूंगा।

डिवाइस मैसेजिंग को क्लाउड

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

1. C2DM सेवा। संदेश देने के लिए Google का क्लाउड। साथ ही उपकरणों और प्रमाणीकरण का पंजीकरण / पुनः पंजीकरण।
2. ग्राहक भाग। एक एंड्रॉइड एप्लिकेशन जो संदेशों को स्वीकार करता है।
3. सर्वर भाग। एक ग्राहक अनुप्रयोग ("तृतीय पक्ष सर्वर" Google शब्दों में) जो संदेश भेजता है।

संदेश पासिंग प्रक्रिया का विवरण उस लिंक द्वारा लिखा जाता है जिसे मैंने ऊपर उद्धृत किया था, लेकिन संक्षेप में, इसमें निम्नलिखित शामिल हैं:

1. एंड्रॉइड एप्लिकेशन C2DM में पंजीकृत है, जिससे संदेशों को प्राप्त करने की अपनी तत्परता की घोषणा की जाती है, और एक पंजीकरण आईडी प्राप्त होता है। पंजीकरण आईडी डिवाइस का एक विशिष्ट पहचानकर्ता है, जिसे जानकर, सर्वर भाग प्राप्तकर्ता को एक संदेश भेज सकता है। पंजीकरण करते समय, आपको Google खाते का नाम बताना होगा, लेकिन मैं इस बारे में बाद में लिखूंगा जब मैं ग्राहक के हिस्से पर विचार करूंगा।
2. एप्लिकेशन सर्वर के पंजीकरण आईडी को प्रसारित करता है ताकि यह पता चले कि किसको संदेश भेजना संभव है।
3. सर्वर भाग को Google सर्वर पर अधिकृत किया जाता है, C2DM में पंजीकरण करते समय एंड्रॉइड एप्लिकेशन के समान खाते का उपयोग करके, और प्रामाणिक टोकन प्राप्त करता है। Google की सेवाओं में प्राधिकरण \ प्रमाणीकरण के बारे में विवरण यहां लिखे गए हैं ।
4. पंजीकरण आईडी और प्रामाणिक टोकन को जानकर, सर्वर Android एप्लिकेशन को एक संदेश भेजता है।

अब आप सीधे विकास पर जा सकते हैं। ग्राहक पक्ष (Android एप्लिकेशन) से शुरू करते हैं।

ग्राहक भाग

C2DM Android का उपयोग करने के लिए, डिवाइस को निम्नलिखित आवश्यकताओं को पूरा करना चाहिए:

1. यह Android 2.2 या उच्चतर संस्करण होना चाहिए। पिछले संस्करणों पर, C2DM समर्थित नहीं है!
2. किसी भी काम करने वाला Google का खाता होना चाहिए। अगर आपके पास Android Market है, तो आपके पास एक है।

यदि सब कुछ किया जाता है, तो आप एप्लिकेशन बनाने के लिए आगे बढ़ सकते हैं। इसके लिए, हम ग्रहण + एंड्रॉइड एसडीके का उपयोग करेंगे। आप TextView पर सबसे सरल "हैलो, वर्ल्ड" बना सकते हैं। मैं एप्लिकेशन बनाने की प्रक्रिया का वर्णन नहीं करूंगा, इसके बारे में बहुत कुछ लिखा गया है, उदाहरण के लिए, यहां या यहां । आपको कुछ इस तरह मिलना चाहिए:


नोट: यदि आपके पास Android 2.2 नहीं है, तो आप एमुलेटर का उपयोग कर सकते हैं, लेकिन आपको मानक SDK प्लेटफ़ॉर्म का उपयोग करने की आवश्यकता नहीं है, लेकिन Google API (API 8 या उच्चतर), क्योंकि मानक एसडीके में Google खातों के लिए कोई समर्थन नहीं है।

एक बार जब आप एप्लिकेशन बना लेते हैं, तो आपको इसे एक विशेष साइट पर पंजीकृत करना होगा, जहां आपको पैकेज का नाम (पैकेज का नाम) निर्दिष्ट करना होगा, और सबसे महत्वपूर्ण बात, Google का मेल खाता, जिसका उपयोग संदेश भेजने के लिए किया जाएगा। यह मेल है जिसे हम क्लाइंट में पंजीकरण के दौरान और सर्वर पर प्रमाणीकरण के दौरान उपयोग करेंगे। एक पुष्टिकरण ईमेल भेजा जाना चाहिए, इस पत्र के बाद निर्दिष्ट खाते का उपयोग C2DM के साथ काम करने के लिए किया जा सकता है।

अगला, हम अपने "हैलो, वर्ल्ड!" एप्लीकेशन को संशोधित करने के लिए आगे बढ़ते हैं। हमें संदेशों को प्राप्त करने के लिए पंजीकरण / डेरेगेजेशन और, निश्चित रूप से, कोड के कार्यान्वयन की आवश्यकता है। यह पहली बार के बाद से खुद को लिखना वास्तव में मुश्किल है सभी बारीकियों को ध्यान में रखना मुश्किल है, इसलिए हम कोड का उपयोग करेंगे, जो उदाहरण के रूप में, Google को ही प्रदान करता है। Svn स्टोरेज से क्लाइंट साइड पर C2DM के साथ काम करने के लिए कक्षाओं का तैयार सेट डाउनलोड करें। और हम उन्हें प्रोजेक्ट में " src \ com \ google \ android \ c2dm " निर्देशिका में जोड़ते हैं । यह इस तरह दिखना चाहिए:


अब हमें अमूर्त वर्ग C2DMBaseReceiver के तरीकों को लागू करने की आवश्यकता है, इसके लिए हम वर्ग C2DMReceiver लिखेंगे, जबकि केवल लॉगिंग कॉल, और इसे मेन के बगल में रखें। C2DMReceiver वर्ग की सामग्री:

1. पैकेज com.home.c2dmtest ;
3. आयात com.google.android.c2dm.C2DMBaseReceiver ;
5. आयात android.app.Notification ;
6. आयात android.app.NotificationManager ;
7. आयात android.app.PendingIntent ;
8. आयात android.content.Context ;
9. आयात android.content.ntent ;
10. import android.util.Log ;
12. सार्वजनिक वर्ग C2DMReceiver का विस्तार C2DMBaseReceiver {
13. सार्वजनिक C2DMReceiver ( ) {
14. सुपर ( "<yourmail> @ gmail.com" ) ;
15. }
17. @ ओवरराइड
18. सार्वजनिक शून्य onRegistered ( संदर्भ प्रसंग, स्ट्रिंग पंजीकरण Id ) {
19. लॉग इन करें। w ( "onRegistered" , registrationId ) ;
20. }
22. @ ओवरराइड
23. सार्वजनिक शून्य onUnregistered ( संदर्भ प्रसंग ) {
24. लॉग इन करें। w ( "onUnregistered" , "" ) ;
25. }
27. @ ओवरराइड
28. सार्वजनिक शून्य onError ( संदर्भ प्रसंग, स्ट्रिंग errorId ) {
29. लॉग इन करें। w ( "onError" , errorId ) ;
30. }
32. @ ओवरराइड
33. संरक्षित शून्य onMessage ( संदर्भ संदर्भ, आशय अभिप्राय ) {
34. लॉग इन करें। डब्ल्यू ( "ऑनमैसेज" , "" ) ;
35. }
36. }

लेकिन आवेदन अभी तक C2DM के साथ काम करने के लिए तैयार नहीं है, क्योंकि आवश्यक अधिकार निर्धारित नहीं हैं और ब्रॉडकास्टसीवर पंजीकृत नहीं है। इसे ठीक करने के लिए, आपको AndroidManifest.xml को संशोधित करने की आवश्यकता है, यह कैसे करें इसे यहां पढ़ा जा सकता है । मेरे उदाहरण के लिए, फ़ाइल इस तरह दिखती है:

1. <? xml संस्करण = "1.0" एन्कोडिंग = "utf-8" ?>
2. <प्रकट xmlns: android = " schemas.android.com/apk/res/android"
3. Android: versionCode = "1"
4. Android: versionName = "1.0" पैकेज = "com.home.c2dmtest" >
5. <आवेदन
6. Android: डीबग करने योग्य = "सत्य"
7. Android: लेबल = "@ स्ट्रिंग / app_name" >
8. <गतिविधि Android: नाम = "मुख्य"
9. Android: लेबल = "@ स्ट्रिंग / app_name"
10. Android: theme = "@android: style / Theme.NoTitleBar" >
11. <आशय-फ़िल्टर >
12. <कार्रवाई Android: नाम = "android.intent.action.MAIN" />
13. <श्रेणी Android: नाम = "android.intent.category.LAUNCHER" />
14. </ आशय-फ़िल्टर >
15. </ गतिविधि >
16. <सेवा Android: name = ".C2DMReceiver" />
17. <रिसीवर
18. Android: name = "com.google.android.c2dm.C2DMBroadcastReceiver"
19. Android: अनुमति = "com.google.android.c2dm.permission.SEND" >
20. <आशय-फ़िल्टर >
21. < Action android: name = "com.google.android.c2dm.intent.RECEIVE" />
22. <श्रेणी Android: नाम = "com.home.c2dmtest" />
23. </ आशय-फ़िल्टर >
24. <आशय-फ़िल्टर >
25. < Action android: name = "com.google.android.c2dm.intent.REGISTRATION" />
26. <श्रेणी Android: नाम = "com.home.c2dmtest" />
27. </ आशय-फ़िल्टर >
28. </ रिसीवर >
29. </ अनुप्रयोग >
30. <उपयोग करता है- sdk Android: minSdkVersion = "8" />
31. <अनुमति
32. Android: name = "com.home.c2dmtest.permission.C2D_MESSAGE"
33. Android: protectionLevel = "हस्ताक्षर" />
34. <उपयोग-अनुमति android: नाम = "com.home.c2dmtest.permission.C2D_MESSAGE" >
35. <उपयोग-अनुमति android: नाम = "com.google.android.c2dm.permission.RECEIVE" />
36. <उपयोग-अनुमति Android: नाम = "android.permission.INTERNET" />
37. <उपयोग-अनुमति एंड्रॉइड: नाम = "android.permission.WAKE_LOCK" />
38. </ प्रकटीकरण >

नोट: C2DM का उपयोग करने के लिए सही android.permission.WAKE_LOCK की आवश्यकता नहीं है, लेकिन हमें बाद में इसकी आवश्यकता होगी, और इस फाइल को दो बार सूचीबद्ध नहीं करने के लिए, मैंने इसे अग्रिम में जोड़ने का फैसला किया।

अब आप C2DM में डिवाइस को पंजीकृत कर सकते हैं, इसके लिए हम OnCreate में निम्नलिखित कोड कहते हैं:

C2DMessaging। रजिस्टर ( यह , "<yourmail> @ gmail.com" ) ;

यदि सब कुछ ठीक रहा, तो कुछ सेकंड के बाद एक नई पुनर्संरचना आईडी C2DMReceiver वर्ग के ऑनरजिस्टर्ड विधि में आ जाएगी। यदि ऐसा नहीं होता है, तो आपको त्रुटियों के लिए लॉगकट के लॉग को देखने की आवश्यकता है।

आप विधि को कॉल करके अपंजीकृत कर सकते हैं:

C2DMessaging। अपंजीकृत ( यह ) ;

वर्तमान पंजीकरण आईडी प्राप्त करें:

स्ट्रिंग आईडी = C2DMessaging। getRegademyId ( यह ) ;

पंजीकरण आईडी किसी भी सेकंड में बदल सकती है, अर्थात Google इसे एक नया अर्थ भेज सकता है, और इसलिए, इस स्थिति को संभालने में सक्षम होने की आवश्यकता है। हमारे उदाहरण में, इसके लिए सब कुछ पहले से ही किया गया है, इस तंत्र का कार्यान्वयन वर्ग C2DMBaseReceiver पद्धति में संभालता है।

अंतिम परियोजना इस प्रकार है:


अब हमें अपनी परियोजना को अधिक दृश्य बनाने की जरूरत है, संदेशों के प्रसंस्करण का विस्तार करें। जब कोई नया संदेश आता है, तो अधिसूचना दिखाई देती है, और जब इसे चुना जाता है, तो हमारा आवेदन सर्वर द्वारा निर्दिष्ट पाठ के साथ शुरू होगा।

ठीक है, इसके लिए हम onMessage कोड को इस प्रकार संशोधित करते हैं:

1. @ ओवरराइड
2. संरक्षित शून्य onMessage ( संदर्भ, आशय प्राप्त )
3. {
4. स्ट्रिंग डेटा = ReceIntent। getStringExtra ( "संदेश" ) ;
5. अगर ( डेटा ! = null )
6. {
7. लॉग इन करें। w ( "C2DMReceiver" , डेटा ) ;
9. आशय अभिप्राय = नया आशय ( यह , मुख्य वर्ग ) ;
10. आशय। putExtra ( "संदेश" , डेटा ) ;
12. सूचना प्रबंधन प्रबंधक = ( अधिसूचना प्रबंधक )
13. getSystemService ( संदर्भ । NOTIFICATION_SERVICE ) ;
14. अधिसूचना अधिसूचना = नया अधिसूचना ( android। आर । ड्राएबल । Ic_dialog_info )
15. "माय सी 2 डीएम संदेश" , सिस्टम । currentTimeMillis ( ) ) ;
16. अधिसूचना। setLatestEventInfo ( संदर्भ, "ऐप नाम" , "C2DM अधिसूचना" ,
17. PendingIntent। getActivity ( यह । getBaseContext ( ) , 0 ,
18. आशय, लंबित। FLAG_CANCEL_CURRENT ) ) ;
19. mManager। सूचित करें ( 0 , अधिसूचना ) ;
20. }
21. }

संदेश उस संदेश का पहचानकर्ता है जो सर्वर भेजता है। हम इसे नए आशय में जोड़ देंगे, ताकि बाद में हम इसे मेन में प्राप्त करें।

प्रेषित संदेश प्रदर्शित करने के लिए मुख्य को संशोधित करें:

1. @ ओवरराइड
2. सार्वजनिक शून्य onCreate ( बंडल सहेजा गया
3. सुपर । onCreate ( saveInstanceState ) ;
5. TextView देखें = नया TextView ( यह ) ;
7. स्ट्रिंग संदेश = getIntent ( ) । getStringExtra ( "संदेश" ) ;
8. अगर ( संदेश == अशक्त )
9. देखने। सेटटेक्स्ट ( "हैलो, वर्ल्ड !!!" ) ;
10. अन्यथा
11. देखने। setText ( "आपका संदेश:" + संदेश ) ;
13. setContentView ( देखें ) ;
15. स्ट्रिंग आईडी = C2DMessaging। getRegademyId ( यह ) ;
16. अगर ( आईडी == "" )
17. {
18. C2DMessaging। रजिस्टर ( यह , "<yourmail> @ gmail.com" ) ;
19. }
20. }

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

सर्वर साइड

पहला कदम प्रामाणिक टोकन प्राप्त करना है। यह इस ब्लॉग पर अच्छी तरह से लिखा गया है (अन्य उपयोगी जानकारी भी है)। सामान्य तौर पर, एक उदाहरण है, सब कुछ रूसी में है, इसलिए हम इसे दोहराएंगे नहीं और हम मान लेंगे कि हमने इसे प्राप्त किया।

तो हमारे पास Registration ID और Auth टोकन है। छोटे के लिए मामला, आपको एक संदेश देना होगा। किसी कारण से, यह इंटरनेट के इस हिस्से के बारे में बहुत कम जानकारी है, हालांकि यहां कुछ भी जटिल नहीं है।

हमें Google सर्वर के साथ एक संबंध स्थापित करने की आवश्यकता है, सही प्रारूप में अनुरोध करें। और वह सब है। एक संदेश भेजने का एक सरल उदाहरण निम्नलिखित कोड में दिया गया है:

1. सार्वजनिक बूलियन sendData (
2. स्ट्रिंग ऑक्टोकेन,
3. स्ट्रिंग पंजीकरण,
4. स्ट्रिंग पतन,
5. स्ट्रिंग कुंजी,
6. स्ट्रिंग मूल्य )
7. IOException { फेंकता है
9. // पंजीकरण आईडी सेट करें
10. StringBuilder postDataBuilder = नया StringBuilder ( ) ;
11. postDataBuilder। append ( "registration_id" ) ।
12. append ( "=" ) । परिशिष्ट ( पंजीकरण ) ;
14. // सेट पतन_की - समूह संदेश यदि पतन कुंजी समान है, और
15. // डिवाइस, उदाहरण के लिए, बंद कर दिया गया है, केवल एक संदेश भेजा जाएगा,
16. // लेकिन सभी एक बार में नहीं।
17. postDataBuilder। परिशिष्ट ( "और" ) । परिशिष्ट ( "पतन_की" ) । append ( "=" ) ।
18. उपांग ( पतन ) ;
20. // प्रेषित तिथि, प्रारूप <data।> <Key> = <value> में जोड़ें
21. postDataBuilder। परिशिष्ट ( "और" ) । append ( "डेटा।" + कुंजी ) । append ( "=" ) ।
22. append ( URLEncoder । सांकेतिक शब्दों में बदलना ( मूल्य, "UTF-8" ) ) ;
24. बाइट [ ] पोस्टडेटा = पोस्टडैटाबुर्टल। .String ( ) getBytes ( "UTF-8" ) ;
26. URL url = नया URL ( " android.clients.google.com/c2dm/send" ) ;
28. // कनेक्शन सेट करें
29. // प्रॉक्सी प्रॉक्सी = नया प्रॉक्सी (Proxy.Type.HTTP, नया InetSocketAddress ("lazerboy.local", 8080));
30. HttpsURLConnection कॉन = ( HttpsURLConnection ) url। openConnection ( / * प्रॉक्सी * / ) ;
31. Conn। setDoOutput ( सच ) ;
32. Conn। setHostnameVerifier ( यह नया MyHostnameVerifier ( ) ) ;
33. Conn। setRequestMethod ( "POST" ) ;
34. Conn। setRequestProperty ( "सामग्री-प्रकार" )
35. "आवेदन / x-www-form-urlencoded; चारसेट = UTF-8" ) ;
36. Conn। setRequestProperty ( "सामग्री-लंबाई" , पूर्णांक । स्ट्रिंग ( पोस्टडेटा। लंबाई ) ) ;
37. Conn। setRequestProperty ( "प्राधिकरण" , "GoogleLogin Ord =" + AndorToken ) ;
39. आउटपुटस्ट्रीम आउट = कॉन। getOutputStream ( ) ;
40. बाहर। लिखना ( पोस्टडेटा ) ;
41. बाहर। करीब ( ) ;
43. // प्रतिक्रिया कोड प्राप्त करें।
44. int responseCode = कॉन। getResponseCode ( ) ;
46. if ( responseCode == HttpServletResponse। SC_UNAUTHORIZED ||
47. responseCode == HttpServletResponse। SC_FORBIDDEN ) {
48. प्रणाली। बाहर । प्रिंटफ ( "अनधिकृत - टोकन की आवश्यकता है" ) ;
49. झूठे लौटना ;
50. }
51. अगर ( responseCode == HttpServletResponse। SC_OK )
52. {
53. प्रणाली। बाहर । प्रिंटफ ( "डेटा डिवाइस को भेजा गया!" ) ;
54. सच लौटना ;
55. }
57. प्रणाली। बाहर । प्रिंटफ ( "कुछ गलत, प्रतिक्रिया संदेश:" , कॉन। getResponseMessage ( ) ) ;
59. झूठे लौटना ;
60. }

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

यदि कोड सफलतापूर्वक काम करता है, तो उपयोगकर्ता हमारे अधिसूचना को अपने डिवाइस पर सूचना क्षेत्र में देखेगा, और यदि वह उस पर क्लिक करता है, तो हमारा आवेदन सर्वर से पाठ के साथ शुरू होगा। हुर्रे, यह वास्तव में हमने क्या हासिल किया है।

निष्कर्ष

मैंने दिखाया कि आप बहुत सिरदर्द के बिना एंड्रॉइड-आधारित एप्लिकेशन को C2DM समर्थन को कैसे तेज कर सकते हैं। इसके लिए क्लाइंट पक्ष और सर्वर साइड, दोनों के लिए क्या करना होगा। बेशक, "सफेद धब्बे" थे, लेकिन मैं दोहराता हूं, मुख्य कार्य विचारों को व्यक्त करना और कोड उदाहरण दिखाना था ताकि इस पोस्ट को पढ़ने वाले लोगों के लिए C2DM समर्थन के साथ एप्लिकेशन विकसित करना शुरू करना आसान हो सके।

उपयोगी लिंक

1. डिवाइस मेसेजिंग के लिए एंड्रॉइड क्लाउड
2. वह स्थान जहां आपको C2DM का उपयोग करने के लिए खाता पंजीकृत करने की आवश्यकता होती है
3. C2DM और Android पर रूसी भाषा का ब्लॉग
4. गूगल से नमूना
5. विषय पर एक और ब्लॉग
6. C2DM उपयोग उदाहरण