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/design/2026-09-15-sdk-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ The single most important finding behind this design: **iOS 7.x and Android 7.x

## 2. Goals

- Ship a 7.x-native React Native SDK for the two current native lines: Android **7.4.2** (7.3.0 first, pinned transitionally as `7.3.0-SNAPSHOT` while that release was pending — see the plan's Phase 3 rulings; 7.3.1 fixes bugsee-android #214–#221 found by the beta campaign; beta validation pinned `7.3.2-SNAPSHOT` (bugsee-android main plus PR #265), released as 7.4.0; 7.4.1 adds the touch-capture fix for bugsee-android #267; 7.4.2 adds the lifecycle and secure-rectangle work the beta campaign ran against) and iOS **7.0.0** (SPM only, iOS deployment target 15.0).
- Ship a 7.x-native React Native SDK for the two current native lines: Android **7.6.0** (7.3.0 first, pinned transitionally as `7.3.0-SNAPSHOT` while that release was pending — see the plan's Phase 3 rulings; 7.3.1 fixes bugsee-android #214–#221 found by the beta campaign; beta validation pinned `7.3.2-SNAPSHOT` (bugsee-android main plus PR #265), released as 7.4.0; 7.4.1 adds the touch-capture fix for bugsee-android #267; 7.4.2 adds the lifecycle and secure-rectangle work the beta campaign ran against; 7.6.0 turns the shake and notification-bar triggers off by default and registers the shared `crash-signals` option, which iOS 7.1.0 also takes, with its own shake trigger off) and iOS **7.1.0** (SPM only, iOS deployment target 15.0).
- Expose the capabilities 7.x added and 6.x never had: breadcrumbs, notification relay, APM, user identity, hang/HTTP-error/frustration/anomaly detection, SDK status, report handlers.
- Make the wrapper's option surface **provably** consistent with the native SDKs, enforced in CI rather than by review.
- Work on bare React Native and on Expo, including Expo apps that regenerate native projects with `prebuild`.
Expand Down
4 changes: 2 additions & 2 deletions docs/design/plans/2026-09-16-implementation-plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@
Every phase's requirements implicitly include this section.

- React Native floor **0.81.0**, New Architecture required. No `oldarch` source set, no legacy bridge fallback. 0.81 still allows opting out of the New Architecture; that is a documented requirement on the consumer, not a second code path. Hard technical floor is 0.80 (`codegenConfig.ios.modulesProvider`).
- Android SDK **7.4.2** (7.3.0 first, pinned transitionally as `7.3.0-SNAPSHOT` while that release was pending — see Phase 3's rulings; 7.3.1 fixes bugsee-android #214–#221; beta validation pinned `7.3.2-SNAPSHOT`, bugsee-android main plus PR #265, released as 7.4.0; 7.4.1 adds the touch-capture fix for bugsee-android #267; 7.4.2 adds the lifecycle and secure-rectangle work the beta campaign ran against), Gradle plugin **4.0.8** (4.0.7 first; 4.0.8 uploads native symbols from the unstripped `merged_native_libs`, independent of `debugSymbolLevel`, with a bugsee-cli floor of 0.8.1), pinned exactly. Neither older pin carries what this wrapper needs: 7.2.0 has no wrapper channel, report-contract methods, `BugseeReportHandlerThread` or `com.bugsee.option.$$WRAPPER` consumer, and 4.0.6 strips every extension's provider (workbook 1.4). The plugin marker resolves from **Maven Central**, not the Gradle Plugin Portal.
- iOS SDK **7.0.0** from `https://github.com/bugsee/spm`, requirement `exact`. SwiftPM will not admit a prerelease into a range. iOS deployment target **15.0**.
- Android SDK **7.6.0** (7.3.0 first, pinned transitionally as `7.3.0-SNAPSHOT` while that release was pending — see Phase 3's rulings; 7.3.1 fixes bugsee-android #214–#221; beta validation pinned `7.3.2-SNAPSHOT`, bugsee-android main plus PR #265, released as 7.4.0; 7.4.1 adds the touch-capture fix for bugsee-android #267; 7.4.2 adds the lifecycle and secure-rectangle work the beta campaign ran against), Gradle plugin **4.0.8** (4.0.7 first; 4.0.8 uploads native symbols from the unstripped `merged_native_libs`, independent of `debugSymbolLevel`, with a bugsee-cli floor of 0.8.1), pinned exactly. Neither older pin carries what this wrapper needs: 7.2.0 has no wrapper channel, report-contract methods, `BugseeReportHandlerThread` or `com.bugsee.option.$$WRAPPER` consumer, and 4.0.6 strips every extension's provider (workbook 1.4). The plugin marker resolves from **Maven Central**, not the Gradle Plugin Portal.
- iOS SDK **7.1.0** from `https://github.com/bugsee/spm`, requirement `exact`. SwiftPM will not admit a prerelease into a range. iOS deployment target **15.0**.
- Package `@bugsee/react-native`. `toSwiftName` maps it to `ReactNative`, which is **reserved**, so `react-native.config.js` pins `spm: { name: 'BugseeReactNative' }` and the SPM product name must match exactly.
- All native versions live in **one** file, `native-versions.json`, consumed by the podspec, `Package.swift` and the Gradle module. The SPM pin and podspec URL must never disagree.
- Every SDK entry point is called on the **main thread** on iOS. `launchWithToken:` off-main logs *"Incorrect bugsee launch…"* and misbehaves.
Expand Down
10 changes: 5 additions & 5 deletions docs/launch-options.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ takes the native SDK's own default, and `Bugsee.getLaunchOptions()` reports what
import Bugsee, { createDefaultLaunchOptions } from '@bugsee/react-native';

const options = createDefaultLaunchOptions();
options.triggerByShake = false; // shake-to-report is ON by default in both SDKs
options.triggerByShake = true; // shake-to-report is OFF by default (iOS 7.1.0, Android 7.6.0)
await Bugsee.launch('<your app token>', options);
```

The tables are checked against the SDK versions pinned in `native-versions.json` (Android 7.4.2, iOS 7.0.0):
The tables are checked against the SDK versions pinned in `native-versions.json` (Android 7.6.0, iOS 7.1.0):
a test fails when either SDK registers an option this package has no accessor for, and `yarn check:options-manifests`
(run in CI and before every publish) compares the option manifest each SDK release published at
`download.bugsee.com/sdk/options/<platform>/<version>.json` with this package. It fails when an SDK publishes an option
Expand Down Expand Up @@ -49,9 +49,9 @@ iOS, does nothing on Android, and reports nothing on either. `launch()` and `rel
| `reportingDefaultCrashPriority` | `com.bugsee.option.reporting.defaults.crash-priority` | `enum IssueSeverity` | iOS, Android | `Blocker` | Default priority of crash reports; see `IssueSeverity`. |
| `reportingDefaultErrorPriority` | `com.bugsee.option.reporting.defaults.error-priority` | `enum IssueSeverity` | iOS, Android | `High` | Default priority of error reports; see `IssueSeverity`. |
| `triggerByBroadcast` | `com.bugsee.option.reporting.triggers.broadcast` | `boolean` | Android | `false` | Let a broadcast open the report dialog. |
| `triggerByNotification` | `com.bugsee.option.reporting.triggers.notification-bar` | `boolean` | Android | `true` | Let the user open the report dialog from the notification bar. The SDK default is on. |
| `triggerByNotification` | `com.bugsee.option.reporting.triggers.notification-bar` | `boolean` | Android | `false` | Let the user open the report dialog from the notification bar. The SDK default is off (Android 7.6.0; on before). |
| `triggerByScreenshot` | `com.bugsee.option.reporting.triggers.screenshot` | `boolean` | iOS, Android | `false` | Let the user open the report dialog by taking a screenshot. |
| `triggerByShake` | `com.bugsee.option.reporting.triggers.shake` | `boolean` | iOS, Android | `true` | Let the user open the report dialog by shaking the device. **The SDK default is on:** set this to `false` to turn shake-to-report off. |
| `triggerByShake` | `com.bugsee.option.reporting.triggers.shake` | `boolean` | iOS, Android | `false` | Let the user open the report dialog by shaking the device. **The SDK default is off (Android 7.6.0, iOS 7.1.0; on before):** set this to `true` to turn shake-to-report on. |
| `reportingUIDescriptionRequired` | `com.bugsee.option.reporting.ui.description-required` | `boolean` | iOS, Android | `false` | Make the Description field mandatory in the report dialog. |
| `reportingUIEmailRequired` | `com.bugsee.option.reporting.ui.email-required` | `boolean` | iOS, Android | `false` | Make the Email field mandatory in the report dialog. |
| `reportingUILabelsEnabled` | `com.bugsee.option.reporting.ui.labels-enabled` | `boolean` | iOS, Android | `false` | Show the Labels field in the report dialog. |
Expand All @@ -70,7 +70,7 @@ iOS, does nothing on Android, and reports nothing on either. `launch()` and `rel
| `captureBreadcrumbsExtras` | `com.bugsee.option.capture.breadcrumbs.extras` | `boolean` | iOS, Android | `false` | Attach the extra detail of automatically collected device-event breadcrumbs. |
| `captureCameraPreview` | `com.bugsee.option.capture.camera-preview` | `boolean` | iOS | `false` | Capture camera preview layers. Read the iOS SDK's privacy and overhead notes before enabling. |
| `crashHandlerType` | `com.bugsee.option.capture.crash-handler-type` | `enum BugseeCrashHandlerType` | iOS | `MachAndBSD` | How the crash reporter intercepts crashes; see `CrashHandlerType`. Unset leaves the SDK default, `CrashHandlerType.MachAndBSD`. |
| `crashSignals` | `com.bugsee.option.capture.crash-signals` | `int` | iOS | `128` | The fatal signals the crash reporter intercepts, as the iOS SDK's `BugseeCrashSignals` bit set: ABRT 1, SEGV 2, BUS 4, ILL 8, FPE 16, TRAP 32. Unset leaves the SDK default (every signal). Added in 7.0.0-beta7. |
| `crashSignals` | `com.bugsee.option.capture.crash-signals` | `int` | iOS, Android | `128` | The fatal signals the native crash handler intercepts, as a bit set: ABRT 1, SEGV 2, BUS 4, ILL 8, FPE 16, TRAP 32 (the same layout on both platforms). Unset leaves the SDK default, 128 (the "let the SDK choose" bit, which resolves to every signal; it counts only on its own). Leave SEGV and BUS out when the app hosts a Mono runtime. On Android it is read once, when the native handler is first armed in the process. iOS 7.0.0-beta7, Android 7.6.0. |
| `captureDeviceAndNetworkNames` | `com.bugsee.option.capture.device-network-names` | `boolean` | iOS | `false` | Record the device and network names. |
| `captureDiskSpace` | `com.bugsee.option.capture.disk-space` | `boolean` | iOS | `false` | Record free disk space. |
| `captureLogs` | `com.bugsee.option.capture.logs` | `boolean` | iOS, Android | `true` | Capture logs. Lines sent with `Bugsee.log()` are always recorded. |
Expand Down
12 changes: 7 additions & 5 deletions examples/bare/scenarios/api-constants.ts
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,8 @@ const P = 'com.bugsee.option.';
export const READBACK_SHARED: Readonly<Record<string, unknown>> = {
[`${P}capture.breadcrumbs`]: true,
[`${P}capture.breadcrumbs.extras`]: true,
/** ABRT | SEGV | ILL; the SDK default is 128, the "let the SDK choose" bit (every signal). */
[`${P}capture.crash-signals`]: 11,
[`${P}capture.logs`]: false,
[`${P}capture.logs.level`]: 2,
[`${P}capture.network`]: false,
Expand Down Expand Up @@ -60,7 +62,8 @@ export const READBACK_SHARED: Readonly<Record<string, unknown>> = {
[`${P}reporting.defaults.crash-priority`]: 2,
[`${P}reporting.defaults.error-priority`]: 1,
[`${P}reporting.triggers.screenshot`]: true,
[`${P}reporting.triggers.shake`]: false,
/** Off by default since iOS 7.1.0 and Android 7.6.0: flipped here. */
[`${P}reporting.triggers.shake`]: true,
[`${P}reporting.ui.description-required`]: true,
[`${P}reporting.ui.email-required`]: true,
[`${P}reporting.ui.labels-enabled`]: true,
Expand Down Expand Up @@ -99,7 +102,8 @@ export const READBACK_ANDROID: Readonly<Record<string, unknown>> = {
[`${P}detect.hang.sampling`]: false,
[`${P}performance.upload-mode`]: 'realtime',
[`${P}reporting.triggers.broadcast`]: true,
[`${P}reporting.triggers.notification-bar`]: false,
/** Off by default since Android 7.6.0: flipped here. */
[`${P}reporting.triggers.notification-bar`]: true,
};

export const READBACK_IOS: Readonly<Record<string, unknown>> = {
Expand All @@ -110,8 +114,6 @@ export const READBACK_IOS: Readonly<Record<string, unknown>> = {
[`${P}capture.camera-preview`]: true,
/** BSD: the SDK default is MachAndBSD (3). */
[`${P}capture.crash-handler-type`]: 1,
/** ABRT | SEGV | ILL; the SDK default is every signal. */
[`${P}capture.crash-signals`]: 11,
[`${P}capture.device-network-names`]: true,
[`${P}capture.disk-space`]: true,
[`${P}capture.logs.oslog`]: true,
Expand Down Expand Up @@ -143,6 +145,7 @@ export const ACCESSOR_KEYS = {
captureLogsLevel: `${P}capture.logs.level`,
captureNetwork: `${P}capture.network`,
captureBreadcrumbs: `${P}capture.breadcrumbs`,
crashSignals: `${P}capture.crash-signals`,
captureVideo: `${P}capture.video`,
detectAndReportCrash: `${P}detect.crash`,
detectAndReportHang: `${P}detect.hang`,
Expand All @@ -161,7 +164,6 @@ export const ACCESSOR_KEYS = {
},
ios: {
captureAVPlayer: `${P}capture.avplayer`,
crashSignals: `${P}capture.crash-signals`,
crashHandlerType: `${P}capture.crash-handler-type`,
captureDiskSpace: `${P}capture.disk-space`,
},
Expand Down
4 changes: 2 additions & 2 deletions examples/playground/VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,10 +30,10 @@ has symbols uploaded (see [README.md](./README.md)).
| M-A3 / M-B3 | Android / iOS | Setup → Advanced options | Set `reporting.ui.summary-required`, `description-required`, `email-required` and `labels-required` to `true`, tap **Launch**. Reports → Report → **Show report dialog (empty)**. Tap Send with empty fields (refused). Fill `x`, `x`, `a@b.co`, label `l1`, tap Send | Send is refused while empty. The report carries all four values | Issues → newest report: summary, description, e-mail, label | |
| M-B3 (cont.) | iOS | Setup → Advanced options | Also set `reporting.ui.labels-enabled=false` and `reporting.ui.priority-selector-enabled=false`, **relaunch**, **Show report dialog (empty)** | The labels field and the priority selector are hidden | | |
| M-B3 (style) | iOS | Setup → Advanced options | Set `reporting.ui.style` (iOS), **relaunch**, **Show report dialog (empty)**, take a screenshot | The dialog uses the chosen style | | |
| M-A4 / M-B4 | Android / iOS | Any tab | Default options (`reporting.triggers.shake` on). Shake the device | The report dialog opens. Back / Cancel closes it | | |
| M-A4 / M-B4 | Android / iOS | Any tab | Set `reporting.triggers.shake=true` (off by default), **relaunch**. Shake the device | The report dialog opens. Back / Cancel closes it | | |
| M-A5 / M-B5 | Android / iOS | Setup → Advanced options | Set `reporting.triggers.screenshot=true`, **relaunch**, take a hardware screenshot | The report dialog opens | | |
| M-A6 | Android | Setup → Advanced options, then Reports → Report | Set `capture.video.mode=20` (Fullscreen, Android), **relaunch**. At the prompt tap "Start now". Go to the Home screen of the phone, wait 10 s, reopen. Reports → **Upload report (no UI)**. Then **relaunch**: no prompt. Set `capture.video.fullscreen-remember-decision=false` (Android), **relaunch**, Cancel at the prompt, then **Upload report (no UI)** | The video shows the status bar and continues across the background. No prompt on the second launch. After Cancel the app keeps running and Upload works | Issues → report → video | |
| M-A7 | Android | Setup → Advanced options | Set `reporting.triggers.notification-bar=true` (Android), **relaunch**, pull down the notification shade, tap the Bugsee notification | The report dialog opens | | |
| M-A7 | Android | Setup → Advanced options | Set `reporting.triggers.notification-bar=true` (Android; off by default), **relaunch**, pull down the notification shade, tap the Bugsee notification | The report dialog opens | | |
| M-A8 / M-B6 | Android / iOS | Reports → Feedback | Fresh install (Android: clear the app's storage. iOS: delete and reinstall). Launch from Setup. Tap **Set greeting**, then **Show feedback UI** | The e-mail screen appears. Skip it and the chat opens. Both platforms show the greeting | Feedback in your Bugsee instance | |
| M-B7 | iOS | Setup → Advanced options | Set `capture.video.privacy-blur=true` (iOS), **relaunch**. Open the app switcher for 3 s, go back. Reports → **Upload report (no UI)** | Blurred frames in the video | Issues → report → video | |
| M-A10 / M-B9 | Android / iOS | Setup → Advanced options, then Privacy → BugseeSecure | Set `detect.frustration=true`, **relaunch**. Tap the "This box is redacted" box 6 times within 2 s (it does nothing). Reports → **Upload report (no UI)** | A frustration event in the report | Issues → report → events | |
Expand Down
4 changes: 2 additions & 2 deletions native-versions.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
{
"android": {
"sdk": "7.4.2",
"sdk": "7.6.0",
"gradlePlugin": "4.0.8"
},
"ios": {
"sdk": "7.0.0",
"sdk": "7.1.0",
"spmUrl": "https://github.com/bugsee/spm"
}
}
4 changes: 2 additions & 2 deletions packages/react-native-feedback/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ do not have to depend on this package.

## Status: beta

At the same version as `@bugsee/react-native` (`7.0.0-beta3`); the npm `latest` and `beta` tags
At the same version as `@bugsee/react-native` (`7.0.0-beta4`); the npm `latest` and `beta` tags
both point at it for now. Install both with `@beta` to keep following betas. The two must be the
same release.

Expand All @@ -25,7 +25,7 @@ yarn add @bugsee/react-native@beta @bugsee/react-native-feedback@beta

No Expo config plugin. Autolinking adds `bugsee-android-feedback` on Android.
On iOS the podspec vendors the `bugsee/feedback-spm` sources for the same
`7.0.0` pin as the core SDK, and React Native 0.87 resolves that
`7.1.0` pin as the core SDK, and React Native 0.87 resolves that
package through Swift Package Manager. There is no `spm_dependency`: that
helper does not embed the framework.

Expand Down
4 changes: 2 additions & 2 deletions packages/react-native-feedback/ios/Package.swift
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,8 @@ let package = Package(
dependencies: [
.package(name: "ReactNative", path: "../../../../xcframeworks"),
.package(name: "React-GeneratedCode", path: "../../../ios"),
.package(url: "https://github.com/bugsee/spm", exact: "7.0.0"),
.package(url: "https://github.com/bugsee/feedback-spm", exact: "7.0.0"),
.package(url: "https://github.com/bugsee/spm", exact: "7.1.0"),
.package(url: "https://github.com/bugsee/feedback-spm", exact: "7.1.0"),
],
targets: [
.target(
Expand Down
4 changes: 2 additions & 2 deletions packages/react-native-feedback/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@bugsee/react-native-feedback",
"version": "7.0.0-beta3",
"version": "7.0.0-beta4",
"description": "In-app feedback UI for the Bugsee React Native SDK",
"license": "MIT",
"homepage": "https://www.bugsee.com",
Expand All @@ -19,7 +19,7 @@
"README.md"
],
"peerDependencies": {
"@bugsee/react-native": "^7.0.0-beta3",
"@bugsee/react-native": "^7.0.0-beta4",
"react": "*",
"react-native": ">=0.81.0"
},
Expand Down
2 changes: 1 addition & 1 deletion packages/react-native-feedback/src/__tests__/pins.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ describe('the feedback package pins the same native versions as the core', () =>
expect(gradle).toMatch(
/api\s+"com\.bugsee:bugsee-android:\$\{nativeVersions\.android\.sdk\}"/,
);
expect(versions.android.sdk).toBe('7.4.2');
expect(versions.android.sdk).toBe('7.6.0');
});

it('reaches Android feedback through Bugsee.ext(Feedback.class)', () => {
Expand Down
5 changes: 2 additions & 3 deletions packages/react-native/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,7 @@ added.

## Status: beta

This is a beta (`7.0.0-beta3`), built on the 7.x native SDKs, and the iOS SDK it
bundles is itself a beta. `latest` and `beta` both point at it for now, so a plain
This is a beta (`7.0.0-beta4`), built on the 7.x native SDKs (Android 7.6.0, iOS 7.1.0). `latest` and `beta` both point at it for now, so a plain
`yarn add @bugsee/react-native` installs it; the `@beta` form in [Install](#install)
keeps following betas once a stable release exists. The API can still change
between betas.
Expand Down Expand Up @@ -103,7 +102,7 @@ option you leave unset takes the SDK's own default.

```ts
const options = createDefaultLaunchOptions();
options.triggerByShake = false; // shake-to-report is ON by default in both SDKs
options.triggerByShake = true; // shake-to-report is OFF by default (iOS 7.1.0, Android 7.6.0)
options.triggerByScreenshot = false;
options.reportingUIEmailRequired = true;
```
Expand Down
4 changes: 2 additions & 2 deletions packages/react-native/ios/Support/Package.resolved

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion packages/react-native/ios/Support/Package.swift
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ let package = Package(
],
dependencies: [
// Exact, not a range: SwiftPM will not admit a prerelease into one.
.package(url: "https://github.com/bugsee/spm", exact: "7.0.0")
.package(url: "https://github.com/bugsee/spm", exact: "7.1.0")
],
targets: [
.target(
Expand Down
Loading
Loading