Глобальные константы в Swift: лучшие практики и организация кода

Правильный подход к глобальным константам в Swift

В Swift действительно нет единого стандарта, но сообщество выработало несколько эффективных паттернов. Главное отличие от Objective-C — Swift поощряет модульность и инкапсуляцию. Рассмотрим три основных подхода, начиная с самого рекомендуемого.

1. Структуры с вложенными namespace (рекомендованный способ)

Используйте структуры для группировки констант по смыслу. Это даёт чистый код без конфликтов имён:

// Constants.swift
struct AppConstants {
    private init() {} // предотвращаем создание экземпляра
    
    struct Network {
        static let baseURL = "https://api.example.com/v2"
        static let timeout: TimeInterval = 30.0
        static let maxRetries = 3
    }
    
    struct UI {
        static let animationDuration: TimeInterval = 0.3
        static let cornerRadius: CGFloat = 12.0
        static let defaultPadding: CGFloat = 16.0
    }
    
    struct Storage {
        static let userDefaultsKey = "com.example.user"
        static let maxCacheSize = 50 * 1024 * 1024 // 50 MB
    }
}

// Использование:
let url = AppConstants.Network.baseURL
let duration = AppConstants.UI.animationDuration

2. Enum без case для namespace

Альтернатива — использовать enum, который нельзя инициализировать:

enum API {
    static let baseURL = "https://api.example.com"
    enum Endpoints {
        static let login = "/auth/login"
        static let profile = "/user/profile"
    }
    enum Headers {
        static let contentType = "application/json"
    }
}

3. Extension для связанных констант

Если константы относятся к конкретному типу, используйте extension:

extension UIColor {
    static let primaryColor = UIColor(red: 0.2, green: 0.4, blue: 0.8, alpha: 1.0)
    static let secondaryColor = UIColor(red: 0.9, green: 0.3, blue: 0.1, alpha: 1.0)
}

extension Notification.Name {
    static let userDidLogin = Notification.Name("userDidLogin")
    static let dataDidUpdate = Notification.Name("dataDidUpdate")
}

Что не стоит делать:

• Глобальные let-переменные на уровне файла — они загрязняют глобальное пространство имён и могут конфликтовать.
• Огромный файл со всеми константами — это нарушает принцип единственной ответственности.
• Использование class с class-свойствами — избыточно, структуры легче и безопаснее.

Продвинутые советы:

• Для чувствительных данных (API ключи) используйте Info.plist или генерацию через build phases.
• Разделяйте константы по модулям/фреймворкам, если проект большой.
• Добавьте префиксы для enum-констант, если работаете с Objective-C кодом.

Лично я рекомендую подход со структурами — он даёт идеальный баланс между читаемостью, производительностью (все static-свойства лениво инициализируются) и инкапсуляцией.

// Config.xcconfig
API_BASE_URL = https://dev.api.example.com
API_KEY = dev_key_123

struct Environment {
    static let baseURL: String = {
        guard let url = Bundle.main.object(forInfoDictionaryKey: "API_BASE_URL") as? String else {
            fatalError("API_BASE_URL not found in Info.plist")
        }
        return url
    }()
    
    static let apiKey: String = {
        guard let key = Bundle.main.object(forInfoDictionaryKey: "API_KEY") as? String else {
            fatalError("API_KEY not found")
        }
        return key
    }()
}