Application Support: какво е, съхранение на конфигурации и Core Data

Какво е Application Support в iOS?

Application Support — е директория в пясъчника на iOS приложението, предназначена за съхранение на данни, които приложението създава и използва за своята работа, но които не са потребителски документи. Това е основното място за конфигурации, бази данни, кеширани метаданни и други помощни файлове.

iOS разграничава Application Support като междинно ниво между Documents (потребителски данни) и Caches (временни данни). Файловете в Application Support могат да бъдат относително постоянни, но потребителят не трябва да има пряк достъп до тях — това го различава от Documents Directory.

Според Apple Developer Documentation (2024), Application Support е препоръчителното място за съхранение на SQLite бази данни на Core Data, Realm файлове, конфигурации в JSON/plist формат, изтеглени справочни материали и други данни, които приложението използва, но които потребителят не е създал изрично.

Важно: по подразбиране Application Support е включена в резервното копие на iCloud и iTunes. Ако приложението съхранява големи обеми данни, които могат да бъдат възстановени в тази директория (напр. изтеглени ръководства), трябва да се зададе флаг isExcludedFromBackup за съответните файлове.

Как да получите пътя до Application Support

В Swift пътят до Application Support Directory се получава чрез FileManager.urls(for: .applicationSupportDirectory). Apple препоръчва създаване на поддиректория с името на приложението вътре в Application Support за изолиране на данни.

import Foundation

let fileManager = FileManager.default
guard let appSupportURL = fileManager.urls(
    for: .applicationSupportDirectory,
    in: .userDomainMask
).first else { return }

// Създаване на поддиректория на приложението
let bundleID = Bundle.main.bundleIdentifier ?? "com.example.app"
let appDir = appSupportURL.appendingPathComponent(bundleID)
try fileManager.createDirectory(
    at: appDir,
    withIntermediateDirectories: true
)

Objective-C използва NSSearchPathForDirectoriesInDomains с NSApplicationSupportDirectory. Подобно на Swift, се препоръчва създаване на поддиректория с името на приложението.

@import Foundation;

NSArray *paths = NSSearchPathForDirectoriesInDomains(
    NSApplicationSupportDirectory,
    NSUserDomainMask,
    YES
);
NSString *appSupportPath = paths.firstObject;
NSString *appDir = [appSupportPath stringByAppendingPathComponent:@"com.example.app"];

При първото стартиране директорията Application Support може да не съществува — трябва да бъде създадена с помощта на createDirectory(at:withIntermediateDirectories:). Това я различава от Documents Directory, която се създава автоматично от системата.

Какви данни да съхранявате в Application Support

Application Support е подходяща за широк спектър от данни, които приложението използва за своята работа. Правилният избор на данни за тази директория подобрява организацията на файловата система и опростява архивирането.

Core Data и Realm бази данни

SQLite файловете на Core Data се създават по подразбиране в Application Support. Realm също препоръчва поставяне на бази данни в тази директория. Това изолира потребителските документи от вътрешните бази данни на приложението.

Конфигурационни файлове

JSON, plist, XML файлове с настройки на приложението, Feature Flags, кеширани метаданни за потребителя (но не токени за удостоверяване — за тях е Keychain).

Критерий за избор: ако данните се създават и използват от приложението, а не от потребителя, и трябва да се запазят между стартиранията — тяхното място е в Application Support.

Core Data и Application Support

Core Data — един от основните консуматори на Application Support. При създаване на NSPersistentContainer, Core Data автоматично поставя SQLite файлове в Library/Application Support с уникално име на базата на името на модела.

Разбирането къде Core Data съхранява файлове е критично за миграции, архивиране и отстраняване на грешки. Основни файлове: .sqlite (данни), .sqlite-wal (Write-Ahead Log), .sqlite-shm (Shared Memory).

import CoreData

// Създаване на Core Data контейнер
let container = NSPersistentContainer(name: "MyAppModel")

// Персонализирана директория с URL на магазина
guard let appSupportURL = FileManager.default
    .urls(for: .applicationSupportDirectory,
        in: .userDomainMask).first else { return }

let storeURL = appSupportURL
    .appendingPathComponent("MyAppModel.sqlite")
let description = NSPersistentStoreDescription(url: storeURL)
container.persistentStoreDescriptions = [description]

При използване на CloudKit синхронизация за Core Data, SQLite файлът остава в Application Support, а CloudKit се използва като транспортен слой. В този случай е важно да не се изключват файловете от архива — иначе синхронизацията между устройствата може да бъде нарушена.

Application Support срещу Documents Directory

Разликата между Application Support и Documents — една от най-важните за правилната организация на файловата структура на iOS приложението. Грешен избор може да доведе до случайно изтриване на важни данни на приложението от потребителя или, обратно, до невъзможност да намери собствените си файлове.

Просто правило: ако потребителят трябва да вижда файла и да може да го изтрие — използвай Documents. Ако файлът е необходим за работата на приложението, но потребителят не трябва да знае за него — използвай Application Support. Ако данните могат да бъдат възстановени — използвай Caches.

Най-добри практики за работа с Application Support

Работата с Application Support изисква вземане предвид на няколко характеристики, които я различават от другите директории в пясъчника. Спазването на тези практики помага да се избегне загуба на данни, проблеми с миграция и неочаквано поведение на приложението.

Винаги създавайте директорията при първото стартиране

За разлика от Documents, Application Support може да не съществува при първото стартиране. Използвай createDirectory(at:withIntermediateDirectories:) с параметър withIntermediateDirectories: true, за да гарантираш създаването на цялата верига от поддиректории.

Използвайте поддиректория с Bundle Identifier

Създай поддиректория с Bundle Identifier вътре в Application Support. Това изолира данните на твоето приложение от данните на други приложения (въпреки че пясъчникът вече осигурява изолация) и опростява миграцията при смяна на доставчик.

import Foundation

enum AppSupport {
    static func ensureDirectory() throws -> URL {
        let fm = FileManager.default
        let baseURL = try fm.url(
            for: .applicationSupportDirectory,
            in: .userDomainMask,
            appropriateFor: nil,
            create: true
        )
        let appDir = baseURL
            .appendingPathComponent(Bundle.main.bundleIdentifier ?? "default")
        try fm.createDirectory(at: appDir, withIntermediateDirectories: true)
        return appDir
    }
}

Спазването на тези практики гарантира, че служебните данни на приложението са правилно организирани, защитени от случайно изтриване от потребителя и правилно възстановени от резервни копия.