frncscgmz / gcm

A gem that helps developers send data from servers to their Android applications on Android devices via Google Cloud Messaging (GCM).

Google Cloud Messaging for Android (GCM)

GCM sends notifications to Android devices via GCM.

##Installation

$ gem install gcm

or in your Gemfile just include it:

gem 'gcm'

##Requirements

An Android device running 2.2 or newer and an API key as per GCM getting started guide.

One of the following, tested Ruby versions:

• 1.9.3
• 2.0.0
• 2.1.0

##Usage

For your server to send a message to one or more devices, you must first initialize a new GCM class with your api key, and then call the send_notification method on this and give it 1 or more (up to 1000) registration IDs as an array of strings. You can also optionally send further HTTP message parameters like data or time_to_live etc. as a hash via the second optional argument to send_notification.

Example sending notifications:

require 'gcm'

gcm = GCM.new(api_key)
# you can set option parameters in here
#  - all options are pass to HTTParty method arguments
#  - ref: https://github.com/jnunemaker/httparty/blob/master/lib/httparty.rb#L40-L68
#  gcm = GCM.new(api_key, timeout: 3)

registration_ids= ["12", "13"] # an array of one or more client registration IDs
options = {data: {score: "123"}, collapse_key: "updated_score"}
response = gcm.send_notification(registration_ids, options)

Currently response is just a hash containing the response body, headers and status. Check here to see how to interpret the responses.

Blog posts

• How to send iOS and Android notifications from your Rails backend
• Как отправлять push уведомления из Вашего Rails приложения
• GCM – 서버 만들기
• ruby から gcm を使って android 端末へメッセージを送信する

Android Client

You can find an Android Client app to recieve notifications from here: Google Cloud Message - Client Android

ChangeLog

0.0.7

• All responses now have a body and header hashes

0.0.6

• You can initialize GCM class with HTTParty Options

0.0.5

• Added support for canonical registration ID
• Only support Ruby versions >= 1.9.3
• Fixed Rspec deprecation warnings for Rspec 3.0.0.beta

##MIT License

• Copyright (c) 2014 Kashif Rasul and Shoaib Burq. See LICENSE.txt for details.

##Many thanks to all the contributors

• Contributors