Application Support: bu nədir, konfiqurasiyaların saxlanması və Core Data

iOS-da Application Support nədir?

Application Support — iOS proqramının sandbox-unda, proqramın öz işi üçün yaratdığı və istifadə etdiyi, lakin istifadəçi sənədləri olmayan məlumatların saxlanması üçün kataloqdur. Bu, konfiqurasiyalar, verilənlər bazaları, keşlənmiş metadatalar və digər yardımçı fayllar üçün əsas yerdir.

iOS Application Support-u Documents (istifadəçi məlumatları) və Caches (müvəqqəti məlumatlar) arasında aralıq səviyyə kimi ayırır. Application Support-dakı fayllar nisbətən qalıcı ola bilər, lakin istifadəçinin onlara birbaşa girişi olmamalıdır — bu, onu Documents Directory-dən fərqləndirir.

Apple Developer Documentation (2024) məlumatına görə, Application Support Core Data SQLite verilənlər bazaları, Realm faylları, JSON/plist formatında konfiqurasiyalar, yüklənmiş istinad materialları və proqramın istifadə etdiyi, lakin istifadəçinin açıq şəkildə yaratmadığı digər məlumatlar üçün tövsiyə olunan yerdir.

Vacibdir: susmaya görə Application Support iCloud və iTunes ehtiyat nüsxələnməsinə daxildir. Əgər proqram bu kataloqda bərpa oluna bilən böyük həcmli məlumatlar saxlayırsa (məsələn, yüklənmiş təlimatlar), müvafiq fayllar üçün isExcludedFromBackup bayrağı qurulmalıdır.

Application Support yolunu necə əldə etmək olar

Swift-də Application Support Directory yoluna FileManager.urls(for: .applicationSupportDirectory) vasitəsilə əldə edilir. Apple məlumatların izolyasiyası üçün Application Support daxilində proqram adı ilə altkataloq yaratmağı tövsiyə edir.

import Foundation

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

// Proqram altkataloqunu yaradın
let bundleID = Bundle.main.bundleIdentifier ?? "com.example.app"
let appDir = appSupportURL.appendingPathComponent(bundleID)
try fileManager.createDirectory(
    at: appDir,
    withIntermediateDirectories: true
)

Objective-C NSSearchPathForDirectoriesInDomains istifadə edir NSApplicationSupportDirectory ilə. Swift-də olduğu kimi, proqram adı ilə altkataloq yaratmaq tövsiyə olunur.

@import Foundation;

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

İlk işə salınmada Application Support kataloqu mövcud olmaya bilər — onu createDirectory(at:withIntermediateDirectories:) istifadə edərək yaratmaq lazımdır. Bu, sistem tərəfindən avtomatik yaradılan Documents Directory-dən fərqlənir.

Application Support-da hansı məlumatları saxlamaq lazımdır

Application Support proqramın öz işi üçün istifadə etdiyi geniş spektrli məlumatlar üçün uyğundur. Bu kataloq üçün düzgün məlumat seçimi fayl sisteminin təşkilini yaxşılaşdırır və ehtiyat nüsxələnməni asanlaşdırır.

Core Data və Realm verilənlər bazaları

SQLite faylları Core Data susmaya görə Application Support-da yaradılır. Realm də verilənlər bazalarını bu kataloqda yerləşdirməyi tövsiyə edir. Bu, istifadəçi sənədlərini proqramın daxili verilənlər bazalarından təcrid edir.

Konfiqurasiya faylları

JSON, plist, proqram parametrləri olan XML faylları, Feature Flags, istifadəçi haqqında keşlənmiş metadatalar (lakin autentifikasiya tokenləri yox — onlar üçün Keychain).

Seçim meyarı: məlumatlar proqram tərəfindən yaradılır və istifadə olunursa, istifadəçi tərəfindən deyil, və işə salmalar arasında saxlanmalıdırsa — onların yeri Application Support-dadır.

Core Data və Application Support

Core Data — Application Support-un əsas istehlakçılarından biridir. NSPersistentContainer yaradılarkən Core Data avtomatik olaraq SQLite fayllarını Library/Application Support-da model adına əsaslanan unikal adla yerləşdirir.

Core Data-nın faylları harada saxladığını başa düşmək miqrasiyalar, ehtiyat nüsxələnmə və debug üçün kritik əhəmiyyətlidir. Əsas fayllar: .sqlite (məlumatlar), .sqlite-wal (Write-Ahead Log), .sqlite-shm (Shared Memory).

import CoreData

// Core Data konteynerini yaradın
let container = NSPersistentContainer(name: "MyAppModel")

// Xüsusi mağaza URL kataloqu
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]

CloudKit sinxronizasiyasından istifadə edərkən Core Data, SQLite faylı Application Support-da qalır, CloudKit isə nəqliyyat təbəqəsi kimi istifadə olunur. Bu halda faylları ehtiyat nüsxədən çıxarmamaq vacibdir — əks halda cihazlar arasında sinxronizasiya pozula bilər.

Application Support vs Documents Directory

Application Support və Documents arasındakı fərq iOS proqramının fayl strukturunun düzgün təşkili üçün ən vacib məqamlardan biridir. Səhv seçim istifadəçinin təsadüfən vacib məlumatları silməsinə və ya əksinə, öz fayllarını tapa bilməməsinə səbəb ola bilər.

Sadə qayda: istifadəçi faylı görməli və silə bilməlidirsə — Documents istifadə edin. Fayl proqramın işləməsi üçün lazımdırsa, lakin istifadəçi onun haqqında bilməməlidirsə — Application Support istifadə edin. Məlumatlar bərpa oluna bilirsə — Caches istifadə edin.

Application Support ilə işin ən yaxşı təcrübələri

Application Support ilə iş sandbox-ın digər kataloqlarından fərqləndirən bir neçə xüsusiyyətin nəzərə alınmasını tələb edir. Bu təcrübələrə riayət etmək məlumat itkisinin, miqrasiya problemlərinin və proqramın gözlənilməz davranışının qarşısını almağa kömək edir.

İlk işə salınmada həmişə kataloqu yaradın

Documents-dən fərqli olaraq, Application Support ilk işə salınmada mövcud olmaya bilər. Bütün altkataloqlar zəncirinin yaradılmasını təmin etmək üçün createDirectory(at:withIntermediateDirectories:) parametr ilə withIntermediateDirectories: true istifadə edin.

Bundle Identifier ilə altkataloqdan istifadə edin

Application Support daxilində Bundle Identifier ilə altkataloq yaradın. Bu, proqramınızın məlumatlarını digər proqramların məlumatlarından təcrid edir (sandbox artıq izolyasiyanı təmin etsə də) və təchizatçı dəyişikliyində miqrasiyanı asanlaşdırır.

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
    }
}

Bu təcrübələrə riayət etmək, proqramın yardımçı məlumatlarının düzgün təşkil olunmasını, istifadəçi tərəfindən təsadüfi silinmədən qorunmasını və ehtiyat nüsxələrdən düzgün bərpa olunmasını təmin edir.