Caches Directory: ما هو، إدارة التخزين المؤقت وتنظيف البيانات

ما هو Caches Directory في iOS؟

Caches Directory هو دليل داخل بيئة الحماية (sandbox) لتطبيق 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 توصي بـ API Swift، إلا أن كود Objective-C مع Caches Directory يظل عاملاً ومدعوماً.

@import Foundation;

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

يجب أن تفضل مشاريع Swift API المستند إلى URL: فهو آمن من حيث النوع ويتكامل بشكل أفضل مع الأطر الحديثة مثل SwiftUI و Combine.

ما البيانات التي تخزنها في Caches

Caches Directory مثالي لعدة فئات من البيانات التي يستخدمها التطبيق لتسريع الأداء، لكنه ليس المصدر الوحيد للحقيقة. اختيار البيانات الصحيحة للتخزين المؤقت يؤثر مباشرة على تجربة المستخدم وأداء التطبيق.

استجابات الشبكة المخزنة مؤقتاً

استجابات JSON من APIs، وبيانات خلاصات الأخبار، وقوائم الكائنات — كل ما يمكن للتطبيق إعادة تحميله من الخادم. استخدم 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 ستكون متاحة بين الجلسات. يُنصح المطورون بتنفيذ آلية احتياطية: إذا كان ملف التخزين المؤقت مفقوداً، قم بتنزيل البيانات من الشبكة وحفظها في Caches مرة أخرى.

سيناريو منفصل هو إلغاء تحميل التطبيق (Offload). عند تفعيل هذه الميزة، يقوم iOS بإزالة التطبيق لكنه يحتفظ بـ Documents Directory الخاص به. يتم حذف Caches Directory في هذه العملية. المستخدم الذي يستعيد التطبيق لن يحصل على البيانات المخزنة مؤقتاً — يجب على التطبيق تنزيلها مرة أخرى.

Caches Directory مقابل 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
}

اتباع هذه الممارسات يضمن أن التطبيق يعمل بشكل صحيح بغض النظر عن إجراءات تنظيف التخزين المؤقت للنظام، وألا يواجه المستخدمون فقداناً غير متوقع للبيانات.