SwiftUI da @AppStorage — bu nima, UserDefaults va sozlamalarni saqlash

SwiftUI da @AppStorage nima?

@AppStorage — Apple tomonidan iOS 14 da taqdim etilgan, View xususiyatini UserDefaults dagi kalit bilan bog‘laydigan property wrapper. Xususiyat o‘qilganda, SwiftUI ko‘rsatilgan kalit bo‘yicha UserDefaults dan qiymatni yuklaydi. Yozishda — yangi qiymatni saqlaydi va View ni qayta chizish zarurligi haqida xabar beradi.

@AppStorage paydo bo‘lishidan oldin, dasturchilar qo‘lda UserDefaults ni onAppear da o‘qishlari, UserDefaults.didChangeNotification bildirishnomasiga obuna bo‘lishlari va o‘zgarishlarda @State ni yangilashlari kerak edi. @AppStorage butun siklni avtomatlashtiradi: bir qatordagi e’lon 15–20 qator boilerplate kodni almashtiradi. Bundan tashqari, @AppStorage ikki tomonlama sinxronizatsiyani ta’minlaydi — agar UserDefaults qiymati boshqa jarayondan (masalan, App Extension yoki Widget) o‘zgartirilsa, View baribir yangilanishni oladi.

Arxitektura nuqtai nazaridan, @AppStorage DynamicProperty sifatida amalga oshirilgan bo‘lib, bu SwiftUI ga bog‘liqliklarni kuzatish va kuzatilgan qiymat o‘zgarganda View ni qayta chizish imkonini beradi. Bu uni foydalanuvchi sozlamalarini saqlash uchun ideal qiladi: interfeys tili, funksiyalarni yoqish/o‘chirish, oxirgi tanlangan tab, foydalanuvchi nomi.

@AppStorage vs UserDefaults: taqqoslash

@AppStorage UserDefaults dan foydalansa ham, xotira bilan ishlash yondashuvlari tubdan farq qiladi. UserDefaults — past darajadagi API bo‘lib, o‘qish, yozish va o‘zgarish bildirishnomalarini qo‘lda boshqarishni talab qiladi. @AppStorage — qutidan chiqqandek reaktiv xatti-harakatni ta’minlovchi SwiftUI abstraksiyasi.

UserDefaults bir martalik operatsiyalar uchun mos keladi: ilova ishga tushganda sozlamalarni yuklash, analitika yozish, tokenlarni keshlash. @AppStorage — UI ni reaktiv yangilashi kerak bo‘lgan sozlamalar uchun: mavzu kalitlari, til tanlash, interfeys holatini saqlash. UserDefaults ni to‘g‘ridan-to‘g‘ri View ichida ishlatish — anti-na’munadir, chunki View qo‘shimcha obuna bo‘lmasdan o‘zgarishlardan xabar topmaydi.

Reaktiv UI li oddiy sozlamalar uchun @AppStorage afzal tanlovdir. Murakkab ma’lumotlar (massivlar, lug‘atlar, maxsus obyektlar) uchun UserDefaults ni @State va qo‘lda o‘zgarish obunasi bilan birga ishlating yoki tuzilgan saqlash uchun SwiftData / Core Data ga o‘ting.

Qo‘llab-quvvatlanadigan ma’lumot turlari

@AppStorage UserDefaults to‘g‘ridan-to‘g‘ri seriyalashtira oladigan standart turlarni qo‘llab-quvvatlaydi: String, Int, Double, Bool, Data, URL. Har bir tur uchun opsional versiya mavjud (String?, Int?, Double?, Bool?, Data?, URL?), “o‘rnatilmagan” va “bo‘sh qiymat” ni farqlash imkonini beradi.

RawRepresentable protokoliga mos maxsus turlarni saqlash uchun @AppStorage avtomatik ishlaydi. Agar enum rawValue turi String yoki Int bo‘lsa, uni to‘g‘ridan-to‘g‘ri ishlatish mumkin: @AppStorage("theme") var theme: AppTheme = .system. SwiftUI avtomatik ravishda qiymatni rawValue orqali seriyalashtiradi/deseriyalashtiradi.

enum AppTheme: String {
    case system, light, dark
}

struct SettingsView: View {
    @AppStorage("username") var username: String = "Guest"
    @AppStorage("launchCount") var launchCount: Int = 0
    @AppStorage("isDarkMode") var isDarkMode: Bool = false
    @AppStorage("appTheme") var theme: AppTheme = .system
    @AppStorage("lastOpened") var lastOpened: Date? = nil

    var body: some View {
        Form {
            TextField("Username", text: $username)
            Toggle("Dark mode", isOn: $isDarkMode)
            Text("\(launchCount) marta ishga tushirildi")
        }
    }
}

Misolda turli xil @AppStorage turlari ishlatilgan: standart qiymati “Guest” bo‘lgan String, ishga tushirish hisoblagichi uchun Int, qorong‘u mavzu uchun Bool, rawValue turi String bo‘lgan enum AppTheme va oxirgi ochilish vaqti uchun opsional Date?. Har bir xususiyat birinchi argumentda ko‘rsatilgan UserDefaults kalitiga bog‘langan. Standart qiymat birinchi ishga tushirishda kalit mavjud bo‘lmasa ishlatiladi.

Store o‘zgarishlarini kuzatish

@AppStorage ning asosiy afzalliklaridan biri — UserDefaults o‘zgarishlarini istalgan manbadan avtomatik kuzatishdir. Agar App Extension yoki Widget qiymatni o‘zgartirsa, asosiy ilovadagi @AppStorage bildirishnoma oladi va View ni qayta chizadi. Bunga @AppStorage ning UserDefaults.didChangeNotification ga avtomatik o‘rnatadigan KVO (Key-Value Observing) mexanizmi orqali erishiladi.

Amalda bu shuni anglatadiki, agar foydalanuvchi Widget da sozlamani o‘zgartirsa (masalan, qorong‘u mavzuni yoqsa), ilova darhol bu o‘zgarishni qabul qiladi. Xuddi shunday asosiy ilova, Share Extension, Watch App va Today Widget o‘rtasida sinxronizatsiya ishlaydi. Dasturchi jarayonlararo ma’lumot almashinuvi uchun kod yozishi shart emas — @AppStorage buni avtomatik qiladi.

struct ThemeSettingView: View {
    @AppStorage("isDarkMode") var isDarkMode: Bool = false

    var body: some View {
        VStack {
            Toggle("Dark Mode", isOn: $isDarkMode)
                .onChange(of: isDarkMode) { oldValue, newValue in
                    print("Qorong‘u rejim \(newValue) ga o‘zgartirildi")
                }
        }
    }
}

Toggle @AppStorage orqali $isDarkMode bilan bog‘langan. O‘zgartirilganda, qiymat avtomatik ravishda UserDefaults da “isDarkMode” kaliti ostida saqlanadi. .onChange modifikatori o‘zgarish vaqtida qo‘shimcha harakatni bajarishga imkon beradi — masalan, analitika yuborish yoki boshqa ekranlar UI sini yangilash. Agar Widget bir xil kalitni o‘zgartirsa, @AppStorage onChange ni ham chaqiradi, holatning izchilligini ta’minlab.

@AppStorage kod misollari

Barcha konfiguratsiyalarni saqlash uchun @AppStorage dan foydalanadigan to‘liq ilova sozlamalari ekranini ko‘rib chiqaylik. Forma turli xil sozlama turlariga ega bo‘limlarni o‘z ichiga oladi: matn maydonlari, kalitlar, hisoblagichlar — barcha qiymatlar avtomatik ravishda UserDefaults da saqlanadi.

struct AppSettingsView: View {
    @AppStorage("displayName") var displayName = ""
    @AppStorage("notificationsEnabled") var notificationsEnabled = true
    @AppStorage("maxResults") var maxResults = 25
    @AppStorage("selectedTab") var selectedTab = "home"

    var body: some View {
        NavigationStack {
            Form {
                Section(header: Text("Profil")) {
                    TextField("Display name", text: $displayName)
                }

                Section(header: Text("Sozlamalar")) {
                    Toggle("Enable notifications",
                           isOn: $notificationsEnabled)
                    Stepper("Max results: \(maxResults)",
                           value: $maxResults,
                           in: 10...100,
                           step: 5)
                }

                Section {
                    Button("Sozlamalarni tiklash") {
                        UserDefaults.standard.removePersistentDomain(
                            forName: Bundle.main.bundleIdentifier!)
                    }
                    .tint(.red)
                }
            }
            .navigationTitle("Settings")
        }
    }
}

Formada turli turdagi to‘rtta @AppStorage xususiyati mavjud: nom uchun String, bildirishnomalar uchun Bool, natijalar soni uchun Int va tanlangan tab uchun String. Barcha boshqaruv elementlari Binding orqali xususiyatlarga bog‘langan ($displayName, $notificationsEnabled va h.k.). “Reset settings” tugmasi barcha UserDefaults ni tiklaydi, ilova domenini o‘chiradi — shundan so‘ng @AppStorage avtomatik ravishda standart qiymatlarga qaytadi.

@AppStorage ni App Group bilan sinxronlash

struct SharedSettingsView: View {
    let sharedDefaults = UserDefaults(suiteName: "group.com.example.app")

    @AppStorage("widgetTheme", store: UserDefaults(suiteName: "group.com.example.app")!)
    var widgetTheme: String = "tizim"

    @AppStorage("widgetColor", store: UserDefaults(suiteName: "group.com.example.app")!)
    var widgetColor: String = "ko‘k"

    var body: some View {
        Form {
            Picker("Widget theme", selection: $widgetTheme) {
                Text("Tizim").tag("system")
                Text("Yorug‘").tag("yorug‘")
                Text("Qorong‘u").tag("qorong‘u")
            }
            Picker("Accent color", selection: $widgetColor) {
                Text("Ko‘k").tag("blue")
                Text("Yashil").tag("yashil")
                Text("Qizil").tag("qizil")
            }
        }
    }
}

App Group (ilova va kengaytmalar o‘rtasidagi umumiy xotira) uchun @AppStorage store parametrini qabul qiladi: UserDefaults(suiteName:). Qiymatlar asosiy ilova, Widget, Watch App va bir guruhning boshqa kengaytmalari uchun mavjud bo‘lgan umumiy konteynerda saqlanadi. Widget bu sozlamalarni o‘qiy oladi va ilovada o‘zgarish bo‘lganda, Widget UserDefaults kuzatish mexanizmi orqali avtomatik yangilanadi.