What is RevenueCat?

RevenueCat is a scalable backend for in-app subscriptions and purchases. With RevenueCat, you can build and manage your mobile app business without having to set up or maintain any purchase infrastructure. Here you can read more about how RevenueCat fits into your app.

Purchases for React Native can be installed either via npm or yarn.

After that, you should link the library to the native projects by doing:

Purchases.framework also needs to be added to your iOS project. The npm install will download the correct framework version and the link command will add libRNPurchases.a to the Linked Frameworks and Libraries of your app target in the iOS project.

1. Create a Framework Reference in your project

1. Drag Purchases.framework from the RNPurchasessub-project under the libraries section to the outer project and create a reference

2. Add iOS Framework to Embedded Binaries

1. In Xcode, in project manager, select your app target.
2. Select the general tab
3. Drag Purchases.framework from your project to the Embedded Binaries section

1. Add $(PROJECT_DIR)/../node_modules/react-native-purchases/ios to Framework Search paths in build settings

3. Add Strip Frameworks Phase

The App Store, in it's infinite wisdom, still rejects fat frameworks, so we need to strip our framework before it is deployed. To do this, add the following script phase to your build.

1. In Xcode, in project manager, select your app target.
2. Open the Build Phases tab
3. Add a new Run Script, name it Strip Frameworks
4. Add the following command "${PROJECT_DIR}/../node_modules/react-native-purchases/ios/strip-frameworks.sh" (quotes included)

4. Link static library

The react-native link command should have added the libRNPurchases.a library to the Linked Frameworks and Libraries section of your app target. If it hasn't add it like this:

5. Installing with Cocoapods / ExpoKit

If your project already uses Cocoapods to install iOS dependencies, common in ExpoKit projects, linking the library should have added it to the podfile. If it hasn't, add the following to your project's podfile to reference the library from your node_modules folder:

In your ios folder, run pod install. If you've just upgraded ExpoKit, you might need to upgrade cocoapods to the newest version: sudo gem install cocoapods.

You should now be able to import Purchases

ExpoKit projects of version 33 or higher can successfully use react-native-purchases. If you haven't upgraded, you can follow the instructions here to upgrade.

If you're planning on ejecting from Expo, upgrade your expo version first, THEN eject. It'll save you a whole lot of hassle.

• Now that you've installed the Purchases SDK in your React Native app, get started by initializing an instance of Purchases