Sentry SDK 的封装，可用于Uniapp全端，及微信小程序，抖音小程序，百度小程序等各家平台。

提示：由于快应用 require 方式特殊性，webpack是在编译期处理的，所以动态代码检测无效，使用时去更改webpack配置也增加了复杂行，所以单独维护，包名为 sentry-quickapp。

快应用项目可参考：

https://github.com/uappkit/sentry-quickapp

• 基于 sentry-javascript 最新的基础模块 封装
• 遵守官方统一的 API 设计文档，使用方式和官方保持一致
• 使用 TypeScript 进行编写
• 包含 Sentry SDK（如：@sentry/browser）的所有基础功能
• 支持 ES6、CommonJS 两种模块系统（支持小程序原生开发方式、使用小程序框架开发方式两种开发模式下使用）
• 默认监听并上报小程序的 onError、onUnhandledRejection、onPageNotFound、onMemoryWarning 事件返回的信息（各事件支持程度与对应各小程序官方保持一致）
• 默认上报运行小程序的设备、操作系统、应用版本信息
• 支持微信小程序
• 支持微信小游戏
• 支持字节跳动小程序
• 支持支付宝小程序
• 支持钉钉小程序
• 支持百度小程序
• 支持快应用
• 支持在 Taro 等第三方小程序框架中使用
• 默认上报异常发生时的路由栈
• 完善的代码测试

支持两种使用方式：

• 直接引用
• 通过 npm 方式使用（推荐）

1. 无论选择哪种使用方式，都需要开启「微信开发者工具 - 设置 - 项目设置 - 增强编译」功能
2. 使用前需要确保有可用的 Sentry Service，比如：使用 官方 Sentry Service 服务 或自己搭建 Sentry Service。如果想直接将异常信息上报到 https://sentry.io/，由于其没有备案，可以先将异常信息上报给自己已备案域名下的服务端接口，由服务端进行请求转发。
3. 在小程序管理后台配置 Sentry Service 对应的 request 合法域名

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

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

1. 安装依赖

   npm install sentry-uniapp --save
   # 或者
   yarn add sentry-uniapp

2. 使用「微信开发者工具 - 工具 - 构建 npm」进行构建，详情可参考npm 支持

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

   import * as Sentry from "sentry-uniapp";
   
   // init Sentry
   // init options: https://github.com/getsentry/sentry-javascript/blob/master/packages/types/src/options.ts
   // extraOptions 可以禁用哪些监听事件，定义见: GlobalHandlersIntegrations
   // 例如出现 LOG: API `onMemoryWarning` is not yet implemented，可通过 `onmemorywarning: false` 关闭
   Sentry.init({
     dsn: "__DSN__",
     extraOptions: {
       onmemorywarning: false,
     },
     // ...
   });
   
   // 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
   // Error 无法定义标题，可以用下面的 captureMessage
   Sentry.captureException(new Error("Good bye"));
   
   // captureMessage 可以定制消息标题
   // extra 为附加的对象内容
   Sentry.captureMessage("message title", {
     extra
   });
   
   Sentry.captureEvent({
     message: "Manual",
     stacktrace: [
       // ...
     ],
   });

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

• sentry-javascript README 中文版
• Sentry 开发指南
• sentry-javascript 源码阅读

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

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

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

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

# 发布到 npm
npm publish --registry=https://registry.npmjs.org/

• 丁香医生
• 丁香医生医生端
• 丁香人才
• 丁香家

• 丁香医生

• 丁香医生

• sentry-javascript
• Sentry Getting Started
• Sentry JavaScript SDKs
• Sentry TypeScript Configuration
• wx.request
• 小程序 App
• wx.onError、App.onError 疑惑及如何捕获 Promise 异常？
• shields.io
• 字节跳动小程序文档
• 支付宝小程序文档
• tt.onError 的疑问

• Fundebug
• FrontJS
• Bugout

欢迎通过 issue、pull request等方式贡献 sentry-uniapp。

最早是直接用的github fork，但发现fork的repo会有一些限制，所以重新创建的这个，本项目基于下面开源基础上修改:

https://github.com/lizhiyao/sentry-miniapp

微信: yinqisen