版本与升级
客户端和服务端 SDK 各自维护版本。客户端版本组合（Suite）记录配套的 Web、Android、iOS、React Native 和 Flutter 包；事件协议另有版本号。安装时以SDK 下载页所选版本及其包内说明为准。
升级前
- 查看目标版本的变更说明，确认公开 API、事件协议及目标应用工具链是否兼容。
- 在测试应用中替换 SDK 包；React Native 和 Flutter 还需一并替换配套的原生 SDK。
- 按数据校验核对关键事件、用户切换和接收结果；若使用授权、自动采集或可选插件，也验证相应行为。
- 有未发送事件时，确认目标版本支持当前持久化格式，并测试重启后的队列恢复。不要通过删除 SDK 数据库处理升级问题。
回退前
新版本可能升级本地存储格式；旧版本未必能读取。当前 SDK 不提供通用数据库降级保证。决定回退前，请在测试环境核对旧包与当前本地数据是否兼容，并准备处理未确认事件的方案。
升级和回退时记录 SDK 包版本、客户端版本组合、协议版本及验证结果。接收端如果按 sdk.name 过滤事件，还需核对所选版本实际发送的名称。