urbanairship
is a Ruby library for using the Urban Airship web service API for push notifications and rich app pages.
We officially support the following Ruby versions:
2.2.5
2.3.1
Newer versions should work as well.
Version 5.0 is a major upgrade, as some features have been removed that were present in earlier versions. A more detailed list of changes can be found in the CHANGELOG.
If you have the bundler
gem (if not you can get it with $ gem install bundler
) add this line to your application's Gemfile:
>>> gem 'urbanairship'
And then execute:
>>> $ bundle
OR install it yourself as:
>>> gem install urbanairship
In your app initialization, you can do something like the following:
>>> require 'urbanairship' >>> Urbanairship.configure do >>> config.log_path = '/path/to/your/logfile' >>> config.log_level = Logger::WARN >>> config.timeout = 60 >>> end
If you want to use a custom logger (e.g Rails.logger), you can do:
>>> require 'urbanairship' >>> Urbanairship.configure do >>> config.custom_logger = Rails.logger >>> config.log_level = Logger::WARN >>> config.timeout = 60 >>> end
- log_path: Allows to define the folder where the log file will be created (the default is nil).
- log_level: Allows to define the log level and only messages at that level or higher will be printed (the default is INFO).
- timeout: Allows to define the request timeout in seconds (the default is 5).
Once the gem has been installed you can start sending pushes! See the full documentation, api examples, as well as the Urban Airship API Documentation for more information.
>>> require 'urbanairship' >>> UA = Urbanairship >>> airship = UA::Client.new(key:'application_key', secret:'master_secret') >>> p = airship.create_push >>> p.audience = UA.all >>> p.notification = UA.notification(alert: 'Hello') >>> p.device_types = UA.all >>> p.send_push
>>> require 'urbanairship' >>> UA = Urbanairship >>> airship = UA::Client.new(key:'application_key', secret:'master_secret') >>> p = airship.create_push >>> p.audience = UA.tag('some_tag') >>> p.notification = UA.notification(alert: 'Hello') >>> p.device_types = UA.all >>> p.send_push
The best place to ask questions is our support site: http://support.urbanairship.com/
- Fork it ( https://github.com/urbanairship/ruby-library )
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes
git commit -am 'Add some feature'
- Push to the branch
git push origin my-new-feature
- Create a new Pull Request
- Sign Urban Airship's contribution agreement.
Note: Changes will not be approved and merged without a signed contribution agreement.
After checking out the repo, ensure you have bundler
installed ($ gem install bundler
) run:
>>> $ bin/setup
to install dependencies. Then, run:
>>> $ bin/console
for an interactive prompt that will allow you to experiment.
OR you can build a local gem to play with:
>>> $ gem build urbanairship.gemspec
>>> $ gem install ./urbanairship-<VERSION>.gem
Having a local build will give you better logging if you are running into issues, but be careful to make sure to use our released public gem in Production.