b2metric_sdk

Releases

1. ▸▾1.1.015 Sept 2026

   A/B testing. Configure experimentIds to take part in experiments created in your B2Metric panel, then read the group this device was assigned to with

   Added

   • A/B testing. Configure experimentIds to take part in experiments created in your B2Metric panel, then read the group this device was assigned to with getExperimentGroupId(). Assignments are fetched when the SDK starts and at the beginning of each session, stored on the device, and read synchronously, so a variant is available during a build with no loading state to thread through the widget tree.
   • experiments (a ValueListenable) and experimentChanges (a broadcast Stream) for rebuilding when assignments change. Both carry the same snapshot; the SDK ships neither a provider nor an InheritedWidget, so it does not compete with the app's own state management.
   • getExperimentAssignments() and refreshExperiments().
   • experimentsBaseUrl to point assignment requests at a test or staging environment.
   • ExperimentAssignment and ExperimentsSnapshot type exports.

   Notes

   • The experiments module stays off until experimentIds is set, so existing integrations are unaffected by upgrading.
   • Reads return null when the device is outside the experiment's audience, the experiment has ended, or the first refresh has not landed yet. Give every experiment a default.
   • Assignment follows the device rather than the signed-in user, so setUser never moves anyone between groups and a variant cannot change underneath someone at login.
   • Stored assignments are kept when a refresh fails or the device is offline.

   Open source →