Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/sdk/android/extensibility/bugsee-extensions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
7 changes: 3 additions & 4 deletions docs/sdk/android/gradle-plugin/auto-load.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion docs/sdk/android/gradle-plugin/requirements.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/sdk/android/installation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down