Глобальный файл констант в Swift: лучшие практики

Проблема глобальных констант

Вы правы — объявление констант на уровне файла работает, но это не лучшая практика. В Swift есть несколько элегантных решений, которые позволяют избежать загрязнения глобального пространства имён и сделать код более организованным.

Решение 1: Структуры со статическими свойствами (рекомендуется)

Самый популярный и чистый подход — использовать struct со статическими константами. Это даёт пространство имён и группировку по смыслу:

// Constants.swift
import Foundation

struct AppConstants {
    // API
    struct API {
        static let baseURL = "https://api.example.com"
        static let timeout: TimeInterval = 30.0
        static let version = "v2"
        
        private init() {} // Запрещаем создание экземпляров
    }
    
    // UI
    struct UI {
        static let cornerRadius: CGFloat = 8.0
        static let animationDuration: TimeInterval = 0.3
        static let defaultPadding: CGFloat = 16.0
    }
    
    // Business Logic
    struct Security {
        static let maxLoginAttempts = 3
        static let tokenExpirationDays = 30
        static let passwordMinLength = 8
    }
    
    // Notifications
    struct Notifications {
        static let userLoggedIn = Notification.Name("userLoggedIn")
        static let dataUpdated = Notification.Name("dataUpdated")
    }
}

Использование:

let url = AppConstants.API.baseURL + "/users"
let padding = AppConstants.UI.defaultPadding
if attempts > AppConstants.Security.maxLoginAttempts { ... }

Решение 2: Enum с raw значениями (для строковых констант)

Если ваши константы — это строки, которые используются как ключи или идентификаторы, enum с raw-значениями — отличный выбор:

enum UserDefaultsKeys: String {
    case isLoggedIn
    case lastSyncDate
    case userPreferences
}

// Использование:
UserDefaults.standard.set(true, forKey: UserDefaultsKeys.isLoggedIn.rawValue)

Решение 3: Расширения существующих типов

Иногда удобно добавлять константы к существующим типам через расширения:

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

extension TimeInterval {
    static let defaultTimeout: TimeInterval = 30.0
    static let animationDuration: TimeInterval = 0.3
}

// Использование:
NotificationCenter.default.post(name: .userDidLogin, object: nil)
let timeout: TimeInterval = .defaultTimeout

Почему это лучше, чем глобальные let?

• Пространство имён: Константы сгруппированы логически, нет конфликтов имён
• Читаемость: Сразу понятно, к какой области относится константа
• Безопасность: Невозможно случайно переопределить константу
• Тестируемость: Легко мокать и подменять значения в тестах
• Документация: Можно добавлять комментарии и документацию к каждой группе

Дополнительный совет: Используйте enum вместо struct для чистых namespace

Если вам нужно только пространство имён без возможности создания экземпляров, используйте enum с case — он гарантированно не может быть инициализирован:

enum Constants {
    enum API {
        static let baseURL = "https://api.example.com"
    }
    // Никто не сможет сделать Constants() — ошибка компиляции
}

Выберите тот подход, который лучше всего подходит для вашего проекта. Для большинства случаев структуры со статическими свойствами — идеальный баланс между простотой и организацией.

// ConfigManager.swift
final class ConfigManager {
    static let shared = ConfigManager()
    
    private let config: [String: Any]
    
    private init() {
        guard let path = Bundle.main.path(forResource: "Config", ofType: "plist"),
              let dict = NSDictionary(contentsOfFile: path) as? [String: Any] else {
            fatalError("Config.plist not found")
        }
        self.config = dict
    }
    
    var apiBaseURL: String {
        config["APIBaseURL"] as! String
    }
    
    var timeout: TimeInterval {
        config["DefaultTimeout"] as! TimeInterval
    }
}