بسم اهلل الرحمن الرحیم

Transcription

1 بسم اهلل الرحمن الرحیم آموزشگاه تحلیل داده تخصصی ترین مرکز برنامه نویسی و دیتابیس در ایران آموزش دریافت پیام از سرویسهای Cloud آندروید در مدرس : مهندس افشین رفوآ

2 آموزش دریافت پیام از سرویسهای Cloud در آندروید این فصل روش نشاندن )push( اطالعات از یک سرور به دستگاه گوگل را برای شما تشریح می کند. فهرست محتوا.1 messaging Cloud to device )پیام رسانی از cloud به دستگاه( Polling )ممیزی یا نظارت( در مقابل push )نشاندن( Cloud service )رایانش ابری( ابزار الزم برای استفاده از C2DM مجوزهای الزم برای استفاده از C2DM intent receiver. 2 مراحل پیاده سازی ثبت سرور برنامه registration( )application server دریافت شناسه ی ثبت ID( )registration برای برنامه ی موبایل ثبت و تخصیص گیرنده برای پیام های C2DM ارسال پیام. 3 ثبت و دستگاه 4. آموزش ایجاد برنامه هایی که قابلیت C2DM در برنامه فعال سازی شده باشد طرح بندی و پروژه ایجاد receiver ها و activity ها ثبت برنامه 5. آموزش استفاده از ابزار خط فرمان Curl برای شبیه سازی سرور

3 6. آموزش ایجاد برنامه ی سرور.1 messaging Cloud to device )پیام رسانی از cloud به دستگاه( Polling )ممیزی یا نظارت( در مقابل push )نشاندن( بیشتر برنامه های موبایل ملزم به دانلود و دریافت داده از اینترنت هستند. یکی از روش های بروز رسانی اطالعات برنامه ی مورد نظر polling )نظارت( است که طی آن برنامه های موبایل در فواصل معین سرور را برای اطالعات جدید بررسی می کند. در صورت نبود داده های مورد نیاز استفاده از این روش پهنای باند شبکه و باتری موبایل را بی هیچ دلیل معینی مصرف کرده است. روش دیگری که می توان از آن بهره برد این است که خود سرویس دهنده یا سرور به محض اینکه داده های جدید عرضه شد با دستگاه موبایل ارتباط برقرار کرده وآن را از وجود اطالعات جدید مطلع کند. به این فرایند push )نشاندن( می گویند. چنانچه اطالعات یا داده ها به طور مداوم تغییر نمی کنند Push روش ارجح تلقی می گردد. Cloud service )رایانش ابری( شما می توانید از طریق Google Play services اطالعیه ها )notification( ها را در برنامه یا اپلیکیشن خود بنشانید. برای این منظور باید Google Cloud Messaging for Android را در Google API Console فعال سازی کنید. در C2DM سه گروه مختلف شرکت دارند. سرور برنامه server( )app که پیام ها را به دستگاه اندروید ارائه داده و یا پیام های نام برده را در آن می نشاند سرورهای C2DM گوگل و دیگری برنامه ی اندروید. برنامه ی موجود در سرور برنامه ممکن است به هر زبان برنامه نویسی نوشته شده باید مانند Java Python و.PHP زمانی که سرور برنامه پیامی را به اپلیکیشن مربوطه اندروید ارائه می دهد )push( در واقع پیام ذکر شده را از طریق HTTP POST به سرورهای C2DM گوگل ارسال می کند.

4 سرورهای C2DM پیام مورد نظر را به دستگاه می فرستند. اگر دستگاه به اینترنت وصل نباشد پیام مربوطه زمانی که دستگاه آنالین شد به آن تحویل داده می شود. پس از اینکه پیغام توسط دستگاه مورد نظر دریافت گردید گیرنده ی )intent receiver( intent ایجاد می گردد. برنامه ی موبایل یک intent receiver ویژه ی این Broadcast ثبت می کند. در مرحله ی بعد برنامه اجرا شده و پیغام مربوطه توسط Intent Receiver پردازش می شود. حجم پیام های C2DM محدود به 1024 بایت می باشد و وظیفه ی آن ها تنها اطالع دادن به دستگاه است و نه انتقال داده ها. )workflow( گردش کار متداول این است که خود سرورهای C2DM گوگل به اپلیکیشن اطالع می دهند که اطالعات جدیدی ویژه ی آن برنامه عرضه شده است. سپس اپلیکیشن اندروید داده ها را از سرور دیگری واکشی می کند. دستگاه های اندروید با سرور Android play مداوم ارتباط دارند. C2DM از این ارتباط یا اتصال موجود با سرورهای گوگل استفاده می کند. این اتصال به گونه ای بهینه سازی شده است که مصرف پهنای باند و باتری به کمترین حالت ممکن برسد. هم اکنون در مرحله ی آزمون بتا به سر می برد برای استفاده از آن باید درخواست بدهید. البته C2DM C2DM روزانه اجازه ی ارسال تنها پیام به ازای هر فرستنده را می دهد و در حال حاضر خدمت رسانی آن رایگان می باشد. C2DM ابزار الزم برای استفاده از C2MD برای نخستین بار در اندروید 2.2 در دسترس قرار گرفت و الزمه ی استفاده از آن نصب برنامه ی Android Play بر روی دستگاه می باشد. جهت استفاده از C2MD بر روی شبیه ساز )EMULATOR( باید از یک دستگاه گوگل که API آن حداقل 8 و یا باالتر است بهره گرفته و یک حساب کاربری گوگل نیز از طریق Settings برای خود ایجاد کنید.

5 C2DM مجوزهای الزم برای استفاده از به منظور استفاده از C2DM در برنامه ی خود الزم است مجوزهای ذیل را رجیستر / ثبت کنید. com.google.android.c2dm.permission.receive android.permission.internet برنامه ی شما همچنین باید مجوز ".permission.c2d_message" "applicationpackage + را با "signature" "android:protectionlevel" of اعالن کند تا از این طریق اپلیکیشن های دیگر نتوانند پیام های برنامه ی مربوطه را ثبت و دریافت کنند. android:protectionlevel="signature" ایجاب می کند که برنامه ی درخواست کننده ی مجوز با همان گواهی یا مجوزی )certificate( که برنامه ی اعالن کننده ی مجوز با آن امضاء شده نشان گذاری شده باشد. در غیر این صورت مجوز به آن برنامه داده نخواهد شد. intent receiver برنامه ی شما باید یک گیرنده ی intent برای دو intent زیر ثبت کند. com.google.android.c2dm.intent.registration com.google.android.c2dm.intent.receive ویژه ی "com.google.android.c2dm.intent.receive" به محض دریافت پیغام جدید receiver فراخوانده می شود در حالی که گیرنده ی )مختص(" com.google.android.c2dm.intent.registration " تنها زمانی صدا زده می شود که کد ثبت / code registration برنامه ی مورد نظر دریافت شده باشد.. 2 مراحل پیاده سازی )application server registration( ثبت سرور برنامه سرور برنامه باید خود را برای سرورهای C2DM احراز هویت کند )بشناساند(. با ارسال درخواست HTTP POST به C2DM توکن یا نشانه ی شناسایی امنیتی token( )authentication توسط یک پست الکترونیکی و رمزعبور مشخص می گردد. توکن در برنامه ی سمت سرور server( )app ذخیره گشته سپس از این توکن

6 برای شناسایی برنامه ی تحت سرور server( )app به سرورهای C2DM به مجرد ارسال پیام ها استفاده می شود. مثال با استفاده از کد زیر می توان توکن ایمیل و پسورد ثبت شده را دریافت کرد. package de.vogella.java.c2dm.server.util; import java.io.bufferedreader; import java.io.ioexception; import java.io.inputstreamreader; import java.io.outputstream; import java.net.httpurlconnection; import java.net.url; public class AuthenticationUtil { private AuthenticationUtil() { // Util class cannot get instanziated public static String gettoken(string String password) throws IOException { // create the post data // Requires a field with the and the password StringBuilder builder = new StringBuilder(); builder.append(" =").append( ); builder.append("&passwd=").append(password); builder.append("&accounttype=google"); builder.append("&source=mylittleexample"); builder.append("&service=ac2dm"); // Setup the Http Post byte[] data = builder.tostring().getbytes(); URL url = new

7 URL(" HttpURLConnection con = (HttpURLConnection) url.openconnection(); con.setusecaches(false); con.setdooutput(true); con.setrequestmethod("post"); con.setrequestproperty("content-type" "application/x-www-form-urlencoded"); con.setrequestproperty("content-length" Integer.toString(data.length)); // Issue the HTTP POST request OutputStream output = con.getoutputstream(); output.write(data); output.close(); // read the response BufferedReader reader = new BufferedReader(new InputStreamReader(con.getInputStream())); String line = null; String auth_key = null; while ((line = reader.readline())!= null) { if (line.startswith("auth=")) { auth_key = line.substring(5); // Finally get the authentication token // To something useful with it return auth_key; توکن به طور متناوب بازسازی می شود.

8 مثال فوق با زبان برنامه نویسی جاوا نوشته شده است. می توان توکن را با استفاده از دیگر ابزار http یا زبان های برنامه نویسی دریافت کرد. برای مثال می توان با استفاده از ابزار خط فرمان )= curl یک ابزار خط فرمان که به منظور ارسال و دریافت فایل ها به وسیله ی ترکیب نحوی URL مورد استفاده قرار می گیرد( سرور را شبیه سازی کرد. دریافت شناسه ی ثبت ID( )registration برای برنامه ی موبایل به منظور رجیستر کردن برنامه ی اندروید برای بهره گرفتن از خدمت رسانی C2DM یک registration intent "com.google.android.c2dm.intent.register". اجرا )fire( کنید. این کار با راه اندازی یک سرویس در نهایت registration را به سرورهای C2DM ارسال می کند. "sender" نام برده دربردارنده ی یک extra با کلید و آدرس ایمیل است که در ابتدای امر برای Intent "app" extra Pendingintent ثبت شده بود. intent این همچنین باید حامل یک با باشد. سرویس C2DM "sender" درباره ی برنامه ی جاری اطالعاتی را به سیستم اندروید ارائه می دهد. مقدار برای PendingIntent آدرس ایمیلی است که تحت آن C2DM message service خود را رجیستر کردید. در مثال زیر را با ایمیل خود جایگزین کنید. public void register(view view) { Intent intent = new Intent("com.google.android.c2dm.intent.REGISTER"); intent.putextra("app" PendingIntent.getBroadcast(this 0 new Intent() 0)); intent.putextra("sender" "youruser@gmail.com"); startservice(intent); intent سرویس به طور ناهمگام با Google رجیستر )ثبت( شده و در صورت موفقیت عملیات ثبت را ارسال می کند. اپلیکیشن شما باید یک "com.google.android.c2dm.intent.registration"

9 Broadcast receiver ویژه ی intent مذکور ثبت کند )یک broadcast receiver به آن تخصیص دهد(. برای این امر نیز به یک مجوز مبتنی بر پکیج نیاز است زیرا که سیستم اندروید آن را از داخل بررسی می کند. package de.vogella.android.c2dm.simpleclient; import android.content.broadcastreceiver; import android.content.context; import android.content.intent; import android.util.log; public class C2DMRegistrationReceiver extends BroadcastReceiver public void onreceive(context context Intent intent) { String action = intent.getaction(); Log.w("C2DM" "Registration Receiver called"); if ("com.google.android.c2dm.intent.registration".equals(action)) { Log.w("C2DM" "Received registration ID"); final String registrationid = intent.getstringextra("registration_id"); String error = intent.getstringextra("error"); Log.d("C2DM" "dmcontrol: registrationid = " + registrationid + " error = " + error); // TODO Send this to my application server فایل AndroidManifest.xml آن به ترتیب زیر است. در صورت استفاده از پکیج دیگر باید کدنویسی را متناسب آن پکیج اصالح کنید.

10 <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android=" package="de.vogella.android.c2dm.simpleclient" android:versioncode="1" android:versionname="1.0"> <uses-sdk android:minsdkversion="8" /> <permission android:name="de.vogella.android.c2dm.simpleclient.permission.c2d_message" android:protectionlevel="signature" /> <uses-permission android:name="de.vogella.android.c2dm.simpleclient.permission.c2d_message" /> <uses-permission android:name="com.google.android.c2dm.permission.receive" /> <uses-permission android:name="android.permission.internet" /> <application <activity android:name=".c2dmclientactivity"> <intent-filter> <action android:name="android.intent.action.main" /> <category android:name="android.intent.category.launcher" /> </intent-filter> </activity> <receiver android:name=".c2dmregistrationreceiver" android:permission="com.google.android.c2dm.permission.send"> <intent-filter> <action android:name="com.google.android.c2dm.intent.registration"> </action> <category android:name="de.vogella.android.c2dm.simpleclient" /> </intent-filter> </receiver>

11 </application> </manifest> اینتنت "com.google.android.c2dm.intent.registration" حاوی یک شناسه ی ثبت ( registration )ID است. هر شناسه ی ثبت نشان دهنده ی دستگاه معینی است به عنوان مثال هر گوشی اندرویدی کد ثبت مختص به خود را دریافت می کند. C2DM ممکن است این شناسه ی ثبت را در بازه هایی معین بازسازی )refresh( کند اما تا یک بازسازی دیگر برنامه ی مورد نظر باید این شناسه را برای استفاده در آینده ذخیره کند. پس از اینکه برنامه ی اندروید شناسه ی ثبت را دریافت کرد باید این اطالعات دریافتی را به سرور برنامه ارسال کند. سرور برنامه می تواند از شناسه ی ثبت استفاده کرده و از طریق سرورهای C2DM به دستگاه پیام ارسال کند. به عنوان مثال کد زیر deviceid و registrationid را به یک سرور ارسال می کند. // Better do this in an asynchronous thread public void sendregistrationidtoserver(string deviceid String registrationid) { Log.d("C2DM" "Sending registration ID to my application server"); HttpClient client = new DefaultHttpClient(); HttpPost post = new HttpPost(" try { List<NameValuePair> namevaluepairs = new ArrayList<NameValuePair>(1); // Get the deviceid namevaluepairs.add(new BasicNameValuePair("deviceid"

12 deviceid)); namevaluepairs.add(new BasicNameValuePair("registrationid" registrationid)); post.setentity(new UrlEncodedFormEntity(nameValuePairs)); HttpResponse response = client.execute(post); BufferedReader rd = new BufferedReader(new InputStreamReader(response.getEntity().getContent())); String line = ""; while ((line = rd.readline())!= null) { Log.e("HttpResponse" line); catch (IOException e) { e.printstacktrace(); سرور شناسه ی ثبت را ماندگار می سازد. C2DM ثبت و تخصیص گیرنده برای پیام های )message receiver( درست مشابه تخصیص یک registration receiver شما باید یک گیرنده ی پیغام پیکربندی و تنظیم کنید. این می تواند دقیق همان registration receiver باشد یا یک گیرنده ی به طور کامل متفاوت باشد. نمونه ی زیر مثالی از یک گیرنده ی پیغام مجزا می دهد. package de.vogella.android.c2dm.simpleclient; import android.content.broadcastreceiver; import android.content.context; import android.content.intent; import android.util.log;

13 public class C2DMMessageReceiver extends BroadcastReceiver public void onreceive(context context Intent intent) { String action = intent.getaction(); Log.w("C2DM" "Message Receiver called"); { if ("com.google.android.c2dm.intent.receive".equals(action)) Log.w("C2DM" "Received message"); final String payload = intent.getstringextra("payload"); Log.d("C2DM" "dmcontrol: payload = " + payload); // Send this to my application server receiver( )message خود را در فایل AndroidManifest.xml ثبت عالوه بر آن کنید. الزم است گیرنده ی پیغام <receiver android:name=".c2dmmessagereceiver" android:permission="com.google.android.c2dm.permission.send"> <intent-filter> <action android:name="com.google.android.c2dm.intent.receive"></action> <category android:name="de.vogella.android.c2dm.simpleclient" /> </intent-filter> </receiver>

14 ارسال پیام در این مرحله سرور برنامه و اپلیکیشن اندروید هر دو آماده ی استفاده از C2DM هستند. سرور توکن امنیتی token( )authentication و شناسه ی ثبت برنامه ی مورد نظر را داشته و اپلیکیشن موبایل نیز یک Broadcast receiver ویژه ی دریافت پیغام ها ثبت کرده است. جهت ارسال یک پیغام به دستگاه سرور اپلیکیشن یک درخواست HTTP POST به سرورهای C2DM گوگل ارسال می کند. این درخواست HTTP GET حاوی شناسه ی ثبت ویژه ی این دستگاه و توکن امنیتی است )برای اینکه به گوگل اطالع دهد که این سرور مجوز ارسال پیغام را دارد(. package de.vogella.java.c2dm.server.util; import java.io.ioexception; import java.io.outputstream; import java.net.url; import java.net.urlencoder; import javax.net.ssl.hostnameverifier; import javax.net.ssl.httpsurlconnection; import javax.net.ssl.sslsession; public class MessageUtil { private final static String AUTH = "authentication"; private static final String UPDATE_CLIENT_AUTH = "Update- Client-Auth"; public static final String PARAM_REGISTRATION_ID = "registration_id"; public static final String PARAM_DELAY_WHILE_IDLE = "delay_while_idle"; public static final String PARAM_COLLAPSE_KEY = "collapse_key"; private static final String UTF8 = "UTF-8"; public static int sendmessage(string auth_token String

15 registrationid String message) throws IOException { StringBuilder postdatabuilder = new StringBuilder(); postdatabuilder.append(param_registration_id).append("=").append(registrationid); postdatabuilder.append("&").append(param_collapse_key).append("= ").append("0"); postdatabuilder.append("&").append("data.payload").append("=").append(urlencoder.encode(message UTF8)); byte[] postdata = postdatabuilder.tostring().getbytes(utf8); // Hit the dm URL. URL url = new URL(" HttpsURLConnection.setDefaultHostnameVerifier(new CustomizedHostnameVerifier()); HttpsURLConnection conn = (HttpsURLConnection) url.openconnection(); conn.setdooutput(true); conn.setusecaches(false); conn.setrequestmethod("post"); conn.setrequestproperty("content-type" "application/x-www-form-urlencoded;charset=utf-8"); conn.setrequestproperty("content-length" Integer.toString(postData.length)); conn.setrequestproperty("authorization" "GoogleLogin auth=" + auth_token);

16 OutputStream out = conn.getoutputstream(); out.write(postdata); out.close(); int responsecode = conn.getresponsecode(); return responsecode; private static class CustomizedHostnameVerifier implements HostnameVerifier { public boolean verify(string hostname SSLSession session) { return true; پس از اینکه سرور پیغام ها را به سرور C2DM فرستاد سرویس دهنده پیام ها را صف بندی کرده و به محض در دسترس بودن دستگاه آن ها را برای شما نمایش می دهد. پیام مذکور به عنوان یک broadcast به broadcast دستگاه مربوط ارسال می گردد. برنامه ی شما باید برای این رخداد ثبت نام کرده تا پیام را دریافت کند. broadcast پیغام دریافت شده به receiver ثبت شده برای "com.google.android.c2dm.intent.receive". ارسال می گردد. داده ها را می توان از intent به وسیله ی تابع getextras() دریافت کرد. کلیدهای موجود نیز عبارتند از "payload"."collapse_key" "from" داده ی واقعی داخل "payload" گنجانده شده است. گیرنده / receiver خود قادر است این اطالعات را استخراج کرده و به آن واکنش نشان دهد.. 3 ثبت و دستگاه

17 در حال حاضر C2DM در مرحله ی آزمایشی بتا به سر می برد. برای دسترسی و استفاده از آن باید درخواست دهید. با مراجعه به این لینک می توانید برای استفاده از آن ثبت نام کنید : form.link to the signup اگر مثال زیر را روی شبیه ساز تست می کنید باید توجه داشته باشید که API گوگل آن نسخه ی 8 یا باالتر باشد. همچنین باید یک کاربر گوگل در محیط شبیه ساز ثبت کنید. این کار را می توان با مراجعه به Settings Accounts Sync این انجام داد. در صورت امتحان کردن این مثال روی دستگاه واقعی اندروید باید از نصب Android Market بر روی دستگاه اطمینان کسب کنید. 4. آموزش ایجاد برنامه هایی که قابلیت C2DM در برنامه فعال سازی شده باشد. طرح بندی و پروژه "C2DMClientActivity" پروژه ی اندروید "de.vogella.android.c2dm.simpleclient" را ایجاد کنید. طرح کلی )layout( main.xml را ایجاد کنید. همراه با اکتیویتی <?xml version="1.0" encoding="utf-8"?> <linearlayout xmlns:android=" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical"> <button android:layout_width="wrap_content" android:layout_height="wrap_content" android:onclick="register" android:text="register"></button> <button android:layout_width="wrap_content" android:layout_height="wrap_content" android:onclick="showregistrationid" android:text="show"></button> </linearlayout>

18 همچنین طرح کلی "activity_result.xml" را ایجاد کنید از این layout در result activity های خود استفاده می کنیم. <?xml version="1.0" encoding="utf-8"?> <linearlayout xmlns:android=" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical"> <textview android:layout_width="match_parent" android:layout_height="match_parent" android:layout_gravity="center" android:text="no info." android:textappearance="?android:attr/textappearancelarge"> </textview> </linearlayout> ایجاد receiver ها و activity ها اکنون کالس های "C2DMReceiverReceiver" و "C2DMMessageReceiver" را بسازید این دو کالس را بعد به عنوان گیرنده برای registration intent و message intent ثبت می کنیم. package de.vogella.android.c2dm.simpleclient; import java.io.bufferedreader; import java.io.ioexception; import java.io.inputstreamreader; import java.util.arraylist; import java.util.list; import org.apache.http.httpresponse; import org.apache.http.namevaluepair; import org.apache.http.client.httpclient; import org.apache.http.client.entity.urlencodedformentity;

19 import org.apache.http.client.methods.httppost; import org.apache.http.impl.client.defaulthttpclient; import org.apache.http.message.basicnamevaluepair; import android.app.notification; import android.app.notificationmanager; import android.app.pendingintent; import android.content.broadcastreceiver; import android.content.context; import android.content.intent; import android.content.sharedpreferences; import android.content.sharedpreferences.editor; import android.preference.preferencemanager; import android.provider.settings.secure; import android.util.log; public class C2DMRegistrationReceiver extends BroadcastReceiver public void onreceive(context context Intent intent) { String action = intent.getaction(); Log.w("C2DM" "Registration Receiver called"); if ("com.google.android.c2dm.intent.registration".equals(action)) { Log.w("C2DM" "Received registration ID"); final String registrationid = intent.getstringextra("registration_id"); String error = intent.getstringextra("error"); Log.d("C2DM" "dmcontrol: registrationid = " + registrationid + " error = " + error); String deviceid =

20 Secure.getString(context.getContentResolver() Secure.ANDROID_ID); createnotification(context registrationid); sendregistrationidtoserver(deviceid registrationid); later // Also save it in the preference to be able to show it saveregistrationid(context registrationid); private void saveregistrationid(context context String registrationid) { SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(context); Editor edit = prefs.edit(); edit.putstring(c2dmclientactivity.auth registrationid); edit.commit(); public void createnotification(context context String registrationid) { NotificationManager notificationmanager = (NotificationManager) context.getsystemservice(context.notification_service); Notification notification = new Notification(R.drawable.icon "Registration successful" System.currentTimeMillis()); // hide the notification after its selected notification.flags = Notification.FLAG_AUTO_CANCEL;

21 Intent intent = new Intent(context RegistrationResultActivity.class); intent.putextra("registration_id" registrationid); PendingIntent pendingintent = PendingIntent.getActivity(context 0 intent 0); notification.setlatesteventinfo(context "Registration" "Successfully registered" pendingintent); notificationmanager.notify(0 notification); // incorrect usage as the receiver may be canceled at any time // do this in an service and in an own thread public void sendregistrationidtoserver(string deviceid { String registrationid) Log.d("C2DM" "Sending registration ID to my application server"); HttpClient client = new DefaultHttpClient(); HttpPost post = new HttpPost(" try { List<NameValuePair> namevaluepairs = new ArrayList<NameValuePair>(1); // Get the deviceid namevaluepairs.add(new BasicNameValuePair("deviceid" deviceid)); namevaluepairs.add(new BasicNameValuePair("registrationid" registrationid));

22 post.setentity(new UrlEncodedFormEntity(nameValuePairs)); HttpResponse response = client.execute(post); BufferedReader rd = new BufferedReader(new InputStreamReader(response.getEntity().getContent())); String line = ""; while ((line = rd.readline())!= null) { Log.e("HttpResponse" line); catch (IOException e) { e.printstacktrace(); package de.vogella.android.c2dm.simpleclient; import android.app.notification; import android.app.notificationmanager; import android.app.pendingintent; import android.content.broadcastreceiver; import android.content.context; import android.content.intent; import android.util.log; public class C2DMMessageReceiver extends BroadcastReceiver public void onreceive(context context Intent intent) { String action = intent.getaction(); Log.w("C2DM" "Message Receiver called"); { if ("com.google.android.c2dm.intent.receive".equals(action)) Log.w("C2DM" "Received message");

23 final String payload = intent.getstringextra("payload"); Log.d("C2DM" "dmcontrol: payload = " + payload); // TODO Send this to my application server to get the real data // Lets make something visible to show that we received the message createnotification(context payload); public void createnotification(context context String payload) { NotificationManager notificationmanager = (NotificationManager) context.getsystemservice(context.notification_service); Notification notification = new Notification(R.drawable.icon "Message received" System.currentTimeMillis()); // hide the notification after its selected notification.flags = Notification.FLAG_AUTO_CANCEL; Intent intent = new Intent(context MessageReceivedActivity.class); intent.putextra("payload" payload); PendingIntent pendingintent = PendingIntent.getActivity(context 0 intent PendingIntent.FLAG_CANCEL_CURRENT); notification.setlatesteventinfo(context "Message" "New message received" pendingintent); notificationmanager.notify(0 notification);

24 همچنین دو activity زیر را ایجاد کنید که در مراحل بعدی جهت مشاهده ی نتایج از آن ها استفاده می کنیم. package de.vogella.android.c2dm.simpleclient; import android.app.activity; import android.os.bundle; import android.widget.textview; public class RegistrationResultActivity extends Activity protected void oncreate(bundle savedinstancestate) { setcontentview(r.layout.activity_result); Bundle extras = getintent().getextras(); if (extras!= null) { String registrationid = extras.getstring("registration_id"); if (registrationid!= null && registrationid.length() > 0) { TextView view = (TextView) findviewbyid(r.id.result); view.settext(registrationid); super.oncreate(savedinstancestate); package de.vogella.android.c2dm.simpleclient; import android.app.activity; import android.os.bundle; import android.widget.textview; public class MessageReceivedActivity extends Activity {

25 @Override protected void oncreate(bundle savedinstancestate) { setcontentview(r.layout.activity_result); Bundle extras = getintent().getextras(); if (extras!= null) { String message = extras.getstring("payload"); if (message!= null && message.length() > 0) { TextView view = (TextView) findviewbyid(r.id.result); view.settext(message); super.oncreate(savedinstancestate); Activity Intent Receiver حال فایل AndroidManifest.xml زیر را ایجاد کنید. فایل گفته شده ها ها درخواست ها و مجوزهای الزم را به ثبت می رساند. <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android=" package="de.vogella.android.c2dm.simpleclient" android:versioncode="1" android:versionname="1.0"> <uses-sdk android:minsdkversion="8" /> <permission android:name="de.vogella.android.c2dm.simpleclient.permission.c2d_message" android:protectionlevel="signature" /> <uses-permission android:name="de.vogella.android.c2dm.simpleclient.permission.c2d_message" /> <uses-permission android:name="com.google.android.c2dm.permission.receive" /> <uses-permission android:name="android.permission.internet" /> <application android:icon="@drawable/icon" android:label="@string/app_name">

26 <activity android:name=".c2dmclientactivity"> <intent-filter> <action android:name="android.intent.action.main" /> <category android:name="android.intent.category.launcher" /> </intent-filter> </activity> <receiver android:name=".c2dmregistrationreceiver" android:permission="com.google.android.c2dm.permission.send"> <intent-filter> <action android:name="com.google.android.c2dm.intent.registration"> </action> <category android:name="de.vogella.android.c2dm.simpleclient" /> </intent-filter> </receiver> <receiver android:name=".c2dmmessagereceiver" android:permission="com.google.android.c2dm.permission.send"> <intent-filter> <action android:name="com.google.android.c2dm.intent.receive"> </action> <category android:name="de.vogella.android.c2dm.simpleclient" /> </intent-filter> </receiver> <activity android:name="registrationresultactivity"> </activity> <activity android:name="messagereceivedactivity"> </activity> </application> </manifest> کالس "C2DMClientActivity" را به ترتیب زیر اصالح کنید. package de.vogella.android.c2dm.simpleclient; import android.app.activity;

27 import android.app.pendingintent; import android.content.intent; import android.content.sharedpreferences; import android.os.bundle; import android.preference.preferencemanager; import android.util.log; import android.view.view; import android.widget.toast; public class C2DMClientActivity extends Activity { public final static String AUTH = "authentication"; // Example Activity to trigger a request for a registration ID to the Google // public void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); setcontentview(r.layout.main); public void register(view view) { Log.w("C2DM" "start registration process"); Intent intent = new Intent("com.google.android.c2dm.intent.REGISTER"); intent.putextra("app" PendingIntent.getBroadcast(this 0 new Intent() 0)); // Sender currently not used intent.putextra("sender" "nonsenses@gmail.com"); startservice(intent); public void showregistrationid(view view) { SharedPreferences prefs = PreferenceManager

28 .getdefaultsharedpreferences(this); String string = prefs.getstring(auth "n/a"); Toast.makeText(this string Toast.LENGTH_LONG).show(); Log.d("C2DM RegId" string); onclick به دکمه ها متصل هستند. دکمه ی متدهای داخل activity ها به وسیله ی خصوصیت (property) اول درخواست برای شناسه ی ثبت را راه اندازی می کند و دکمه ی دوم کلید ثبت key( )registration ذخیره شده را نشان می دهد. همچنین شناسه ی ثبت را در LogCat view رایت کنید. اکنون یک کپی از شناسه ی ثبت LogCat view تهیه کرده تا در آینده بتوانید آن را در پیاده سازی سرور خود بکار ببرید. ثبت برنامه برنامه ی خود را اجرا کرده و کاربر ثبت نام شده را نگه دارید سپس دکمه ی مربوط را بزنید. LogCat را برای شناسه ی ثبت بررسی کنید. در صورت مشاهده ی پیغام زیر مطمئن شوید که از دستگاه گوگل استفاده کرده و همچنین یک کاربر گوگل روی دستگاه مورد نظر ثبت کرده اید. Unable to start service Intent {act=com.google.android.c2dm.intent.register... : not found 5. آموزش استفاده از ابزار خط فرمان Curl برای شبیه سازی سرور در صورت راه اندازی سیستم لینوکس می توانید به راحتی سرویس را روی خط فرمان تست کنید. با استفاده از curl روی خط فرمان می توان کلید شناسایی / احراز هویت key( )authentication را درخواست کرد. از پاسخ دریافتی بخش پس از "Auth=" را دریافت کرده و بکار ببرید.

29 curl -d =your_user -d "Passwd=your_password" -d accounttype=google -d source=google-curl-example -d service=ac2dm با استفاده از این بخش و کد ثبت code( )registration می توان پیغام به دستگاه ارسال کرد. curl --header "Authorization: GoogleLogin auth=your_authenticationid" " -d registration_id=your_registration -d "data.payload=payload" -d collapse_key=0 6. آموزش ایجاد برنامه ی سرور همان طور که پیشتر توضیح داده شد سرور برنامه باید از طریق HTTPS یک کلید احراز هویت دریافت کند. پس از این مرحله سرور برنامه باید پیام های مورد نظر را از طریق HTTP با ارائه ی کلید احراز هویت و شناسه ی ثبت به دستگاه مربوطه ارسال کنید. با بهره گیری از یک برنامه ی جاوا سرویس دهنده را شبیه سازی می کنیم. شناسه ی ثبت دستگاه داخل اپلیکیشن hard-code )وابسته به مقادیر موجود در متن برنامه / code source و نه مقادیری که توسط کاربر وارد می گردد( می شود زیرا که امکان دستیابی به برنامه از طریق http وجود ندارد. جهت ثبت و ذخیره ی اعتبارنامه )credentials( خود کالس زیر را بکار ببرید. package de.vogella.java.c2dm.server.secret; public class SecureStorage { public static final String USER = "your_registereduser"; public static final String PASSWORD = "your_password";

30 یک پروژه جدید جاوا "de.vogella.java.c2dm.server" ایجاد کنید. حال کالس زیر را بسازید. کالس مزبور در utility class واقع به عنوان یک کالس خدماتی / )کالسی که یک مجموعه متد ویژه اجرای توابع متداول که مدام مورد استفاده ی مجدد قرار ی گیرند تعریف می کند( عمل می کند که توکن یا نشانه ی امنیتی token( )authentication را از سرور گوگل دریافت می کند. package de.vogella.java.c2dm.server.util; import java.io.bufferedreader; import java.io.ioexception; import java.io.inputstreamreader; import java.io.outputstream; import java.net.httpurlconnection; import java.net.url; public class AuthenticationUtil { private AuthenticationUtil() { // Util class cannot get instanziated public static String gettoken(string String password) throws IOException { // create the post data // Requires a field with the and the password StringBuilder builder = new StringBuilder(); builder.append(" =").append( ); builder.append("&passwd=").append(password); builder.append("&accounttype=google"); builder.append("&source=mylittleexample"); builder.append("&service=ac2dm"); // Setup the Http Post byte[] data = builder.tostring().getbytes(); URL url = new URL("

31 HttpURLConnection con = (HttpURLConnection) url.openconnection(); con.setusecaches(false); con.setdooutput(true); con.setrequestmethod("post"); con.setrequestproperty("content-type" "application/x-www-form-urlencoded"); con.setrequestproperty("content-length" Integer.toString(data.length)); // Issue the HTTP POST request OutputStream output = con.getoutputstream(); output.write(data); output.close(); // read the response BufferedReader reader = new BufferedReader(new InputStreamReader(con.getInputStream())); String line = null; String auth_key = null; while ((line = reader.readline())!= null) { if (line.startswith("auth=")) { auth_key = line.substring(5); // Finally get the authentication token // To something useful with it return auth_key; اکنون کالس "GetAuthenticationToken" را ایجاد کنید. از این کالس می توان برای دریافت نشانه ی امنیتی token( )authentication استفاده کرد.

32 package de.vogella.java.c2dm.server; import java.io.ioexception; import de.vogella.java.c2dm.server.secret.securestorage; import de.vogella.java.c2dm.server.util.authenticationutil; public class GetAuthenticationToken { public static void main(string[] args) throws IOException { String token = AuthenticationUtil.getToken(SecureStorage.USER SecureStorage.PASSWORD); System.out.println(token); کالس GetAuthenticationToken را اجرا کرده و به خاطر داشته باشید که باید نشانه ی احراز هویت token( )authentication و شناسه ی ثبت id( )registration خود را نگه دارید. package de.vogella.java.c2dm.server; public class ServerConfiguration { public static final String AUTHENTICATION_TOKEN = "your_token"; public static final String REGISTRATION_ID = "registration_id_of_your_device"; همچنین الزم است کالس خدماتی class( )utility زیر را ایجاد کنید. کالس گفته شده به شما اجازه می دهد پیام ها را به دستگاه ارسال کنید. package de.vogella.java.c2dm.server.util; import java.io.ioexception; import java.io.outputstream; import java.net.url; import java.net.urlencoder;

33 import javax.net.ssl.hostnameverifier; import javax.net.ssl.httpsurlconnection; import javax.net.ssl.sslsession; public class MessageUtil { private final static String AUTH = "authentication"; private static final String UPDATE_CLIENT_AUTH = "Update- Client-Auth"; public static final String PARAM_REGISTRATION_ID = "registration_id"; public static final String PARAM_DELAY_WHILE_IDLE = "delay_while_idle"; public static final String PARAM_COLLAPSE_KEY = "collapse_key"; private static final String UTF8 = "UTF-8"; public static int sendmessage(string auth_token String registrationid IOException { String message) throws StringBuilder postdatabuilder = new StringBuilder(); postdatabuilder.append(param_registration_id).append("=").append(registrationid); postdatabuilder.append("&").append(param_collapse_key).append("= ").append("0"); postdatabuilder.append("&").append("data.payload").append("=").append(urlencoder.encode(message UTF8)); byte[] postdata = postdatabuilder.tostring().getbytes(utf8); // Hit the dm URL. URL url = new

34 URL(" HttpsURLConnection.setDefaultHostnameVerifier(new CustomizedHostnameVerifier()); HttpsURLConnection conn = (HttpsURLConnection) url.openconnection(); conn.setdooutput(true); conn.setusecaches(false); conn.setrequestmethod("post"); conn.setrequestproperty("content-type" "application/x-www-form-urlencoded;charset=utf-8"); conn.setrequestproperty("content-length" Integer.toString(postData.length)); conn.setrequestproperty("authorization" "GoogleLogin auth=" + auth_token); OutputStream out = conn.getoutputstream(); out.write(postdata); out.close(); int responsecode = conn.getresponsecode(); return responsecode; private static class CustomizedHostnameVerifier implements HostnameVerifier { public boolean verify(string hostname SSLSession session) { return true;

35 در مرحله ی آخر کالس "SendMessageToDevice" را ایجاد کنید این کالس نیز به شما اجازه می دهد پیام ها را به دستگاه خود بفرستید. package de.vogella.java.c2dm.server; import java.io.ioexception; import de.vogella.java.c2dm.server.util.messageutil; public class SendMessageToDevice { public static void main(string[] args) throws IOException { // "Message to your device." is the message we will send to the Android app int responsecode = MessageUtil.sendMessage(ServerConfiguration.AUTHENTICATION_TOKEN ServerConfiguration.REGISTRATION_ID "Message to your device."); System.out.println(responseCode); حال آن را اجرا کنید. باید پیغامی به دستگاه ارسال شده و کد بازگشتی code( )return "200" را به شما ارائه دهد. روی دستگاه باید اطالعیه ی مشاهده کنید و در صورت آن باز کردن پیغامی برای شما به نمایش گذاشته شود.