Skip to content

主包体积优化 ​

主包接近平台上限时,先检查 SDK 在最终小程序中的实际增量与重复副本,再决定是否延迟加载。sentry-miniapp 包含 @sentry/core 与多端适配,实际占用随版本、格式和打包方式变化;gzip 大小不能代替平台包体积。

先确认实际占用 ​

  • npm 展示的解包总量包含 ESM/CommonJS/UMD、类型声明和 Source Map,不代表小程序需要打入的体积;项目只应使用所需的构建格式。
  • 用平台开发者工具或框架构建分析查看最终 JS 属于主包还是分包,并检查是否出现 SDK 或 Core 的重复副本。
  • 关闭性能、日志等可选采集会改变运行行为,不保证对应代码从产物中移除。ESM 的按需裁剪取决于打包器和实际引用;独立 CommonJS/UMD 文件包含完整 SDK。

框架项目先检查 ESM 按需打包 ​

Taro、uni-app 等构建项目,先确认打包器实际使用 ESM 入口,再查看最终包分析。明确引用使用的 API;需要宿主性能条目时才添加 performanceIntegration()。没有使用的 Performance API、HTTP 上下文集成可以被支持 tree-shaking 的打包器移除,已有的默认集成和跨端回退仍会保留。

javascript
import { init, performanceIntegration } from 'sentry-miniapp';

init({
  dsn: 'YOUR_DSN',
  integrations: [performanceIntegration()], // 需要宿主性能条目时添加
});

不需要该能力时移除这项导入和配置。避免通过动态属性名读取整个 SDK 或集成命名空间,这可能让打包器保留所有出口。不同工具链的结果可能不同,仍须以最终小程序产物为准;这项裁剪不会让独立 CommonJS 文件变成按需版本。

方案 A:微信原生分包异步化 ​

微信原生支持分包异步化,可用 require.async 跨分包加载 SDK。

  1. 把 sentry-miniapp 的 npm 包或构建产物放进某个分包目录(如 subpackageA)。
  2. 在 app.js 中用 require.async 异步加载并初始化:
javascript
// app.js
App({
  onLaunch() {
    require.async('./subpackageA/sentry-miniapp.js')
      .then((Sentry) => {
        Sentry.init({ dsn: 'YOUR_DSN' /* ...其他配置 */ });
      })
      .catch((err) => console.error('Sentry 加载失败', err));
  },
});

确认生成的 SDK 文件被归入 subpackageA 后,它的体积会计入分包,主包不再同步加载 SDK。用开发者工具的包体积分析核对结果,避免打包器仍在主包保留副本。

方案 B:其他平台 / 跨端框架 ​

支付宝、字节、百度、Taro、uni-app 等项目要以各自平台和框架的分包能力为准。通用原则是:确保 SDK 的实际产物被打进分包,并在分包加载完成后再执行 Sentry.init。不同工具链对 import('sentry-miniapp') 是否拆包、拆到哪个包,规则并不一致,不能只看源码写法。

建议每次调整后检查构建产物:

  • 主包目录里不应出现 sentry-miniapp / @sentry/core 相关大块代码;
  • 分包目录里能找到 SDK 产物或对应 chunk;
  • 真机预览验证:分包加载完成后主动 captureException(new Error('sentry test')),确认能上报。

权衡

异步加载会让 SDK 晚于主包就绪,分包加载完成前的异常和请求无法自动补采;初始化时 App() 已注册,首次 Session、启动面包屑等能力也可能缺失,详见初始化时序。需要完整的启动阶段监控时,把 SDK 同步放在主包并在 App() 前初始化。

基于 @sentry/core 的跨端小程序与小游戏 SDK · MIT Licensed