Build configurations (Debug, Release) in iOS Swift

Introduction

Build configurations help you create different versions of your app for testing and for users. Debug is for testing with extra info, Release is for final app without extra info.

When you want to test your app with extra debugging information.

When you want to make a fast, optimized app to send to users.

When you want to find and fix errors during development.

When you want to reduce app size and improve performance for users.

When you want to control what code runs in testing versus production.

Syntax

iOS Swift

// In Xcode, build configurations are set in the project settings.
// You can check the current configuration in Swift code like this:
#if DEBUG
print("Debug build")
#else
print("Release build")
#endif

Use #if DEBUG to run code only in Debug builds.

Release builds are optimized and do not include debug info.

Examples

This code prints different messages depending on the build configuration.

iOS Swift

#if DEBUG
print("This runs only in Debug build")
#else
print("This runs only in Release build")
#endif

Use different servers for testing and production by checking build configuration.

iOS Swift

// You can set different API URLs for Debug and Release
#if DEBUG
let apiUrl = "https://test.api.example.com"
#else
let apiUrl = "https://api.example.com"
#endif

Sample App

This SwiftUI app shows a text message that changes depending on whether the app is built in Debug or Release mode.

iOS Swift

import SwiftUI

struct ContentView: View {
    var body: some View {
        Text(buildMessage())
            .padding()
    }

    func buildMessage() -> String {
        #if DEBUG
        return "Running Debug Build"
        #else
        return "Running Release Build"
        #endif
    }
}

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Important Notes

Debug builds include extra information to help find problems.

Release builds are faster and smaller but hide debug info.

You can add custom build configurations if needed in Xcode.

Summary

Build configurations let you create different app versions for testing and release.

Use #if DEBUG in Swift to run code only in Debug builds.

Release builds are optimized for users without debug info.