Application Support: wat is het, configuraties opslaan en Core Data

Wat is Application Support in iOS?

Application Support — is een directory in de sandbox van een iOS-app, bedoeld voor het opslaan van gegevens die de app aanmaakt en gebruikt voor zijn werking, maar die geen gebruikersdocumenten zijn. Dit is de primaire locatie voor configuraties, databases, gecachte metadata en andere ondersteunende bestanden.

iOS onderscheidt Application Support als tussenliggend niveau tussen Documents (gebruikersgegevens) en Caches (tijdelijke gegevens). Bestanden in Application Support kunnen relatief permanent zijn, maar de gebruiker zou er geen directe toegang toe moeten hebben — dit onderscheidt het van Documents Directory.

Volgens Apple Developer Documentation (2024) is Application Support de aanbevolen locatie voor het opslaan van Core Data SQLite-databases, Realm-bestanden, configuraties in JSON/plist-formaat, gedownloade referentiematerialen en andere gegevens die de app gebruikt, maar die de gebruiker niet expliciet heeft aangemaakt.

Belangrijk: standaard is Application Support opgenomen in de iCloud- en iTunes-back-up. Als de app grote hoeveelheden herbruikbare gegevens in deze directory opslaat (bijv. gedownloade handleidingen), moet de vlag isExcludedFromBackup worden ingesteld voor de betreffende bestanden.

Hoe krijg ik het pad naar Application Support

In Swift wordt het pad naar Application Support Directory verkregen via FileManager.urls(for: .applicationSupportDirectory). Apple raadt aan om een subdirectory met de app-naam aan te maken binnen Application Support voor gegevensisolatie.

import Foundation

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

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

Objective-C gebruikt NSSearchPathForDirectoriesInDomains met NSApplicationSupportDirectory. Net als in Swift wordt aanbevolen een subdirectory met de app-naam aan te maken.

@import Foundation;

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

Bij de eerste start bestaat de Application Support-directory mogelijk niet — deze moet worden aangemaakt met createDirectory(at:withIntermediateDirectories:). Dit onderscheidt het van Documents Directory, die automatisch door het systeem wordt aangemaakt.

Welke gegevens opslaan in Application Support

Application Support is geschikt voor een breed scala aan gegevens die de app gebruikt voor zijn werking. De juiste gegevenskeuze voor deze directory verbetert de bestandssysteemorganisatie en vereenvoudigt back-ups.

Core Data en Realm databases

SQLite-bestanden van Core Data worden standaard aangemaakt in Application Support. Realm raadt ook aan databases in deze directory te plaatsen. Dit isoleert gebruikersdocumenten van de interne databases van de app.

Configuratiebestanden

JSON, plist, XML-bestanden met app-instellingen, Feature Flags, gecachte metadata over de gebruiker (maar geen authenticatietokens — daarvoor is Keychain).

Selectiecriterium: als gegevens worden aangemaakt en gebruikt door de app, niet door de gebruiker, en moeten worden bewaard tussen starts — dan is hun plaats in Application Support.

Core Data en Application Support

Core Data — een van de belangrijkste gebruikers van Application Support. Bij het aanmaken van NSPersistentContainer plaatst Core Data automatisch SQLite-bestanden in Library/Application Support met een unieke naam op basis van de modelnaam.

Begrijpen waar Core Data bestanden opslaat is cruciaal voor migraties, back-ups en debuggen. Belangrijkste bestanden: .sqlite (gegevens), .sqlite-wal (Write-Ahead Log), .sqlite-shm (Shared Memory).

import CoreData

// Maak Core Data-container aan
let container = NSPersistentContainer(name: "MyAppModel")

// Aangepaste winkel-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]

Bij gebruik van CloudKit synchronisatie voor Core Data blijft het SQLite-bestand in Application Support en wordt CloudKit gebruikt als transportlaag. In dit geval is het belangrijk bestanden niet uit te sluiten van back-up — anders kan synchronisatie tussen apparaten worden verstoord.

Application Support vs Documents Directory

Het verschil tussen Application Support en Documents — een van de belangrijkste voor een correcte organisatie van de bestandsstructuur van een iOS-app. Een verkeerde keuze kan ertoe leiden dat de gebruiker per ongeluk belangrijke app-gegevens verwijdert of, omgekeerd, zijn eigen bestanden niet kan vinden.

Eenvoudige regel: als de gebruiker het bestand moet zien en moet kunnen verwijderen — gebruik Documents. Als het bestand nodig is voor de werking van de app, maar de gebruiker hoeft er niet van te weten — gebruik Application Support. Als gegevens kunnen worden hersteld — gebruik Caches.

Beste praktijken voor werken met Application Support

Werken met Application Support vereist het in acht nemen van verschillende kenmerken die het onderscheiden van andere directories in de sandbox. Het naleven van deze praktijken helpt gegevensverlies, migratieproblemen en onverwacht app-gedrag te voorkomen.

Maak altijd de directory aan bij de eerste start

In tegenstelling tot Documents kan Application Support bij de eerste start niet bestaan. Gebruik createDirectory(at:withIntermediateDirectories:) met parameter withIntermediateDirectories: true om de aanmaak van de volledige keten van subdirectories te garanderen.

Gebruik een subdirectory met Bundle Identifier

Maak een subdirectory met Bundle Identifier aan binnen Application Support. Dit isoleert de gegevens van jouw app van gegevens van andere apps (hoewel de sandbox al isolatie biedt) en vereenvoudigt migratie bij een leverancierswissel.

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

Het naleven van deze praktijken garandeert dat de servicegegevens van de app correct zijn georganiseerd, beschermd tegen onbedoeld verwijderen door de gebruiker en correct worden hersteld uit back-ups.