apphud

What's New in Flutter SDK v3.3.0:

• Apphud Rules — Full Rules support for Figma rule paywalls and legacy rule screens via Apphud.setRuleListener() / ApphudRuleListener (appear, purchase, dismiss, survey, and apphudRulePaywallWithoutScreen on both platforms). Also adds Apphud.checkRules(), Apphud.pendingRule(), Apphud.showPendingRuleScreen(), plus Apphud.submitPushNotificationsToken() and Apphud.handlePushNotification() for push-triggered rules. ApphudRule now exposes screenId, paywallId, and paywallIdentifier.

• Rule purchase details — apphudRulePurchaseCompleted delivers the purchased subscription / nonRenewingPurchase, the transaction on [iOS] (null for StoreKit 2 purchases) and purchase on [Android]. Failed rule purchases now report a descriptive message, errorCode, and networkIssue.

• Direct & deferred deep link attribution — Added Apphud.setDeeplinkHandler() (ApphudDeeplinkAttribution with attribution, kind (direct / deferred), and url) and Apphud.requestDeferredDeeplinkAttribution().

• BREAKING — Removed Apphud.attributeFromDeeplink(). Use Apphud.setDeeplinkHandler() and Apphud.requestDeferredDeeplinkAttribution() instead.

• iOS deep links — Direct deep links (open url, universal links via continue userActivity, launch options) are captured automatically through the Flutter app-delegate plugin. Host AppDelegate must subclass FlutterAppDelegate and call super if those lifecycle methods are overridden. Only universal links on Apphud's aphd.cc domain are reported as handled, so other deep link SDKs (Firebase Dynamic Links, OneSignal, Branch) keep receiving their own links. Set FlutterDeepLinkingEnabled to false in Info.plist unless you intentionally route the same universal links through Flutter.

• Android deep links — Forward incoming links from Activity.onCreate / onNewIntent via Apphud.handleIntent(intent) (see example app).

• Example app — Rules debug actions, Android FCM / iOS APNs push token submit, deep link handling samples, and rule/deeplink listener logging.

• Included Native SDK Versions — [Android] ApphudSDK-Android 3.4.2, [iOS] ApphudSDK 4.4.8.

What's new in v3.2.5:

• [Android] Fixed a bug that could lead to a crash while upgrading from previous SDK versions to newer.

What's New in Flutter SDK v3.2.4:

• iOS ApphudError fields fix — Errors returned from purchase, purchaseProduct, purchasePromo, restorePurchases, loadFallbackPaywalls, and showPaywall now expose networkIssue and errorCode on the Flutter side (not just message). Previously these fields were always false / null on iOS, so offline/network failures could not be detected from Dart (e.g. show cached paywalls when purchase fails with no internet).

• iOS fetchPlacements error forwarding — fetchPlacements now forwards native errors to Flutter via ApphudPlacements.error, matching Android behavior. Errors include networkIssue and errorCode when applicable.

• Included Native SDK Versions — [Android] ApphudSDK-Android 3.2.5, [iOS] ApphudSDK 4.2.3.

What's New in Flutter SDK v3.2.3:

• User-Level Remote Config & Experiment Metadata — ApphudUser (from Apphud.start() / startManually() and ApphudListener.userDidLoad) now includes remoteConfig(), remoteConfigString, experimentName, variationName, targetingName, and totalDevicesCount, so you can drive UI/logic from Mission control targeting without an app update.

• Deep-Link Attribution — Added Apphud.attributeFromDeeplink() to attribute users from a recently opened deep link and receive attribution payload data when available.

• Placement-First API (Paywalls API Cleanup) — SDK flow is now centered on placements/targetings. Legacy paywall-centric entry points were removed (including ApphudUser.rawPaywalls, Apphud.rawPaywalls(), Apphud.paywallsDidLoadCallback(), and ApphudListener.paywallsDidFullyLoad()). Migrate to placements APIs like Apphud.placements(), Apphud.placement(), Apphud.rawPlacements(), and ApphudListener.placementsDidFullyLoad().

• Richer Placement & Product Models — ApphudPlacement adds variationName. ApphudProduct adds properties, variationIdentifier, and experimentId for more accurate experiment/targeting context in purchases and analytics.

• Commitment Plan Helpers (iOS) — Added Apphud.isCommitmentPlanPreferred() and Apphud.isCommitmentPlanSupported() (iOS 26.4+; Android returns false) to check Mission control commitment-plan configuration and device support before purchase.

• Custom API Host — Added Apphud.setHost(). baseUrl on start / startManually is now applied before SDK initialization on iOS and Android.

• Mission control Naming — Public documentation updated from Product Hub to Mission control.

• Native SDK Updates — [Android] ApphudSDK-Android 3.2.5, [iOS] ApphudSDK 4.2.3.

• Dependencies of Native SDK's were updated to:
  • [Android] 3.2.4
  • [iOS] 4.2.3

• Dependencies of Native SDK's were updated to:
  • [Android] 3.2.3
  • [iOS] 4.2.2
• [Dart] ApphudUser: added totalDevicesCount, internalId, experimentName, variationName, targetingName, remoteConfigString, and remoteConfig() helper.
• [Dart] ApphudPlacement: added variationName.
• [Dart] ApphudProduct: added properties, variationIdentifier, experimentId, and isCommitmentPlanPreferred().
• [Dart] Apphud.attributeFromDeeplink() for deeplink attribution.
• [Dart] Apphud.setHost() to override API host before SDK start.
• [Dart] Apphud.isCommitmentPlanPreferred() and Apphud.isCommitmentPlanSupported() (iOS only; Android returns false).
• [iOS], [Android] Product Hub renamed to Mission control in public documentation.
• [iOS], [Android] Custom API host (baseUrl / setHost) is applied before start / startManually.
• BREAKING [Dart] Removed ApphudUser.rawPaywalls.
• BREAKING [Dart] Removed Apphud.rawPaywalls() and Apphud.paywallsDidLoadCallback().
• BREAKING [Dart] Removed ApphudListener.paywallsDidFullyLoad. Use placementsDidFullyLoad and read paywalls from ApphudPlacement.paywall.
• [iOS] Product lookup for purchaseProduct and commitment-plan checks uses ApphudPaywallsHelper.resolveProduct (ios/Classes/common/ApphudPaywallsHelper.swift, lines 22–35).

What's new in v3.1.2:

• [iOS] Fixed SKProductDiscount mapping: identifier and type are now forwarded to Flutter, and priceLocale is serialized correctly (it was hardcoded as an empty map before, which also affected introductoryPrice.priceLocale).
• [iOS], [Dart] SKProductDiscountWrapper now exposes identifier (String?) and type (SKProductDiscountType enum: introductory / subscription).
• [iOS], [Dart] SKProductWrapper now exposes the full discounts list in addition to introductoryPrice. This unblocks dynamic resolution of discountID for Apphud.purchasePromo without hardcoding it on the client side.
• [iOS] checkEligibilityForIntroductoryOffer, checkEligibilityForPromotionalOffer, checkEligibilitiesForIntroductoryOffers and checkEligibilitiesForPromotionalOffers methods were implemented (previously stubbed and not wired up).

What's new in v3.1.0:

• Billing 8 support on Android

What's new in v3.0.2:

• Fixed a bug with mapping from iOS native module of the "restorePurchases" function.
• Dependencies of Native SDK's were updated to:
• [Android] 3.0.6
• [iOS] 4.0.3

What's new in v3.0.1:

• [iOS], [Android] showPaywall method has been introduced. Show Figma paywalls in one line: final result = await Apphud.showPaywall(placement.paywall!, maxTimeout: 10, iOSAnimationStyle: IOSAnimationStyle.bottomToTop);
• [iOS] preloadPaywall method has been introduced.
• BREAKING [iOS], [Android] fetchPlacements has new optional parameter: forceRefresh. Use this when you need to apply updated audience segmentation or A/B test assignments.
• [iOS], [Android] isNonRenewingPurchaseConsumable method was introducted.
• [iOS] loadFallbackPaywalls method was introduced.
• BREAKING [iOS] collectSearchAdsAttribution method updated. Changed the return type from ApphudError? to Map<String, dynamic>?, now it returns attribution data, if any.
• BREAKING [iOS], [Android] method paywallClosed removed entirely.
• BREAKING [Android] method syncPurchasesInObserverMode removed entirely as it syncs automatically in Observer mode.
• [iOS] updateUserID method now returns ApphudUser model asynchronously.
• Dependencies of Native SDK's were updated to:
  • [Android] 3.0.4
  • [iOS] 4.0.2

• [iOS], [Android] showPaywall method has been introduced. Show Figma paywalls in one line: final result = await Apphud.showPaywall(placement.paywall!, maxTimeout: 10, iOSAnimationStyle: IOSAnimationStyle.bottomToTop);
• [iOS] preloadPaywall method has been introduced.
• BREAKING [iOS], [Android] fetchPlacements has new optional parameter: forceRefresh. Use this when you need to apply updated audience segmentation or A/B test assignments.
• [iOS], [Android] isNonRenewingPurchaseConsumable method was introducted.
• [iOS] loadFallbackPaywalls method was introduced.
• BREAKING [iOS] collectSearchAdsAttribution method updated. Changed the return type from ApphudError? to Map<String, dynamic>?, now it returns attribution data, if any.
• BREAKING [iOS], [Android] method paywallClosed removed entirely.
• BREAKING [Android] method syncPurchasesInObserverMode removed entirely as it syncs automatically in Observer mode.
• [iOS] updateUserID method now returns ApphudUser model asynchronously.
• Dependencies of Native SDK's were updated to:
• [Android] 3.0.4
• [iOS] 4.0.2

• Dependencies of Native SDK's were updated to:
• [Android] 2.9.7

• Dependencies of Native SDK's were updated to:
• [Android] 2.9.6

• [Android] proguard-rules.pro was improved
• Dependencies of Native SDK's were updated to:
• [Android] 2.9.3
• [iOS], [Android] Added platform property to Subscription model
• [Android] Added basePlanId property to Subscription model
• [Android] Added consumableInAppProduct property to purchase consumable product. (Merged https://github.com/apphud/ApphudSDK-Flutter/pull/75)

• [Android] proguard-rules.pro was added

• Dependencies of Native SDK's were updated to:

  • [Android] 2.9.2

• Google Billing Client updated to 7.1.1

• BREAKING [iOS], [Android] addAttribution method was renamed to setAttribution

• Dependencies of Native SDK's were updated to:

  • [Android] 2.9.1
  • [iOS] 3.6.2

• BREAKING [Android] ApphudListener.apphudDidReceivePurchase method was introduced

• BREAKING [iOS], [Android] paywalls method was removed

• BREAKING [iOS] rawPaywalls method was removed

• [Android] ApphudNonRenewingPurchase.purchaseToken property was introduced

• [Android] ApphudSubscription.purchaseToken property was introduced

• [Android], [iOS] deferPlacements method was introduced

• [Android] refreshUserData method was introduced

• [Android], [iOS] forceFlushUserProperties method was introduced

• [Android] refreshUserData now returns ApphudUser?

• [Android] updateUserID now returns ApphudUser?

• [Android], [iOS] attributeFromWeb method was introduced

• Dependencies of Native SDK's were updated to:

  • [Android] 2.8.3
  • [iOS] 3.5.6

• [iOS],[Android] ApphudAttributionProvider.facebook was added.

• [iOS],[Android] ApphudAttributionProvider.custom was added.

• [Android] trackPurchase method was introduced.

• [Android] syncPurchasesInObserverMode method was deprecated. All purchases on Android are now automatically intercepted and sent to Apphud.

• Dependencies of Native SDK's were updated to:

  • [Android] 2.7.0
  • [iOS] 3.4.0

• [iOS], [Android] Example App was refactored

• [Android] loadFallbackPaywalls method was introduced

• Dependencies of Native SDK's were updated to:

  • [Android] 2.6.5

• Dependencies of Native SDK's were updated to:
  • [Android] 2.6.0
  • [iOS] 3.3.6
• BREAKING ApphudGroup's products variable was changed to List<String> productIds.

• Dependencies of Native SDK's were updated to:
  • [Android] 2.4.5

• [Android] BREAKING Future<List<ApphudPlacement>> placementsDidLoadCallback() renamed to Future<ApphudPlacements> fetchPlacements()

• [Android] paywallsDidLoadCallback call result contains optional ApphudError

• [Android] refreshUserData method was introduced

• [Android] ApphudError now contains networkIssue, billingResponseCode and billingErrorTitle attributes

• [iOS], [Android] ApphudPaywall now contains variationName and parentPaywallIdentifier attributes

• Dependencies of Native SDK's were updated to:

  • [Android] 2.4.2

• [Android] fixed some build issues

• Dependencies of Native SDK's were updated to:

  • [Android] 2.3.9

• [iOS] Fixed 'addAttribution' calling issue in some cases

• [Android] Fixed 'paywalls' calling issue in some cases

• Placements: Offers a strategic method to integrate paywalls throughout your app. This feature allows developers to position paywalls effectively in different app sections, such as onboarding or settings, targeting distinct user audiences. For more comprehensive information, please refer to our Placements guide.

• [iOS], [Android] BREAKING Property 'variationName' were removed from ApphudPaywall, which was confusing developers and lead to incorrect implementations.

• [iOS] BREAKING Method 'didFetchProductsNotification' was removed.

• [iOS], [Android] BREAKING Method 'productsDidFetchCallback' was removed.

• [iOS] BREAKING Method 'refreshStoreKitProducts' was removed.

• [iOS], [Android] BREAKING Method 'purchaseWithoutValidation' was removed.

• [iOS] BREAKING Method 'didPurchaseFromPaywall' was removed.

• [Android] BREAKING Method 'refreshEntitlements' was removed.

• [iOS] BREAKING Method 'validateReceipt' was removed.

• [iOS] BREAKING Method 'migratePurchasesIfNeeded' was removed.

• [iOS] BREAKING Method 'appStoreReceipt' was removed.

• [iOS] BREAKING Method 'fetchRawReceiptInfo' was removed.

• [iOS] BREAKING Method 'isSandbox' was removed.

• [Android] BREAKING Class 'AndroidAccountIdentifiersWrapper' was removed.

• [Android] BREAKING Method 'syncPurchases' was renamed to 'syncPurchasesInObserverMode'. The ' paywallIdentifier' parameter was removed.

• [Android] BREAKING Class 'AndroidPurchaseWrapper' was modified.

• [Android], [iOS] BREAKING Class 'ApphudNonRenewingPurchase' was modified.

• [Android], [iOS] BREAKING Class 'ApphudPaywall' was modified.

• [Android], [iOS] BREAKING Class 'ApphudProduct' was modified.

• [Android], [iOS] BREAKING Class 'ApphudSubscriptionWrapper' was modified.

• [Android], [iOS] Method 'products' always returns 'ApphudProductComposite' list.

• [Android], [iOS] BREAKING 'ApphudAttributionProvider.appleSearchAds', ' ApphudAttributionProvider.facebook' were modified.

• [Android], [iOS] some fixes of the example app

• [iOS], [Android] 'paywallsDidLoadCallback' method was introduced.

• [iOS], [Android] 'placements' method was introduced.

• [iOS], [Android] 'placement' method was introduced.

• [iOS], [Android] 'placementsDidLoadCallback' method was introduced.

• [iOS], [Android] 'rawPlacements' method was introduced.

• [iOS], [Android] 'rawPaywalls' method was introduced.

• [iOS], [Android] The 'start' and 'startManually' methods now return an ApphudUser object.

• [iOS], [Android] The 'ApphudListener' 'placementsDidFullyLoad' method was introduced.

• [iOS], [Android] BREAKING The 'ApphudListener' 'userDidLoad' method now returns an ApphudUser object.

• Dependencies of Native SDK's were updated to:

  • [Android] 2.3.7
  • [iOS] 3.2.8

• [Android] Fixed restore purchase issue in some cases

• Fixed purchase result parsing issue in some cases

• [Android] BREAKING SkuDetailsWrapper was replaced by ProductDetailsWrapper because of the migration to Billing v5.

• Dependencies of Native SDK's were updated to:

  • [Android] 2.0.0

• [iOS] PUSH notifications handling was added to the example app.

• [Android] 'optOutOfTracking' and 'collectDeviceIdentifiers' are introduced

• [Android] BREAKING Method disableAdTracking is removed.

• Dependencies of Native SDK's were updated to:

  • [Android] 1.8.0

• [Android] Fixes bug with AddAttribution for AppsFlyer provider.

• [Android] Bug fixes

• Dependencies of Native SDK's were updated to:

  • [Android] 1.7.7

• [Android] Bug fixes

• Dependencies of Native SDK's were updated to:

  • [Android] 1.7.6

• [Android] Bug fixes

• Dependencies of Native SDK's were updated to:

  • [Android] 1.7.5

• [Android] Bug fixes

• Dependencies of Native SDK's were updated to:

  • [Android] 1.7.3

• [Android] Bug fixes

• Dependencies of Native SDK's were updated to:

  • [Android] 1.7.2

• [Android] Internal improvements and bug fixes with syncing purchases

• Dependencies of Native SDK's were updated to:

  • [Android] 1.7.0

• [Android] fixed incorrect ApphudListener behaviour when the ApphudPlugin instance is created twice because of Firebase.

• [Android] Internal improvements.

• Dependencies of Native SDK's were updated to:

  • [Android] 1.6.5

• [iOS] Bug fix for Flutter SDK
• Dependencies of Native SDK's were updated to:
  • [iOS] 2.8.8

• [Android] Fixed a bug when ApphudListener’s paywallsDidFullyLoad method wasn’t called in some cases.

• [Android] Added new method refreshEntitlements().

• [iOS] hasActiveSubscription(), hasPremiumAccess() improvements and bug fixes

• [iOS] Added purchasePromo() logging

• [iOS] Added checkTransactions logic for force receipt sending if a new transaction was found.

• Dependencies of Native SDK's were updated to:

  • [Android] 1.6.2
  • [iOS] 2.8.6

• [iOS] Payment swizzle was disabled for observer mode.

• [iOS] Improved interaction with Apple Search Ads attribution.

• [iOS] Updated methods description and improve documentation.

• Dependencies of Native SDK's were updated to:

  • [iOS] 2.8.3

• [iOS], [Android] Method hasPremiumAccess() was implemented.

• [Android] The parameter paywallIdentifier was introduced for the method syncPurchases().

• [iOS] The method didPurchaseFromPaywall was implemented.

• Dependencies of Native SDK's were updated to:

  • [Android] 1.6.0
  • [iOS] 2.8.1

• [Android] Fixed bug that method hasActiveSubscription was false for paying users at launch before data refreshes. Now value is cached.

• [Android] Fixed internal potential crash

• [iOS] Fixed 403 server error bug, when user could be blocked from sever 403 error code

• [iOS] Add push token cache

• [iOS] Update general cache time

• [iOS] Update some Logs

• Dependencies of Native SDK's were updated to:

  • [Android] 1.5.5
  • [iOS] 2.5.7

• [iOS] The optional parameter 'level' was added to the method enableDebugLogs(). Possible values are:

  • 'ApphudDebugLevel.low' - the same as previous amount of debug information.
  • 'ApphudDebugLevel.high' - enables printing of additional debug messages, for example HTTP requests and responses.

• [iOS], [Android] Automatic fetching of Apphud Flutter SDK version was implemented

• [iOS] BREAKING Method 'disableIDFACollection()' was removed

• [Android] Method 'grantPromotional()' was implemented

• [Android], [iOS] Class 'ApphudListener' and method 'setListener({ApphudListener? listener})' were implemented

• [Android], [iOS] BREAKING Method 'getPaywalls()' was removed. Please use ApphudListener instead.

• [iOS] BREAKING Method 'paywallsDidLoadCallback()' was removed. Please use ApphudListener instead.

• [Android] Method 'deviceId()' was implemented

• [Andoid], [iOS] Significantly improved SDK performance and caching. Now SDK will send much less requests to Apphud server.

• Dependencies of Native SDK's were updated to:

  • [Android] 1.5.3
  • [iOS] 2.5.6

• [iOS], [Android] Experiments were added. Run Experiments(A/B tests) to test different in-app purchases prices in order to find the best.

• [iOS] Apple search Ads logic was improved. Submit Apple Attribution Token to Apphud with Apphud.addAttribution().

• [iOS] Paywalls methods was improved. Paywalls are already exist after SDK initialization. Use paywalls() method.

• [iOS] paywallsDidLoadCallback() method was added. This callback is called when paywalls are fully loaded with their StoreKit products.

• [iOS] Promotionals were added. You can grant free promotional subscription to user with new method grantPromotional()

• [iOS] Fixed important bug when User Properties sometimes may not be saved when submitted simultaneously with initialisation.

• [iOS] Fixed a bug when incoming rules did not automatically mark as read.

• [Android] Paywalls events methods were implemented: paywallShown(), paywallClosed()

• [Android] Supporting of Google Billing library 4.0 was implemented

• [iOS], [Android] Properties 'experimentName' and 'variationName' were added to ApphudPaywall.

• [iOS], [Android] Bug fixing and some internal improvements.

• [iOS], [Android] Products list was removed from Example app because of deprecation due to Paywalls.

• BREAKING refactor [iOS], [Android]:

  • 'name' property was removed from ApphudPaywall

• Dependencies of Native SDK's were updated to:

  • [Android] 1.3.3
  • [iOS] 2.4.4

• Paywalls features were implemented:

  • method getPaywalls() [iOS], [Android]
  • method permissionGroups() [iOS], [Android]
  • method purchase({ ApphudProduct? product }) [iOS], [Android]
  • method paywallShown(ApphudPaywall paywall) [iOS]
  • method paywallClosed(ApphudPaywall paywall) [iOS]

• Bugs were fixed:

  • Method restorePurchases() always returns result with error [Android]

• Dependencies of Native SDK's were updated to:

  • [Android] 1.1.3
  • [iOS] 2.1.1

• BREAKING refactor [iOS], [Android]:

  • AppHud class was renamed to Apphud
  • ApphudProduct was renamed to ApphudProductComposite and was marked as deprecated
  • Method purchase(String productId) -> purchase({String? productId}). Parameter productId was marked as deprecated

• Methods are deprecated:

  • didFetchProductsNotification()
  • refreshStoreKitProducts()
  • product()
  • products()

• [iOS] Add method collectSearchAdsAttribution() to send search ads attribution data to Apphud.

• Update collection dependency
• Correct readme.md

• Upgrade the example application

• [Android] Upgrade to use ApphudSDK-Android:0.8.5
• [Fixed] [Android] bugs with wrong parameters' names according to Flutter
• [iOS] Upgrade to use ApphudSDK 1.2

First version Apphud SDK for Flutter