A scrappy step-by-step to creating multiple configurations for an iOS target

MultipleConfigurations.md

1. Create a Production.xcconfig and a Development.xcconfig file (or whatever you want to call them)
2. In both of those config files: (production) [development]

BUNDLE_IDENTIFIER = (com.company.ios) [com.company.ios.dev]
PRODUCT_NAME = (App) [App Dev]
API_SCHEME = (https) [https]
API_HOST = (api.company.com) [dev.company.com]

3. In the Project Navigator select the Project (not a Target) > Info > Configurations > + “Duplicate Debug” > Rename to “Development Debug”
4. Rename “Debug” -> “Production Debug”, “Release” -> “Production Release” (You should have three configurations: Production Debug, Production Release, Development Debug)
5. On each of those configurations, expand them so you can see the targets, then under “Based on Configuration File” column select the corresponding .xcconfig file (either Production or Development)
6. In the Project Navigator select the main Target > Build Settings > Product Name > Set to $(PRODUCT_NAME)
7. Target > Build Settings > Product Bundle Identifier > Set to $(BUNDLE_IDENTIFIER)
8. In your Info.plist create two entries:

• API Scheme = ${API_SCHEME}
• API Host = ${API_HOST}

9. Then you can pull the baseURL out of the .xcconfig file via the Info.plist dictionary:

lazy var apiBaseURL: URL = {
    let schemeString = Bundle.main.infoDictionary["API Scheme"] as! String
    let apiHostString = Bundle.main.infoDictionary["API Host"] as! String
    var apiURLComponents = URLComponents()
    apiURLComponents.scheme = schemeString
    apiURLComponents.host = apiHostString
    guard let apiBaseURL = apiURLComponents.url else {
        // Handle this error
    }
    return apiBaseURL
}()

10. (In the menu bar) Product > Scheme > Manage Schemes
11. Select the default scheme, then click the gear in the bottom left > “Duplicate” and rename to “App - Development”
12. Rename the original “App - Production”
13. Open the each scheme (double click it), and for each action (Run, Test, Profile, Analyze, Archive) go to the Info tab and select the appropriate Build Configuration: (production) [development]

• Run: (Production Debug) [Development Debug]
• Test: (Production Debug) [Development Debug]
• Profile: (Production Release) [Development Debug]
• Analyze: (Production Debug) [Development Debug]
• Archive: (Production Release) [Development Debug] (You should now have two schemes: App - Production, App - Development. And at this point you should be able to install both on a single device)