NativeScript 的 Sentry 插件

这是一个用于使用 Sentry 记录应用崩溃的插件。

安装

从项目根目录运行以下命令

$ tns plugin add @essent/nativescript-ng-sentry

此命令将自动安装必要的文件，并在您的项目 package.json 文件中将 nativescript-ng-sentry 存储为依赖项。

使用方法

要使用 nativescript-ng-sentry，您必须首先 导入 模块

import { NgSentry } from '@essent/nativescript-ng-sentry';

在您的应用启动时，使用您自己的凭据调用 setCredentials，这些凭据可以在您的 Sentry 项目设置中的客户端密钥（DSN）中找到。使用公共 DSN 作为这些凭据。您还可以提供环境和用户 ID。

NgSentry.getInstance().setCredentials('123456', '123456789abcdefghijklmnopqrstuvw', 'development', 'unique-user-id');

要记录崩溃，请使用消息和详细信息调用 saveCrash。详细信息将被用作 Sentry 的 breadcrumb，您可以使用它来保存堆栈跟踪，例如。您可以查看 我们的示例 了解如何使用未捕获的错误事件调用此方法。

NgSentry.getInstance().saveCrash('My crash message', 'My crash details');

崩溃不会自动发送到 Sentry，您可以使用 sendCrashes 将所有保存的崩溃发送到 Sentry。我们建议您在应用恢复事件中调用此方法。

NgSentry.getInstance().sendCrashes();

Breadcrumb（可选）

您可以将 breadcrumb 保存下来以查看用户在崩溃发生之前做了什么，这些将被添加到您保存的下一个崩溃中。要添加 breadcrumb，请使用标题和类别调用 saveBreadcrumb。

NgSentry.getInstance().saveBreadcrumb('Routed to details page', 'state');

您可以选择向 breadcrumb 添加额外的数据。

const properties: KeyValue<string> = {
    page: 'Change user data',
    changed: 'Username'
};
NgSentry.getInstance().saveBreadcrumb('Save success', 'action', properties);

您可以选择设置 breadcrumb 的最大数量，默认为 50。

NgSentry.getInstance().setMaxAmountOfBreadcrumbs(10);