rradz / rpush Goto Github PK

• Supports:
  • Apple Push Notification Service
  • Google Cloud Messaging
  • Amazon Device Messaging
  • Windows Phone Push Notification Service.
• Seamless Rails (3, 4) integration.
• Scalable - choose the number of persistent connections for each app.
• Designed for uptime - signal -HUP to add, update apps.
• Run as a daemon or inside an existing processs.
• Use in a scheduler for low-workload deployments (Push API).
• Hooks for fine-grained instrumentation and error handling (Reflection API).
• Works with MRI, JRuby, Rubinius 1.9, 2.0, 2.1.

Add it to your Gemfile:

gem 'rpush'

Generate the migrations, rpush.yml and migrate:

rails g rpush
rake db:migrate

If this is your first time using the APNs, you will need to generate SSL certificates. See Generating Certificates for instructions.

app = Rpush::Apns::App.new
app.name = "ios_app"
app.certificate = File.read("/path/to/sandbox.pem")
app.environment = "sandbox" # APNs environment.
app.password = "certificate password"
app.connections = 1
app.save!

n = Rpush::Apns::Notification.new
n.app = Rpush::Apns::App.find_by_name("ios_app")
n.device_token = "..."
n.alert = "hi mom!"
n.attributes_for_device = {:foo => :bar}
n.save!

You should also implement the ssl_certificate_will_expire reflection to monitor when your certificate is due to expire.

app = Rpush::Gcm::App.new
app.name = "android_app"
app.auth_key = "..."
app.connections = 1
app.save!

n = Rpush::Gcm::Notification.new
n.app = Rpush::Gcm::App.find_by_name("android_app")
n.registration_ids = ["..."]
n.data = {:message => "hi mom!"}
n.save!

GCM also requires you to respond to Canonical IDs.

app = Rpush::Adm::App.new
app.name = "kindle_app"
app.client_id = "..."
app.client_secret = "..."
app.connections = 1
app.save!

n = Rpush::Adm::Notification.new
n.app = Rpush::Adm::App.find_by_name("kindle_app")
n.registration_ids = ["..."]
n.data = {:message => "hi mom!"}
n.collapse_key = "Optional consolidationKey"
n.save!

For more documentation on ADM.

app = Rpush::Wpns::App.new
app.name = "windows_phone_app"
app.connections = 1
app.save!

n = Rpush::Wpns::Notification.new
n.app = Rpush::Wpns::App.find_by_name("windows_phone_app")
n.uri = "http://..."
n.alert = "..."
n.save!

As a daemon:

cd /path/to/rails/app
rpush <Rails environment> [options]

Inside an existing process (see Embedding API):

Rpush.embed

Please note that only ever a single instance of Rpush should be running.

In a scheduler (see Push API):

Rpush.push
Rpush.apns_feedback

See Configuration for a list of options, or run rpush --help.

After updating you should run rails g rpush to check for any new migrations.

• Configuration
• Moving from Rapns
• Deploying to Heroku
• Hot App Updates
• Signals
• Reflection API
• Push API
• Embedding API
• Implementing your own storage backend
• Upgrading from 2.x to 3.0

• Generating Certificates
• Advanced APNs Features
• APNs Delivery Failure Handling
• Why open multiple connections to the APNs?
• Silent failures might be dropped connections

• Notification Options
• Canonical IDs
• Delivery Failures & Retries

Fork as usual and go crazy!

When running specs, please note that the ActiveRecord adapter can be changed by setting the ADAPTER environment variable. For example: ADAPTER=postgresql rake.

Available adapters for testing are mysql, mysql2 and postgresql.

Note that the database username is changed at runtime to be the currently logged in user's name. So if you're testing with mysql and you're using a user named 'bob', you will need to grant a mysql user 'bob' access to the 'rpush_test' mysql database.