[Swift 입문] 26편 — UserDefaults와 앱 설정 저장

🤖 이 글은 Claude Code(AI)가 작성합니다. | 시리즈 목차 | 이전: [25편] Codable과 JSON

설정값을 어디에 저장할까?

앱을 종료하고 다시 열어도 사용자 설정이 유지되어야 합니다. “다크 모드 켜기”, “알림 허용”, “마지막으로 선택한 탭” 같은 간단한 값들을 저장하는 가장 쉬운 방법이 UserDefaults입니다.

UserDefaults는 macOS/iOS가 제공하는 키-값 저장소입니다. 앱이 종료되어도 데이터가 유지되며, 같은 앱 내 어디서든 접근할 수 있습니다.

기본 사용법

import Foundation

// 저장
UserDefaults.standard.set(true, forKey: "isDarkMode")
UserDefaults.standard.set(16.0, forKey: "fontSize")
UserDefaults.standard.set("홍길동", forKey: "username")
UserDefaults.standard.set(42, forKey: "loginCount")

// 읽기
let isDarkMode = UserDefaults.standard.bool(forKey: "isDarkMode")      // false (없으면 기본값)
let fontSize = UserDefaults.standard.double(forKey: "fontSize")         // 16.0
let username = UserDefaults.standard.string(forKey: "username")         // Optional("홍길동")
let loginCount = UserDefaults.standard.integer(forKey: "loginCount")    // 42

// 삭제
UserDefaults.standard.removeObject(forKey: "username")

저장 가능한 타입

Bool, Int, Float, Double
String, URL
Data (바이너리 데이터)
Array, Dictionary (위 타입으로 이루어진)
Date

커스텀 객체는 직접 저장할 수 없습니다 — Data로 변환(Codable 사용)해야 합니다.

키 상수화 — 오타 방지

문자열 키를 직접 쓰면 오타가 생기기 쉽습니다. 상수로 관리하는 것이 좋습니다.

extension UserDefaults {
    enum Key: String {
        case isDarkMode = "isDarkMode"
        case fontSize = "fontSize"
        case username = "username"
        case lastOpenedTab = "lastOpenedTab"
    }

    // 편의 메서드
    func bool(forKey key: Key) -> Bool {
        return bool(forKey: key.rawValue)
    }

    func set(_ value: Bool, forKey key: Key) {
        set(value, forKey: key.rawValue)
    }

    func string(forKey key: Key) -> String? {
        return string(forKey: key.rawValue)
    }

    func set(_ value: String?, forKey key: Key) {
        set(value, forKey: key.rawValue)
    }
}

// 사용 — 문자열 대신 타입 안전한 키 사용
UserDefaults.standard.set(true, forKey: .isDarkMode)
let isDark = UserDefaults.standard.bool(forKey: .isDarkMode)

Codable 객체 저장

struct AppTheme: Codable {
    var accentColor: String
    var fontSize: Double
    var showSidebar: Bool
}

extension UserDefaults {
    // Codable 객체 저장
    func save<T: Encodable>(_ value: T, forKey key: String) {
        let data = try? JSONEncoder().encode(value)
        set(data, forKey: key)
    }

    // Codable 객체 불러오기
    func load<T: Decodable>(_ type: T.Type, forKey key: String) -> T? {
        guard let data = data(forKey: key) else { return nil }
        return try? JSONDecoder().decode(type, from: data)
    }
}

// 사용
let theme = AppTheme(accentColor: "blue", fontSize: 14.0, showSidebar: true)
UserDefaults.standard.save(theme, forKey: "appTheme")

if let savedTheme = UserDefaults.standard.load(AppTheme.self, forKey: "appTheme") {
    print(savedTheme.accentColor)  // "blue"
}

SwiftUI에서 UserDefaults — @AppStorage

SwiftUI에서는 @AppStorage로 UserDefaults를 훨씬 간편하게 사용할 수 있습니다.

struct SettingsView: View {
    @AppStorage("isDarkMode") private var isDarkMode = false
    @AppStorage("fontSize") private var fontSize = 14.0
    @AppStorage("username") private var username = ""

    var body: some View {
        Form {
            Section("외관") {
                Toggle("다크 모드", isOn: $isDarkMode)

                VStack(alignment: .leading) {
                    Text("글꼴 크기: \(Int(fontSize))")
                    Slider(value: $fontSize, in: 10...24, step: 1)
                }
            }

            Section("계정") {
                TextField("사용자 이름", text: $username)
                    .textFieldStyle(.roundedBorder)
            }
        }
        .padding()
        .preferredColorScheme(isDarkMode ? .dark : .light)
    }
}

@AppStorage("키이름")은 내부적으로 UserDefaults를 사용합니다. 값이 바뀌면 자동으로 뷰가 업데이트되고, UserDefaults에도 즉시 저장됩니다.

설정 스토어 패턴

여러 설정을 하나의 @Observable 클래스로 관리하면 앱 전체에서 사용하기 편리합니다.

@Observable
class SettingsStore {
    // UserDefaults와 동기화되는 속성들
    var isDarkMode: Bool {
        get { UserDefaults.standard.bool(forKey: "isDarkMode") }
        set { UserDefaults.standard.set(newValue, forKey: "isDarkMode") }
    }

    var fontSize: Double {
        get { UserDefaults.standard.double(forKey: "fontSize").nonZero ?? 14.0 }
        set { UserDefaults.standard.set(newValue, forKey: "fontSize") }
    }

    var notificationsEnabled: Bool {
        get { UserDefaults.standard.bool(forKey: "notificationsEnabled") }
        set { UserDefaults.standard.set(newValue, forKey: "notificationsEnabled") }
    }

    // 복잡한 객체는 Codable로
    var recentSearches: [String] {
        get { UserDefaults.standard.stringArray(forKey: "recentSearches") ?? [] }
        set { UserDefaults.standard.set(newValue, forKey: "recentSearches") }
    }

    func reset() {
        isDarkMode = false
        fontSize = 14.0
        notificationsEnabled = true
        recentSearches = []
    }
}

// 앱 전체에 환경으로 공유
@main
struct MyApp: App {
    @State private var settings = SettingsStore()

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(settings)
        }
    }
}

기본값 등록

앱이 처음 실행될 때 기본값을 설정하려면:

// AppDelegate 또는 앱 시작 시점에 한 번만 실행
func registerDefaults() {
    UserDefaults.standard.register(defaults: [
        "isDarkMode": false,
        "fontSize": 14.0,
        "notificationsEnabled": true,
        "launchCount": 0
    ])
}
// register(defaults:)는 이미 값이 있으면 덮어쓰지 않음
// → 앱 업데이트로 새 키가 추가될 때 유용

UserDefaults 주의사항

민감한 정보 저장 금지: 비밀번호, 토큰, 개인 식별 정보는 Keychain에 저장해야 합니다. UserDefaults는 암호화되지 않습니다.
대용량 데이터 부적합: 작은 설정값에만 사용. 큰 데이터는 파일이나 SQLite에 저장합니다.
동기화 타이밍: 저장은 즉시 되지만 플러시(디스크 반영)는 시스템이 결정합니다. 앱 충돌 시 마지막 변경이 유실될 수 있습니다.

다른 플랫폼과 비교

플랫폼	간단한 설정 저장	특징
macOS/iOS	UserDefaults	시스템 통합, plist 파일로 저장
Android	SharedPreferences	XML 파일로 저장
웹 브라우저	localStorage	도메인별 키-값 저장
Python	configparser, json 파일	파일 직접 관리

핵심 요약

UserDefaults: 앱 재시작 후에도 유지되는 간단한 키-값 저장소
set(_:forKey:)로 저장, bool/string/integer(forKey:)로 읽기
@AppStorage: SwiftUI에서 UserDefaults를 선언적으로 사용하는 방법
커스텀 타입은 Codable + Data로 변환해서 저장
register(defaults:)로 앱 첫 실행 시 기본값 설정
민감한 정보는 반드시 Keychain 사용

다음 편에서는 파일을 직접 읽고 쓰는 FileManager를 배웁니다.

🤖 Generated with Claude Code

Naver Ending Study