FileManager — какво е това, работа с файловата система на iOS

Какво е FileManager

FileManager — сингълтън клас от Foundation framework, предоставящ унифицирано API за взаимодействие с файловата система на всички платформи на Apple. Достъпен е чрез FileManager.default или чрез създаване на инстанция с персонализиран делегат.

Основните възможности на класа включват: проверка за съществуване на файл (fileExists), създаване на директории (createDirectory), копиране и преместване (copyItem, moveItem), изтриване (removeItem), получаване на атрибути (attributesOfItem) и съдържание на директории (contentsOfDirectory). FileManager е тясно свързан с NSData, String и JSONEncoder/Decoder за сериализация на данни.

FileManager е thread-safe: Apple гарантира безопасността на извикване на методи от различни нишки. Въпреки това, операциите с файловата система могат да бъдат бавни при големи файлове, поради което Apple препоръчва да се изпълняват в опашка на заден план (DispatchQueue.global) и да се извикват методите на FileManagerDelegate за информиране за напредъка.

let fileManager = FileManager.default
let documentsURL = fileManager.urls(
    for: .documentDirectory,
    in: .userDomainMask
).first!

let fileURL = documentsURL.appendingPathComponent("data.plist")

if fileManager.fileExists(atPath: fileURL.path) {
    print("File exists at \(fileURL.path)")
}

Основни директории на iOS приложение

Всяко iOS приложение има три основни директории, достъпни чрез FileManager в рамките на Sandbox: Documents, Library и tmp. Всяка има своето предназначение и правила за архивиране, чието спазване е от решаващо значение за преминаване на преглед в App Store.

Documents — за потребителски данни, които трябва да се запазват между стартиранията и да се архивират в iCloud. Library — за файлове на приложението: кешове (Caches), настройки (Preferences), бази данни (Application Support). tmp — за временни файлове, които могат да бъдат изтрити от системата по всяко време между стартиранията на приложението.

Правило на Apple: ако файл може да бъде възстановен от интернет или пресъздаден — трябва да се съхранява в Caches (без архивиране). Ако файлът съдържа потребителски данни — Documents (с архивиране). Неправилното поставяне на файлове е една от честите причини за отхвърляне на приложението, тъй като Apple проверява съответствието с Storage & iCloud Backup Guidelines.

Четене и запис на файлове

FileManager сам по себе си не предоставя методи за четене на съдържание на файлове — за това се използват NSData(contentsOf), String(contentsOf) или методи на FileHandle. FileManager отговаря за управлението на файлове: проверка за съществуване, преместване, копиране, изтриване.

За запис на данни се използва методът createFile(atPath:contents:attributes:) или високо ниво API — data.write(to:), JSONEncoder.encode и PropertyListEncoder. FileManager също така предоставя FileHandle за поточно четене и запис на големи файлове, който не зарежда целия файл в паметта.

struct UserSettings: Codable {
    let username: String
    let isDarkMode: Bool
    let fontSize: Int
}

let settings = UserSettings(
    username: "developer",
    isDarkMode: true,
    fontSize: 16
)

// Запис на JSON в Documents
let encoder = JSONEncoder()
encoder.outputFormatting = .prettyPrinted
let data = try encoder.encode(settings)
let url = documentsURL.appendingPathComponent("settings.json")
try data.write(to: url, options: .atomic)

// Четене на JSON
let loadedData = try Data(contentsOf: url)
let loadedSettings = try JSONDecoder()
    .decode(UserSettings.self, from: loadedData)

При запис използвайте options: .atomic — това гарантира, че файлът няма да бъде повреден в случай на грешка при запис: данните първо се запазват във временен файл, след което атомарно се преместват към целевия път. За четене на големи файлове използвайте FileHandle с .readingMode и четете данните на части, като контролирате използването на паметта.

Управление на директории

FileManager предоставя методи за пълно управление на директории: createDirectory (създаване на всички междинни папки чрез withIntermediateDirectories), contentsOfDirectory (получаване на списък с файлове), enumeratorAt (рекурсивно обхождане) и subpathsOfDirectory (всички пътища в директорията).

Методът enumeratorAt връща DirectoryEnumerator, който позволява ефективно обхождане на големи директории без зареждане на цялото съдържание в паметта. Той поддържа филтриране чрез skipDescendants и предоставя атрибути на всеки елемент без допълнителна заявка към файловата система.

// Рекурсивно обхождане на директория
if let enumerator = fileManager.enumerator(
    at: documentsURL,
    includingPropertiesForKeys: [.fileSizeKey, .isDirectoryKey]
) {
    for case let fileURL as URL in enumerator {
        let attrs = try fileURL.resourceValues(
            for: [.fileSizeKey, .isDirectoryKey]
        )
        if attrs.isDirectory == false {
            let size = attrs.fileSize ?? 0
            print("File: \(fileURL.lastPathComponent), Size: \(size) bytes")
        }
    }
}

За изтриване на директория използвайте removeItem(at:). Внимание: изтриването на директория в iOS е необратимо — файловете не отиват в кошчето, както на macOS. Преди изтриване се уверете, че вече не използвате файлове от тази директория, и изпълнете операцията на фонова нишка, тъй като изтриването на много файлове може да блокира потребителския интерфейс.

FileManager и iCloud

FileManager се интегрира с iCloud Drive чрез метода URLForUbiquityContainerIdentifier, който връща URL на iCloud директорията за приложението. За работа е необходимо да се активира iCloud capability в проекта и да се добави съответният entitlement.

iCloud файловете се синхронизират автоматично, но FileManager предоставя методи за ръчен контрол: startDownloadingUbiquitousItem принудително започва изтегляне, evictUbiquitousItem изтрива локалното копие, а urlOfItem(at:) връща локалния URL за iCloud файла. NSMetadataQuery се използва за търсене на файлове в iCloud.

Критично ограничение: iCloud Drive не се поддържа за файлове в директорията Documents — само за файлове в ubiquityContainer. Не се опитвайте да синхронизирате Documents чрез iCloud; за целта използвайте NSUbiquitousKeyValueStore за малки обеми данни или Core Data с CloudKit за сложни структури.

Производителност на FileManager

Операциите с FileManager могат да бъдат скъпи, особено на устройства с бавна флаш памет. Основните препоръки на Apple включват извършване на всички файлови операции в опашки на заден план, минимизиране на броя на извикванията на fileExistsAtPath и използване на кеширане на резултати.

Методът fileExists изпълнява системно извикване stat(), което е относително бавно. Ако проверявате съществуването на файл преди да го прочетете, по-добре е веднага да опитате да го прочетете и да обработите грешката — това изпълнява същия stat, но елиминира двойното системно извикване. За масови проверки използвайте enumeratorAt с resourceValues.

За оптимизиране на работа с големи обеми данни:

• Използвайте FileHandle за поточна обработка на големи файлове
• Кеширайте резултатите от fileManager.urls за често използвани директории
• Изпълнявайте пакетни операции в гранулирана опашка, избягвайте блокиране на основната нишка
• Използвайте CoordinatedFileManager за безопасен достъп от множество нишки

Apple Instruments предоставя шаблон File Activity за профилиране на файлови операции. Използвайте го за идентифициране на тесни места — например чести извиквания на fileExists в цикъл или операции за запис на основната нишка. Най-честите проблеми с производителността са свързани със синхронен запис на големи файлове при минимизиране на приложението.