Application Support: apa itu, penyimpanan konfigurasi dan Core Data

Apa itu Application Support di iOS?

Application Support — adalah direktori dalam sandbox aplikasi iOS yang dirancang untuk menyimpan data yang dibuat dan digunakan aplikasi untuk pengoperasiannya, tetapi bukan dokumen pengguna. Ini adalah tempat utama untuk konfigurasi, database, metadata yang di-cache, dan file pendukung lainnya.

iOS membedakan Application Support sebagai tingkat menengah antara Documents (data pengguna) dan Caches (data sementara). File di Application Support bisa relatif permanen, tetapi pengguna tidak boleh memiliki akses langsung ke sana — ini yang membedakannya dari Documents Directory.

Menurut Apple Developer Documentation (2024), Application Support adalah lokasi yang direkomendasikan untuk menyimpan database SQLite Core Data, file Realm, konfigurasi dalam format JSON/plist, materi referensi yang diunduh, dan data lain yang digunakan aplikasi tetapi tidak dibuat secara eksplisit oleh pengguna.

Penting: secara default, Application Support termasuk dalam cadangan iCloud dan iTunes. Jika aplikasi menyimpan volume data besar yang dapat dipulihkan di direktori ini (misalnya, panduan yang diunduh), perlu mengatur flag isExcludedFromBackup untuk file yang bersangkutan.

Cara mendapatkan jalur ke Application Support

Di Swift, jalur ke Application Support Directory diperoleh melalui FileManager.urls(for: .applicationSupportDirectory). Apple merekomendasikan membuat subdirektori dengan nama aplikasi di dalam Application Support untuk isolasi data.

import Foundation

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

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

Objective-C menggunakan NSSearchPathForDirectoriesInDomains dengan NSApplicationSupportDirectory. Sama seperti di Swift, disarankan membuat subdirektori dengan nama aplikasi.

@import Foundation;

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

Pada peluncuran pertama, direktori Application Support mungkin belum ada — harus dibuat menggunakan createDirectory(at:withIntermediateDirectories:). Ini membedakannya dari Documents Directory yang dibuat secara otomatis oleh sistem.

Data apa yang disimpan di Application Support

Application Support cocok untuk berbagai data yang digunakan aplikasi untuk pengoperasiannya. Pemilihan data yang tepat untuk direktori ini meningkatkan organisasi sistem file dan menyederhanakan pencadangan.

Database Core Data dan Realm

File SQLite Core Data secara default dibuat di Application Support. Realm juga merekomendasikan menempatkan database di direktori ini. Ini mengisolasi dokumen pengguna dari database internal aplikasi.

File konfigurasi

JSON, plist, file XML dengan pengaturan aplikasi, Feature Flags, metadata yang di-cache tentang pengguna (tetapi bukan token autentikasi — untuk itu ada Keychain).

Kriteria pemilihan: jika data dibuat dan digunakan oleh aplikasi, bukan oleh pengguna, dan harus dipertahankan antar peluncuran — tempatnya di Application Support.

Core Data dan Application Support

Core Data — salah satu konsumen utama Application Support. Saat membuat NSPersistentContainer, Core Data secara otomatis menempatkan file SQLite di Library/Application Support dengan nama unik berdasarkan nama model.

Memahami di mana Core Data menyimpan file sangat penting untuk migrasi, pencadangan, dan debugging. File utama: .sqlite (data), .sqlite-wal (Write-Ahead Log), .sqlite-shm (Shared Memory).

import CoreData

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

// Direktori URL toko kustom
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]

Saat menggunakan sinkronisasi CloudKit untuk Core Data, file SQLite tetap di Application Support, dan CloudKit digunakan sebagai lapisan transport. Dalam hal ini, penting untuk tidak mengecualikan file dari cadangan — jika tidak, sinkronisasi antar perangkat dapat terganggu.

Application Support vs Documents Directory

Perbedaan antara Application Support dan Documents — salah satu yang paling penting untuk organisasi struktur file aplikasi iOS yang benar. Pilihan yang salah dapat menyebabkan pengguna secara tidak sengaja menghapus data penting aplikasi atau, sebaliknya, tidak dapat menemukan file mereka sendiri.

Aturan sederhana: jika pengguna harus melihat file dan dapat menghapusnya — gunakan Documents. Jika file diperlukan aplikasi untuk beroperasi, tetapi pengguna tidak perlu tahu tentangnya — gunakan Application Support. Jika data dapat dipulihkan — gunakan Caches.

Praktik terbaik bekerja dengan Application Support

Bekerja dengan Application Support memerlukan pertimbangan beberapa fitur yang membedakannya dari direktori lain di sandbox. Mengikuti praktik ini membantu menghindari kehilangan data, masalah migrasi, dan perilaku aplikasi yang tidak terduga.

Selalu buat direktori pada peluncuran pertama

Tidak seperti Documents, Application Support mungkin tidak ada pada peluncuran pertama. Gunakan createDirectory(at:withIntermediateDirectories:) dengan parameter withIntermediateDirectories: true untuk menjamin pembuatan seluruh rantai subdirektori.

Gunakan subdirektori dengan Bundle Identifier

Buat subdirektori dengan Bundle Identifier di dalam Application Support. Ini mengisolasi data aplikasi Anda dari data aplikasi lain (meskipun sandbox sudah menyediakan isolasi) dan menyederhanakan migrasi saat berganti penyedia.

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

Mengikuti praktik ini menjamin bahwa data layanan aplikasi terorganisir dengan benar, terlindung dari penghapusan tidak sengaja oleh pengguna, dan dipulihkan dengan benar dari cadangan.