NativeScript plugin for Sentry
This is a plugin to log app crashes with Sentry.
Run the following command from the root of your project:
$ tns plugin add @essent/nativescript-ng-sentry
This command automatically installs the necessary files, as well as stores nativescript-ng-sentry as a dependency in your project's
To use nativescript-ng-sentry you must first
import the module:
At the launch of your app call
setCredentials with your own credentials, these can be found in your Sentry Project Settings, Client Keys (DSN). Use the public DSN for these credentials. Optionally you can also provide an environment and a user id.
NgSentry.getInstance.setCredentials'123456', '123456789abcdefghijklmnopqrstuvw', 'development', 'unique-user-id';
To log a crash, call
saveCrash with a message and details.
The details will be used as a Sentry breadcrumb, you can use this to save a stacktrace, for example.
You can have a look at our example on how to call this with an uncaughtErrorEvent.
NgSentry.getInstance.saveCrash'My crash message', 'My crash details';
Crashes are not send to Sentry automatically, you can call
sendCrashes to send all saved crashes to Sentry.
We suggest you call this method in the resume event of your app.
You can save breadcrumbs to see what a user did before a crash occurred, these will be added to the next crash you save.
To add a breadcrumb use
saveBreadcrumb with a title and category.
NgSentry.getInstance.saveBreadcrumb'Routed to details page', 'state';
Optionally you can add extra data to the breadcrumb.
;NgSentry.getInstance.saveBreadcrumb'Save success', 'action', properties;
Optionally you can set a maximum amount of breadcrumbs, the default is 50.