From 1e5ee057d11067cd8c4a7677904210d01eb599ff Mon Sep 17 00:00:00 2001 From: Alexander Dinauer Date: Thu, 12 Nov 2026 14:20:19 +0100 Subject: [PATCH] docs(java): Document envelope cache API changes Explain how custom Java and Android envelope caches migrate from the removed store overloads to storeEnvelope and its result. Co-Authored-By: Claude --- docs/platforms/android/migration/v8-to-v9.mdx | 8 ++++++++ docs/platforms/java/common/migration/8.x-to-9.0.mdx | 8 ++++++++ 2 files changed, 16 insertions(+) diff --git a/docs/platforms/android/migration/v8-to-v9.mdx b/docs/platforms/android/migration/v8-to-v9.mdx index f7e9850e1cd15..4d921fbd8f3dd 100644 --- a/docs/platforms/android/migration/v8-to-v9.mdx +++ b/docs/platforms/android/migration/v8-to-v9.mdx @@ -91,3 +91,11 @@ If you previously turned Performance V2 off, the SDK now: ### Removed `ActivityFramesTracker` `ActivityFramesTracker` has been removed, and the `ActivityLifecycleIntegration` constructor no longer takes it. If you create `ActivityLifecycleIntegration` manually, pass only the `Application` and `BuildInfoProvider` arguments. + +## Removed `IEnvelopeCache.store()` Methods + +Version 9 removes the deprecated `IEnvelopeCache.store(...)` overloads. If you provide a custom envelope cache: + +- Rename `store(SentryEnvelope, Hint)` to `storeEnvelope(SentryEnvelope, Hint)`. +- Return `true` only when the envelope was stored, and `false` when it wasn't. +- Replace calls to `store(envelope)` with `storeEnvelope(envelope, new Hint())`. diff --git a/docs/platforms/java/common/migration/8.x-to-9.0.mdx b/docs/platforms/java/common/migration/8.x-to-9.0.mdx index 932e2977a42c8..db4faee901396 100644 --- a/docs/platforms/java/common/migration/8.x-to-9.0.mdx +++ b/docs/platforms/java/common/migration/8.x-to-9.0.mdx @@ -100,3 +100,11 @@ The minimum-level options only select eligible records. They do not enable Sentr ## Constructor Changes The Log4j 2 `SentryAppender` constructor and `createAppender` factory now require a `logsEnabled` argument. Pass `true` to capture Sentry Logs or `false` to keep capture disabled. The deprecated constructor without `minimumLevel` has been removed. + +## Removed `IEnvelopeCache.store()` Methods + +Version 9 removes the deprecated `IEnvelopeCache.store(...)` overloads. If you provide a custom envelope cache: + +- Rename `store(SentryEnvelope, Hint)` to `storeEnvelope(SentryEnvelope, Hint)`. +- Return `true` only when the envelope was stored, and `false` when it wasn't. +- Replace calls to `store(envelope)` with `storeEnvelope(envelope, new Hint())`.