Nami SDK Early Access Releases

Changelog

v3.1.21-beta.01 (Nov 19, 2023)

Bug Fixes

• Ventura: Resolve an issue with showing the right product on the right slide
• Ventura: Resolve an issue that prevented buy sku when legal terms is checked

Enhancements

• Ventura: Allow portrait mode on tablet
• Ventura: Add support for validating product groups

v3.1.19-beta.01 (Nov 8, 2023)

Enhancements

• Initial support for Ventura paywall template

v3.1.18-beta.01 (Nov 6, 2023)

Maintenance

• Downgrade Moshi for a SDK build variant

v3.1.13-rc.01 (Sep 26, 2023)

Bug Fixes

• Guard NamiPaywallManager.isPaywallOpen if SDK has not been initialized
• Only enable ML functionality on supported accounts

Enhancements

• Provide an optional completion callback for Nami.configure

v3.1.10-beta.03 (Sep 19, 2023)

Bug Fixes

• Attempt to resolve Android 13 crash by moving to safer back press methods
• Remove a proguard addition that may be leading to another crash

Maintenance

• Upload mapping outputs when we do a release
• Bump targetSdk and compileSdk to 33
• Bump some dependencies due to above version changes

v3.1.10-beta.02 (Sep 16, 2023)

Enhancements

• Refine when purchase history updates from Google Play occur

v3.1.10-beta.01 (Sep 15, 2023)

Bug Fixes

• Update purchase history from Google Play more often to help ensure cross-grade flow isn't engaged after a subscription expires

v3.0.0-alpha.12 (November 9, 2022)

New Features

• Support for V1 of Brighton paywall template
• Advanced use case: support for overriding device language with a NamiLanguageCode

Enhancements

• Add additional symbols for use within paywall templates
• Support changing symbol color on templates that support them

Bug Fixes

• Improved robustness of gathering required Google Play product details before paywall display

v3.0.0-alpha.11 (November 4, 2022)

Changelog

New Features

• Added LaunchCampaignResult.PurchaseChanged to NamiCampaignManager.launch result callback to surface changes purchase events occurring the launch lifecycle.
• Added additional paywallActionCallback to NamiCampaignManager.launch to allow the monitoring of the user's paywall interactions (see: NamiPaywallAction) as they occur
• Added NamiPaywallManager.registerCloseHandler to allow override of paywall close behavior when implemented
• Support for paywall templates with product selection that is separated from the buy action

Enhancements

• UI improvements for paywall templates with horizontal products

v3.0.0-alpha.10 (October 25, 2022)

Changelog

Bug Fixes

• Removed a background service responsible for some crashes
• Improved paywall display behavior on Android TV
• Fixed calculation for Smart Text variable priceDifferenceFromSku

Enhancements

• Further improvements to support for Nami cross-platform SDKs
• Additional enhancements to support for upcoming paywall templates

v3.0.0-alpha.09 (October 18, 2022)

Changelog

New Features

• Added a new paywall Smart Text variable: priceDifferenceFromSku
• Improved support for customers bringing their own Play Billing implementation

Enhancements

• Improved support for Nami cross-platform SDKs (e.g. Flutter, React Native, Xamarin)
• Add initial support for upcoming paywall templates

v3.0.0-alpha.08 (October 11, 2022)

Changelog

New Features

• Lower Android minimum SDK version to 25. See compatibility guide for details.

Bug Fixes

• Fix bug that prevented past purchase validation for products no longer present on paywalls
• Fix another crash related to a SDK service that attempts to start when app is in background

Maintenance

• Change Basic sample app to minimum SDK version 25
• Fix UI thread issue in Java sample code

v3.0.0-alpha.07 (September 30, 2022)

Changelog

New Features

• New paywall templates: Mantis, Venice
• Added a new Smart Text variable: percentagePriceDifferenceFromSku
• Added NamiCustomerManager.registerAccountStateHandler to make it easier to respond to login and logout calls. See SDK Reference for details.
• Initial support for paywalls with more than one group of products
• Initial support for Android TV

Bug Fixes

• Fix crash due to unhandled exception for API paginated requests
• Fix crash related to a SDK service that attempts to start when app is in background
• For templates supporting gradients, correct gradient direction

Enhancements

• Provide better error message in logs when campaign launch fails
• Adjust template padding behavior

v3.0.0-alpha.06 (September 9, 2022)

Changelog

This releases focuses on resolving known issues from prior releases, polish items related to paywall templates, and improving upgrade/downgrade support.

Bug Fixes

• Improve feature badge rendering on trident template
• Improve product button rendering on starfish template
• Add missing product subtext on starfish template
• Resolve missing impression and transaction events

Enhancements

• Add gradient color support
• Improve upgrade/downgrade handling for apps with tiers of service
• Add additional debug level logging during upgrade/downgrade scenarios

v3.0.0-alpha.05 (September 2, 2022)

Changelog

This releases focuses on improvements to Nami's next-generation paywall template engine and adds support for new Smart Text variables

New Features

• Initial support for 3-product paywall template (codename: starfish)
• Add new Smart Text variables: pricePerMonth, durationInMonths, periodInMonths, periodNumberInMonths (see more: https://docs.namiml.com/docs/paywall-smart-text)

Bug Fixes

• Improved support for apps with a large number of SKUs

Enhancements

• Improved support for paywall templates (codenames: penguin, pacific, trident)
• Additional logging if the NamiPurchaseCompleteHandler callback can't be invoked

Known Issues

• Gradients are not yet fully supported in paywall templates that use them
• Device paywall impression and transaction events are not consistently reported to the Nami backend

v3.0.0-alpha.04 (August 17, 2022)

Changelog

This releases focuses on supporting Nami's next-generation paywall template engine, including initial support for three templates.

New Features

• Support for paywall templates (codenames: penguin, pacific, trident)

Enhancements

• Add NamiPurchase object to NamiPurchaseCompleteResult
• Add Play Billing purchase token to NamiPurchase

Known Bugs

• Live campaigns containing the 3-product paywall template (codename: starfish), results in a crash.
• Device paywall impression and transaction events are not being reported to the Nami backend

v3.0.0-alpha.03 (July 27, 2022)

Changelog

This release is focused on stabilizing the SDK interfaces with the V3 spec as well as setting the stage for rendering the next-generation paywall templates in upcoming alpha releases.

Breaking Changes

• Renamed NamiEntitlementsManager.registerChangeListener to NamiEntitlementsManager.registerActiveEntitlementsHandler
• Renamed NamiAnalyticsSupport.registerAnalyticsListener to NamiAnalyticsSupport.registerAnalyticsHandler
• Renamed NamiCustomerManager.registerCustomerJourneyChangeListener to NamiCustomerManager.registerJourneyStateHandler
• Renamed NamiPurchaseManager.registerPurchasesChangedListener to NamiPurchaseManager.registerPurchasesChangedHandler

New Features

• N/A

Bug Fixes

• Fixed crash in background service when SDK not initialized
• Fixed NamiEntitlementsManager.registerActiveEntitlementsHandler callback not firing
• Fixed NamiCustomerManager.registerJourneyStateHandler callback not firing
• Better error handling for incorrect App Platform ID

Enhancements

• Surface paywall sku entitlement reference for linked paywall

Maintenance

• Parse backend data for next-gen paywalls
• Bring Jetpack Compose related dependencies into the project
• Bump Kotlin version to 1.6.10
• Bump R8 version to 3.3.28 to resolve minify issues

v3.0.0-alpha.02 (July 12, 2022)

Changelog

This is the second alpha in the 3.0.0 early access release series. Changes include:

New Features

• N/A

Breaking Changes

• Remove NamiPaywallManager.registerApplicationAutoRaisePaywallBlocker

Enhancements

• Paywall impressions, session, and transaction events upgraded to V3 spec; will now show up in Control Center > Developer
• Updated Basic sample app to include Refresh Entitlements button
• Improved log message when a campaign with linked paywall is launched, but NamiPaywallManager.renderCustomUiHandler is not implemented

Bugfixes

• Fix pro guard issue on CampaignRuleType
• Put class name in logging in the event json parsing fails
• Add correct value to source field when sending transaction event to Nami backend
• Handle case where a past purchased product, not configured in current Nami Control Center instance, prints a helpful log rather than 400

Maintenance

• Rename NamiPaywallRaiseListener to NamiPaywallDataProvider to align with V3 spec
• Update Nami configure function parameter names to align with V3 spec
• Removed dead code related to V2 api spec

v3.0.0-alpha.01 (July 6, 2022)

Changelog

This is the first alpha in the 3.0.0 release series. Changes include includes:

• Support for next-generation campaigns supporting paywall a/b testing
• Simple, yet more powerful mechanism to present paywalls
• SDK usability improvements including easier to understand interfaces
• Updated internal API calls to latest spec for improved performance and robustness

New Features

• Improved NamiCampaignManager and NamiPaywallManager for new style campaigns and paywalls
• Add NamiEntitlementManager.refresh to get latest entitlement state from Nami servers

Breaking Changes

• Paywalls are now raised using NamiCampaignManager

  • NamiPaywall.raisePaywall replaced by NamiCampaignManager.launch

• Simplified linking device to an external account via external ID

  • Nami.setExternalIdentifier replaced by NamiCustomerManager.login
  • Nami.clearExternalIdentifier replaced by NamiCustomerManager.logout
  • Nami.getExternalIdentifier replaced by NamiCustomerManager.loggedInId
  • Added NamiCustomerManager.isLoggedIn
  • Removed NamiExternalIdentifierType

• Updated several interfaces for clarity

  • Renamed NamiEntitlementManager.registerEntitlementChangeListener to NamiEntitlementManager.registerChangeHandler
  • Renamed NamiPaywallManager.registerSignInListener to NamiPaywallManager.registerSignInHandler
  • Renamed NamiPaywallManager.registerPaywallRaiseListener to NamiPaywallManager.renderCustomUiHandler`

• Ability to set untrusted entitlements moving to backend API

  • Removed NamiEntitlmentManager.setEntitlements
  • Removed NamiEntitlmentManager.getEntitlements
  • Removed NamiEntitlmentManager.clearEntitlements
  • Removed NamiPlatformType

Enhancements

• N/A

Bugfixes

• Gracefully handle unknown (to the SDK) paywall types

Maintenance

• Update sample apps to use new interfaces
• Migrate core API requests to Nami V3 API spec
• Update maven publish location to https://packages.namiml.com/NamiSDK/Android/
• Dependency update for building on M1 Macs