orangeappsru / cordova-fabric-crashlytics-plugin

Fabric Crashlytics plugin for Cordova apps

org.apache.cordova.crashlytics

This plugin provides a bridge between javascript error handling and Fabric Crashlytics serverside client API.

Installation

cordova plugin add https://github.com/vianneyniji/cordova-fabric-crashlytics-plugin --variable CRASHLYTICS_API_SECRET=<YOUR CRASHLYTICS API SECRET HERE> --variable CRASHLYTICS_API_KEY=<YOUR CRASHLYTICS API KEY HERE>

Crashlytics

Plugins provides a navigator.crashlytics object with following methods :

• logException(string) : Sends an exception (non fatal) to the Crashlytics backend (Android only)
• log(string) : Sends a standard log message (non fatal) to the Crashlytics backend
• log(errorLevel, tag, msg) (Android only)
• setApplicationInstallationIdentifier(appInstId) (Android only)
• setBool(key, value)
• setDouble(key, value)
• setFloat(key, value)
• setInt(key, value)
• setLong(key, value)
• setString(key, value)
• setUserEmail(email)
• setUserIdentifier(userId)
• setUserName(userName)
• simulateCrash(): Simulates a crash

Supported platforms

• Android
• iOS

AngularJS integration

Use the following snippet to integrate the plugin in your AngularJS app gracefully :

var module = angular.module("my-module", []);

module.config(['$provide', function($provide) {
    $provide.decorator("$exceptionHandler", ['$delegate', function($delegate) {
        return function(exception, cause) {
            $delegate(exception, cause);

            // Decorating standard exception handling behaviour by sending exception to crashlytics plugin
            var message = exception.toString();
            // Here, I rely on stacktrace-js (http://www.stacktracejs.com/) to format exception stacktraces before
            // sending it to the native bridge
            var stacktrace = exception.stack.toLocaleString();
            navigator.crashlytics.logException("ERROR: "+message+", stacktrace: "+stacktrace);
        };
    }]);
}]);