Что такое UserDefaults и когда его использовать?

Что такое UserDefaults?

UserDefaults — это механизм в iOS/macOS для легковесного постоянного хранения небольших объемов данных (обычно настроек, флагов или простых значений пользователя) между запусками приложения. Это интерфейс к свой-значениям (property list) файлу, хранящемуся в sandbox приложения, реализованный как класс NSUserDefaults (в Objective-C) или UserDefaults (в Swift). По сути, это простой ключ-значение (key-value) хранилище, где ключ — это строка (String), а значение — один из поддерживаемых типов данных.

Поддерживаемые типы данных:

• Foundation типы: Data, String, Number (Int, Double, Float), Bool, Date.
• Коллекции: Array и Dictionary, но только если их элементы также являются поддерживаемыми типами (т.е., они должны быть сериализуемы в property list).

Как это работает технически?

При сохранении данных, UserDefaults сериализует их в формат property list (plist) и записывает в файл (обычно ~/Library/Preferences/<your.app.bundle.id>.plist). При чтении — десериализует обратно. Весь процесс синхронный (хотя есть асинхронные методы ввода.

// Пример использования в Swift
import Foundation

let defaults = UserDefaults.standard

// Запись значений
defaults.set("Иван Иванов", forKey: "userName")
defaults.set(25, forKey: "userAge")
defaults.set(true, forKey: "isOnboardingCompleted")
defaults.set(Date(), forKey: "lastLaunchDate")

// Чтение значений
let name = defaults.string(forKey: "userName") // "Иван Иванов"
let age = defaults.integer(forKey: "userAge") // 25
let isCompleted = defaults.bool(forKey: "isOnboardingCompleted") // true
let lastLaunch = defaults.object(forKey: "lastLaunchDate") as? Date

// Удаление значения
defaults.removeObject(forKey: "userAge")

---

Когда использовать UserDefaults?

UserDefaults идеально подходит для некритичных, небольших и простых данных. Его главные преимущества: простота API, отсутствие настройки и высокая скорость для малых объемов.

Типичные сценарии использования:

1. Настройки пользователя (Settings/Preferences):

    *   Тема приложения (светлая/темная).
    *   Единицы измерения (километры/мили).
    *   Включение/выключение уведомлений.
    *   Язык или региональные настройки (если не используете систему).

1. Состояние интерфейса или приложения:

    *   Флаг, что **онбординг (onboarding)** был показан (`isOnboardingCompleted`).
    *   Последняя выбранная вкладка в `UITabBarController`.
    *   Свернуто/развернуто состояние некоторых UI-компонентов.

1. Легковесные данные сессии или кэш:

    *   Токен авторизации (хотя для безопасности лучше Keychain).
    *   Профиль пользователя (имя, email), если данные не объемные.
    *   Время последнего обновления данных для простого кэширования.

1. Флаги функциональности (Feature Flags):

    *   Включение экспериментальных функций A/B тестирования.
    *   Условия отображения определенных экранов.

1. Простая миграция или отслеживание версий:

    *   Номер последней установленной версии приложения для выполнения миграции данных один раз.

Когда НЕ стоит использовать UserDefaults?

• Для хранения чувствительных данных (пароли, токены, платежная информация). Используйте Keychain Services.
• Для больших объемов данных (массив из тысяч объектов, изображения, видео). Это замедлит работу и может привести к аномальным завершениям. Используйте Core Data, Realm, SQLite или запись файлов в Documents.
• Для сложных реляционных данных с связями и запросами. Требуется настоящая база данных.
• Когда необходима высокая производительность для частых операций с большими наборами данных. UserDefaults загружает весь plist-файл в память при инициализации.
• Для хранения кастомных объектов или структур, не соответствующих property-list типам. Потребуется сериализация в Data (например, через Codable), что усложняет подход.

---

Важные особенности и лучшие практики

• Стандартный экземпляр (UserDefaults.standard): Общий для всего приложения. Для расширений (App Groups) используйте UserDefaults(suiteName: "group.com.your.app").
• Синхронность: Основные методы set и synchronize (устаревший) блокируют поток. Используйте асинхронную запись через defaults.setValue(value, forKey: key) в фоновой очереди для избежания блокировки UI.
• Типизированные методы: Всегда используйте типизированные геттеры (string(forKey:), integer(forKey:)), они возвращают nil или значение по умолчанию (0, false, ""), если ключ отсутствует или тип не совпадает.
• Наблюдение за изменениями: Можно подписаться на уведомления UserDefaults.didChangeNotification для реагирования на обновления данных.
• Именование ключей: Используйте константы или enum для избежания опечаток.

// Лучшая практика: использование enum для ключей
enum UserDefaultsKeys {
    static let userName = "userName"
    static let isOnboardingCompleted = "isOnboardingCompleted"
}

defaults.set(true, forKey: UserDefaultsKeys.isOnboardingCompleted)

Итог: UserDefaults — это ваш "швейцарский нож" для хранения простых пользовательских настроек и состояния приложения. Он интуитивно понятен, не требует настройки и отлично справляется со своей задачей в отведенной ему нише. Однако, для любой более сложной, объемной или чувствительной информации всегда выбирайте специализированное решение: Keychain, Core Data или файловую систему.