Application Support: Konfigurationsspeicher und Core Data

Was ist Application Support in iOS?

Application Support ist ein Verzeichnis in der iOS-App-Sandbox, das zum Speichern von Daten konzipiert ist, die die App für ihre Arbeit erstellt und verwendet, die aber keine Benutzerdokumente sind. Dies ist der primäre Ort für Konfigurationen, Datenbanken, zwischengespeicherte Metadaten und andere Hilfsdateien.

iOS weist Application Support als Zwischenschicht zwischen Documents (Benutzerdaten) und Caches (temporäre Daten) aus. Dateien in Application Support können relativ dauerhaft sein, aber der Benutzer sollte keinen direkten Zugriff darauf haben — dies unterscheidet es vom Documents Directory.

Laut Apple Developer Documentation (2024) ist Application Support der empfohlene Ort zum Speichern von Core Data SQLite-Datenbanken, Realm-Dateien, Konfigurationen im JSON/plist-Format, heruntergeladenen Referenzmaterialien und anderen Daten, die die App verwendet, die der Benutzer jedoch nicht explizit erstellt hat.

Wichtig: Standardmäßig ist Application Support in das iCloud- und iTunes-Backup eingeschlossen. Wenn die App große Datenmengen in diesem Verzeichnis speichert, die neu erstellt werden können (z. B. heruntergeladene Anleitungen), muss die isExcludedFromBackup-Flag für die entsprechenden Dateien gesetzt werden.

So erhalten Sie den Pfad zu Application Support

In Swift wird der Pfad zum Application Support Directory über FileManager.urls(for: .applicationSupportDirectory) abgerufen. Apple empfiehlt, ein Unterverzeichnis mit dem App-Namen innerhalb von Application Support zur Datenisolierung zu erstellen.

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 verwendet NSSearchPathForDirectoriesInDomains mit NSApplicationSupportDirectory. Wie bei Swift wird empfohlen, ein Unterverzeichnis mit dem App-Namen zu erstellen.

@import Foundation;

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

Beim ersten Start ist das Application Support-Verzeichnis möglicherweise nicht vorhanden — es muss mit createDirectory(at:withIntermediateDirectories:) erstellt werden. Dies unterscheidet es vom Documents Directory, das automatisch vom System erstellt wird.

Welche Daten in Application Support gespeichert werden

Application Support eignet sich für eine Vielzahl von Daten, die die App für ihre Arbeit verwendet. Die richtige Auswahl der Daten für dieses Verzeichnis verbessert die Organisation des Dateisystems und vereinfacht die Sicherung.

Core Data- und Realm-Datenbanken

Die SQLite-Dateien von Core Data werden standardmäßig in Application Support erstellt. Realm empfiehlt ebenfalls, Datenbanken in diesem Verzeichnis zu platzieren. Dies isoliert Benutzerdokumente von den internen Datenbanken der App.

Konfigurationsdateien

JSON-, plist-, XML-Dateien mit App-Einstellungen, Feature Flags, zwischengespeicherte Benutzermetadaten (aber keine Authentifizierungstoken — dafür Keychain verwenden).

Auswahlkriterium: Wenn die Daten von der App erstellt und verwendet werden, nicht vom Benutzer, und zwischen den Starts erhalten bleiben sollen — gehört ihr Platz in Application Support.

Core Data und Application Support

Core Data ist einer der Hauptnutzer von Application Support. Beim Erstellen eines NSPersistentContainer platziert Core Data automatisch SQLite-Dateien in Library/Application Support mit einem eindeutigen Namen basierend auf dem Modellnamen.

Zu verstehen, wo Core Data Dateien speichert, ist entscheidend für Migrationen, Sicherung und Fehlerbehebung. Hauptdateien: .sqlite (Daten), .sqlite-wal (Write-Ahead Log), .sqlite-shm (Shared Memory).

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]

Bei Verwendung der CloudKit Core Data-Synchronisation bleibt die SQLite-Datei in Application Support und CloudKit fungiert als Transportschicht. In diesem Fall ist es wichtig, Dateien nicht vom Backup auszuschließen — andernfalls kann die Synchronisation zwischen Geräten gestört werden.

Application Support vs Documents Directory

Der Unterschied zwischen Application Support und Documents ist einer der wichtigsten für die richtige Organisation der iOS-App-Dateistruktur. Eine falsche Wahl kann dazu führen, dass der Benutzer versehentlich wichtige App-Daten löscht oder umgekehrt seine Dateien nicht finden kann.

Einfache Regel: Wenn der Benutzer die Datei sehen und löschen können soll — verwenden Sie Documents. Wenn die Datei für die App zum Funktionieren benötigt wird, der Benutzer aber nichts davon wissen muss — verwenden Sie Application Support. Wenn die Daten neu erstellt werden können — verwenden Sie Caches.

Bewährte Verfahren für die Arbeit mit Application Support

Die Arbeit mit Application Support erfordert die Berücksichtigung mehrerer Merkmale, die es von anderen Sandbox-Verzeichnissen unterscheiden. Die Befolgung dieser Verfahren hilft, Datenverlust, Migrationsprobleme und unerwartetes App-Verhalten zu vermeiden.

Erstellen Sie das Verzeichnis immer beim ersten Start

Anders als Documents ist Application Support möglicherweise beim ersten Start nicht vorhanden. Verwenden Sie createDirectory(at:withIntermediateDirectories:) mit dem Parameter withIntermediateDirectories: true, um die Erstellung der gesamten Unterverzeichniskette zu gewährleisten.

Verwenden Sie ein Unterverzeichnis mit Bundle Identifier

Erstellen Sie ein Unterverzeichnis mit der Bundle-ID innerhalb von Application Support. Dies isoliert die Daten Ihrer App von anderen Apps (obwohl die Sandbox bereits Isolierung bietet) und vereinfacht die Migration bei einem Anbieterwechsel.

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

Die Befolgung dieser Verfahren stellt sicher, dass die Servicedaten der App ordnungsgemäß organisiert, vor versehentlichem Löschen durch den Benutzer geschützt und korrekt aus Backups wiederhergestellt werden.