Application Support: تخزين الإعدادات وCore Data

ما هو Application Support في iOS؟

Application Support هو دليل في بيئة الحماية (sandbox) لتطبيق iOS مصمم لتخزين البيانات التي ينشئها التطبيق ويستخدمها لعمله، ولكنها ليست مستندات مستخدم. هذا هو المكان الرئيسي للإعدادات، وقواعد البيانات، والبيانات الوصفية المخزنة مؤقتاً، وغيرها من الملفات المساعدة.

يصنف iOS Application Support كـ طبقة وسيطة بين Documents (بيانات المستخدم) و Caches (بيانات مؤقتة). يمكن أن تكون الملفات في Application Support دائمة نسبياً، ولكن لا ينبغي أن يكون للمستخدم وصول مباشر إليها — وهذا ما يميزها عن دليل Documents.

وفقاً لـ وثائق مطوري Apple (2024)، Application Support هو المكان الموصى به لتخزين قواعد بيانات SQLite الخاصة بـ Core Data، وملفات Realm، والإعدادات بتنسيق JSON/plist، والمواد المرجعية التي تم تنزيلها، وغيرها من البيانات التي يستخدمها التطبيق ولكن لم ينشئها المستخدم صراحةً.

مهم: بشكل افتراضي، Application Support مشمول في النسخ الاحتياطي لـ iCloud و iTunes. إذا كان التطبيق يخزن كميات كبيرة من البيانات في هذا الدليل التي يمكن إعادة إنشائها (مثل الأدلة التي تم تنزيلها)، فيجب تعيين علامة isExcludedFromBackup للملفات المعنية.

كيفية الحصول على المسار إلى Application Support

في Swift، يتم الحصول على المسار إلى دليل Application Support عبر FileManager.urls(for: .applicationSupportDirectory). توصي Apple بإنشاء دليل فرعي باسم التطبيق داخل Application Support لعزل البيانات.

import Foundation

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

// Create app subdirectory
let bundleID = Bundle.main.bundleIdentifier ?? "com.example.app"
let appDir = appSupportURL.appendingPathComponent(bundleID)
try fileManager.createDirectory(
    at: appDir,
    withIntermediateDirectories: true
)

يستخدم Objective-C NSSearchPathForDirectoriesInDomains مع NSApplicationSupportDirectory. كما هو الحال مع Swift، يُنصح بإنشاء دليل فرعي باسم التطبيق.

@import Foundation;

NSArray *paths = NSSearchPathForDirectoriesInDomains(
    NSApplicationSupportDirectory,
    NSUserDomainMask,
    YES
);
NSString *appSupportPath = paths.firstObject;
NSString *appDir = [appSupportPath stringByAppendingPathComponent:@"com.example.app"];

عند التشغيل الأول، قد لا يكون دليل Application Support موجوداً — يجب إنشاؤه باستخدام createDirectory(at:withIntermediateDirectories:). هذا يختلف عن دليل Documents الذي ينشئه النظام تلقائياً.

ما البيانات التي تخزنها في Application Support

Application Support مناسب لمجموعة واسعة من البيانات التي يستخدمها التطبيق لعمله. اختيار البيانات الصحيحة لهذا الدليل يحسن تنظيم نظام الملفات ويبسط النسخ الاحتياطي.

قواعد بيانات Core Data و Realm

ملفات SQLite الخاصة بـ Core Data تُنشأ في Application Support بشكل افتراضي. توصي Realm أيضاً بوضع قواعد البيانات في هذا الدليل. هذا يعزل مستندات المستخدم عن قواعد البيانات الداخلية للتطبيق.

ملفات الإعدادات

ملفات JSON و plist و XML بإعدادات التطبيق، و Feature Flags، والبيانات الوصفية المخزنة مؤقتاً عن المستخدم (ولكن ليس رموز المصادقة — استخدم Keychain لها).

معيار الاختيار: إذا كانت البيانات منشأة ومستخدمة من قبل التطبيق، وليس المستخدم، ويجب أن تبقى بين جلسات التشغيل — مكانها في Application Support.

Core Data و Application Support

Core Data هو أحد المستهلكين الرئيسيين لـ Application Support. عند إنشاء NSPersistentContainer، تضع Core Data تلقائياً ملفات SQLite في Library/Application Support باسم فريد بناءً على اسم النموذج.

فهم أين تخزن Core Data الملفات أمر بالغ الأهمية لـ الترحيل (migrations)، والنسخ الاحتياطي، وتصحيح الأخطاء. الملفات الرئيسية: .sqlite (البيانات)، .sqlite-wal (سجل الكتابة المسبقة)، .sqlite-shm (الذاكرة المشتركة).

import CoreData

// Create Core Data container
let container = NSPersistentContainer(name: "MyAppModel")

// Custom store URL directory
guard let appSupportURL = FileManager.default
    .urls(for: .applicationSupportDirectory,
        in: .userDomainMask).first else { return }

let storeURL = appSupportURL
    .appendingPathComponent("MyAppModel.sqlite")
let description = NSPersistentStoreDescription(url: storeURL)
container.persistentStoreDescriptions = [description]

عند استخدام مزامنة Core Data مع CloudKit، يبقى ملف SQLite في Application Support، ويعمل CloudKit كطبقة نقل. في هذه الحالة، من المهم عدم استثناء الملفات من النسخ الاحتياطي — وإلا فقد تتعطل المزامنة بين الأجهزة.

Application Support مقابل دليل Documents

الفرق بين Application Support و Documents هو أحد أهم الاختلافات لتنظيم هيكل ملفات تطبيق iOS بشكل صحيح. الاختيار غير الصحيح قد يؤدي إلى حذف المستخدم لبيانات مهمة عن طريق الخطأ أو، على العكس، عدم قدرته على العثور على ملفاته.

قاعدة بسيطة: إذا كان يجب على المستخدم رؤية الملف والقدرة على حذفه — استخدم Documents. إذا كان الملف مطلوباً لعمل التطبيق ولكن لا يحتاج المستخدم إلى معرفته — استخدم Application Support. إذا كان يمكن إعادة إنشاء البيانات — استخدم Caches.

أفضل الممارسات للعمل مع Application Support

العمل مع Application Support يتطلب مراعاة عدة ميزات تميزه عن أدلة الحماية الأخرى. اتباع هذه الممارسات يساعد في تجنب فقدان البيانات، ومشاكل الترحيل، والسلوك غير المتوقع للتطبيق.

دائماً أنشئ الدليل عند التشغيل الأول

على عكس Documents، قد لا يكون Application Support موجوداً عند التشغيل الأول. استخدم createDirectory(at:withIntermediateDirectories:) مع المعامل withIntermediateDirectories: true لضمان إنشاء سلسلة الأدلة الفرعية بأكملها.

استخدم دليلاً فرعياً مع Bundle Identifier

أنشئ دليلاً فرعياً مع Bundle Identifier داخل Application Support. هذا يعزل بيانات تطبيقك عن بيانات التطبيقات الأخرى (على الرغم من أن بيئة الحماية توفر بالفعل عزلاً) ويبسط الترحيل عند تغيير المزود.

import Foundation

enum AppSupport {
    static func ensureDirectory() throws -> URL {
        let fm = FileManager.default
        let baseURL = try fm.url(
            for: .applicationSupportDirectory,
            in: .userDomainMask,
            appropriateFor: nil,
            create: true
        )
        let appDir = baseURL
            .appendingPathComponent(Bundle.main.bundleIdentifier ?? "default")
        try fm.createDirectory(at: appDir, withIntermediateDirectories: true)
        return appDir
    }
}

اتباع هذه الممارسات يضمن أن بيانات خدمة التطبيق منظمة بشكل صحيح، ومحمية من الحذف العرضي من قبل المستخدم، ويتم استعادتها بشكل صحيح من النسخ الاحتياطية.