FileManager — bu nima, iOS fayl tizimi bilan ishlash

FileManager nima

FileManager — bu Foundation frameworkidan barcha Apple platformalarida fayl tizimi bilan o'zaro aloqa qilish uchun yagona API ta'minlovchi singleton sinfdir. U FileManager.default yoki maxsus delegat bilan namuna yaratish orqali mavjud.

Sinfning asosiy imkoniyatlari: fayl mavjudligini tekshirish (fileExists), kataloglarni yaratish (createDirectory), nusxalash va ko'chirish (copyItem, moveItem), o'chirish (removeItem), atributlarni olish (attributesOfItem) va kataloglar tarkibini olish (contentsOfDirectory). FileManager ma'lumotlarni seriyalashtirish uchun NSData, String va JSONEncoder/Decoder bilan chambarchas bog'liq.

FileManager thread-safe hisoblanadi: Apple turli oqimlardan metodlarni chaqirish xavfsizligini kafolatlaydi. Biroq, fayl tizimi operatsiyalari katta fayllarda sekin bo'lishi mumkin, shuning uchun Apple ularni fon navbatida (DispatchQueue.global) bajarishni va taraqqiyot haqida xabar berish uchun FileManagerDelegate metodlarini chaqirishni tavsiya qiladi.

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 ilovasining asosiy kataloglari

Har bir iOS ilovasi Sandbox doirasida FileManager orqali mavjud bo'lgan uchta asosiy katalog ga ega: Documents, Library va tmp. Har biri o'z maqsadiga va zaxira nusxa qoidalariga ega, ularga rioya qilish App Store ko'rib chiqishidan o'tish uchun juda muhimdir.

Documents — ishga tushirishlar orasida saqlanishi va iCloud-ga zaxira nusxasi olinishi kerak bo'lgan foydalanuvchi ma'lumotlari uchun. Library — ilova fayllari uchun: kesh (Caches), sozlamalar (Preferences), ma'lumotlar bazalari (Application Support). tmp — ilova ishga tushirishlari orasida tizim tomonidan istalgan vaqtda o'chirilishi mumkin bo'lgan vaqtinchalik fayllar uchun.

Apple qoidasi: agar faylni internetdan tiklash yoki qayta yaratish mumkin bo'lsa — u Caches da saqlanishi kerak (zaxira nusxasiz). Agar fayl foydalanuvchi ma'lumotlarini o'z ichiga olsa — Documents da (zaxira nusxasi bilan). Fayllarni noto'g'ri joylashtirish ilovani rad etishning tez-tez uchraydigan sabablaridan biridir, chunki Apple Storage & iCloud Backup Guidelines ga muvofiqligini tekshiradi.

Fayllarni o'qish va yozish

FileManager o'zi fayllar tarkibini o'qish uchun metodlarni taqdim etmaydi — buning uchun NSData(contentsOf), String(contentsOf) yoki FileHandle metodlari ishlatiladi. FileManager fayllarni boshqarish uchun javobgardir: mavjudligini tekshirish, ko'chirish, nusxalash, o'chirish.

Ma'lumotlarni yozish uchun createFile(atPath:contents:attributes:) metodi yoki yuqori darajadagi API-lar — data.write(to:), JSONEncoder.encode va PropertyListEncoder ishlatiladi. FileManager shuningdek, katta fayllarni oqimli o'qish va yozish uchun butun faylni xotiraga yuklamaydigan FileHandle ni taqdim etadi.

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

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

// JSON ni Documents ga yoz
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 ni o'qish
let loadedData = try Data(contentsOf: url)
let loadedSettings = try JSONDecoder()
    .decode(UserSettings.self, from: loadedData)

Yozishda options: .atomic dan foydalaning — bu yozishdagi nosozlikda faylning buzilmasligini kafolatlaydi: ma'lumotlar avval vaqtinchalik faylga saqlanadi, so'ngra atomik ravishda maqsadli yo'lga ko'chiriladi. Katta fayllarni o'qish uchun FileHandle ni .readingMode bilan ishlating va xotira sarfini nazorat qilib, ma'lumotlarni bo'laklab o'qing.

Kataloglarni boshqarish

FileManager kataloglarni to'liq boshqarish uchun metodlarni taqdim etadi: createDirectory (withIntermediateDirectories orqali barcha oraliq papkalarni yaratish), contentsOfDirectory (fayllar ro'yxatini olish), enumeratorAt (rekursiv aylanib chiqish) va subpathsOfDirectory (katalog ichidagi barcha yo'llar).

enumeratorAt metodi DirectoryEnumerator qaytaradi, bu butun tarkibni xotiraga yuklamasdan katta kataloglarni samarali aylanib chiqish imkonini beradi. U skipDescendants orqali filtrlashni qo'llab-quvvatlaydi va fayl tizimiga qo'shimcha so'rovsiz har bir elementning atributlarini taqdim etadi.

// Rekursiv katalog aylanib chiqish
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")
        }
    }
}

Katalogni o'chirish uchun removeItem(at:) dan foydalaning. Diqqat: iOS-da katalogni o'chirish qaytarilmasdir — fayllar macOS-dagi kabi axlat qutisiga tushmaydi. O'chirishdan oldin ushbu katalogdagi fayllardan endi foydalanmayotganingizga ishonch hosil qiling va operatsiyani fon oqimida bajaring, chunki ko'p sonli fayllarni o'chirish UI ni bloklashi mumkin.

FileManager va iCloud

FileManager iCloud Drive bilan URLForUbiquityContainerIdentifier metodi orqali integratsiyalashadi, bu ilova uchun iCloud katalogining URL-ni qaytaradi. Ishlash uchun loyihada iCloud capability-ni yoqish va tegishli entitlement qo'shish talab qilinadi.

iCloud fayllari avtomatik sinxronlanadi, ammo FileManager qo'lda boshqarish uchun metodlarni taqdim etadi: startDownloadingUbiquitousItem yuklab olishni majburan boshlaydi, evictUbiquitousItem mahalliy nusxani o'chiradi, urlOfItem(at:) iCloud fayli uchun mahalliy URL qaytaradi. NSMetadataQuery iCloud-da fayllarni qidirish uchun ishlatiladi.

Muhim cheklov: iCloud Drive Documents katalogidagi fayllar uchun qo'llab-quvvatlanmaydi — faqat ubiquityContainer dagi fayllar uchun. Documents ni iCloud orqali sinxronlashtirishga urinmang; buning uchun kichik hajmdagi ma'lumotlar uchun NSUbiquitousKeyValueStore yoki murakkab tuzilmalar uchun Core Data bilan CloudKit dan foydalaning.

FileManager ishlashi

FileManager operatsiyalari, ayniqsa sekin flesh-xotiraga ega qurilmalarda, qimmat bo'lishi mumkin. Apple ning asosiy tavsiyalari barcha fayl operatsiyalarini fon navbatlarida bajarish, fileExistsAtPath chaqiruvlari sonini minimallashtirish va natijalarni keshlashni o'z ichiga oladi.

fileExists metodi nisbatan sekin bo'lgan stat() tizim chaqiruvini bajaradi. Agar faylni o'qishdan oldin uning mavjudligini tekshirayotgan bo'lsangiz, darhol o'qishga urinib, xatoni boshqarish yaxshiroqdir — bu bir xil stat-ni bajaradi, ammo ikkilangan tizim chaqiruvidan qutqaradi. Ommaviy tekshirishlar uchun resourceValues bilan enumeratorAt dan foydalaning.

Katta hajmdagi ma'lumotlar bilan ishlashni optimallashtirish uchun:

• Katta fayllarni oqimli qayta ishlash uchun FileHandle dan foydalaning
• Tez-tez ishlatiladigan kataloglar uchun fileManager.urls natijalarini keshlang
• Ommaviy operatsiyalarni granulat navbatda bajaring, main thread bloklanishidan saqlaning
• Bir nechta oqimlardan xavfsiz kirish uchun CoordinatedFileManager dan foydalaning

Apple Instruments fayl operatsiyalarini profillash uchun File Activity shablonini taqdim etadi. Uni tor joylarni aniqlash uchun foydalaning — masalan, siklda tez-tez fileExists chaqiruvlari yoki main thread da yozish operatsiyalari. Eng keng tarqalgan ishlash muammolari ilovani yig'ish paytida katta fayllarni sinxron yozish bilan bog'liq.