Caches Directory: ce este, gestionarea cache-ului și ștergerea datelor

Ce este Caches Directory în iOS?

Caches Directory — este un director în interiorul sandbox-ului aplicației iOS, optimizat pentru stocarea datelor care pot fi restaurate la nevoie. Spre deosebire de Documents Directory, Caches nu este destinat datelor utilizatorului — este o stocare temporară pentru accelerarea funcționării aplicației.

iOS folosește Caches Directory pentru plasarea răspunsurilor de rețea stocate în cache, imaginilor preîncărcate, obiectelor serializate și datelor pe care aplicația le poate restaura. Dezvoltatorul nu trebuie să se bazeze pe stocarea pe termen lung a datelor în acest director.

Conform datelor Apple WWDC 2020, aproximativ 40% din aplicațiile iOS folosesc Caches Directory pentru stocarea imaginilor cache și a datelor de rețea, iar 25% dintre dezvoltatori plasează incorect în Caches date care ar trebui să se afle în Documents sau Application Support, din cauza neînțelegerii diferențelor dintre aceste directoare.

Proprietatea critică a Caches: aplicația trebuie să gestioneze corect situația în care fișierul cache a fost șters de sistem. Dacă după ștergerea cache-ului funcționalitatea aplicației este afectată — înseamnă că datele sunt stocate în directorul greșit.

Cum se obține calea către Caches Directory

În Swift, calea către Caches Directory se obține prin metoda standard FileManager cu specificarea .cachesDirectory. Este o operațiune simplă, utilizată practic în fiecare aplicație iOS care lucrează cu date de rețea.

import Foundation

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

// Salvează JSON-ul cache
let cacheFile = cachesURL.appendingPathComponent("feed_cache.json")
let jsonData = try JSONSerialization.data(
    withJSONObject: response,
    options: [.prettyPrinted]
)
try jsonData.write(to: cacheFile)

Objective-C folosește NSSearchPathForDirectoriesInDomains cu NSCachesDirectory. Deși Apple recomandă Swift API, codul Objective-C cu Caches Directory rămâne funcțional și suportat.

@import Foundation;

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

Proiectele Swift ar trebui să prefere API-ul bazat pe URL: este sigur din punct de vedere al tipurilor și se integrează mai bine cu framework-urile moderne precum SwiftUI și Combine.

Ce date să stocați în Caches

Caches Directory este optim pentru câteva categorii de date pe care aplicația le folosește pentru a-și accelera funcționarea, dar nu este singura sursă de adevăr. Selectarea corectă a datelor pentru cache influențează direct UX-ul și performanța aplicației.

Răspunsuri de rețea stocate în cache

Răspunsurile JSON de la API, datele fluxurilor de știri, listele de obiecte — tot ce poate aplicația reîncărca de pe server. Folosiți URLCache pentru cache automat al răspunsurilor HTTP sau salvați manual obiecte serializate.

Imagini și fișiere media

Imaginile încărcate din rețea — cel mai frecvent caz de utilizare a Caches Directory. Bibliotecile precum SDWebImage și Kingfisher salvează implicit imaginile cache exact în Caches.

Dacă datele nu pot fi restaurate — locul lor nu este în Caches. Acesta este cel mai simplu criteriu: imaginați-vă că mâine sistemul șterge toate fișierele din Caches. Dacă aplicația continuă să funcționeze corect — datele sunt stocate corect.

Cum gestionează sistemul ștergerea cache-ului

iOS gestionează automat ștergerea Caches Directory, dar declanșatoarele și algoritmii exacti nu sunt documentați de Apple. Se știe că sistemul poate șterge fișierele din Caches când spațiul pe disc este insuficient, precum și la funcționarea funcției Offload Unused Apps.

Procesul de ștergere este transparent pentru aplicație: sistemul șterge fișierele fără notificare. Aplicația trebuie să verifice existența fișierului înainte de citire și să îl creeze din nou la absență. A nu se baza pe stocarea pe termen lung — este cerința cheie la lucrul cu Caches.

Conform articolului Apple "File System Basics" (2024), aplicația nu trebuie să conteze că fișierele din Caches Directory vor fi disponibile între sesiuni. Dezvoltatorilor li se recomandă să implementeze un mecanism de fallback: la absența fișierului cache — încărcați datele din rețea și salvați din nou în Caches.

Un scenariu separat — descărcarea aplicației (Offload). La activarea acestei funcții, iOS șterge aplicația dar păstrează Documents Directory. Caches Directory este șters în acest proces. Utilizatorul care a restaurat aplicația nu va primi datele cache — aplicația trebuie să le încarce din nou.

Caches Directory vs Temporary Directory

Diferența dintre Caches și Temporary (tmp) cauzează adesea confuzie printre dezvoltatori. Ambele directoare stochează date temporare, dar cu garanții diferite de durată de viață și scop.

Alegeți Caches dacă datele sunt utile de păstrat între pornirile aplicației, dar pot fi restaurate. Folosiți tmp dacă datele sunt necesare doar în sesiunea curentă și nu au valoare după încheierea aplicației.

Cele mai bune practici de lucru cu Caches

Lucrul cu Caches Directory necesită respectarea câtorva reguli care ajută la evitarea pierderii de date, a comportamentului neașteptat al aplicației și a problemelor de performanță.

Verificați întotdeauna existența fișierului înainte de citire

FileManager.fileExists(atPath:) trebuie apelat înainte de fiecare citire din Caches. Dacă fișierul lipsește — încărcați datele din sursa originală și salvați în cache. Nu presupuneți niciodată că fișierul din Caches există.

Limitați dimensiunea cache-ului

Stabiliți dimensiunea maximă a Caches Directory în aplicație. De exemplu, o limită de 50 MB pentru imagini și 10 MB pentru răspunsuri JSON. La depășirea limitei, ștergeți cele mai vechi fișiere după data modificării.

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 }

    // Enumeră și șterge fișierele vechi
    // la depășirea limitei de dimensiune
}

Respectarea acestor practici garantează că aplicația funcționează corect la orice acțiuni ale sistemului de ștergere a cache-ului, iar utilizatorul nu se confruntă cu pierderea neașteptată a datelor.