#Xcode scheme code

Settings Bundle works well when developing: It creates a shortcut to change environment values without using any third-party API or server. In addition, the Settings Bundle facilitates the testing process. To support multiple levels of testing, the Settings Bundle is usually integrated along with the dev configurations. This type of file can be edited outside of Xcode and integrates well with source control systems.īecause of different settings for each environment (such as bundle identifiers, endpoints, etc.), the developers also define them in different *.xcconfig files.

#Xcode scheme code

#if DEBUG // Code the app includes in DEBUG environments #else // Code the app includes when it is not build with DEBUG environments #endif Xcode Configuration FileĪ Configuration Settings File ( *.xcconfig), also known as a build configuration file, is a plain text file that defines and overrides the build settings for a particular build configuration of a project or target. The considerable advantage when using custom flags is customizable specific features based on a particular environment.Įxample: Specify a value based on the environment: The following table will describe how the developers differentiate a configuration from the others. In the iOS template project, there are three custom conditional compilation flags: DEBUG, STAGING, PRODUCTION.

Xcode provides a build setting named Active Compilation Conditions, which supports passing conditional compilation flags to the Swift compiler. Having distinct flags for each configuration is the preferred solution. The recommended set of configurations to have is: Since the team always wants to ensure the application is working in a designated manner, additional levels of testing are required before the application is ready to be used. However, these basic configurations are not enough for the development process. Initially, there are two basic configurations for a project generated automatically by Xcode, which are: It is possible to build a scheme with different Build Configurations. There are three default targets in a project:Ī scheme is a collection of settings that specifies the targets to build for a project, the build configuration to use, and the executable environment to use when the application is launched. When creating a project from a template, a default target will be added automatically for the main application.

Basic targets, schemes, build settings options, etc., for building a project.Ī target specifies a product to build, such as an iOS, watchOS, or macOS app.

Terminologies and topics related to project configurations.

This document presents in detail the set of configurations used in the iOS projects developed at Nimble.