Sunday 23 December 2012

Android Goggle Cloud Messaging | GCM | Android push notification

Hello Droid Guys,

This tutorial helps you to implement “Google Cloud Messaging for Android (GCM)"  and
sending "Android Push Notification" using GCM.
 According to Google, “Google Cloud Messaging for Android (GCM)" is a service which
 helps developer in sending data from server to there "Android Application" whenever
 there is new data added on server. Also , No need to request server after every time 
 period(the timely fashion which we mostly did to fetch updated data from server after a
 fixed time period for e,g after every 6hrs,or a day).
1. How it works ?
       1. Android device sends a "sender id" and "application id" to GCM server for 
       2. After Successfully registration on server, the GCM server generate a 
           "Registration id" and returns it.
       3. After receiving this "registration id" the device send this "registration id "
           to our server (i.e. my mysql server).
       4. Our server store this "registration id" into database for later usage.

 Registering Your Application for “Google Cloud Messaging for Android (GCM)":

  Step-1. Goto Here and create a new project. (If you haven’t created already 
               otherwise it will take you to dashboard).

  Step-2. Click on create project and check your browser url, It will change some thing
               " "
                Note: This Id will be used by the Android Device while Registering for Push Notification.

Step-3.   Choose Service tab from the left side menu on the web page. and turn on 
                    “ Google Cloud Messaging for Android “
android google cloud messaging example

Step-4. Go to API Access tab from the left menu of web pagee and press Create new
                  Server key and note down the generated key.

android google cloud messaging example

Creating Andrid application for GCM:

Note: Before starting to create android application , first update your ADT plugin to 20.
1. Go to window => android Sdk => extras=> choose Google Cloud Messaging for Android Library.

android push notification example
Now Start Creating Android application project and remember to add gcm .jar inside your project lib folder.
You can easily find this gcm.jar inside your  android_sdk/extras/google/gcm  after updating your ADT and 
Now place following file inside your project
 package com.mukesh.gcm;  
 import static com.mukesh.gcm.CommonUtilities.SENDER_ID;  
 import android.os.Bundle;  
 import android.util.Log;  
 import android.widget.TextView;  
 public class PushAndroidActivity extends Activity {  
      private String TAG = "** pushAndroidActivity **";  
      private TextView mDisplay;  
      public void onCreate(Bundle savedInstanceState) {  
           checkNotNull(SENDER_ID, "SENDER_ID");  
           mDisplay = (TextView) findViewById(;  
           final String regId = GCMRegistrar.getRegistrationId(this);  
           Log.i(TAG, "registration id ===== " + regId);  
           if (regId.equals("")) {  
                GCMRegistrar.register(this, SENDER_ID);  
           } else {  
                Log.v(TAG, "Already registered");  
           mDisplay.setText("ffffff  " + regId);  
      private void checkNotNull(Object reference, String name) {  
           if (reference == null) {  
                throw new NullPointerException(getString(R.string.error_config,  
      protected void onPause() {  
 package com.mukesh.gcm;  
 import static com.mukesh.gcm.CommonUtilities.SENDER_ID;  
 import android.content.Context;  
 import android.content.Intent;  
 import android.util.Log;  
 public class GCMIntentService extends GCMBaseIntentService {  
      public GCMIntentService() {  
      private static final String TAG = "===GCMIntentService===";  
      protected void onRegistered(Context arg0, String registrationId) {  
           Log.i(TAG, "Device registered: regId = " + registrationId);  
      protected void onUnregistered(Context arg0, String arg1) {  
           Log.i(TAG, "unregistered = " + arg1);  
      protected void onMessage(Context arg0, Intent arg1) {  
           Log.i(TAG, "new message= ");  
      protected void onError(Context arg0, String errorId) {  
           Log.i(TAG, "Received error: " + errorId);  
      protected boolean onRecoverableError(Context context, String errorId) {  
           return super.onRecoverableError(context, errorId);  


 package com.mukesh.gcm;  
     public final class CommonUtilities {  
     static final String SENDER_ID = "4815162342";  

4. AndroidManifest.xml

 <?xml version="1.0" encoding="utf-8"?>  
 <manifest xmlns:android=""  
      package="com.mukesh.gcm" android:versionCode="1" android:versionName="1.0">  
      <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="16" />  
      <permission android:name="com.mukesh.gcma.permission.C2D_MESSAGE"  
           android:protectionLevel="signature" />  
      <uses-permission android:name="com.mukesh.gcm.permission.C2D_MESSAGE" />  
      <uses-permission android:name="android.permission.GET_ACCOUNTS" />  
      <uses-permission android:name="android.permission.WAKE_LOCK" />  
      <uses-permission android:name="android.permission.INTERNET" />  
      <uses-permission android:name="" />  
      <application android:icon="@drawable/ic_launcher"  
           <activity android:name=".PushAndroidActivity" android:label="@string/app_name">  
                     <action android:name="android.intent.action.MAIN" />  
                     <category android:name="android.intent.category.LAUNCHER" />  
           <receiver android:name=""  
                     <action android:name="" />  
                     <action android:name="" />  
                     <category android:name="com.mukesh.gcm" />  
           <service android:name=".GCMIntentService" />  

Enjoy Coding... :)
Cheers :)

Also see this blog for more help:
     1. Open| Launch Activity on receiving Push Notification 

Mukesh Kumar

Hi Guys I am from Delhi working as Web/Mobile Application Developer(Android Developer), also have knowledge of Roboelctric and Mockito ,android test driven development... Blogging has been my passion and I think blogging is one of the powerful medium to share knowledge and ideas....


  1. Where GCM is used.. What is the purpose.. ple giv reply

  2. We can use GCM for serveral purpose like:
    1.sending notification on android device
    2. Also if you are going to imaplement some chat application , gcm will be usefull.
    3. Notifying the user about the updates related to app and many more....

  3. i am getting error in error_config in page.. What i want to do for that Mukesh

  4. will you please share me the logcat taht I will help you...

  5. 05-08 11:31:07.592: D/AndroidRuntime(340): Shutting down VM
    05-08 11:31:07.592: W/dalvikvm(340): threadid=1: thread exiting with uncaught exception (group=0x40015560)
    05-08 11:31:07.612: E/AndroidRuntime(340): FATAL EXCEPTION: main
    05-08 11:31:07.612: E/AndroidRuntime(340): java.lang.RuntimeException: Unable to start activity ComponentInfo{com.sagar.gcma/com.sagar.gcma.MainActivity}: java.lang.UnsupportedOperationException: Device does not have package
    05-08 11:31:07.612: E/AndroidRuntime(340): at
    05-08 11:31:07.612: E/AndroidRuntime(340): at
    05-08 11:31:07.612: E/AndroidRuntime(340): at$1500(
    05-08 11:31:07.612: E/AndroidRuntime(340): at$H.handleMessage(
    05-08 11:31:07.612: E/AndroidRuntime(340): at android.os.Handler.dispatchMessage(
    05-08 11:31:07.612: E/AndroidRuntime(340): at android.os.Looper.loop(
    05-08 11:31:07.612: E/AndroidRuntime(340): at
    05-08 11:31:07.612: E/AndroidRuntime(340): at java.lang.reflect.Method.invokeNative(Native Method)
    05-08 11:31:07.612: E/AndroidRuntime(340): at java.lang.reflect.Method.invoke(
    05-08 11:31:07.612: E/AndroidRuntime(340): at$
    05-08 11:31:07.612: E/AndroidRuntime(340): at
    05-08 11:31:07.612: E/AndroidRuntime(340): at dalvik.system.NativeStart.main(Native Method)
    05-08 11:31:07.612: E/AndroidRuntime(340): Caused by: java.lang.UnsupportedOperationException: Device does not have package
    05-08 11:31:07.612: E/AndroidRuntime(340): at
    05-08 11:31:07.612: E/AndroidRuntime(340): at com.sagar.gcma.MainActivity.onCreate(
    05-08 11:31:07.612: E/AndroidRuntime(340): at
    05-08 11:31:07.612: E/AndroidRuntime(340): at
    05-08 11:31:07.612: E/AndroidRuntime(340): ... 11 more

  6. Force close is comming. And i import gcm.jar file also.

    i just change error_config in
    page to app_name..

  7. This is an package issue cross check your activity package name declaration in manifest file.This package is not found in your app "" please check your code.

  8. Thanks for this example. This is perfect working. but i have one question is it possible to display Badge count into Application Icon into Home Screen?

  9. very helpful tutorial thanks alot....:)

  10. Hey...
    i want to communicate through gcm....
    between two devices...
    so that one user can send message to another user...only..
    if possible plse give me some sample code..



Copyright @ 2013 Android Developers Blog.