Superwall
Ask AISupport

Changelog

Release notes for the Superwall Flutter SDK

2.4.6

Enhancements

  • Adds isActive convenience property on the SubscriptionStatus class
  • Adds support for SuperwallOptions.paywalls.onBackPressed callback to react to back button presses on Android

2.4.5

Enhancements

2.4.4

Enhancements

2.4.3

Enhancements

2.4.2

Enhancements

  • Exposes Superwall.shared.overrideProductsByName variable.

2.4.1

Enhancements

  • Updates iOS SDK to 4.7.0 View iOS SDK release notes.
  • Updates Android SDK to 2.5.1 View Android SDK release notes. Note: This contains an update to Play Billing 8.
  • Adds overrideProductsByName to PaywallOptions - allows globally overriding products on any paywall by product name.
  • Adds shouldShowWebPurchaseConfirmationAlert to PaywallOptions - shows localized alert confirming successful web checkout purchases (iOS only).

Fixes

  • Fixes missing paywall info

2.4.0

Enhancements

2.3.5

Fixes

  • Adds params mapping back to EventInfo for easier forwarding to analytics

2.3.4

Enhancements

Fixes

  • Fixes issue where shouldShowWebRestorationAlert wasn't getting through to the iOS PaywallOptions.

2.3.3

Enhancements

  • Exposes shouldShowWebRestorationAlert in PaywallOptions.

2.3.2

Enhancements

2.3.1

Enhancements

Fixes

  • Fixes issue with registerPlacement blocking

2.3.0

Enhancements

  • Exposes ConfirmedAssignments and StoreProduct to superwallkit_flutter.
  • Adds Superwall.shared.getDeviceAttributes(), which returns the device attributes that are used when evaluating audience filters.
  • Updates iOS SDK to 4.4.1 View iOS SDK release notes.
  • Updates Android SDK to 2.1.1 View Android SDK release notes.

Fixes

  • Fixes issue where SuperwallEventInfo didn't contain all expected variables.
  • Fixes issue when building for app that deploys with a minimum version of iOS 13.

2.2.2

Fixes

  • Fixes issue with paywall presentation handlers not working.

2.2.1

Fixes

  • Fixes issue with iOS side of project not building.

2.2.0

Fixes

  • Fixes missing Event info

Enhancements

2.2.0-beta.2

Enhancements

2.2.0-beta.1

Enhancements

2.1.0

Enhancements

2.1.0-beta.2

Enhancements

2.1.0-beta.1

Enhancements

  • Reworks the SDK's beneath the surface to rely on Pigeon codegen
  • Improves stability
  • Improved correctness of the SDK

Note:

  • This could include some potentially breaking changes. If you find some, please open an issue or reach out to the team.

2.0.8

Enhancements

2.0.7

Fixes

  • Fixes issue when accessing presentedByPlacement* properties from a custom placement

2.0.6

Enhancements

  • Adds a subscription stream example in the example app

Fixes

  • Fixes issue with second subscriber not receiving the SubscriptionStatus broadcast stream
  • Fixes issue with PurchasedPaywallResult not properly deserialising in onDismiss

2.0.5

Enhancements

2.0.4

Enhancements

  • Updates onDismissHandler to now receive a PaywallResult also
  • Updates Android SDK to 2.0.2 View Android SDK release notes
  • handleSuperwallPlacement(SuperwallPlacementInfo eventInfo) has been replaced with handleSuperwallEvent(SuperwallEventtInfo eventInfo)

2.0.3

Fixes

  • Fixes BridgeInstance crashes
  • Adds awaiting on shared instance of BridgeCreator to avoid crashes when plugin is yet to attach

2.0.2

2.0.1

2.0.0

  • Adds entitlements to subscriptions, allowing you to set them using:
    • await Superwall.shared.setSubscriptionStatus(status) by passing in one of:
      • SubscriptionStatusActive(entitlements: entitlements))
        • Note: Passing in empty entitlements will set the subscription status to inactive
      • SubscriptionStatusInactive
      • SubscriptionStatusUnknown
  • Subscribing to subscription status updates via stream Superwall.shared.subscriptionStatus
  • SuperwallBuilder which will automatically update the state whenever subscription status changes
  • Superwall.shared.registerEvent has now been replaced with Superwall.shared.registerPlacement
  • handleSuperwallEvent(SuperwallEventInfo eventInfo) has been replaced with handleSuperwallPlacement(SuperwallPlacementInfo placementInfo)
  • PaywallPresentationHandler.onDismiss now has 2 arguments, PaywallInfo and PaywallResult

2.0.0-alpha.1

  • Adds entitlements to subscriptions, allowing you to set them using:
  • await Superwall.shared.setSubscriptionStatus(status) by passing in one of:
    • SubscriptionStatusActive(entitlements: entitlements))
      • Note: Passing in empty entitlements will set the subscription status to inactive
    • SubscriptionStatusInactive
    • SubscriptionStatusUnknown
  • Subscribing to subscription status updates via stream Superwall.shared.subscriptionStatus
  • SuperwallBuilder which will automatically update the state whenever subscription status changes
  • Superwall.shared.registerEvent has now been replaced with Superwall.shared.registerPlacement
  • handleSuperwallEvent(SuperwallEventInfo eventInfo) has been replaced with handleSuperwallPlacement(SuperwallPlacementInfo placementInfo)

1.3.11

Fixes

  • Fixes BridgeInstance crashes
  • Adds awaiting on shared instance of BridgeCreator to avoid crashes when plugin is yet to attach

1.3.10

Fixes

  • Fixes an issue on iOS where the plugin could get registered multiple times resulting in a MissingPluginException.

1.3.9

Fixes

  • Fixes a compatibility issue with WorkManager and other isolate-running libraries where the plugin would detach and cause a Missing Activity or BridgeCreator exception

Enhancements

1.3.8

Fixes

  • Removes unnecessary date comparison from PurchaseController example code.

1.3.7

Enhancements

1.3.6

Enhancements

1.3.5

Enhancements

Fixes

  • Fixes issue with PaywallInfoBridge and other bridges throwing NPE when reattaching to activities from deep sleep.

1.3.4

Enhancements

  • Adds setLocaleIdentifier(_:) and getLocaleIdentifier().

1.3.3

  • Upgrades Android SDK to 1.3.1 View Android SDK release notes
  • This fixes the issue when using Superwall with some SDK's would cause a crash (i.e. Smartlook SDK)

1.3.2

  • Updates project linting and formatting to be consistent with the Flutter style
  • Removes rogue logging statements by matching them with the provided Log level
  • Adds passIdentifiersToPlayStore to SuperwallOptions which allows you to pass user identifiers to the Play Store purchases as account identifiers. This is useful for tracking user purchases in the Play Store console.

1.3.1

Enhancements

  • Upgrades Android SDK to 1.3.0 View Android SDK release notes
  • Upgrades iOS SDK to 3.10.1 View iOS SDK release notes
  • Adds confirmAllAssignments method to Superwall which confirms assignments for all placements and returns an array of all confirmed experiment assignments. Note that the assignments may be different when a placement is registered due to changes in user, placement, or device parameters used in audience filters.

1.3.0

Enhancements

  • Upgrades iOS SDK to 3.9.1. View iOS SDK release notes
  • Upgrades Android SDK to 1.2.7 View Android SDK release notes
  • Exposes the SuperwallOption collectAdServicesAttribution for iOS. When true, this collects the AdServices attribute token, which will be process by our backend. Adds adServicesTokenRequest_start, adServicesTokenRequest_complete, and adServicesTokenRequest_fail.
  • Exposes getConfigurationStatus(), which replaces getIsConfigured(). This returns either ConfigurationStatusPending, ConfigurationStatusConfigured, or ConfigurationStatusFailed.

1.2.2

Enhancements

Fixes

  • Reapply the single bridge instance limit to fix issues with setDelegate where plugins with multiple isolates are used
  • Fixes stateful bridges by applying new state when invoking create, resolving issues seen in #23

1.2.1

Enhancements

1.2.0

Enhancements

Fixes

  • Updates compileSDKVersion to 34 fixing build issues on Android.

1.1.9

Enhancements

Fixes

  • Bumps minimum Kotlin version to 1.8.0 and Android Gradle Plugin to 8.1.0 to be able to be compatible with the latest Android SDK. This was necessary for important bug fixes.
  • SW-2868: Fixes transaction issues caused by hot restart.

1.1.8

Enhancements

1.1.7

Enhancements

1.1.6

Enhancements

1.1.5

Enhancements

1.1.4

Enhancements

Fixes

  • Updates the UUID framework dependency to the latest version to prevent conflicts.

1.1.3

Fixes

  • Fixes crash that occurred if an Android foreground service was started and the app was relaunched from a cold start.

1.1.2

Enhancements

1.1.1

Fixes

  • Fixes LocalNotification issue that was trying to initialise an int with a double.

1.1.0

Enhancements

1.0.1

Fixes

  • Fixes issue with invalid imports due to a breaking change on Android.

1.0.0

Enhancements

How is this guide?

Edit on GitHub

Welcome

Welcome to the Superwall Flutter SDK documentation

Install the SDK

Install the Superwall Flutter SDK via pub package manager.

On this page

2.4.6Enhancements2.4.5Enhancements2.4.4Enhancements2.4.3Enhancements2.4.2Enhancements2.4.1EnhancementsFixes2.4.0Enhancements2.3.5Fixes2.3.4EnhancementsFixes2.3.3Enhancements2.3.2Enhancements2.3.1EnhancementsFixes2.3.0EnhancementsFixes2.2.2Fixes2.2.1Fixes2.2.0FixesEnhancements2.2.0-beta.2Enhancements2.2.0-beta.1Enhancements2.1.0Enhancements2.1.0-beta.2Enhancements2.1.0-beta.1EnhancementsNote:2.0.8Enhancements2.0.7Fixes2.0.6EnhancementsFixes2.0.5Enhancements2.0.4Enhancements2.0.3Fixes2.0.22.0.12.0.02.0.0-alpha.11.3.11Fixes1.3.10Fixes1.3.9FixesEnhancements1.3.8Fixes1.3.7Enhancements1.3.6Enhancements1.3.5EnhancementsFixes1.3.4Enhancements1.3.31.3.21.3.1Enhancements1.3.0Enhancements1.2.2EnhancementsFixes1.2.1Enhancements1.2.0EnhancementsFixes1.1.9EnhancementsFixes1.1.8Enhancements1.1.7Enhancements1.1.6Enhancements1.1.5Enhancements1.1.4EnhancementsFixes1.1.3Fixes1.1.2Enhancements1.1.1Fixes1.1.0Enhancements1.0.1Fixes1.0.0Enhancements