8.0.0-beta.1

We have opened a channel in our Discord server for participants in the Beta to ask questions and give feedback: https://discord.gg/wXEfBGem5n.

iOS Updates

StoreKit 2

Version 8.0 of the RevenueCat SDK enables full StoreKit 2 flow on the SDK and the RevenueCat backend by default.

We have been testing StoreKit 2 support in parallel to StoreKit 1 in our backend for a while and we believe it is ready for widespread use.

Here's some of the benefits you get with StoreKit 2:

• Better handling of a few specific edge cases which were unfixable with StoreKit 1:
• No more "Missing receipt" errors in Sandbox that could result in failure restoring purchases or getting trial eligibility status "unknown".
• No more "The purchased product was missing in the receipt" error that could cause an invalid receipt error when making a purchase.
• Future proofing: StoreKit 1 APIs are being progressively deprecated by Apple, and new features are being added to StoreKit 2.
• Faster processing time: More efficient and performant implementation of receipts validation. We have found that receipts validation can be ~200ms faster comparing to SK1 implementation for p95 of the requests.

In order to use StoreKit 2, you will need to configure your In-App Purchase Key in the RevenueCat dashboard.

The previously deprecated configuration option usesStoreKit2IfAvailable has been removed. Remove it from your configuration option to continue using StoreKit 2.

The SDK will automatically use StoreKit 1 where StoreKit 2 is not supported, in iOS 14 and earlier.

If for any reason you need to always use StoreKit 1, it is possible to switch back using the following configuration API:

Purchases.configure({
  apiKey: "key",
  storeKitVersion: Purchases.STOREKIT_VERSION.STOREKIT_1,
});

3rd Party Analytics SDKs

If you are using any 3rd party analytics SDKs to automatically track in-app purchases, you need to be aware most of them do not completely support logging purchases made with StoreKit 2. This is the case for some popular SDKs like Facebook, Mixpanel, OneSignal, Segment or Firebase. For these services, we recommend you use our data integrations.

If you're using the Firebase SDK, you'll need to follow these instructions to log purchases made with StoreKit 2.

Observer Mode

Version 8.0 of the SDK introduces support for observer mode when making purchases with StoreKit 2. You can enable it when configuring the SDK:

Purchases.configure({
  apiKey: "key",
  storeKitVersion: Purchases.STOREKIT_VERSION.STOREKIT_2,
  observerMode: true,
});

Additionally, because of the way in which StoreKit 2 operates, you must manually handle newly purchased transactions by calling Purchases.handleObserverModeTransaction(). Subscription updates will be automatically tracked.

# Your existing code to purchase a product with ID "product_id"
await purchaseProduct("product_id")

# Inform the SDK about the new purchase
await Purchases.handleObserverModeTransaction("product_id");

If you're using observer mode with StoreKit 1, you will need to explicitly configure the SDK to use StoreKit 1:

Purchases.configure({
  apiKey: "key",
  storeKitVersion: Purchases.STOREKIT_VERSION.STOREKIT_1,
  observerMode: true,
});

Original Application Version

If you're converting a paid app to in-app subscriptions, and want to provide existing customers with certain features, we recommend using the "original app version" field in customer info.

Because of a limitation of StoreKit 2, this field is not available if the customer is running on iOS 15. If this is a requirement for you, we recommend switching back to StoreKit 1.

Deployment Target

The minimum target for iOS has been raised to iOS 13.0.

Other Changes

• Bump PHC to version 10.0.0-beta.1 via Mark Villacampa (@MarkVillacampa)
• Add onRestoreStarted (#907) via Toni Rico (@tonidero)
• Add onPurchaseStarted event (#911) via Cesar de la Vega (@vegaro)
• [AUTOMATIC] Release/7.21.1 (#910)

Dependency Updates

• Bump ip from 1.1.8 to 1.1.9 (#909) via dependabot[bot] (@dependabot[bot])
• [AUTOMATIC BUMP] Updates purchases-hybrid-common to 9.7.2 (#908) via RevenueCat Git Bot (@RCGitBot)
  • Android 7.5.2
  • iOS 4.36.3

Other Changes

• Update cocoapods in Gemfile (#906) via Cesar de la Vega (@vegaro)