Caches Directory: що це, управління кешем та очищення даних

Що таке Caches Directory в iOS?

Caches Directory — це директорія всередині пісочниці iOS-застосунку, оптимізована для зберігання даних, які можна відновити за потреби. На відміну від Documents Directory, Caches не призначений для користувацьких даних — це тимчасове сховище для прискорення роботи застосунку.

iOS використовує Caches Directory для розміщення кешованих мережевих відповідей, попередньо завантажених зображень, серіалізованих об’єктів та даних, які застосунок може відновити. Розробник не повинен покладатися на довгострокове зберігання даних у цій директорії.

За даними Apple WWDC 2020, близько 40% iOS-застосунків використовують Caches Directory для зберігання кешованих зображень та мережевих даних, при цьому 25% розробників неправильно розміщують у Caches дані, які повинні знаходитися в Documents або Application Support, через нерозуміння відмінностей між цими директоріями.

Критична властивість Caches: застосунок повинен коректно обробляти ситуацію, коли файл з кешу було видалено системою. Якщо після видалення кешу функціональність застосунку порушується, значить дані зберігаються в неправильній директорії.

Як отримати шлях до Caches Directory

У Swift шлях до Caches Directory отримується стандартним методом FileManager із зазначенням .cachesDirectory. Це проста дія, яка використовується практично в кожному iOS-застосунку, що працює з мережевими даними.

import Foundation

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

// Save cached JSON
let cacheFile = cachesURL.appendingPathComponent("feed_cache.json")
let jsonData = try JSONSerialization.data(
    withJSONObject: response,
    options: [.prettyPrinted]
)
try jsonData.write(to: cacheFile)

Objective-C використовує NSSearchPathForDirectoriesInDomains з NSCachesDirectory. Незважаючи на те, що Apple рекомендує Swift API, Objective-C-код з Caches Directory залишається робочим та підтримується.

@import Foundation;

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

Swift-проекти повинні віддавати перевагу URL-based API: воно типобезпечне та краще інтегрується з сучасними фреймворками, такими як SwiftUI та Combine.

Які дані зберігати в Caches

Caches Directory оптимальна для кількох категорій даних, які застосунок використовує для прискорення роботи, але не є єдиним джерелом істини. Правильний вибір даних для кешування безпосередньо впливає на UX та продуктивність застосунку.

Кешовані мережеві відповіді

JSON-відповіді від API, дані новинних стрічок, списки об’єктів. Все, що застосунок може повторно завантажити з сервера. Використовуй URLCache для автоматичного кешування HTTP-відповідей або зберігай вручну серіалізовані об’єкти.

Зображення та медіафайли

Зображення, завантажені з мережі — найчастіший випадок використання Caches Directory. Бібліотеки на кшталт SDWebImage та Kingfisher за замовчуванням зберігають кешовані зображення саме в Caches.

Якщо дані не можуть бути відновлені — їм не місце в Caches. Це найпростіший критерій: уяви, що завтра система видалить всі файли з Caches. Якщо застосунок продовжить коректно працювати — дані зберігаються правильно.

Як система керує очищенням кешу

iOS автоматично керує очищенням Caches Directory, але точні тригери та алгоритми не задокументовані Apple. Відомо, що система може видаляти файли з Caches при нестачі місця на диску, а також при роботі функції Offload Unused Apps.

Процес очищення — прозорий для застосунку: система видаляє файли без повідомлення. Застосунок повинен перевіряти наявність файлу перед читанням та створювати його заново за відсутності. Нерозраховування на довгострокове зберігання — ключова вимога при роботі з Caches.

За даними статті Apple «File System Basics» (2024), застосунок не повинен розраховувати на те, що файли в Caches Directory будуть доступні між сесіями. Розробникам рекомендується реалізувати fallback-механізм: при відсутності кешованого файлу — завантажити дані з мережі та зберегти в Caches знову.

Окремий сценарій — вивантаження застосунку (Offload). При активації цієї функції iOS видаляє застосунок, але зберігає його Documents Directory. Caches Directory при цьому видаляється. Користувач, який відновив застосунок, не отримає кешовані дані — застосунок повинен завантажити їх заново.

Caches Directory vs Temporary Directory

Різниця між Caches та Temporary (tmp) директоріями часто викликає плутанину у розробників. Обидві директорії зберігають тимчасові дані, але з різними гарантіями часу життя та призначенням.

Обирай Caches, якщо дані корисно зберігати між запусками застосунку, але їх можна відновити. Використовуй tmp, якщо дані потрібні лише в рамках поточної сесії та не мають цінності після завершення застосунку.

Кращі практики роботи з Caches

Робота з Caches Directory вимагає дотримання кількох правил, які допомагають уникнути втрати даних, неочікуваної поведінки застосунку та проблем з продуктивністю.

Завжди перевіряй наявність файлу перед читанням

FileManager.fileExists(atPath:) повинен викликатися перед кожним читанням з Caches. Якщо файл відсутній — завантаж дані з першоджерела та збережи в кеш. Ніколи не припускай, що файл з Caches існує.

Обмежуй розмір кешу

Встановлюй максимальний розмір Caches Directory в застосунку. Наприклад, ліміт у 50 МБ для зображень та 10 МБ для JSON-відповідей. При перевищенні ліміту видаляй найстаріші файли за датою модифікації.

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 }

    // Enumerate and remove old files
    // when exceeding size limit
}

Дотримання цих практик гарантує, що застосунок коректно працює при будь-яких діях системи щодо очищення кешу, а користувач не стикається з неочікуваною втратою даних.