Caches Directory: mi ez, a gyorsítótár kezelése és az adatok törlése

Mi az a Caches Directory iOS-ben?

Caches Directory — egy könyvtár az iOS alkalmazás homokozójában, optimalizálva olyan adatok tárolására, amelyek szükség esetén visszaállíthatók. A Documents Directory-val ellentétben a Caches nem felhasználói adatokra szolgál — ez egy ideiglenes tároló az alkalmazás működésének gyorsítására.

Az iOS a Caches Directory-t használja gyorsítótárazott hálózati válaszok, előre betöltött képek, szerializált objektumok és olyan adatok elhelyezésére, amelyeket az alkalmazás visszaállíthat. A fejlesztő nem támaszkodhat az adatok hosszú távú tárolására ebben a könyvtárban.

Az Apple WWDC 2020 adatai szerint az iOS alkalmazások körülbelül 40%-a használja a Caches Directory-t gyorsítótárazott képek és hálózati adatok tárolására, míg a fejlesztők 25%-a helytelenül helyezi el a Caches-ben azokat az adatokat, amelyeknek a Documents vagy Application Support könyvtárban kellene lenniük, mert nem értik a könyvtárak közötti különbségeket.

A Caches kritikus tulajdonsága: az alkalmazásnak megfelelően kell kezelnie azt a helyzetet, amikor a gyorsítótár-fájlt a rendszer törölte. Ha a gyorsítótár törlése után az alkalmazás funkciói megsérülnek — az azt jelenti, hogy az adatok rossz könyvtárban vannak tárolva.

Hogyan kaphatjuk meg a Caches Directory elérési útját

Swift-ben a Caches Directory elérési útja a FileManager szabványos metódusával kapható meg a .cachesDirectory megadásával. Ez egy egyszerű művelet, amelyet gyakorlatilag minden hálózati adatokkal dolgozó iOS alkalmazás használ.

import Foundation

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

// Gyorsítótárazott JSON mentése
let cacheFile = cachesURL.appendingPathComponent("feed_cache.json")
let jsonData = try JSONSerialization.data(
    withJSONObject: response,
    options: [.prettyPrinted]
)
try jsonData.write(to: cacheFile)

Az Objective-C a NSSearchPathForDirectoriesInDomains-t használja NSCachesDirectory-val. Bár az Apple a Swift API-t ajánlja, az Objective-C kód a Caches Directory-val továbbra is működőképes és támogatott.

@import Foundation;

NSArray *paths = NSSearchPathForDirectoriesInDomains(
    NSCachesDirectory,
    NSUserDomainMask,
    YES
);
NSString *cachesPath = paths.firstObject;
NSString *cacheFile = [cachesPath stringByAppendingPathComponent:@"feed_cache.plist"];

A Swift projekteknek az URL-alapú API-t kell előnyben részesíteniük: ez típusbiztos és jobban integrálható olyan modern keretrendszerekkel, mint a SwiftUI és a Combine.

Milyen adatokat tároljunk a Caches-ben

Caches Directory optimális több olyan adatkategória számára, amelyeket az alkalmazás a működés gyorsítására használ, de nem ez az egyetlen igazságforrás. A gyorsítótárazandó adatok helyes kiválasztása közvetlenül befolyásolja az alkalmazás UX-ét és teljesítményét.

Gyorsítótárazott hálózati válaszok

JSON-válaszok API-tól, hírcsatorna-adatok, objektumlisták — minden, amit az alkalmazás újra tud tölteni a szerverről. Használja az URLCache-t a HTTP-válaszok automatikus gyorsítótárazásához, vagy manuálisan mentse a szerializált objektumokat.

Képek és médiafájlok

Képek letöltve a hálózatból — a Caches Directory leggyakoribb használati esete. Az olyan könyvtárak, mint az SDWebImage és a Kingfisher, alapértelmezés szerint pontosan a Caches-ben tárolják a gyorsítótárazott képeket.

Ha az adatok nem állíthatók vissza — a helyük nem a Caches-ben van. Ez a legegyszerűbb kritérium: képzelje el, hogy holnap a rendszer törli az összes fájlt a Caches-ből. Ha az alkalmazás továbbra is megfelelően működik — az adatok helyesen vannak tárolva.

Hogyan kezeli a rendszer a gyorsítótár törlését

Az iOS automatikusan kezeli a Caches Directory törlését, de a pontos triggerek és algoritmusok nincsenek dokumentálva az Apple által. Ismert, hogy a rendszer törölhet fájlokat a Caches-ből, ha nincs elegendő lemezterület, valamint az Offload Unused Apps funkció működése során.

A törlési folyamat átlátható az alkalmazás számára: a rendszer értesítés nélkül törli a fájlokat. Az alkalmazásnak ellenőriznie kell a fájl meglétét olvasás előtt, és hiány esetén újra létre kell hoznia. A hosszú távú tárolásra való támaszkodás elkerülése — kulcsfontosságú követelmény a Caches használatakor.

Az Apple "File System Basics" (2024) cikke szerint az alkalmazás nem számíthat arra, hogy a Caches Directory-ban lévő fájlok elérhetőek lesznek a munkamenetek között. A fejlesztőknek ajánlott fallback mechanizmust implementálniuk: ha a gyorsítótárazott fájl hiányzik — töltse le az adatokat a hálózatból, és mentse el újra a Caches-be.

Külön forgatókönyv — az alkalmazás kiürítése (Offload). E funkció aktiválásakor az iOS törli az alkalmazást, de megtartja annak Documents Directory-ját. A Caches Directory ezzel együtt törlődik. Az a felhasználó, aki visszaállította az alkalmazást, nem kapja meg a gyorsítótárazott adatokat — az alkalmazásnak újra le kell töltenie azokat.

Caches Directory vs Temporary Directory

A Caches és a Temporary (tmp) közötti különbség gyakran zavart okoz a fejlesztők körében. Mindkét könyvtár ideiglenes adatokat tárol, de eltérő élettartam-garanciákkal és célokkal.

Válassza a Caches-t, ha az adatok hasznosak az alkalmazás indítások között, de visszaállíthatók. Használja a tmp-t, ha az adatok csak az aktuális munkamenetben szükségesek, és nincs értékük az alkalmazás befejezése után.

Legjobb gyakorlatok a Caches használatához

A Caches Directory-val való munka néhány szabály betartását igényli, amelyek segítenek elkerülni az adatvesztést, az alkalmazás váratlan viselkedését és a teljesítményproblémákat.

Mindig ellenőrizze a fájl meglétét olvasás előtt

A FileManager.fileExists(atPath:)-t minden Caches-ből történő olvasás előtt meg kell hívni. Ha a fájl hiányzik — töltse le az adatokat az eredeti forrásból, és mentse el a gyorsítótárba. Soha ne feltételezze, hogy a Caches-ből származó fájl létezik.

Korlátozza a gyorsítótár méretét

Állítsa be a Caches Directory maximális méretét az alkalmazásban. Például 50 MB-os korlát a képekhez és 10 MB a JSON-válaszokhoz. A korlát túllépésekor törölje a legrégebbi fájlokat a módosítás dátuma szerint.

import Foundation

func trimCache(to maxSizeBytes: Int) {
    let cachesURL = FileManager.default
        .urls(for: .cachesDirectory, in: .userDomainMask)
        .first!

    guard let enumerator = FileManager.default
        .enumerator(
            at: cachesURL,
            includingPropertiesForKeys: [.fileSizeKey, .contentModificationDateKey]
        )
    else { return }

    // Régi fájlok felsorolása és törlése
    // méretkorlát túllépésekor
}

E gyakorlatok betartása garantálja, hogy az alkalmazás megfelelően működik a rendszer gyorsítótár-törlési műveletei során, és a felhasználó nem találkozik váratlan adatvesztéssel.