This plugin provides a bridge between javascript error handling and Fabric Crashlytics serverside client API.
This Plugin has a dependency on the java stacktracejs library:
bower install stacktrace-js
bower install stackframe
bower install error-stack-parser
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>
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
- Android
- iOS
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);
};
}]);
}]);