diff --git a/docs/sdk/android/extensibility/bugsee-extensions.mdx b/docs/sdk/android/extensibility/bugsee-extensions.mdx index d80945b..5f7f0fd 100644 --- a/docs/sdk/android/extensibility/bugsee-extensions.mdx +++ b/docs/sdk/android/extensibility/bugsee-extensions.mdx @@ -70,7 +70,7 @@ dependencies { } ``` -The auto-pulled version is the latest patch of the same `MAJOR.MINOR` series the plugin was released against (e.g. `[7.0.0, 7.1.0)`), so you pick up patch updates without bumping the plugin and never silently cross a minor boundary. Opt out via `bugsee { sdkAutoLoad.set(false) }` if you ship the core SDK from a manual classpath path or a locally-published artefact — see the [Gradle plugin reference](/sdk/android/gradle-plugin/auto-load). +The auto-pulled version is bounded to the next major version above the plugin's minimum-compatible SDK version (currently `[7.1.0, 8.0.0)`), so you pick up any newer compatible `7.x` release without bumping the plugin — pin the core SDK explicitly if you need to hold a specific version. Opt out via `bugsee { sdkAutoLoad.set(false) }` if you ship the core SDK from a manual classpath path or a locally-published artefact — see the [Gradle plugin reference](/sdk/android/gradle-plugin/auto-load). For OkHttp, installation is fully transparent: the plugin's bytecode instrumentation injects the Bugsee interceptor at every `OkHttpClient.Builder.build()` call site. For **Ktor 2 / Ktor 3 / Cronet**, the plugin adds the artifact but your code still needs an explicit `install(BugseeKtorPlugin...)` / `BugseeCronet.instrument(engine)` call — these clients do not expose a transparent interception point. diff --git a/docs/sdk/android/gradle-plugin/auto-load.mdx b/docs/sdk/android/gradle-plugin/auto-load.mdx index 1617688..a9f082a 100644 --- a/docs/sdk/android/gradle-plugin/auto-load.mdx +++ b/docs/sdk/android/gradle-plugin/auto-load.mdx @@ -18,7 +18,7 @@ During `withDependencies` evaluation of the `implementation` configuration, the | `org.chromium.net:*` | `com.bugsee:bugsee-android-cronet` | :::caution[Auto-added extensions track the SDK version line, not the plugin version] -Auto-added extension modules are pulled at the **Bugsee SDK version line** — the same min-compatible SDK range the plugin emits for the core `bugsee-android` artifact (e.g. `[7.0.0, 7.1.0)`), **not** the plugin's own 4.x version. The plugin and the SDK runtime are versioned independently, so the extension artifacts (which are SDK modules) always match the SDK line rather than the plugin line. This keeps the core SDK and every auto-added extension on the same coordinated version series. +Auto-added extension modules are pulled at the **Bugsee SDK version line** — the same min-compatible SDK range the plugin emits for the core `bugsee-android` artifact (e.g. `[7.1.0, 8.0.0)`), **not** the plugin's own 4.x version. The plugin and the SDK runtime are versioned independently, so the extension artifacts (which are SDK modules) always match the SDK line rather than the plugin line. This keeps the core SDK and every auto-added extension on the same coordinated version series. ::: If you already declared the matching Bugsee artifact yourself, the plugin leaves your declaration alone. Each auto-install rule can be disabled via the corresponding DSL property — for example `instrumentation.ktor.set(false)` suppresses Ktor auto-install, and `instrumentation.cronet.set(false)` suppresses Cronet auto-install. The same DSL toggles can also be set via Gradle properties (`-Pbugsee.instrumentation.ktor=false`) or `bugsee.properties` (`plugin.instrumentation.ktor=false`). See [Configuration](/sdk/android/gradle-plugin/configuration) for the full toggle list. @@ -36,12 +36,11 @@ dependencies { } ``` -The plugin reads its bundled `sdk-min-version` (the lowest SDK release the plugin was tested against), parses it as SemVer, and emits a Gradle dynamic-version range bounded to the **same `MAJOR.MINOR` series** — so consumers automatically pick up the latest patch on that line but never cross a minor boundary that could carry breaking changes: +The plugin reads its bundled `sdk-min-version` (the lowest SDK release the plugin was tested against), parses it as SemVer, and emits a Gradle dynamic-version range bounded to the **next major version** — so consumers automatically pick up any newer compatible SDK release on the same major line without an automatic jump to the next major. The current floor is `7.1.0`: | `sdk-min-version` | Emitted range | Pulls | | --- | --- | --- | -| `7.0.0` | `[7.0.0, 7.1.0)` | latest `7.0.x` patch | -| `7.2.5` | `[7.2.5, 7.3.0)` | latest `7.2.x` patch | +| `7.1.0` | `[7.1.0, 8.0.0)` | latest compatible `7.x` release | The same range logic governs the auto-installed extension modules described above — they are pulled on the SDK version line, not the plugin line. diff --git a/docs/sdk/android/gradle-plugin/requirements.mdx b/docs/sdk/android/gradle-plugin/requirements.mdx index f797558..cfc2f42 100644 --- a/docs/sdk/android/gradle-plugin/requirements.mdx +++ b/docs/sdk/android/gradle-plugin/requirements.mdx @@ -31,7 +31,7 @@ plugin expects the exact runtime-library shape shipped alongside it. ## Minimum-compatible SDK version -The plugin auto-loads the core SDK on the `[7.0.0, 7.1.0)` range and gates +The plugin auto-loads the core SDK on the `[7.1.0, 8.0.0)` range and gates app-startup tracing on the SDK shipping `com.bugsee.library.adapters.BugseeAppStartupDispatcher` — a class introduced in SDK `7.0.0`. Pairing the plugin with an SDK older than `7.0.0` is diff --git a/docs/sdk/android/installation.mdx b/docs/sdk/android/installation.mdx index 004913e..6cc191d 100644 --- a/docs/sdk/android/installation.mdx +++ b/docs/sdk/android/installation.mdx @@ -162,7 +162,7 @@ bugsee { } ``` -The dynamic-version range used for the auto-pulled core is bounded to the same `MAJOR.MINOR` series as the plugin's `sdk-min-version` (e.g. `[7.0.0, 7.1.0)`), so you pick up patches automatically without crossing a minor boundary. +The dynamic-version range used for the auto-pulled core is bounded to the next major version above the plugin's `sdk-min-version` (currently `[7.1.0, 8.0.0)`), so you pick up any newer compatible `7.x` release automatically. The full list of dependency-driven auto-installs lives on the [Gradle plugin](/sdk/android/gradle-plugin/auto-load) page.