Legacy Mac Apps

Configuring legacy Mac apps with RevenueCat

For newer Mac apps, in-app purchases can be shared across Mac and iOS apps. This is called Universal Purchases.

👍

Mac apps with Universal Purchases don't require this setup

If your Mac app uses Universal Purchases (meaning your Mac app is part of the same app record as your iOS app) or it was created after March 2020, you don't need to follow this guide. RevenueCat will just work for your app!

520520

This Mac app is part of the same app record as the iOS app, which means it uses Universal Purchases. It also has the same bundle ID as the iOS app. No special setup is required in RevenueCat for this Mac app if you already have your iOS app set up.

📘

If you have an existing Mac app that you want to migrate to universal purchases, you will have to follow the steps found Apple's documentation: https://developer.apple.com/support/universal-purchase/

Since most Mac apps released today on RevenueCat's platform use universal purchases, by default the Mac configuration options on the dashboard are hidden. If you want to set up a Mac app in RevenueCat, follow the following steps:

1. Create a new app in RevenueCat

You need to contact support so that the Mac setup options are available in your dashboard. But before you can do that, you need to create a template Mac app. To do this, create a new app and enter your App Name, App Bundle ID, and iTunesConnect App-Specific Shared Secret in the App Store configuration section. Then click Add.

12371237

Enter your Mac bundle ID and app-specific shared secret in the iOS fields.

2. Contact RevenueCat support

After configuring your RevenueCat app in step 1, contact RevenueCat support to enable legacy Mac app configuration for your app. Provide the name of your RevenueCat app. After RevenueCat support enables Mac app configuration options, your dashboard will show the new options, like this:

12371237

After contacting support, the macOS Configuration section appears in the dashboard.

3. Enter your Mac App Store shared secret

If you're not going to add an iOS or universal Mac app to the RevenueCat app, delete the bundle ID and app-specific shared secret in the App Store configuration section. If you are going to add an iOS app, enter the iOS/universal Mac app's bundle ID and shared secret.

12371237

In this example we added the Mac app store shared secret and updated the App Store configuration with the details for our universal app.

4. Update your universal app code

This step is only required if you have both a legacy Mac app and an iOS/universal Mac app. In the universal Mac app, add this line of code right before Purchases.configure:

Purchases.setForceUniversalAppStore(true)
Purchases.configure()
// ...

👍

You're done 🎉

You've successfully configured your Mac app in RevenueCat!


Did this page help you?