Add a public key to your app

To establish trust between your app and our service, the Setapp Framework requires a unique public key for each app and platform.

📘

If you distribute your app on other platforms

If your iOS app is distributed outside of the App Store — through your own website or a third-party marketplace — your app can still be a part of the Setapp Membership. To register it in Setapp and add it to your developer account, please get in touch with your Developer Support Representetive, and we'll add your app. The instructions below are not relevant to your case.

Register your iOS app in the Setapp developer account

An iOS app can be added as:

• a companion to an existing macOS app, or
• a standalone app.

📘

How to add a standalone iOS app

Please contact your Developer Support Representative, and we’ll add your app. It’s the only way at the moment.

To add the companion iOS app, do the following:

1. Go to the Apps page of your developer account and click "Add iOS app" below the companion macOS app.
2. Enter the URL of your iOS app on the App Store, then click Generate. Once the Setapp system processes the link, your app becomes registered, and the Setapp public key is generated.
   When submitting the app for review with Setapp, you won't need to specify the App Store URL again — the information is stored in the Setapp system.

Add a public key(s) to your project as a resource

❗️

Important

Please note that the public keys for the Setapp macOS app and Setapp iOS app platforms are different. If you have all three apps, you will need three separate public keys.

The public key is crucial for handling data received from the Setapp system. The public key is unique to each app in the Setapp suite and is an essential part of the Setapp Framework's security.

To add the public key to your project in Xcode, drag the setappPublicKey.pem key file to the navigator area. A new dialog box appears. Select the 'Copy items if needed' checkbox at the top.

👍

Tip

If you have more than one public key, set the different names for each of them, for example, setappPublicKey.setapp.pem and setappPublicKey.setappMobile.pem.

If you name the public keys precisely, you won’t mix them up in future iterations, making the integration setup easier for you.