|
| 1 | +--- |
| 2 | +title: "SDK Versions" |
| 3 | +description: "Look up the latest version of each RUM SDK, and the versioned url scheme for the Web CDN bundles" |
| 4 | +keywords: ["RUM", "SDK version", "version lookup", "CDN"] |
| 5 | +--- |
| 6 | + |
| 7 | +Each SDK is released independently and carries its own version number — Android's `0.6.0` has no relationship to Web's `0.1.0`. This page gives the **official version lookup page** for every platform. Those pages are maintained by the package registries themselves, so they always show the current release. |
| 8 | + |
| 9 | +<Info> |
| 10 | +Most installation examples in the integration guides do not pin a version, so that you get the latest release. When you do need to pin one, look the version up at the link below and write it into your dependency declaration. |
| 11 | +</Info> |
| 12 | + |
| 13 | +## Latest version per platform |
| 14 | + |
| 15 | +| Platform | Package | Look up the latest version | |
| 16 | +| --- | --- | --- | |
| 17 | +| Web | `@flashcatcloud/browser-rum` | [npm](https://www.npmjs.com/package/@flashcatcloud/browser-rum) | |
| 18 | +| Electron | `@flashcatcloud/electron-sdk` | [npm](https://www.npmjs.com/package/@flashcatcloud/electron-sdk) | |
| 19 | +| WeChat Mini Program | `@flashcatcloud/miniprogram-rum` | [npm](https://www.npmjs.com/package/@flashcatcloud/miniprogram-rum) | |
| 20 | +| React Native | `@flashcatcloud/mobile-react-native` | [npm](https://www.npmjs.com/package/@flashcatcloud/mobile-react-native) | |
| 21 | +| Android | `cloud.flashcat:dd-sdk-android-core` | [Maven Central](https://central.sonatype.com/artifact/cloud.flashcat/dd-sdk-android-core) | |
| 22 | +| iOS | `FlashcatCore` | [CocoaPods](https://cocoapods.org/pods/FlashcatCore) | |
| 23 | +| HarmonyOS | `@flashcatcloud/core` | [ohpm](https://ohpm.openharmony.cn/#/cn/detail/@flashcatcloud%2Fcore) | |
| 24 | +| Flutter | `flashcat_flutter_plugin` | [pub.dev](https://pub.dev/packages/flashcat_flutter_plugin) | |
| 25 | + |
| 26 | +Most platforms ship companion packages alongside the one above — `dd-sdk-android-rum` and `dd-sdk-android-okhttp` on Android, `FlashcatRUM` and `FlashcatTrace` on iOS, `@flashcatcloud/rum` on HarmonyOS, and so on. Companion packages of the same platform **stay on the same version**, so look up the main package and use that version for all of them. |
| 27 | + |
| 28 | +## Url scheme for the Web CDN bundles |
| 29 | + |
| 30 | +Besides npm, the Web SDK is distributed through a CDN. Each release gets **its own directory** on the CDN, named for the version with a `v` prefix: |
| 31 | + |
| 32 | +``` |
| 33 | +https://static.flashcat.cloud/browser-sdk/<version>/flashcat-rum.js |
| 34 | +https://static.flashcat.cloud/browser-sdk/<version>/fc-rum-legacy.js |
| 35 | +``` |
| 36 | + |
| 37 | +Take `<version>` from the npm page in the Web row above and add a `v`. If npm shows `0.1.0`, the url is `https://static.flashcat.cloud/browser-sdk/v0.1.0/flashcat-rum.js`. |
| 38 | + |
| 39 | +Directories of earlier releases are **kept indefinitely and never rewritten**, so a url always serves the version it names. Upgrading means pointing at a newer release, not re-downloading the same url. |
| 40 | + |
| 41 | +<Warning> |
| 42 | +**Do not use `https://static.flashcat.cloud/browser-sdk/v0/...` any more.** That is an earlier path named for the major version, and it has not been updated since `v0.1.0` — it still resolves, but its contents stay at an old release and will receive no fixes. If your page still references it, switch to a url carrying the full version, as described above. |
| 43 | +</Warning> |
| 44 | + |
| 45 | +`fc-rum-legacy.js` is a separate build for browsers without ES2015 support (IE 9 to 11). It ships from `v0.1.0` onwards, is distributed through the CDN only, and is not published to npm. The directories of earlier releases do not contain it. |
| 46 | + |
| 47 | +## Self-hosted deployments |
| 48 | + |
| 49 | +Private networks usually cannot reach the public CDN, so the bundles have to be served from your own static host. The Web SDK's files depend on each other through hash-named chunks, so **do not pick files by hand** — use the sync script in the repository to download a complete set in one go: |
| 50 | + |
| 51 | +```bash |
| 52 | +node scripts/deploy/sync-bundles.js |
| 53 | +``` |
| 54 | + |
| 55 | +With no arguments it downloads the version of the checkout it runs from, and it fails loudly rather than producing a directory with anything missing. See the [browser-sdk repository](https://github.com/flashcatcloud/browser-sdk) for details. |
| 56 | + |
| 57 | +## Release notes |
| 58 | + |
| 59 | +For what changed in each Web SDK release, see the [browser-sdk CHANGELOG](https://github.com/flashcatcloud/browser-sdk/blob/main/CHANGELOG.md). Release notes for the other platforms are on their package pages linked in the table above. |
0 commit comments