Cordova plugin for the Rollbar service allowing for native crash reporting for Codova/PhoneGap apps.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 18 commits ahead, 2 commits behind Resgrid:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
www
.gitignore
LICENSE
README.md
package.json
plugin.xml

README.md

npm version

Rollbar Cordova Plugin

PhoneGap / Cordova plugin for using the Rollbar service. Currently supports Android and iOS allowing for capturing native exceptions that occur outside the context of the Web View (i.e. native crashes).

For tracking within your Web View, see the Rollbar plugin for Angular.

Rollbar

This plugin requires a Rollbar account. Sign up for your free Rollbar account here.

Installation

Stable

You can install the plugin by running the following command.

cordova plugin add cordova-plugin-rollbar --variable ROLLBAR_ACCESS_TOKEN="<ROLLBAR_ACCESS_TOKEN>" --variable ROLLBAR_ENVIRONMENT="<ROLLBAR_ENVIRONMENT>"

If you're using Cordova 7+, use the following command:

cordova plugin add cordova-plugin-rollbar --variable ROLLBAR_ACCESS_TOKEN="<ROLLBAR_ACCESS_TOKEN>" --variable ROLLBAR_ENVIRONMENT="<ROLLBAR_ENVIRONMENT>" --nofetch

Bleeding edge

To install the most recent version in development, use:

cordova plugin add https://github.com/emilyemorehouse/cordova-plugin-rollbar.git --variable ROLLBAR_ACCESS_TOKEN="<ROLLBAR_ACCESS_TOKEN>" --variable ROLLBAR_ENVIRONMENT="<ROLLBAR_ENVIRONMENT>"

If you're using Cordova 7+, use the following command:

cordova plugin add https://github.com/emilyemorehouse/cordova-plugin-rollbar.git --variable ROLLBAR_ACCESS_TOKEN="<ROLLBAR_ACCESS_TOKEN>" --variable ROLLBAR_ENVIRONMENT="<ROLLBAR_ENVIRONMENT>" --nofetch

Usage

Initialization

After the device is ready, call the following line of code to initialize the Rollbar plugin. Note that the token and environment are pulled form the plugin variables.

window.cordova.plugins.Rollbar.init();

There are many ways to wait until the device ready event has fired, but here is one example:

$ionicPlatform.ready(function() {
    window.cordova.plugins.Rollbar.init();
}

Debugging

On iOS, there is a helper method to simulate a crash. To do so, simply call:

window.cordova.plugins.Rollbar.simulateCrash();

Supported Platforms

  • Android
  • iOS

Notes

Currently in development, we welcome PR's and other fixes. Hope to have it production ready soon.

Authors

Special Thanks

License

Apache 2.0