10.0.2

RevenueCat SDK

📦 Dependency Updates

10.0.1

RevenueCat SDK

📦 Dependency Updates

10.0.0

RevenueCat SDK

💥 Breaking Changes

This version is only compatible with Capacitor V7+. Please check official documentation on how to migrate your app to the new Capacitor version before upgrading the plugin to this version: https://capacitorjs.com/docs/updating/7-0

📦 Dependency Updates

9.2.1

RevenueCat SDK

📦 Dependency Updates

9.2.0

RevenueCat SDK

✨ New Features

🔄 Other Changes

9.1.0

RevenueCat SDK

✨ New Features

9.0.9

RevenueCat SDK

📦 Dependency Updates

🔄 Other Changes

9.0.8

RevenueCat SDK

🐞 Bugfixes

📦 Dependency Updates

🔄 Other Changes

9.0.7

RevenueCat SDK

📦 Dependency Updates

9.0.6

RevenueCat SDK

📦 Dependency Updates

🔄 Other Changes

9.0.5

RevenueCat SDK

📦 Dependency Updates

9.0.4

RevenueCat SDK

📦 Dependency Updates

9.0.3

RevenueCat SDK

📦 Dependency Updates

9.0.2

RevenueCat SDK

📦 Dependency Updates

🔄 Other Changes

9.0.1

Bugfixes

Dependency Updates

Other Changes

9.0.0

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

New Minimum OS Versions

This release raises the minumum required OS versions to the following:

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: STOREKIT_VERSION 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.configure({
    apiKey,
    STOREKIT_VERSION.STOREKIT_1,
});

Observer Mode is now PurchasesAreCompletedBy

Version 9.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.configure({
    apiKey: apiKey,
    appUserID: appUserID,
    purchasesAreCompletedBy: {
        type: PURCHASES_ARE_COMPLETED_BY_TYPE.MY_APP,
        storeKitVersion: STOREKIT_VERSION.STOREKIT_2,
    },
});

⚠️ 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:

await Purchases.recordPurchase(productID);

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:

await Purchases.configure({
    apiKey: REVENUECAT_API_KEY,
    purchasesAreCompletedBy: {
        type: PURCHASES_ARE_COMPLETED_BY_TYPE.MY_APP,
        storeKitVersion: STOREKIT_VERSION.STOREKIT_2,
    }
});

Full migration guide to V9: Capacitor - V9 API Migration Guide

8.0.0

Breaking Changes

7.7.1

Bugfixes

7.7.0

New Features

Dependency Updates

7.6.1

Dependency Updates

7.6.0

New Features

Dependency Updates

7.5.10

Bugfixes

Dependency Updates

7.5.9

Dependency Updates

Other Changes

7.5.8

Dependency Updates

7.5.7

Dependency Updates

7.5.6

Dependency Updates

Other Changes

7.5.5

Dependency Updates

Other Changes

7.5.4

Dependency Updates

7.5.3

Dependency Updates

7.5.2

Dependency Updates

Other Changes

7.5.1

Dependency Updates

7.5.0

Dependency Updates

Other Changes

7.4.0

Dependency Updates

Other Changes

7.3.2

Bugfixes

Dependency Updates

7.3.1

Dependency Updates

7.3.0

Dependency Updates

7.2.0

New Features

Dependency Updates

Other Changes

7.1.1

Dependency Updates

7.1.0

Other Changes

Dependency Updates

7.0.0

RevenueCat Capacitor SDK v7 is here!! 😻

This latest release updates the SDK to use BillingClient 6 in Android. This version of BillingClient brings little change compared with BillingClient 5 which brought an entire new subscription model which resulted in large changes across the entire SDK.

The only modification at the API level involves replacing "ProrationMode" with "ReplacementMode". The specific replacement modes remain unchanged.

If your app doesn't currently use DEFERRED replacement modes, then you should be safe to upgrade to this version without changes in behavior.

If your app supports product changes using DEFERRED replacement mode, then you can either stick with the previous major version until support for DEFERRED is re-introduced in this major version, or you can remove DEFERRED replacement options from your app.

If you are using the SDK in observer mode, you should only use v7 in Android if you're using BillingClient 6.

See the Android Native - 6.x to 7.x Migration for more details.

If you come from an older version of the RevenueCat SDK, see Android Native - 5.x to 6.x Migration for a more thorough explanation of the new Google subscription model announced with BillingClient 5 and how to take advantage of it.

Bumped minimum Android SDK version

RevenueCat SDK v7 bumps minimum Android SDK version from Android 4.0 (API level 16) to Android 4.4 (API level 19).

Support for InApp Messages

We've added new APIs to support InApp messages both in Android and iOS. You can read more about:

InApp Messages are shown by default in both platforms. If you want to disable this behaviour during configuration of the RevenueCat SDK, setup the shouldShowInAppMessagesAutomatically property during configuration to false:

  Purchases.configure({
    apiKey,
    appUserID,
    observerMode,
    userDefaultsSuiteName,
    usesStoreKit2IfAvailable,
    useAmazon,
    shouldShowInAppMessagesAutomatically
  });

Dependency Updates

6.1.2

Dependency Updates

6.1.1

Dependency Updates

6.1.0

Dependency Updates

Other Changes

6.0.0

RevenueCat Capacitor SDK v6 is here!! 😻

Important Announcement: Official Ownership Transition

We are thrilled to announce that RevenueCat has officially taken over the ownership and development of this plugin from @riderx. This transition marks the beginning of a new chapter for Capacitor Purchases, as it becomes the official plugin supported by RevenueCat. As a part of this transition, the plugin's npm package has moved from @capgo/capacitor-purchases to @revenuecat/purchases-capacitor.

A Heartfelt Thank You to @riderx and @cap-go

We want to extend our deepest gratitude to @riderx and @cap-go for their incredible work on Capacitor Purchases. Their dedication and skill have laid a strong foundation for the plugin's future. We are committed to continuing the legacy of excellence they have established.

What's New in This Release

With this transition, we are also excited to introduce new features and improvements that enhance the plugin's performance, usability, and functionality:

Future Roadmap

As the new stewards of Capacitor Purchases, we have big plans for its continued development and improvement. Stay tuned for regular updates, new features, and top-notch support.

Migration Guides

CapGo's plugin releases (@capgo/capacitor-purchases)

5.1.0 (2023-08-01)

Features

5.0.8 (2023-07-31)

Bug Fixes

5.0.7 (2023-07-17)

5.0.6 (2023-07-03)

5.0.5 (2023-06-15)

5.0.4 (2023-06-15)

Bug Fixes

5.0.3 (2023-06-12)

Bug Fixes

5.0.2 (2023-06-05)

Bug Fixes

5.0.1 (2023-06-01)

Bug Fixes

5.0.0 (2023-06-01)

⚠ BREAKING CHANGES

Features

Bug Fixes

6.0.0 (2023-06-01)

⚠ BREAKING CHANGES

Features

Bug Fixes

10.0.0 (2023-06-01)

⚠ BREAKING CHANGES

Features

Bug Fixes

9.0.0 (2023-05-29)

⚠ BREAKING CHANGES

Features

Bug Fixes

8.0.0 (2023-05-29)

⚠ BREAKING CHANGES

Features

Bug Fixes

7.0.0 (2023-05-23)

⚠ BREAKING CHANGES

Features

Bug Fixes

6.0.0 (2023-05-23)

⚠ BREAKING CHANGES

Features

Bug Fixes

5.0.0 (2023-05-23)

⚠ BREAKING CHANGES

Features

Bug Fixes

4.0.0 (2023-05-22)

⚠ BREAKING CHANGES

Features

Bug Fixes

3.0.0 (2023-05-22)

⚠ BREAKING CHANGES

Features

Bug Fixes

2.9.0 (2023-05-22)

Features

Bug Fixes

2.8.0 (2023-05-15)

Features

Bug Fixes

2.7.0 (2023-05-08)

Features

Bug Fixes

2.6.0 (2023-05-01)

Features

Bug Fixes

2.5.0 (2023-04-24)

Features

Bug Fixes

2.4.0 (2023-04-17)

Features

Bug Fixes

2.3.0 (2023-04-17)

Features

Bug Fixes

2.2.0 (2023-04-10)

Features

Bug Fixes

2.1.0 (2023-03-27)

Features

Bug Fixes

2.0.24 (2023-02-02)

Bug Fixes

2.0.23 (2023-02-02)

Bug Fixes

2.0.22 (2023-01-30)

Bug Fixes

2.0.21 (2023-01-30)

Bug Fixes

2.0.20 (2023-01-30)

2.0.19 (2023-01-23)

Bug Fixes

2.0.18 (2023-01-19)

2.0.17 (2023-01-18)

2.0.16 (2023-01-18)

2.0.15 (2023-01-12)

2.0.14 (2023-01-12)

Bug Fixes

2.0.13 (2023-01-12)

Bug Fixes

2.0.12 (2023-01-12)

Bug Fixes

2.0.11 (2023-01-12)

Bug Fixes

2.0.10 (2023-01-12)

2.0.9 (2023-01-12)

Bug Fixes

2.0.8 (2023-01-12)

2.0.7 (2023-01-12)

2.0.6 (2023-01-12)

Bug Fixes

2.0.5 (2023-01-12)

Bug Fixes

2.0.4 (2023-01-12)

Bug Fixes

2.0.3 (2023-01-11)

Bug Fixes

2.0.2 (2023-01-11)

Bug Fixes

2.0.1 (2023-01-11)

Bug Fixes

2.0.0 (2023-01-11)

⚠ BREAKING CHANGES

Bug Fixes

1.3.49 (2023-01-11)

Bug Fixes

1.3.48 (2023-01-11)

Bug Fixes

1.3.47 (2023-01-11)

Bug Fixes

1.3.46 (2023-01-11)

Bug Fixes

1.3.45 (2023-01-11)

Bug Fixes

1.3.44 (2023-01-04)

1.3.43 (2023-01-02)

1.3.42 (2022-12-26)

Bug Fixes

1.3.41 (2022-12-12)

1.3.40 (2022-12-03)

1.3.39 (2022-12-03)

1.3.38 (2022-11-30)

1.3.37 (2022-11-24)

1.3.36 (2022-11-24)

Bug Fixes

1.3.35 (2022-11-24)

Bug Fixes

1.3.34 (2022-11-24)

Bug Fixes

1.3.33 (2022-11-24)

Bug Fixes

1.3.32 (2022-11-24)

Bug Fixes

1.3.31 (2022-11-24)

Bug Fixes

1.3.30 (2022-11-24)

Bug Fixes

1.3.29 (2022-11-22)

Bug Fixes

1.3.28 (2022-11-22)

Bug Fixes

1.3.27 (2022-11-22)

Bug Fixes

1.3.26 (2022-11-22)

Bug Fixes

1.3.25 (2022-11-22)

Bug Fixes

1.3.24 (2022-11-22)

Bug Fixes

1.3.23 (2022-11-22)

1.3.22 (2022-11-22)

1.3.21 (2022-11-17)

Bug Fixes

1.3.20 (2022-11-11)

Bug Fixes

1.3.19 (2022-11-11)

Bug Fixes

1.3.18 (2022-09-02)

Bug Fixes

1.3.17 (2022-09-02)

1.3.16 (2022-08-29)

1.3.15 (2022-08-21)

Bug Fixes

1.3.14 (2022-08-19)

Bug Fixes

1.3.13 (2022-08-05)

Bug Fixes

1.3.12 (2022-07-31)

Bug Fixes

1.3.11 (2022-07-28)

Bug Fixes

1.3.10 (2022-07-28)

Bug Fixes

1.3.9 (2022-07-24)

Bug Fixes

1.3.8 (2022-07-24)

1.3.7 (2022-07-24)

1.3.6 (2022-07-24)

1.3.5 (2022-07-24)

1.3.4 (2022-07-24)

1.3.3 (2022-07-24)

1.3.2 (2022-07-24)

1.3.1 (2022-07-24)

1.3.0 (2022-07-24)

Features

Bug Fixes