> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashduty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK 版本

> 查询各端 RUM SDK 的最新版本，以及 Web CDN 产物的版本化地址规则

各端 SDK 独立发版，版本号互不相同 —— Android 的 `0.6.0` 与 Web 的 `0.1.0` 之间没有对应关系。本页给出每个端的**官方版本查询地址**，这些地址由各自的包仓库维护，永远显示当前最新版本。

<Info>
  接入文档里的安装示例大多不写死版本号，为的就是让您装到最新版。需要锁定某个具体版本时，先到下表对应的地址查到版本号，再写进依赖声明。
</Info>

## 各端最新版本

| 平台           | 包名                                   | 查看最新版本                                                                                    |
| ------------ | ------------------------------------ | ----------------------------------------------------------------------------------------- |
| Web          | `@flashcatcloud/browser-rum`         | [npm](https://www.npmjs.com/package/@flashcatcloud/browser-rum)                           |
| Electron     | `@flashcatcloud/electron-sdk`        | [npm](https://www.npmjs.com/package/@flashcatcloud/electron-sdk)                          |
| 微信小程序        | `@flashcatcloud/miniprogram-rum`     | [npm](https://www.npmjs.com/package/@flashcatcloud/miniprogram-rum)                       |
| React Native | `@flashcatcloud/mobile-react-native` | [npm](https://www.npmjs.com/package/@flashcatcloud/mobile-react-native)                   |
| Android      | `cloud.flashcat:dd-sdk-android-core` | [Maven Central](https://central.sonatype.com/artifact/cloud.flashcat/dd-sdk-android-core) |
| iOS          | `FlashcatCore`                       | [CocoaPods](https://cocoapods.org/pods/FlashcatCore)                                      |
| HarmonyOS    | `@flashcatcloud/core`                | [ohpm](https://ohpm.openharmony.cn/#/cn/detail/@flashcatcloud%2Fcore)                     |
| Flutter      | `flashcat_flutter_plugin`            | [pub.dev](https://pub.dev/packages/flashcat_flutter_plugin)                               |

每个端通常还有若干配套包（如 Android 的 `dd-sdk-android-rum`、`dd-sdk-android-okhttp`，iOS 的 `FlashcatRUM`、`FlashcatTrace`，HarmonyOS 的 `@flashcatcloud/rum` 等）。同一端的配套包**保持版本一致**，查上表中的主包即可，配套包用同一个版本号。

## Web CDN 产物的地址规则

Web SDK 除 npm 外还通过 CDN 分发。CDN 上**每个版本一个独立目录**，目录名就是版本号加 `v` 前缀：

```
https://static.flashcat.cloud/browser-sdk/<version>/flashcat-rum.js
https://static.flashcat.cloud/browser-sdk/<version>/fc-rum-legacy.js
```

`<version>` 从上表 Web 那一行的 npm 页面查得，前面加 `v`。例如 npm 上是 `0.1.0`，地址就是 `https://static.flashcat.cloud/browser-sdk/v0.1.0/flashcat-rum.js`。

旧版本的目录会**永久保留、内容不变**，所以一个地址永远指向它命名的那个版本。升级意味着把地址指向新版本，而不是重新下载同一个地址。

<Warning>
  **不要再使用 `https://static.flashcat.cloud/browser-sdk/v0/...`。** 这是早期按大版本号命名的路径，自 `v0.1.0` 起已停止更新 —— 它仍然可以访问，但内容会一直停留在旧版本，不会收到任何修复。如果您的页面还在引用它，请按上面的规则改为带完整版本号的地址。
</Warning>

`fc-rum-legacy.js` 是面向不支持 ES2015 的浏览器（IE 9 \~ 11）的独立构建，自 `v0.1.0` 起提供，仅通过 CDN 分发，不发布到 npm。更早版本的目录里没有这个文件。

## 私有化部署

内网环境通常无法访问公共 CDN，需要把产物下载到自己的静态服务器上。Web SDK 的产物之间存在哈希文件名的依赖关系，**不要手工挑选文件**，请使用仓库提供的同步脚本一次性下载完整集合：

```bash theme={null}
node scripts/deploy/sync-bundles.js
```

不带参数时它会按当前代码库的版本下载，任何文件缺失都会明确报错并拒绝产出一个不完整的目录。详见 [browser-sdk 仓库](https://github.com/flashcatcloud/browser-sdk)。

## 版本变更记录

Web SDK 的每个版本改了什么，见 [browser-sdk CHANGELOG](https://github.com/flashcatcloud/browser-sdk/blob/main/CHANGELOG.md)。其余各端的变更记录在上表对应的包仓库页面上。