Building an iOS Binary with App Groups Entitlement

This document describes the process for configuring App Groups and rebuilding an iOS binary that uses the App Groups entitlement.

All configuration steps are performed in the Apple Developer Portal.

Prerequisites

• An active Apple Developer account
• Access to the App ID configuration in the Apple Developer Portal
• The bundle identifiers for:
  • The main application (e.g., com.example.app)
  • Any extensions (e.g., com.example.app.ShareExtension)

App Group Configuration

A. Create an App Group

This creates the App Group.

1. Go to the Apple Developer Portal > Identifiers https://developer.apple.com/account/resources/identifiers
2. Select App Groups.

3. Click + to create a new App Group.
4. Enter a Description and an Identifier - the identifier must start with group. (e.g. group.com.company.app)

5. Click Continue, then Register.

B. Enable App Groups for the Main Application

6. In Identifiers, select App IDs.

7. Locate and select the main application’s bundle identifier (e.g. com.example.app).
8. Scroll to the Capabilities section and enable App Groups.

9. Click Configure, select the App Group created in Section A.

C. Enable App Groups for Extensions

10. Repeat the steps in Section B for each extension that requires access to the shared container (for example, com.example.app.ShareExtension).

    Important: Every target that uses shared data must have the same App Group enabled in its App ID configuration.

D. Regenerate Provisioning Profiles and Build

After enabling the App Group capability:

11. Go to your Median App and regenerate the provisioning profile

11. Rebuild the iOS binary

Verification Checklist

Before distributing the build, confirm:

• The App Group identifier begins with group.

• The App Group is enabled for all relevant App IDs

• Provisioning profiles were regenerated after enabling the capability