用途:为 Ionic Capacitor 应用接入 Sentry,实现原生崩溃与前端错误的统一上报。
主要能力:@sentry/capacitor 负责捕获 iOS/Android 原生崩溃;框架 SDK(@sentry/angular、@sentry/react、@sentry/vue)负责捕获 JS 错误、面包屑和性能追踪。两者通过一次 init() 调用集成。
使用方式:按框架安装依赖。Angular 用 npm install @sentry/capacitor @sentry/angular;React 用 npm install @sentry/capacitor @sentry/react;Vue 用 npm install @sentry/capacitor @sentry/vue,然后执行 npx cap sync。具体初始化与各框架集成细节见 setup.md。
硬性规则:在应用启动最早期初始化 Sentry,早于任何可能抛错的代码;release 值设为应用版本(如取自 package.json),以便与 source maps/发行版本对应;environment 按构建模式设为 production、staging 或 development 便于过滤;在构建流水线中上传 source maps,否则 JS 堆栈不可读;不要在未启用隐私控制并获法律批准时发送 PII(邮箱、全名、IP);不要重复 init,@sentry/capacitor 已包装框架 SDK,分别调用两个 init 会导致重复上报。
限制:资料未提供收费、价格、具体效果或完整配置步骤。