Changelog

Dependency Updates [AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.2.0 (#1157) via RevenueCat Git Bot (@RCGitBot) Bump rexml from 3.3.4 to 3.3.6 (#1151) via dependabot[bot] (@dependabot[bot]) Other Changes Update fastlane-plugin-revenuecat_internal (#1158) via Cesar de la Vega (@vegaro) To view new release, visit https://github.com/RevenueCat/purchases-flutter/releases/tag/8.1.1

New Features Adds pricePerPeriod functions to PurchasesStoreProduct (#1045) via JayShortway (@JayShortway) Dependency Updates Bump micromatch from 4.0.7 to 4.0.8 (#1079) via dependabot[bot] (@dependabot[bot]) [AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.2.0 (#1081) via RevenueCat Git Bot (@RCGitBot) Android 8.7.0 iOS 5.3.1 Bump rexml from 3.3.3 to 3.3.6 in /examples/MagicWeather (#1078) via dependabot[bot] (@dependabot[bot]) Bump rexml from 3.3.3 to 3.3.6 in /examples/purchaseTesterTypescript (#1076) via dependabot[bot] (@dependabot[bot]) Bump rexml from 3.3.3 to 3.3.6 (#1077) via dependabot[bot] (@dependabot[bot]) To view new release, visit https://github.com/RevenueCat/react-native-purchases/releases/tag/8.2.0

Bugfixes Fix compatibleTopBarTrailing in MacOS and api tests (#4226) via Cesar de la Vega (@vegaro) [Paywall] Fix restoreStarted not being called on presentPaywallIfNeeded when using requiredEntitlementIdentifier (#4223) via Josh Holtz (@joshdholtz) [CustomerCenter] Move sheet and restore alert creation to ManageSubscriptionsView (#4220) via Cesar de la Vega (@vegaro) [EXTERNAL] Custom Entitlements Computation: fix support display on debug screen (#4215) by @NachoSoto (#4218) via Toni Rico (@tonidero) [Customer Center] Add padding to No thanks in promotional offer screen (#4221) via Cesar de la Vega (@vegaro) Fix version number in plist files (#4213) via Cesar de la Vega (@vegaro) fix mac os sandbox check slowness (#3879) via Andy Boedo (@aboedo) [Customer Center] Fix FeedbackSurveyView not opening (#4208) via Cesar de la Vega (@vegaro) Remove unneeded_override disable to fix linter (#4209) via Cesar de la Vega (@vegaro) Dependency Updates Bump rexml from 3.3.3 to 3.3.6 in /Tests/InstallationTests/CocoapodsInstallation (#4210) via dependabot[bot] (@dependabot[bot]) Bump rexml from 3.3.3 to 3.3.6 (#4211) via dependabot[bot] (@dependabot[bot]) Other Changes Update readme wording (#3914) via James Borthwick (@jamesrb1) Set a maximum duration for iOS 15 tests (#4229) via Cesar de la Vega (@vegaro) Paywall Components Initial Commit (#4224) via James Borthwick (@jamesrb1) [CustomerCenter] Open App Store when the user wants to update their app (#4199) via JayShortway (@JayShortway) [Customer Center] Shows a warning when the app is not the latest version (#4193) via JayShortway (@JayShortway) Fix integration tests simulator version (#4219) via Cesar de la Vega (@vegaro) Pin swift-docc-plugin to 1.3.0 (#4216) via James Borthwick (@jamesrb1) To view new release, visit https://github.com/RevenueCat/purchases-ios/releases/tag/5.3.1

New Features Paywalls can use custom in-app purchase/restore code (#1777) via James Borthwick (@jamesrb1) Bugfixes [Paywalls] Add spacing between paragraphs and make text go full width so text align applies (#1824) via Josh Holtz (@joshdholtz) Dependency Updates Bump rexml from 3.3.4 to 3.3.6 (#1823) via dependabot[bot] (@dependabot[bot]) Bump fastlane-plugin-revenuecat_internal from 4c4b8ce to 85e1c83 (#1812) via dependabot[bot] (@dependabot[bot]) Adds Detekt rules for Compose. Updates detekt to 1.23.6. (#1822) via JayShortway (@JayShortway) Other Changes Converts MagicWeather's Gradle files to Kotlin (#1821) via JayShortway (@JayShortway) To view new release, visit https://github.com/RevenueCat/purchases-android/releases/tag/8.7.0

Open App Store when the user wants to update their app (#4199) via JayShortway (@JayShortway) Move sheet and restore alert creation to ManageSubscriptionsView (#4220) via Cesar de la Vega (@vegaro) Shows a warning when the app is not the latest version (#4193) via JayShortway (@JayShortway) Add padding to No thanks in promotional offer screen (#4221) via Cesar de la Vega (@vegaro) Fix FeedbackSurveyView not opening (#4208) via Cesar de la Vega (@vegaro) Migrate to List style (#4190) via Cody Kerns (@codykerns) Hide Contact Support button if URL can't be created (#4192) via Cesar de la Vega (@vegaro) Improving customer center buttons (#4165) via Cody Kerns (@codykerns) Clean up colors in WrongPlatformView and NoSubscriptionsView (#4204) via Cesar de la Vega (@vegaro) CustomerCenterViewModel checks whether the app is the latest version (#4169) via JayShortway (@JayShortway) Corrects references from ManageSubscriptionsButtonStyle to ButtonsStyle. (#4186) via JayShortway (@JayShortway) Customer center improvements (#4166) via James Borthwick (@jamesrb1) replace color(from colorInformation:) global with extension (#4183) via Andy Boedo (@aboedo) Enable customer center tests (#4171) via James Borthwick (@jamesrb1) To view new release, visit https://github.com/RevenueCat/purchases-ios/releases/tag/5.3.0-customercenter.alpha.4

Bugfixes Refine StoreKitVersion logging in configure function (#1068) via Will Taylor (@fire-at-will) Dependency Updates [AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.1.0 (#1074) via RevenueCat Git Bot (@RCGitBot) Android 8.6.0 Android 8.5.0 iOS 5.3.0 Bump rexml from 3.2.8 to 3.3.3 in /examples/MagicWeather (#1072) via dependabot[bot] (@dependabot[bot]) Bump rexml from 3.2.8 to 3.3.3 in /examples/purchaseTesterTypescript (#1066) via dependabot[bot] (@dependabot[bot]) Bump rexml from 3.2.9 to 3.3.3 (#1065) via dependabot[bot] (@dependabot[bot]) Other Changes Typo fix in v8-MIGRATION.md (#1071) via Will Taylor (@fire-at-will) To view new release, visit https://github.com/RevenueCat/react-native-purchases/releases/tag/8.1.0

Dependency updates Update compose-bom to 2024.08.00 (#1817) via Toni Rico (@tonidero) Other Changes Update debug view snapshot tests (#1819) via Toni Rico (@tonidero) To view new release, visit https://github.com/RevenueCat/purchases-android/releases/tag/8.6.0

New Features Price rounding logic (#4132) via James Borthwick (@jamesrb1) Bugfixes [Customer Center] Migrate to List style (#4190) via Cody Kerns (@codykerns) [Paywalls] Improve locale consistency (#4158) via Josh Holtz (@joshdholtz) Set Paywalls Tester deployment target to iOS 15 (#4196) via James Borthwick (@jamesrb1) [Customer Center] Hide Contact Support button if URL can't be created (#4192) via Cesar de la Vega (@vegaro) Fix the setting for SKIP_INSTALL in Xcode project (#4195) via Andy Boedo (@aboedo) [Customer Center] Improving customer center buttons (#4165) via Cody Kerns (@codykerns) Revert workaround for iOS 18 beta 5 SwiftUI crash (#4173) via Mark Villacampa (@MarkVillacampa) [Paywalls] Make iOS version calculation lazy (#4163) via Mark Villacampa (@MarkVillacampa) [Paywalls] Observe PurchaseHandler when owned externally (#4097) via James Borthwick (@jamesrb1) Other Changes [Customer Center] Clean up colors in WrongPlatformView and NoSubscriptionsView (#4204) via Cesar de la Vega (@vegaro) Fix failing all-tests and retry more flaky tests (#4188) via Josh Holtz (@joshdholtz) Compatibility content unavailable improvements (#4197) via James Borthwick (@jamesrb1) Create lane to enable customer center (#4191) via Cesar de la Vega (@vegaro) XCFramework artifacts in CircleCI (#4189) via Andy Boedo (@aboedo) [Customer Center] CustomerCenterViewModel checks whether the app is the latest version (#4169) via JayShortway (@JayShortway) export RevenueCatUI xcframework (#4172) via Andy Boedo (@aboedo) Corrects references from ManageSubscriptionsButtonStyle to ButtonsStyle. (#4186) via JayShortway (@JayShortway) Speed up carthage installation tests (#4184) via Andy Boedo (@aboedo) Customer center improvements (#4166) via James Borthwick (@jamesrb1) replace color(from colorInformation:) global with extension (#4183) via Andy Boedo (@aboedo) Fix tests in main (#4174) via Andy Boedo (@aboedo) Enable customer center tests (#4171) via James Borthwick (@jamesrb1) [Customer Center] Initial implementation (#3967) via Cesar de la Vega (@vegaro) To view new release, visit https://github.com/RevenueCat/purchases-ios/releases/tag/5.3.0

Other Changes Update fastlane-plugin-revenuecat_internal (#1133) via Mark Villacampa (@MarkVillacampa) update purchases_flutter dependency to 7.0.0 on purchases_ui_flutter (#1132) via Mark Villacampa (@MarkVillacampa) To view new release, visit https://github.com/RevenueCat/purchases-flutter/releases/tag/7.0.1

This latest release updates the Android SDK dependency from v7 to v8 to use BillingClient 7 and updates the iOS SDK dependency from v4 to v5 to use StoreKit 2 by default in the SDK. Migration Guides See Android Native - V8 API Migration Guide for a more thorough explanation of the Android changes. See iOS Native - V5 Migration Guide for a more thorough explanation of the iOS changes. Notably, this version uses StoreKit 2 to process purchases by default. New Minimum OS Versions This release raises the minumum required OS versions to the following: iOS 13.0 tvOS 13.0 watchOS 6.2 macOS 10.15 Android: SDK 21 (Android 5.0) In-App Purchase Key Required for StoreKit 2 In order to use StoreKit 2, you must configure your In-App Purchase Key in the RevenueCat dashboard. You can find instructions describing how to do this here. usesStoreKit2IfAvailable is now storeKitVersion When configuring the SDK, the usesStoreKit2IfAvailable parameter has been replaced by an optional storeKitVersion parameter. It defaults to letting the iOS SDK determine the most appropriate version of StoreKit at runtime. If you'd like to use a specific version of StoreKit, you may provide a value for storeKitVersion like so: Purchases purchases = GetComponent<Purchases>(); Purchases.PurchasesConfiguration purchasesConfiguration = Purchases.PurchasesConfiguration.Builder.Init("api_key") .SetStoreKitVersion(Purchases.StoreKitVersion.StoreKit2) .Build(); purchases.Configure(purchasesConfiguration); Observer Mode is now PurchasesAreCompletedBy Version 7.0 of the SDK deprecates the term "Observer Mode" (and the APIs where this term was used), and replaces it with PurchasesAreCompletedBy (either RevenueCat or your app). When specifying that your app will complete purchases, you must provide the StoreKit version that your app is using to make purchases on iOS. If your app is only available on Android, you may provide any value since the native Android SDK ignores this value. You can enable it when configuring the SDK: Purchases purchases = GetComponent<Purchases>(); Purchases.PurchasesConfiguration purchasesConfiguration = Purchases.PurchasesConfiguration.Builder.Init("api_key") .SetPurchasesAreCompletedBy(Purchases.PurchasesAreCompletedBy.MyApp, Purchases.StoreKitVersion.StoreKit2) .Build(); purchases.Configure(purchasesConfiguration); ⚠️ Observing Purchases Completed by Your App on macOS By default, when purchases are completed by your app using StoreKit 2 on macOS, the SDK does not detect a user's purchase until after the user foregrounds the app after the purchase has been made. If you'd like RevenueCat to immediately detect the user's purchase, call Purchases.recordPurchase(productID) for any new purchases, like so: Purchases purchases = GetComponent<Purchases>(); purchases.recordPurchase(productID, (transaction, error) => { ... }); Observing Purchases Completed by Your App with StoreKit 1 If purchases are completed by your app using StoreKit 1, you will need to explicitly configure the SDK to use StoreKit 1: Purchases purchases = GetComponent<Purchases>(); Purchases.PurchasesConfiguration purchasesConfiguration = Purchases.PurchasesConfiguration.Builder.Init("api_key") .SetPurchasesAreCompletedBy(Purchases.PurchasesAreCompletedBy.MyApp, Purchases.StoreKitVersion.StoreKit1) .Build(); purchases.Configure(purchasesConfiguration); Full migration guide to V7: Unity - V7 API Migration Guide New Features Amazon: Add getAmazonLWAConsentStatus method to support Quick Subscribe (#442) via Mark Villacampa (@MarkVillacampa) Dependency Updates Bump rexml from 3.2.9 to 3.3.3 (#486) via dependabot[bot] (@dependabot[bot]) Bump danger from 9.4.3 to 9.5.0 (#487) via dependabot[bot] (@dependabot[bot]) Bump fastlane from 2.221.1 to 2.222.0 (#480) via dependabot[bot] (@dependabot[bot]) Update VERSIONS.md to include Billing client version and update fastlane plugin (#476) via Toni Rico (@tonidero) Other Changes Fix Gemfile.lock with new fastlane plugin dependencies (#479) via Toni Rico (@tonidero) Update Unity IAP compatiiblity (#475) via Andy Boedo (@aboedo) To view new release, visit https://github.com/RevenueCat/purchases-unity/releases/tag/7.0.0

Fix project.pbxproj (#4122) Fix BackendGetCustomerCenterConfigTests (#4124) Add contact support button (#4023) Fix checking eligibility (#4138) Make colors nullable (#4134) To view new release, visit https://github.com/RevenueCat/purchases-ios/releases/tag/5.2.2-customercenter.alpha.2

Dependency Updates Bump nokogiri from 1.16.5 to 1.16.6 (#3980) via dependabot[bot] (@dependabot[bot]) Other Changes Only Retry POST Receipt Paths for 429 (#4107) via Will Taylor (@fire-at-will) Clarify Instructions to Run All Manual Tests (#4112) via Will Taylor (@fire-at-will) Fixes trigger_all_tests.yml triggering on every issue comment (#4114) via JayShortway (@JayShortway) Fixes a typo in the bug_report issue template (#3945) via JayShortway (@JayShortway) [External] Add missing SwiftUI environment for previews (#4109) via @noahsmartin (#4110) via Andy Boedo (@aboedo) Remove notify-on-non-patch-release-branches (#4106) via Cesar de la Vega (@vegaro) To view new release, visit https://github.com/RevenueCat/purchases-ios/releases/tag/5.2.2

Bugfixes Retry Requests with HTTP Status 429 (#4048) via Will Taylor (@fire-at-will) Use newer Alert API for showing customer restored alert (#4078) via Mark Villacampa (@MarkVillacampa) Dependency Updates Bump fastlane-plugin-revenuecat_internal from 5f55466 to d5f0742 (#4101) via dependabot[bot] (@dependabot[bot]) Other Changes PaywallsTester: fix macOS build (#4093) via Andy Boedo (@aboedo) Cleanup trigger_all_tests github workflow (#4088) via Toni Rico (@tonidero) Fix PaywallsTester by changing TestData DEBUG checks (#4092) via Cesar de la Vega (@vegaro) Add missing @PublicForExternalTesting that broke PaywallsTester (#4087) via Cesar de la Vega (@vegaro) Fix workflow permission check logic (#4084) via Toni Rico (@tonidero) Fix prepare next version job (#4085) via Toni Rico (@tonidero) [CI]: fix CI test trigger parameters (#4076) via Andy Boedo (@aboedo) Fix docs deploy and add manual trigger on CI (#4081) via Josh Holtz (@joshdholtz) To view new release, visit https://github.com/RevenueCat/purchases-ios/releases/tag/5.2.1

Bugfixes Fix syncObserverModeAmazonPurchase deprecation warning (#1115) via Toni Rico (@tonidero) To view new release, visit https://github.com/RevenueCat/purchases-flutter/releases/tag/6.30.2

New Features Paywalls with custom purchase and restore logic handlers (#3973) via James Borthwick (@jamesrb1) Bugfixes Prevent paywall PurchaseHandler from being cleared on rerender (#4035) via Josh Holtz (@joshdholtz) Update Purchase Tester for 5.0.0 (#4015) via Will Taylor (@fire-at-will) Dependency Updates Bump fastlane from 2.221.0 to 2.221.1 (#3977) via dependabot[bot] (@dependabot[bot]) Other Changes Bring official xcodes back to CI (#4029) via Cesar de la Vega (@vegaro) Paywalls tester with sandbox purchases (#4024) via James Borthwick (@jamesrb1) Update v5 migration guide to contain current latest version (#4019) via Toni Rico (@tonidero) CI Build Docs Improvements (#4014) via Will Taylor (@fire-at-will) Use available resource class for backend-integration-tests-offline-job (#4013) via Will Taylor (@fire-at-will) Add X-Preferred-Locales header (#4008) via Cesar de la Vega (@vegaro) To view new release, visit https://github.com/RevenueCat/purchases-ios/releases/tag/5.1.0

Bugfixes Add OptIn annotation on paywalls code (#1112) via Cesar de la Vega (@vegaro) To view new release, visit https://github.com/RevenueCat/purchases-flutter/releases/tag/6.30.1

New Features Add support for DEFERRED upgrades and updates purchases-hybrid-common to 11.1.1 (#1029) via RevenueCat Git Bot (@RCGitBot) Android 7.12.0 iOS 4.43.2 iOS 4.43.1 Dependency Updates [AUTOMATIC BUMP] Updates purchases-hybrid-common to 11.0.0 (#1026) via RevenueCat Git Bot (@RCGitBot) Android 7.12.0 iOS 4.43.2 iOS 4.43.1 Bump fastlane from 2.221.0 to 2.221.1 (#1023) via dependabot[bot] (@dependabot[bot]) Bump ws from 6.2.2 to 6.2.3 (#1021) via dependabot[bot] (@dependabot[bot]) Bump fastlane from 2.220.0 to 2.221.0 (#1020) via dependabot[bot] (@dependabot[bot]) Other Changes get_phc_version now also checks PHC UI versions (#1019) via JayShortway (@JayShortway) To view new release, visit https://github.com/RevenueCat/react-native-purchases/releases/tag/7.28.0

New Features Add support for DEFERRED upgrades and updates purchases-hybrid-common to 11.1.0 (#1108) via RevenueCat Git Bot (@RCGitBot) Android 7.12.0 iOS 4.43.2 iOS 4.43.1 Dependency Updates [AUTOMATIC BUMP] Updates purchases-hybrid-common to 11.0.0 (#1106) via RevenueCat Git Bot (@RCGitBot) Android 7.12.0 iOS 4.43.2 iOS 4.43.1 Bump fastlane from 2.220.0 to 2.221.1 (#1102) via dependabot[bot] (@dependabot[bot]) Other Changes Adds .aiexclude (#1104) via JayShortway (@JayShortway) get_phc_version now also checks PHC UI versions (#1100) via JayShortway (@JayShortway) Removes api key from integration test (#1098) via JayShortway (@JayShortway) To view new release, visit https://github.com/RevenueCat/purchases-flutter/releases/tag/6.30.0

New Features Add DEFERRED replacement mode (#1751) via Toni Rico (@tonidero) Bugfixes Use correct product context with DEFERRED purchases (#1766) via Toni Rico (@tonidero) Call callbacks on DEFERRED purchases (#1764) via Toni Rico (@tonidero) Dependency Updates Bump fastlane from 2.221.0 to 2.221.1 (#1758) via dependabot[bot] (@dependabot[bot]) Other Changes Adds .aiexclude (#1762) via JayShortway (@JayShortway) To view new release, visit https://github.com/RevenueCat/purchases-android/releases/tag/8.2.0

Dependency Updates Bump fastlane from 2.220.0 to 2.221.0 (#3971) via dependabot[bot] (@dependabot[bot]) Bump rexml from 3.2.6 to 3.2.8 (#3907) via dependabot[bot] (@dependabot[bot]) Bump fastlane-plugin-revenuecat_internal from 8ec0072 to 5f55466 (#3938) via dependabot[bot] (@dependabot[bot]) Other Changes Fix cocoapods installation tests (#3981) via Toni Rico (@tonidero) Remove carthage from CI and update release jobs to use xcode 15 and M1 (#3927) via Cesar de la Vega (@vegaro) Bring back offline integration tests on M1 (#3976) via Toni Rico (@tonidero) Fix Carthage (#3978) via James Borthwick (@jamesrb1) Revert "Run offline backend integration tests on M1 machines (#3961)" (#3974) via Toni Rico (@tonidero) Run offline backend integration tests on M1 machines (#3961) via Toni Rico (@tonidero) Xcode project with RevenueCatUI + Tests (#3960) via James Borthwick (@jamesrb1) Clone to spm using fastlane (#3926) via James Borthwick (@jamesrb1) finishTransactions/ObserverMode -> PurchasesAreCompletedBy (#3947) via James Borthwick (@jamesrb1) Switch tests for iOS 12 and 13 to M1 (#3958) via Toni Rico (@tonidero) Fix prepare next version job (#3939) via Toni Rico (@tonidero) To view new release, visit https://github.com/RevenueCat/purchases-ios/releases/tag/4.43.1

Dependency Updates [AUTOMATIC BUMP] Updates purchases-hybrid-common to 10.9.0 (#1096) via RevenueCat Git Bot (@RCGitBot) Android 7.11.1 iOS 4.43.0 To view new release, visit https://github.com/RevenueCat/purchases-flutter/releases/tag/6.29.4

Dependency Updates [AUTOMATIC BUMP] Updates purchases-hybrid-common to 10.9.0 (#543) via RevenueCat Git Bot (@RCGitBot) Android 7.11.1 iOS 4.43.0 Other Changes Update RELEASING.md (#511) via Cesar de la Vega (@vegaro) Fix cordova ios integration tests (#542) via Toni Rico (@tonidero) To view new release, visit https://github.com/RevenueCat/cordova-plugin-purchases/releases/tag/5.7.8

Dependency Updates Bump braces from 3.0.2 to 3.0.3 (#1015) via dependabot[bot] (@dependabot[bot]) [AUTOMATIC BUMP] Updates purchases-hybrid-common to 10.9.0 (#1014) via RevenueCat Git Bot (@RCGitBot) Android 7.11.1 iOS 4.43.0 Other Changes [EXTERNAL] Refactor magicweather package item via #1001 @onamfc (#1016) via Toni Rico (@tonidero) To view new release, visit https://github.com/RevenueCat/react-native-purchases/releases/tag/7.27.4

For a full migration guide check v8-MIGRATION.md Breaking Changes Support BC7 (#1737) via Toni Rico (@tonidero) New APIs: SubscriptionOption.installmentInfo which contains information about installment plans you might want to display in your paywall. PurchasesConfiguration.pendingTransactionsForPrepaidPlansEnabled allows to enable pending prepaid subscriptions. Breaking changes Increase min Sdk to 21. This was increased in BC7 Increase min kotlin version to 1.7.0 Remove UpgradeInfo Remove all purchasePackage and purchaseProduct methods using UpgradeInfo. If you want to perform upgrades/downgrades, please migrate to use the purchase(PurchaseParams) method, which has options to perform that operation. Other Changes Bump kotlin to 1.8 (#1726) To view new release, visit https://github.com/RevenueCat/purchases-android/releases/tag/8.0.0

Dependency Updates [AUTOMATIC BUMP] Updates purchases-hybrid-common to 10.8.0 (#1091) via RevenueCat Git Bot (@RCGitBot) Android 7.11.0 iOS 4.42.0 To view new release, visit https://github.com/RevenueCat/purchases-flutter/releases/tag/6.29.3