Allows app to receive the push notifications from Google cloud messaging server. There are two library project in this project. Project contains demo app to illustrate the uses of the libraries.

####InstantGCM Allows app to register on Google Cloud Messaging server and receive GCM registration Id with new implementation of InstantId API method over deprecated register() method of gcm instance. App developer can store this registration Id at middleware or their own server for further authentication with GCM

#####Uses

1. Call InstantGCMClient.initialise(Context context , GCMDataInterface dataInterface , final GCMRegListener gcmRegListener)

• GCMDataInterface delivers project Id or # for request
• GCMRegListener provides result callback after attempting to achieve Registration Id to GCM server

2. Implement GcmListenerService . Message from GCM will received in onMessageReceived callback. Don't forget to mention this service in Application tag of manifest file.

   <service android:name="com.yourpackagename.MyGcmListenerService"
           android:exported="false" >
           <intent-filter>
               <action android:name="com.google.android.c2dm.intent.RECEIVE" />
           </intent-filter>
       </service>
   

####Connecting to Application Middleware Enable app to Register and Deregister on its middleware so that app can subscribe and unsubcribe anytime on app user request for receiving GCM message.

#####Uses It has two main methods

1. GCMMiddlewareClient.register(Context context , MiddlewareDataInterface middlewareDataInterface, InstantGCMRegistrationListener instantGCMRegistrationListener)

   • MiddlewareDataInterface passes correspoding Base url , project Id or # and device unique Id such as IMEI #.
   • InstantGCMRegistrationListener provides result callback of this register method.
   • Before attepting to register at middleware, this method first establishes the connection between GCM server and gains GCM Registration Id. Only After successful connection we proceed with the middleware registration.

2.                            InstantGCMDeregistrationListener instantGCMRegistrationListener)```
    - ```MiddlewareDataInterface``` passes correspoding Base url , project Id or # and device unique Id such as IMEI #.
    - ```InstantGCMDeregistrationListener``` provides result callback of this register method. 
   
   

####Add dependency of libraries

Add following in your build.gradle :

1. For instantgcm (Available on jcenter):

   compile 'com.instant.instantgcm:instantgcm:1.0.0'

   or

   compile project(':instantgcm')

2. For middlewarelib :

   compile project(':middlewarelib')

###License

Copyright 2016 Sneha Khadatare

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.