Skip to content
Sentry 小程序 SDK:用于小程序平台的 Sentry SDK(目前支持微信、字节跳动、支付宝小程序)
TypeScript JavaScript
Branch: master
Clone or download

README.md

Sentry 小程序 SDK

npm version npm download github forks github stars github watchers github license

用于小程序平台的 Sentry SDK

功能特点

  • 基于 sentry-javascript 最新的基础模块 封装
  • 遵守官方统一的 API 设计文档,使用方式和官方保持一致
  • 使用 TypeScript 进行编写
  • 包含 Sentry SDK(如:@sentry/browser)的所有基础功能
  • 支持 ES6CommonJS 两种模块系统 ---> 支持小程序原生开发方式、使用小程序框架开发方式两种开发模式下使用
  • 默认监听并上报小程序的 onError、onPageNotFound、onMemoryWarning 事件返回的信息
  • 默认上报运行小程序的设备、操作系统、应用版本信息
  • 支持字节跳动小程序
  • 支持支付宝小程序
  • 默认上报异常发生时的路由栈
  • 完善的代码测试

已知问题

  • 由于各家小程序的 App.onError() 无法自动捕获 Promise 的异常,所以对于应用中的异步异常,需要应用开发者手动上报(问题解决中)

用法

支持两种使用方式:

  • 直接引用
  • 通过 npm 方式使用(推荐)

注意

  1. 无论选择哪种使用方式,都需要开启「微信开发者工具 - 设置 - 项目设置 - 增强编译」功能
  2. 使用前需要确保有可用的 Sentry Service,比如:使用 官方 Sentry Service 服务 或自己搭建 Sentry Service
  3. 在小程序管理后台配置 Sentry Service 对应的 request 合法域名

直接引用

  1. 微信小程序下载 sentry-minapp.wx.min.js;字节跳动小程序下载 sentry-minapp.tt.min.js;支付宝小程序下载 sentry-minapp.my.min.js
  2. 参照 /examples 中各项目使用方式,将 sentry-minapp.xx.min.js 放入项目的合适目录中,比如放入 vendor 文件夹
  3. 参照 /examples/app.js 代码,进行 Sentry 的初始化
  4. 对于提供了微信、字节跳动小程序 sentry-miniapp 会自动上报 xx.onError() 捕获的异常,对于支付宝小程序需要应用开发者在 App.onError() 中主动进行异常上报。详情可见 /docs/cross-platform.md

npm 方式

注意:目前字节跳动小程序不支持 npm 方式。

  1. 安装依赖

    npm install sentry-miniapp --save
    # 或者
    yarn add sentry-miniapp
  2. 使用「微信开发者工具 - 工具 - 构建 npm」进行构建,详情可参考npm 支持

  3. app.js 中引用并初始化 Sentry,根据实际需求设置上报到 Sentry 的元信息

    import * as Sentry from "sentry-miniapp";
    
    // init Sentry
    // init options: https://github.com/getsentry/sentry-javascript/blob/master/packages/types/src/options.ts
    Sentry.init({
      dsn: "__DSN__"
      // ...
    });
    
    // Set user information, as well as tags and further extras
    Sentry.configureScope(scope => {
      scope.setExtra("battery", 0.7);
      scope.setTag("user_mode", "admin");
      scope.setUser({ id: "4711" });
      // scope.clear();
    });
    
    // Add a breadcrumb for future events
    Sentry.addBreadcrumb({
      message: "My Breadcrumb"
      // ...
    });
    
    // Capture exceptions, messages or manual events
    Sentry.captureException(new Error("Good bye"));
    Sentry.captureMessage("Hello, world!");
    Sentry.captureEvent({
      message: "Manual",
      stacktrace: [
        // ...
      ]
    });

开发

知识储备

开发前请仔细阅读下面内容:

相关命令

# 根据 package.json 中的版本号更新 SDK 源码中的版本号
npm run version

# 构建供小程序直接引用的 sentry-minapp.xx.min.js;在本地可直接使用开发者工具打开 examples 下具体项目进行调试
npm run build:dev

# 构建用于发布到 npm 的 dist 资源
npm run build

# 构建用于发布到 npm 的 esm 资源
npm run build:esm

# 发布到 npm
npm publish

效果图

Dashboard Error00 Error01 Error02

谁在使用 sentry-miniapp

  • 丁香医生微信小程序
  • 丁香医生医生端微信小程序
  • 丁香人才微信小程序
  • 丁香医生支付宝小程序
  • 丁香医生字节跳动小程序

参考资料

其他小程序异常监控产品

贡献

欢迎通过 issuepull request等方式贡献 sentry-miniapp

联系作者

作者博客

微信交流群

微信交流群二维码

You can’t perform that action at this time.