How to define a different App Group for each environment from XCode

I'm woking on a iOS app that uses App Groups to share data between the app and an extension.

I have three flavours of the app, one for Development, another for Staging and a last one for Production.

I want to define a different App Group for each environment.

What I've done:

• I've created the three App Groups through the development portal.
• I've created three app identifiers, one for each enviroment, and granted access to the right App Group for that environment.
• I've created a Build Configuration for each environment.
• I've created a Build Configuration parameter for the App Group identifier and assigned a different value for each enviroment.
• I've created a parameter in the Info.plist with the value of the parameter in the Build Configuration to be able to access the App Group identifier in the code.
• I'm assigning the right App Group identifier through the code. -I've created a Scheme for building each build configuration, however, all Schemes share the same Project and Targets configuration.

The problem: -When I edit the Target settings, I see the three App Groups there, but only one is selected (the development one) and the same one is selected for all Schemes. I've tried selecting a new App Group for each scheme but as all schemes share the same targets, changing the App Group changes it for all schemes.

Question -As I define whichApp Group to access by code, all three flavours of the app seem to be workikng fine, however, I fear that if XCode regenrates the app identifiers on the development portal it will assign all the flavours of the app access to the same App Group (because that is what is configured in the Target). Am i missing something? How can I have the target settings to point to a different App Group per scheme?

You’re right in identifying that Xcode’s target settings for App Groups aren’t scheme- or build-configuration-specific—they’re project-wide and tied to the target. So, even though your code picks the correct App Group identifier based on the environment, Xcode’s signing and capabilities system only knows about the App Groups you check in the target settings.

Here’s what you need to know:

1. All App Groups must be enabled in target settings:
   In your target’s “Signing & Capabilities” > App Groups section, check all the App Groups your various flavors use (Development, Staging, Production).

   • This setup ensures the provisioning profile Xcode generates will include entitlements for all your App Groups, preventing runtime entitlement errors as long as your app/extension is accessing one of the allowed groups.

2. Selecting a group per scheme is not possible in Xcode UI:
   The checkboxes in the target’s capabilities correspond to the entitlements applied to all configurations/schemes for that target. Schemes themselves cannot change entitlements (nor can build configurations directly).

3. Environment-specific access is controlled in code:
   It’s fine (and quite common) to conditionally select which App Group identifier you use at runtime based on the environment. As long as all possible App Groups are listed in your entitlements, this is a safe and accepted practice.

4. Provisioning profiles:
   In the Apple Developer portal, make sure all the App IDs (for each environment) have access to their appropriate App Groups, and that your provisioning profiles are up to date and include all App Groups required by the app and any extensions.

5. Potential pitfalls:

   • If you remove an App Group from the target’s capabilities, Xcode may also update your provisioning profile to drop it, which could break one or more flavors.

   • Xcode will never allow you to dynamically select an App Group at build time via schemes/configurations in the Xcode UI—it’s always a superset at the target level.

Summary / TL;DR:

• Check all relevant App Groups in your target’s “Signing & Capabilities.”

• Use runtime logic in your app and extension to select the correct App Group per environment.

• Maintain correct mapping in the Developer portal and provisioning profiles.

• It’s safe as long as you do not access App Groups not listed in entitlements, and all flavors’ App IDs are granted access to the App Groups.

Extra tip:
If you add or remove App Groups in the Developer portal, always update your provisioning profiles and regenerate them in Xcode to ensure all entitlements are synced.