兼容性

了解微信小程序 RUM SDK 的基础库版本、开发工具和平台 API 兼容性要求

微信小程序 RUM SDK 运行在微信小程序环境中，通过小程序基础库提供的生命周期、网络、存储、错误监听和性能 API 采集数据。接入前，请确认小程序的最低基础库版本和开发工具配置满足以下要求。

​

版本要求

项目	要求	说明
小程序基础库	2.10.0+	SDK 初始化会注册 wx.onUnhandledRejection，低于该版本的运行时不建议接入
推荐基础库	2.12.0+	可完整采集页面渲染、启动、脚本执行和 setData 更新耗时
微信开发者工具	使用近期稳定版	需要支持 npm 安装依赖并执行 工具 > 构建 npm
npm 包	@flashcatcloud/fc-sdk-miniprogram	包含核心能力、平台适配层和 RUM 入口

如果小程序允许用户在低于 2.10.0 的基础库中运行，SDK 初始化阶段可能无法注册未处理 Promise 拒绝监听。建议在小程序管理后台设置最低基础库版本，或在接入前根据业务覆盖范围评估低版本用户占比。

​

功能兼容性

功能	依赖能力	最低基础库	低版本表现
页面生命周期采集	全局 Page 包装、onLoad、onShow、onReady、onHide、onUnload	基础能力	受小程序页面生命周期能力限制
用户操作采集	页面事件处理函数包装	基础能力	受页面事件能力限制
网络请求采集	wx.request、wx.uploadFile、wx.downloadFile	基础能力	不支持对应 API 时无法自动采集该类型请求
错误采集	wx.onError、wx.onUnhandledRejection	2.10.0+	低版本不建议启用 SDK
网络状态	wx.getNetworkType、wx.onNetworkStatusChange	基础能力	获取失败时会按默认连接状态处理
本地缓存	wx.setStorageSync、wx.getStorageSync、wx.removeStorageSync	基础能力	用于会话状态和失败 payload 重试
页面性能	wx.getPerformance	2.11.0+	不支持时不会采集 Performance API 指标
setData 更新耗时	页面实例 setUpdatePerformanceListener	2.12.0+	SDK 会检测函数是否存在，不支持时跳过该指标

trackPerformance 默认开启，但性能相关 API 在源码中做了兼容处理。基础库不支持 wx.getPerformance 或页面实例不支持 setUpdatePerformanceListener 时，页面、操作、请求、错误等基础事件仍可继续采集。

​

支持的平台

平台	支持状态	说明
微信小程序	✅ 支持	SDK 面向微信小程序运行时设计
微信小游戏	❌ 不支持	当前 SDK 依赖小程序页面生命周期和 Page 包装
其他小程序平台	❌ 不支持	支付宝、百度、字节、QQ 等小程序平台 API 不在当前支持范围内
uni-app / Taro 等跨端框架	⚠️ 需验证	如果最终产物运行在微信小程序并保留标准 Page 与 wx.* API，可在测试环境验证后接入

​

开发工具和构建要求

接入 npm 包时，需要在微信开发者工具中完成 npm 构建：

1. 在小程序项目根目录执行 npm install @flashcatcloud/fc-sdk-miniprogram
2. 在微信开发者工具中打开项目
3. 执行 工具 > 构建 npm
4. 确认生成的 miniprogram_npm 可以被小程序代码引用

本地验证兼容性时，可在微信开发者工具的本地设置中选择不同调试基础库版本，分别验证初始化、自动采集和数据上报行为。

​

相关页面

SDK 接入指南

完成微信小程序 RUM SDK 安装和初始化。

高级配置

配置代理、链路追踪、会话和手动埋点。

数据收集

了解 SDK 自动采集的页面、操作、请求、错误和性能数据。